summaryrefslogtreecommitdiffstats
path: root/contrib/tcl/doc/TraceVar.3
diff options
context:
space:
mode:
authorphk <phk@FreeBSD.org>1997-07-25 19:27:55 +0000
committerphk <phk@FreeBSD.org>1997-07-25 19:27:55 +0000
commit30db38624722a51670556ef9b2dd7ccf4fb57387 (patch)
treed2f88b3e9ffa79ffb2cc1a0699dd3ee96c47c3e5 /contrib/tcl/doc/TraceVar.3
parent4170733a21f58ada18a6760af477926f494b5b67 (diff)
downloadFreeBSD-src-30db38624722a51670556ef9b2dd7ccf4fb57387.zip
FreeBSD-src-30db38624722a51670556ef9b2dd7ccf4fb57387.tar.gz
Import TCL release 8.0 beta 2.
Diffstat (limited to 'contrib/tcl/doc/TraceVar.3')
-rw-r--r--contrib/tcl/doc/TraceVar.312
1 files changed, 1 insertions, 11 deletions
diff --git a/contrib/tcl/doc/TraceVar.3 b/contrib/tcl/doc/TraceVar.3
index ecfdc3e..665a3a7 100644
--- a/contrib/tcl/doc/TraceVar.3
+++ b/contrib/tcl/doc/TraceVar.3
@@ -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.
'\"
-'\" SCCS: @(#) TraceVar.3 1.25 96/03/25 20:08:44
+'\" SCCS: @(#) TraceVar.3 1.26 96/08/26 12:59:52
'\"
.so man.macros
.TH Tcl_TraceVar 3 7.4 Tcl "Tcl Library Procedures"
@@ -39,11 +39,9 @@ Interpreter containing variable.
Name of variable. May refer to a scalar variable, to
an array variable with no index, or to an array variable
with a parenthesized index.
-.VS
If the name references an element of an array, then it
must be in writable memory: Tcl will make temporary modifications
to it while looking up the name.
-.VE
.AP int flags in
OR-ed combination of the values TCL_TRACE_READS, TCL_TRACE_WRITES, and
TCL_TRACE_UNSETS, and TCL_GLOBAL_ONLY. Not all flags are used by all
@@ -195,10 +193,8 @@ for the variable, so that calls to \fBTcl_GetVar2\fR and
to be invoked again.
Disabling only occurs for the variable whose trace procedure
is active; accesses to other variables will still be traced.
-.VS
However, if a variable is unset during a read or write trace then unset
traces will be invoked.
-.VE
.PP
During unset traces the variable has already been completely
expunged.
@@ -222,10 +218,8 @@ and \fBTcl_GetVar2\fR procedures.
returned.
It may modify the value of the variable to affect what
is returned by the traced access.
-.VS
If it unsets the variable then the access will return an error
just as if the variable never existed.
-.VE
.PP
When write tracing has been specified for a variable, the
trace procedure will be invoked whenever the variable's value
@@ -239,10 +233,8 @@ returned.
It may modify the value of the variable to override the change
and to determine the value actually returned by the traced
access.
-.VS
If it deletes the variable then the traced access will return
an empty string.
-.VE
.PP
When unset tracing has been specified, the trace procedure
will be invoked whenever the variable is destroyed.
@@ -270,11 +262,9 @@ access, in order from most-recently-created to least-recently-created.
When there exist whole-array traces for an array as well as
traces on individual elements, the whole-array traces are invoked
before the individual-element traces.
-.VS
If a read or write trace unsets the variable then all of the unset
traces will be invoked but the remainder of the read and write traces
will be skipped.
-.VE
.SH "ERROR RETURNS"
.PP
OpenPOWER on IntegriCloud