summaryrefslogtreecommitdiffstats
path: root/doc/trace.n
diff options
context:
space:
mode:
Diffstat (limited to 'doc/trace.n')
-rw-r--r--doc/trace.n22
1 files changed, 8 insertions, 14 deletions
diff --git a/doc/trace.n b/doc/trace.n
index 7ab4f07..e929a53 100644
--- a/doc/trace.n
+++ b/doc/trace.n
@@ -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: trace.n,v 1.20 2007/10/25 14:07:32 dkf Exp $
+'\" RCS: @(#) $Id: trace.n,v 1.21 2007/10/26 20:11:53 dgp Exp $
'\"
.so man.macros
.TH trace n "8.4" Tcl "Tcl Built-In Commands"
@@ -21,7 +21,7 @@ trace \- Monitor variable accesses, command usages and command executions
.SH DESCRIPTION
.PP
This command causes Tcl commands to be executed whenever certain operations are
-invoked. The legal \fIoption\fRs (which may be abbreviated) are:
+invoked. The legal \fIoption\fR's (which may be abbreviated) are:
.TP
\fBtrace add \fItype name ops ?args?\fR
Where \fItype\fR is \fBcommand\fR, \fBexecution\fR, or \fBvariable\fR.
@@ -40,8 +40,7 @@ one or more of the following items:
\fBrename\fR
Invoke \fIcommand\fR whenever the command is renamed. Note that
renaming to the empty string is considered deletion, and will not
-be traced with
-.QW rename .
+be traced with '\fBrename\fR'.
.TP
\fBdelete\fR
Invoke \fIcommand\fR when the command is deleted. Commands can be
@@ -58,9 +57,7 @@ command is as follows:
.CE
\fIOldName\fR and \fInewName\fR give the traced command's current
(old) name, and the name to which it is being renamed (the empty
-string if this is a
-.QW delete
-operation).
+string if this is a 'delete' operation).
\fIOp\fR indicates what operation is being performed on the
command, and is one of \fBrename\fR or \fBdelete\fR as
defined above. The trace operation cannot be used to stop a command
@@ -95,11 +92,9 @@ just after the actual execution takes place.
\fBenterstep\fR
Invoke \fIcommand\fR for every Tcl command which is executed
inside the procedure \fIname\fR, just before the actual execution
-takes place. For example if we have
-.QW "proc foo {} { puts {hello world} }" ,
-then an \fIenterstep\fR trace would be invoked just before
-.QW "puts {hello world}"
-is executed.
+takes place. For example if we have 'proc foo {} { puts "hello" }',
+then an \fIenterstep\fR trace would be
+invoked just before \fIputs "hello"\fR is executed.
Setting an \fIenterstep\fR trace on a \fIcommand\fR
will not result in an error and is simply ignored.
.TP
@@ -126,8 +121,7 @@ all arguments in their fully expanded form.
command execution, and is one of \fBenter\fR or \fBenterstep\fR as
defined above. The trace operation can be used to stop the
command from executing, by deleting the command in question. Of
-course when the command is subsequently executed, an
-.QW "invalid command"
+course when the command is subsequently executed, an 'invalid command'
error will occur.
.PP
For \fBleave\fR and \fBleavestep\fR operations: