[Patch 2995655] Report inner contexts in [info errorstack]

1 files changed, 12 insertions, 8 deletions

diff --git a/doc/info.n b/doc/info.n
index 3bfb713..4c39821 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.39 2010/10/17 20:16:55 ferrieux Exp $
+'\" RCS: @(#) $Id: info.n,v 1.40 2010/10/20 20:52:26 ferrieux 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