diff options
| author | dgp <dgp@users.sourceforge.net> | 2004-11-20 00:17:28 (GMT) |
|---|---|---|
| committer | dgp <dgp@users.sourceforge.net> | 2004-11-20 00:17:28 (GMT) |
| commit | ff53303dbf5fc75eea7bb3d9bc569267adb1d49b (patch) | |
| tree | 37544eb5529a0eb1f2f1a0f46ad94a43354cc96b /doc/Async.3 | |
| parent | 2c96347f634403dffaf0ecf177118cd8202af841 (diff) | |
| download | tcl-ff53303dbf5fc75eea7bb3d9bc569267adb1d49b.zip tcl-ff53303dbf5fc75eea7bb3d9bc569267adb1d49b.tar.gz tcl-ff53303dbf5fc75eea7bb3d9bc569267adb1d49b.tar.bz2 | |
* doc/AddErrInfo.3: Docs for Tcl_(Get|Set)ReturnOptions. [TIP 227]
* doc/AddErrInfo.3:
* doc/Async.3: Documentation updates to replace references
* doc/BackgdErr.3: to global variable ::errorInfo and ::errorCode
* doc/SaveResult.3: and to the ::bgerror command with references
* doc/after.n: to their preferred replacements, the
* doc/bgerror.n: -errorinfo and -errorcode return options,
* doc/error.n: the Tcl_*InterpState routines, and the
* doc/exec.n: [interp bgerror] command.
* doc/exit.n:
* doc/fileevent.n:
* doc/interp.n:
* doc/return.n:
* doc/tclvars.n:
* doc/update.n:
Diffstat (limited to 'doc/Async.3')
| -rw-r--r-- | doc/Async.3 | 13 |
1 files changed, 6 insertions, 7 deletions
diff --git a/doc/Async.3 b/doc/Async.3 index 3c40c44..cae4318 100644 --- a/doc/Async.3 +++ b/doc/Async.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: Async.3,v 1.6 2004/10/07 14:44:31 dkf Exp $ +'\" RCS: @(#) $Id: Async.3,v 1.7 2004/11/20 00:17:31 dgp Exp $ '\" .so man.macros .TH Tcl_AsyncCreate 3 7.0 Tcl "Tcl Library Procedures" @@ -152,12 +152,11 @@ This sort of behavior can disrupt the execution of scripts in subtle ways and result in bugs that are extremely difficult to track down. If an asynchronous event handler needs to evaluate Tcl scripts -then it should first save the interpreter's result plus the values -of the variables \fBerrorInfo\fR and \fBerrorCode\fR (this can -be done, for example, by storing them in dynamic strings). +then it should first save the interpreter's state by calling +\fBTcl_SaveInterpState\fR, passing in the \fIcode\fR argument. When the asynchronous handler is finished it should restore -the interpreter's result, \fBerrorInfo\fR, and \fBerrorCode\fR, -and return the \fIcode\fR argument. +the interpreter's state by calling \fBTcl_RestoreInterpState\fR, +and then returning the \fIcode\fR argument. .SH KEYWORDS -asynchronous event, handler, signal +asynchronous event, handler, signal, Tcl_SaveInterpState |