summaryrefslogtreecommitdiffstats
path: root/doc/Async.3
diff options
context:
space:
mode:
authordavidg <davidg>2000-07-26 01:29:00 (GMT)
committerdavidg <davidg>2000-07-26 01:29:00 (GMT)
commit5a5c6d53b6765c4258fb89b137cd4a88af62bc65 (patch)
tree99464d73dab437ba51d409432424bee4a4b25391 /doc/Async.3
parent1e09e0a51157bce655a6cb8ef0490121f4cf8fe2 (diff)
downloadtcl-5a5c6d53b6765c4258fb89b137cd4a88af62bc65.zip
tcl-5a5c6d53b6765c4258fb89b137cd4a88af62bc65.tar.gz
tcl-5a5c6d53b6765c4258fb89b137cd4a88af62bc65.tar.bz2
Thread-safe rewrite for the Tcl_Async* commands.
Diffstat (limited to 'doc/Async.3')
-rw-r--r--doc/Async.39
1 files changed, 8 insertions, 1 deletions
diff --git a/doc/Async.3 b/doc/Async.3
index 81c5cd1..60fdad4 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.4 2000/04/14 23:01:48 hobbs Exp $
+'\" RCS: @(#) $Id: Async.3,v 1.5 2000/07/26 01:29:00 davidg Exp $
'\"
.so man.macros
.TH Tcl_AsyncCreate 3 7.0 Tcl "Tcl Library Procedures"
@@ -60,6 +60,13 @@ The only safe approach is to set a flag indicating that the event
occurred, then handle the event later when the world has returned
to a clean state, such as after the current Tcl command completes.
.PP
+\fBTcl_AsyncCreate\fR, \fBTcl_AsyncDelete\fR, and \fBTcl_AsyncReady\fR
+are thread sensitive. They access and/or set a thread-specific data
+structure in the event of an --enable-thread built core. The token
+created by Tcl_AsyncCreate contains the needed thread information it
+was called from so that calling Tcl_AsyncMark(token) will only yield
+the origin thread into the AsyncProc.
+.PP
\fBTcl_AsyncCreate\fR creates an asynchronous handler and returns
a token for it.
The asynchronous handler must be created before