summaryrefslogtreecommitdiffstats
path: root/Doc/libthread.tex
diff options
context:
space:
mode:
authorGuido van Rossum <guido@python.org>1997-08-14 19:51:26 (GMT)
committerGuido van Rossum <guido@python.org>1997-08-14 19:51:26 (GMT)
commit3572d3718bb694e476bc96e5ce82bbb72c6debad (patch)
tree886feb80c409910fba5f2084a440cd18e814ea80 /Doc/libthread.tex
parent8f06247b51924245ff1777bbf46aee9f38237c8e (diff)
downloadcpython-3572d3718bb694e476bc96e5ce82bbb72c6debad.zip
cpython-3572d3718bb694e476bc96e5ce82bbb72c6debad.tar.gz
cpython-3572d3718bb694e476bc96e5ce82bbb72c6debad.tar.bz2
Updated platform specific notes (it is now more common to have this)
added some caveats.
Diffstat (limited to 'Doc/libthread.tex')
-rw-r--r--Doc/libthread.tex24
1 files changed, 20 insertions, 4 deletions
diff --git a/Doc/libthread.tex b/Doc/libthread.tex
index 080a35c..4f5497a 100644
--- a/Doc/libthread.tex
+++ b/Doc/libthread.tex
@@ -8,9 +8,9 @@ threads of control sharing their global data space. For
synchronization, simple locks (a.k.a.\ \dfn{mutexes} or \dfn{binary
semaphores}) are provided.
-The module is optional and supported on SGI IRIX 4.x and 5.x and Sun
-Solaris 2.x systems, as well as on systems that have a PTHREAD
-implementation (e.g.\ KSR).
+The module is optional. It is supported on Windows NT and '95, SGI
+IRIX, Solaris 2.x, as well as on systems that have a POSIX thread
+(a.k.a. ``pthread'') implementation.
It defines the following constant and functions:
@@ -91,7 +91,7 @@ thread. (When the \code{signal} module is available, interrupts
always go to the main thread.)
\item
-Calling \code{sys.exit()} or raising the \code{SystemExit} is
+Calling \code{sys.exit()} or raising the \code{SystemExit} exception is
equivalent to calling \code{thread.exit_thread()}.
\item
@@ -99,4 +99,20 @@ Not all built-in functions that may block waiting for I/O allow other
threads to run. (The most popular ones (\code{sleep}, \code{read},
\code{select}) work as expected.)
+\item
+It is not possible to interrupt the \code{acquire()} method on a lock
+-- the \code{KeyboardInterrupt} exception will happen after the lock
+has been acquired.
+
+\item
+When the main thread exits, it is system defined whether the other
+threads survive. On SGI IRIX using the native thread implementation,
+they survive. On most other systems, they are killed without
+executing ``try-finally'' clauses or executing object destructors.
+
+\item
+When the main thread exits, it doesn't do any of its usual cleanup
+(except that ``try-finally'' clauses are honored), and the standard
+I/O files are not flushed.
+
\end{itemize}