diff options
author | dgp <dgp@users.sourceforge.net> | 2002-03-29 21:01:11 (GMT) |
---|---|---|
committer | dgp <dgp@users.sourceforge.net> | 2002-03-29 21:01:11 (GMT) |
commit | cb3ffc68aefa6b11adf7c31ae97da681a91b8c04 (patch) | |
tree | 45d34400a0d6c9126eb259f658c44f63e2fc1b02 /doc/AllowExc.3 | |
parent | ecdc61ad73b61ea283f30fa6cd4e25f39521f59e (diff) | |
download | tcl-cb3ffc68aefa6b11adf7c31ae97da681a91b8c04.zip tcl-cb3ffc68aefa6b11adf7c31ae97da681a91b8c04.tar.gz tcl-cb3ffc68aefa6b11adf7c31ae97da681a91b8c04.tar.bz2 |
* Corrected problems with Tcl_AllowExceptions
having influence over the wrong scope of Tcl_*Eval* calls. Patch
from Miguel Sofer. Report from Jean-Claude Wippler. [Bug 219181]
Diffstat (limited to 'doc/AllowExc.3')
-rw-r--r-- | doc/AllowExc.3 | 12 |
1 files changed, 8 insertions, 4 deletions
diff --git a/doc/AllowExc.3 b/doc/AllowExc.3 index 1145fa4..17d6ec0 100644 --- a/doc/AllowExc.3 +++ b/doc/AllowExc.3 @@ -5,7 +5,7 @@ '\" See the file "license.terms" for information on usage and redistribution '\" of this file, and for a DISCLAIMER OF ALL WARRANTIES. '\" -'\" RCS: @(#) $Id: AllowExc.3,v 1.2 1998/09/14 18:39:45 stanton Exp $ +'\" RCS: @(#) $Id: AllowExc.3,v 1.3 2002/03/29 21:01:11 dgp Exp $ '\" .so man.macros .TH Tcl_AllowExceptions 3 7.4 Tcl "Tcl Library Procedures" @@ -27,12 +27,16 @@ Interpreter in which script will be evaluated. .PP If a script is evaluated at top-level (i.e. no other scripts are pending evaluation when the script is invoked), and if the script -terminates with a completion code other than TCL_OK, TCL_CONTINUE +terminates with a completion code other than TCL_OK, TCL_ERROR or TCL_RETURN, then Tcl normally converts this into a TCL_ERROR -return with an appropriate message. +return with an appropriate message. The particular script +evaluation procedures of Tcl that act in the manner are +\fBTcl_EvalObjEx\fR, \fBTcl_EvalObjv\fR, \fBTcl_Eval\fR, \fBTcl_EvalEx\fR, +\fBTcl_GlobalEval\fR, \fBTcl_GlobalEvalObj\fR, \fBTcl_VarEval\fR and +\fBTcl_VarEvalVA\fR. .PP However, if \fBTcl_AllowExceptions\fR is invoked immediately before -calling a procedure such as \fBTcl_Eval\fR, then arbitrary completion +calling one of those a procedures, then arbitrary completion codes are permitted from the script, and they are returned without modification. This is useful in cases where the caller can deal with exceptions |