summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authordkf <donal.k.fellows@manchester.ac.uk>2009-07-11 11:26:20 (GMT)
committerdkf <donal.k.fellows@manchester.ac.uk>2009-07-11 11:26:20 (GMT)
commit616fced29acb8d7baf98bcd84637e59b465d8f09 (patch)
tree21cc8efd5975f673944c69281f4de0259ed7aaaf
parentdd1d583ae03e2348fe8bc8a8b1918ea5e49be545 (diff)
downloadtcl-616fced29acb8d7baf98bcd84637e59b465d8f09.zip
tcl-616fced29acb8d7baf98bcd84637e59b465d8f09.tar.gz
tcl-616fced29acb8d7baf98bcd84637e59b465d8f09.tar.bz2
Extended the warning about vwait gotchas
-rw-r--r--doc/vwait.n7
1 files changed, 5 insertions, 2 deletions
diff --git a/doc/vwait.n b/doc/vwait.n
index 9a63813..43a2618 100644
--- a/doc/vwait.n
+++ b/doc/vwait.n
@@ -4,7 +4,7 @@
'\" See the file "license.terms" for information on usage and redistribution
'\" of this file, and for a DISCLAIMER OF ALL WARRANTIES.
'\"
-'\" RCS: @(#) $Id: vwait.n,v 1.10 2009/05/12 22:48:42 dkf Exp $
+'\" RCS: @(#) $Id: vwait.n,v 1.11 2009/07/11 11:26:20 dkf Exp $
'\"
.so man.macros
.TH vwait n 8.0 Tcl "Tcl Built-In Commands"
@@ -41,7 +41,10 @@ inner ones do. It is recommended that code should never nest \fBvwait\fR
calls (by avoiding putting them in event callbacks) but when that is not
possible, care should be taken to add interlock variables to the code to
prevent all reentrant calls to \fBvwait\fR that are not \fIstrictly\fR
-necessary.
+necessary. Be aware that the synchronous modes of operation of some Tcl
+packages (e.g.,\ \fBhttp\fR) use \fBvwait\fR internally; if using the event
+loop, it is best to use the asynchronous callback-based modes of operation of
+those packages where available.
.SH EXAMPLES
.PP
Run the event-loop continually until some event calls \fBexit\fR.