summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authordkf <donal.k.fellows@manchester.ac.uk>2007-12-13 11:21:46 (GMT)
committerdkf <donal.k.fellows@manchester.ac.uk>2007-12-13 11:21:46 (GMT)
commit337857f8f0c62f7a7ac175f85876f4f498e92255 (patch)
tree8b30ac2370ee2735e155b13d19588332a83a02ce
parent6e47a3ff9a5adbccedc0346d443f6c4aac9c09c6 (diff)
downloadtcl-337857f8f0c62f7a7ac175f85876f4f498e92255.zip
tcl-337857f8f0c62f7a7ac175f85876f4f498e92255.tar.gz
tcl-337857f8f0c62f7a7ac175f85876f4f498e92255.tar.bz2
More clarification. [Bug 614282]
-rw-r--r--ChangeLog18
-rw-r--r--doc/trace.n17
2 files changed, 25 insertions, 10 deletions
diff --git a/ChangeLog b/ChangeLog
index 98a1365..79cf5e6 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,7 +1,7 @@
2007-12-13 Donal K. Fellows <donal.k.fellows@manchester.ac.uk>
* doc/trace.n: Clarified documentation of enterstep and leavestep
- traces. [Bug 1701540]
+ traces, including adding example. [Bug 614282, 1701540]
2007-12-12 Don Porter <dgp@users.sourceforge.net>
@@ -24,24 +24,24 @@
* doc/StrMatch.3: It is compatible with existing usage.
* generic/tclExecute.c (INST_STR_MATCH): flag for TclByteArrayMatch
* generic/tclUtil.c (TclByteArrayMatch, TclStringMatchObj):
- * generic/tclRegexp.c (Tcl_RegExpExecObj):
+ * generic/tclRegexp.c (Tcl_RegExpExecObj):
* generic/tclCmdMZ.c (StringMatchCmd): Use TclStringMatchObj
* tests/string.test (11.9.* 11.10.*): more tests
-
+
2007-12-10 Joe English <jenglish@users.sourceforge.net>
* doc/string.n, doc/UniCharIsAlpha.3: Fix markup errors.
* doc/CrtCommand.3, doc/CrtMathFnc.3, doc/FileSystem.3,
- doc/GetStdChan.3, doc/OpenFileChnl.3, doc/SetChanErr.3,
- doc/eval.n, doc/filename.n: Consistency: Move "KEYWORDS"
- section after "SEE ALSO".
+ * doc/GetStdChan.3, doc/OpenFileChnl.3, doc/SetChanErr.3,
+ * doc/eval.n, doc/filename.n: Consistency: Move "KEYWORDS" section
+ after "SEE ALSO".
2007-12-10 Daniel Steffen <das@users.sourceforge.net>
* tools/genStubs.tcl: fix numerous issues handling 'macosx',
'aqua' or 'x11' entries interleaved
- with 'unix' entries [Bug 1834288];
- add genStubs::export command
+ with 'unix' entries [Bug 1834288]; add
+ genStubs::export command
[Tk FR 1716117]; cleanup formatting.
* generic/tcl.decls: use new genstubs 'export' command to
@@ -60,7 +60,7 @@
* tests/io.test, tests/chanio.test (io-73.1): Make sure to invalidate
* generic/tclIO.c (SetChannelFromAny): internal rep only after
validating channel rep. [Bug 1847044]
-
+
2007-12-08 Donal K. Fellows <dkf@users.sf.net>
* doc/expr.n, doc/mathop.n: Improved the documentation of the
diff --git a/doc/trace.n b/doc/trace.n
index 781921a..ef6a3f6 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.23 2007/12/13 11:10:20 dkf Exp $
+'\" RCS: @(#) $Id: trace.n,v 1.24 2007/12/13 11:21:46 dkf Exp $
'\"
.so man.macros
.TH trace n "8.4" Tcl "Tcl Built-In Commands"
@@ -387,6 +387,21 @@ proc doMult args {
\fBtrace add\fR variable foo write doMult
\fBtrace add\fR variable bar write doMult
.CE
+.PP
+Print a trace of what commands are executed during the processing of a Tcl
+procedure:
+.CS
+proc x {} { y }
+proc y {} { z }
+proc z {} { puts hello }
+proc report args {puts [info level 0]}
+\fBtrace add\fR execution x enterstep report
+x
+ \(-> \fIreport y enterstep\fR
+ \fIreport z enterstep\fR
+ \fIreport {puts hello} enterstep\fR
+ \fIhello\fR
+.CE
.SH "SEE ALSO"
set(n), unset(n)
.SH KEYWORDS