summaryrefslogtreecommitdiffstats
path: root/doc/trace.n
diff options
context:
space:
mode:
authorericm <ericm>2000-08-25 20:39:31 (GMT)
committerericm <ericm>2000-08-25 20:39:31 (GMT)
commitf97152e392c85c9bd4b78be2bb666328b7044928 (patch)
treec69a36203d04a0e5c5ed4330b83a25a757695724 /doc/trace.n
parentda5194713b3c8a85943b8b731534a32a398981a9 (diff)
downloadtcl-f97152e392c85c9bd4b78be2bb666328b7044928.zip
tcl-f97152e392c85c9bd4b78be2bb666328b7044928.tar.gz
tcl-f97152e392c85c9bd4b78be2bb666328b7044928.tar.bz2
* tests/trace.test: Extended array tracing tests.
* doc/trace.n: Clarified information about when array traces will be fired. * generic/tclVar.c (Tcl_ArrayObjCmd): Corrected call to CallTraces (for TCL_TRACE_ARRAY) to only be called when the variable is either an array or is undefined, to ensure that array traces do not fire for scalar variables.
Diffstat (limited to 'doc/trace.n')
-rw-r--r--doc/trace.n7
1 files changed, 5 insertions, 2 deletions
diff --git a/doc/trace.n b/doc/trace.n
index bf04299..e351311 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.4 2000/08/25 02:04:27 ericm Exp $
+'\" RCS: @(#) $Id: trace.n,v 1.5 2000/08/25 20:39:31 ericm Exp $
'\"
.so man.macros
.TH trace n "8.4" Tcl "Tcl Built-In Commands"
@@ -83,7 +83,10 @@ one or more of the following items:
.TP
\fBarray\fR
Invoke \fIcommand\fR whenever the variable is accessed or modified via
-the \fBarray\fR command.
+the \fBarray\fR command, provided that \fIname\fR is not a scalar
+variable at the time that the \fBarray\fR command is invoked. If
+\fIname\fR is a scalar variable, the access via the \fBarray\fR
+command will not trigger the trace.
\fBread\fR
Invoke \fIcommand\fR whenever the variable is read.
.TP