summaryrefslogtreecommitdiffstats
path: root/doc
diff options
context:
space:
mode:
authorKevin B Kenny <kennykb@acm.org>2010-10-23 15:49:54 (GMT)
committerKevin B Kenny <kennykb@acm.org>2010-10-23 15:49:54 (GMT)
commita8212a3142ffffc86cf0eb05606cae9116d2d337 (patch)
treefbfde62679ab0f9c00e17a2080063adef9127263 /doc
parentba272f699236d12685e8a297303f71d9fe87080f (diff)
downloadtcl-a8212a3142ffffc86cf0eb05606cae9116d2d337.zip
tcl-a8212a3142ffffc86cf0eb05606cae9116d2d337.tar.gz
tcl-a8212a3142ffffc86cf0eb05606cae9116d2d337.tar.bz2
merge
Diffstat (limited to 'doc')
-rw-r--r--doc/info.n20
1 files changed, 12 insertions, 8 deletions
diff --git a/doc/info.n b/doc/info.n
index 717ddcf..dc7947f 100644
--- a/doc/info.n
+++ b/doc/info.n
@@ -8,7 +8,7 @@
'\" See the file "license.terms" for information on usage and redistribution
'\" of this file, and for a DISCLAIMER OF ALL WARRANTIES.
'\"
-'\" RCS: @(#) $Id: info.n,v 1.38.2.1 2010/10/20 01:50:18 kennykb Exp $
+'\" RCS: @(#) $Id: info.n,v 1.38.2.2 2010/10/23 15:49:54 kennykb Exp $
'\"
.so man.macros
.TH info n 8.4 Tcl "Tcl Built-In Commands"
@@ -100,13 +100,17 @@ Returns, in a form that is programmatically easy to parse, the function names
and arguments at each level from the call stack of the last error in the given
\fIinterp\fR, or in the current one if not specified.
-This form is an
-even-sized list alternating tokens and parameters. Tokens are currently either
-\fBCALL\fR or \fBUP\fR, but other values may be introduced in the
-future. \fBCALL\fR indicates a procedure call, and its parameter is the
-corresponding [info level 0]; \fBUP\fR indicates a shift in variable frames
-generated by uplevel or similar, and applies to the previous CALL item. Its
-parameter is the level offset.
+This form is an even-sized list alternating tokens and parameters. Tokens are
+currently either \fBCALL\fR, \fBUP\fR, or \fBINNER\fR, but other values may be
+introduced in the future. \fBCALL\fR indicates a procedure call, and its
+parameter is the corresponding [info level 0]. \fBUP\fR indicates a shift in
+variable frames generated by uplevel or similar, and applies to the previous
+CALL item. Its parameter is the level offset. \fBINNER\fR identifies the
+"inner context", which is the innermost atomic command or bytecode instruction
+that raised the error, along with its arguments when available. While
+\fBCALL\fR and \fBUP\fR allow to follow complex call paths, \fBINNER\fR homes
+in on the offending operation in the innermost proc call, even going to
+sub-expr granularity.
This information is also present in the
\fB\-errorstack\fR entry of the options dictionary returned by 3-argument