diff options
author | ericm <ericm@noemail.net> | 2000-01-26 21:36:35 (GMT) |
---|---|---|
committer | ericm <ericm@noemail.net> | 2000-01-26 21:36:35 (GMT) |
commit | 17c006309b0621e3f6a8b6039c740bb1965ba3bd (patch) | |
tree | c034dc441d7fe54e8a3187e41a118ac3a83186fd /doc | |
parent | c2eb8874372076fe197d6322021de5ffbdd42829 (diff) | |
download | tcl-17c006309b0621e3f6a8b6039c740bb1965ba3bd.zip tcl-17c006309b0621e3f6a8b6039c740bb1965ba3bd.tar.gz tcl-17c006309b0621e3f6a8b6039c740bb1965ba3bd.tar.bz2 |
* generic/tclNamesp.c: Undid fix for #956, which broke backwards
compatibility.
* doc/variable.n:
* doc/trace.n:
* doc/namespace.n:
* doc/info.n: Added further information about differences between
"namespace which" and "info exists".
* doc/SetErrno.3: Added descriptions of ErrnoId() and ErrnoMsg()
functions.
FossilOrigin-Name: 234fd734e8d4daeaea295834d47f4f7b419321d5
Diffstat (limited to 'doc')
-rw-r--r-- | doc/SetErrno.3 | 19 | ||||
-rw-r--r-- | doc/info.n | 6 | ||||
-rw-r--r-- | doc/namespace.n | 7 | ||||
-rw-r--r-- | doc/trace.n | 6 | ||||
-rw-r--r-- | doc/variable.n | 6 |
5 files changed, 32 insertions, 12 deletions
diff --git a/doc/SetErrno.3 b/doc/SetErrno.3 index d57263b..78adebd 100644 --- a/doc/SetErrno.3 +++ b/doc/SetErrno.3 @@ -4,12 +4,12 @@ '\" See the file "license.terms" for information on usage and redistribution '\" of this file, and for a DISCLAIMER OF ALL WARRANTIES. '\" -'\" RCS: @(#) $Id: SetErrno.3,v 1.2 1998/09/14 18:39:50 stanton Exp $ +'\" RCS: @(#) $Id: SetErrno.3,v 1.3 2000/01/26 21:36:35 ericm Exp $ .so man.macros -.TH Tcl_SetErrno 3 7.5 Tcl "Tcl Library Procedures" +.TH Tcl_SetErrno 3 8.3 Tcl "Tcl Library Procedures" .BS .SH NAME -Tcl_SetErrno, Tcl_GetErrno \- manipulate errno to store and retrieve error codes +Tcl_SetErrno, Tcl_GetErrno, Tcl_ErrnoId, Tcl_ErrnoMsg \- manipulate errno to store and retrieve error codes .SH SYNOPSIS .nf \fB#include <tcl.h>\fR @@ -20,6 +20,12 @@ void int \fBTcl_GetErrno\fR() .sp +char * +\fBTcl_ErrnoId\fR() +.sp +char * +\fBTcl_ErrnoMsg\fR() +.sp .SH ARGUMENTS .AS Tcl_Interp *errorCode in .AP int errorCode in @@ -43,6 +49,13 @@ via \fBerrno\fR should call \fBTcl_SetErrno\fR rather than setting \fBTcl_GetErrno\fR returns the current value of \fBerrno\fR. Procedures wishing to access \fBerrno\fR should call this procedure instead of accessing \fBerrno\fR directly. +.PP +\fBTcl_ErrnoId\fR and \fBTcl_ErrnoMsg\fR return a string +representation of the current \fBerrno\fR value. \fBTcl_ErrnoId\fR +returns a machine-readable textual identifier such as +"EACCES". \fBTcl_ErrnoMsg\fR returns a human-readable string such as +"permission denied". The strings returned by these functions are +statically allocated and the caller must not free or modify them. .SH KEYWORDS errno, error code, global variables @@ -6,7 +6,7 @@ '\" See the file "license.terms" for information on usage and redistribution '\" of this file, and for a DISCLAIMER OF ALL WARRANTIES. '\" -'\" RCS: @(#) $Id: info.n,v 1.2 1998/09/14 18:39:53 stanton Exp $ +'\" RCS: @(#) $Id: info.n,v 1.3 2000/01/26 21:36:35 ericm Exp $ '\" .so man.macros .TH info n 7.5 Tcl "Tcl Built-In Commands" @@ -72,8 +72,8 @@ into variable \fIvarname\fR. .TP \fBinfo exists \fIvarName\fR Returns \fB1\fR if the variable named \fIvarName\fR exists in the -current context (either as a global or local variable), returns \fB0\fR -otherwise. +current context (either as a global or local variable) and has been +defined by being given a value, returns \fB0\fR otherwise. .TP \fBinfo globals \fR?\fIpattern\fR? If \fIpattern\fR isn't specified, returns a list of all the names diff --git a/doc/namespace.n b/doc/namespace.n index eeb45f5..93d1656 100644 --- a/doc/namespace.n +++ b/doc/namespace.n @@ -5,7 +5,7 @@ '\" See the file "license.terms" for information on usage and redistribution '\" of this file, and for a DISCLAIMER OF ALL WARRANTIES. '\" -'\" RCS: @(#) $Id: namespace.n,v 1.3 1999/04/16 00:46:35 stanton Exp $ +'\" RCS: @(#) $Id: namespace.n,v 1.4 2000/01/26 21:36:35 ericm Exp $ '\" .so man.macros .TH namespace n 8.0 Tcl "Tcl Built-In Commands" @@ -228,7 +228,10 @@ For example, if \fIname\fR does not exist in the current namespace but does exist in the global namespace, this command returns a fully-qualified name in the global namespace. If the command or variable does not exist, -this command returns an empty string. +this command returns an empty string. If the variable has been +created but not defined, such as with the \fBvariable\fR command +or through a \fBtrace\fR on the variable, this command will return the +fully-qualified name of the variable. If no flag is given, \fIname\fR is treated as a command name. See the section \fBNAME RESOLUTION\fR below for an explanation of the rules regarding name resolution. diff --git a/doc/trace.n b/doc/trace.n index 317205a..7266bac 100644 --- a/doc/trace.n +++ b/doc/trace.n @@ -5,7 +5,7 @@ '\" See the file "license.terms" for information on usage and redistribution '\" of this file, and for a DISCLAIMER OF ALL WARRANTIES. '\" -'\" RCS: @(#) $Id: trace.n,v 1.2 1998/09/14 18:39:56 stanton Exp $ +'\" RCS: @(#) $Id: trace.n,v 1.3 2000/01/26 21:36:35 ericm Exp $ '\" .so man.macros .TH trace n "" Tcl "Tcl Built-In Commands" @@ -30,7 +30,9 @@ refer to a normal variable, an element of an array, or to an array as a whole (i.e. \fIname\fR may be just the name of an array, with no parenthesized index). If \fIname\fR refers to a whole array, then \fIcommand\fR is invoked whenever any element of the array is -manipulated. +manipulated. If the variable does not exist, it will be created but +will not be given a value, so it will be visible to \fBnamespace which\fR +queries, but not to \fBinfo exists\fR queries. .RS .PP \fIOps\fR indicates which operations are of interest, and consists of diff --git a/doc/variable.n b/doc/variable.n index 3b742a9..417cd24 100644 --- a/doc/variable.n +++ b/doc/variable.n @@ -5,7 +5,7 @@ '\" See the file "license.terms" for information on usage and redistribution '\" of this file, and for a DISCLAIMER OF ALL WARRANTIES. '\" -'\" RCS: @(#) $Id: variable.n,v 1.2 1998/09/14 18:39:56 stanton Exp $ +'\" RCS: @(#) $Id: variable.n,v 1.3 2000/01/26 21:36:35 ericm Exp $ '\" .so man.macros .TH variable n 8.0 Tcl "Tcl Built-In Commands" @@ -36,7 +36,9 @@ Normally, \fIname\fR is unqualified (does not include the names of any containing namespaces), and the variable is created in the current namespace. If \fIname\fR includes any namespace qualifiers, -the variable is created in the specified namespace. +the variable is created in the specified namespace. If the variable +is not defined, it will be visible to the \fBnamespace which\fR +command, but not to the \fBinfo exists\fR command. .PP If the \fBvariable\fR command is executed inside a Tcl procedure, it creates local variables |