Opened 13 years ago

Last modified 7 years ago

#15623 new enhancement

guide (trunk) Documentation missing for several Tcl extenstions (pextlib1.0)

Reported by: febeling@… Owned by: macports-tickets@…
Priority: Normal Milestone:
Component: guide Version:
Keywords: Cc: cooljeanius (Eric Gallager)
Port:

Description

Many of the Pextlib commands are undocumented, among them prominent ones like "system".

system
flock
readdir
strsed
mkstemp
mktemp
md5
fs-traverse
filemap
rpm-vercomp
rmd160
sha1
compat
umask
sudo
mkfifo
unixsocketpair
mkchannelfromfd
pipe
curl
symlink
unsetenv
readline
rl_history
getuid
geteuid
getgid
getegid
setuid
seteuid
setgid
setegid
name_to_uid
uid_to_name
name_to_gid
gid_to_name
tracelib

See the definition of the extension here:

http://trac.macports.org/browser/trunk/base/src/pextlib1.0/Pextlib.c#L1167

The list is compiled by copying those minus the ones which actually are documented here in the guide.

http://guide.macports.org/#reference.tcl-extensions

Not sure if some of these should stay undocumented because they are rather implementation detail or "private", but most look quite generally applicable.

The related list discussion was this:

http://www.mail-archive.com/macports-dev@lists.macosforge.org/msg05179.html

Change History (5)

comment:1 Changed 12 years ago by (none)

Milestone: Website & Documentation

Milestone Website & Documentation deleted

comment:2 Changed 9 years ago by cooljeanius (Eric Gallager)

Cc: egall@… added

Cc Me!

comment:3 Changed 9 years ago by cooljeanius (Eric Gallager)

I was bitten by fs-traverse not being documented in #38555

comment:4 Changed 8 years ago by cooljeanius (Eric Gallager)

Also since these are Tcl procs, it would be useful to have manpages for them in section "n" of the manual like the rest of the Tcl manpages, so that I could just do:

man n fs-traverse

to find out about fs-traverse, for example.

comment:5 Changed 7 years ago by mf2k (Frank Schima)

Owner: changed from markd@… to macports-tickets@…
Type: defectenhancement
Version: 1.6.0

markd has retired. See #44782.

Note: See TracTickets for help on using tickets.