From 337857f8f0c62f7a7ac175f85876f4f498e92255 Mon Sep 17 00:00:00 2001 From: dkf Date: Thu, 13 Dec 2007 11:21:46 +0000 Subject: More clarification. [Bug 614282] --- ChangeLog | 18 +++++++++--------- doc/trace.n | 17 ++++++++++++++++- 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 * doc/trace.n: Clarified documentation of enterstep and leavestep - traces. [Bug 1701540] + traces, including adding example. [Bug 614282, 1701540] 2007-12-12 Don Porter @@ -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 * 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 * 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 * 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 -- cgit v0.12