summaryrefslogtreecommitdiffstats
path: root/doc/Thread.3
diff options
context:
space:
mode:
authorvasiljevic <vasiljevic@noemail.net>2004-11-25 15:48:51 (GMT)
committervasiljevic <vasiljevic@noemail.net>2004-11-25 15:48:51 (GMT)
commit049ab9156e46f0e4add84e2e42c1bb368147e304 (patch)
tree584fbfa6f58f7abcbef24cf5293f23ce2d253394 /doc/Thread.3
parentcac72e67f06a47c1a13a33fe44df5949b2797c39 (diff)
downloadtcl-049ab9156e46f0e4add84e2e42c1bb368147e304.zip
tcl-049ab9156e46f0e4add84e2e42c1bb368147e304.tar.gz
tcl-049ab9156e46f0e4add84e2e42c1bb368147e304.tar.bz2
Added hint to TCL_DECLARE_MUTEX macro usage.
FossilOrigin-Name: cf849ef569bbef770d6cf4e62caa48a6b61ee434
Diffstat (limited to 'doc/Thread.3')
-rw-r--r--doc/Thread.310
1 files changed, 7 insertions, 3 deletions
diff --git a/doc/Thread.3 b/doc/Thread.3
index f319d7b..ba33882 100644
--- a/doc/Thread.3
+++ b/doc/Thread.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: Thread.3,v 1.14.2.1 2004/11/25 15:31:18 vasiljevic Exp $
+'\" RCS: @(#) $Id: Thread.3,v 1.14.2.2 2004/11/25 15:48:52 vasiljevic Exp $
'\"
.so man.macros
.TH Threads 3 "8.1" Tcl "Tcl Library Procedures"
@@ -140,8 +140,9 @@ creating multithreaded scripts (for example, scripts that could spawn
a Tcl interpreter in a separate thread). If you need to add this
feature at this time, see the \fItclThreadTest.c\fR
file in the Tcl source distribution for an experimental implementation
-of a Tcl "Thread" package implementing thread creation and management
-commands at the script level.
+or use the Tcl "Threading Extension" package implementing thread creation
+and management commands at the script level.
+
.SH DESCRIPTION
A mutex is a lock that is used to serialize all threads through a piece
@@ -155,6 +156,9 @@ On some platforms it will result in a deadlock.
.VE
The \fBTcl_MutexLock\fR, \fBTcl_MutexUnlock\fR and \fBTcl_MutexFinalize\fR
procedures are defined as empty macros if not compiling with threads enabled.
+For declaration of mutexes the \fBTCL_DECLARE_MUTEX\fR macro should be used.
+This macro assures correct mutex handling even when the core is compiled
+without threads enabled.
.PP
A condition variable is used as a signaling mechanism:
a thread can lock a mutex and then wait on a condition variable