summaryrefslogtreecommitdiffstats
path: root/Doc/lib
diff options
context:
space:
mode:
authorGuido van Rossum <guido@python.org>2002-12-30 22:30:22 (GMT)
committerGuido van Rossum <guido@python.org>2002-12-30 22:30:22 (GMT)
commitad50ca91a99e9a16a583fb13799c79f23067ef30 (patch)
tree31e4e18a5980f1c50029b117b3c6231cb0e59458 /Doc/lib
parentc91ed400e053dc9f11dd30c84e2bb611999dce50 (diff)
downloadcpython-ad50ca91a99e9a16a583fb13799c79f23067ef30.zip
cpython-ad50ca91a99e9a16a583fb13799c79f23067ef30.tar.gz
cpython-ad50ca91a99e9a16a583fb13799c79f23067ef30.tar.bz2
Brett Cannon's dummy_thread and dummy_threading modules (SF patch
622537), with some nitpicking editorial changes.
Diffstat (limited to 'Doc/lib')
-rw-r--r--Doc/lib/libdummythread.tex22
-rw-r--r--Doc/lib/libdummythreading.tex22
2 files changed, 44 insertions, 0 deletions
diff --git a/Doc/lib/libdummythread.tex b/Doc/lib/libdummythread.tex
new file mode 100644
index 0000000..56e3a03
--- /dev/null
+++ b/Doc/lib/libdummythread.tex
@@ -0,0 +1,22 @@
+\section{\module{dummy_thread} ---
+ Drop-in replacement for the \module{thread} module}
+
+\declaremodule[dummythread]{standard}{dummy_thread}
+\modulesynopsis{Drop-in replacement for the thread module.}
+
+This module provides a duplicate interface to the \refmodule{thread} module. It
+is meant to be imported when the \module{thread} module is not provided on a
+platform.
+
+Suggested usage is:
+
+\begin{verbatim}
+try:
+ import thread as _thread
+except ImportError:
+ import dummy_thread as _thread
+\end{verbatim}
+
+Be careful to not use this module where deadlock might occur from a thread
+being created that blocks waiting for another thread to be created. This
+often occurs with blocking I/O.
diff --git a/Doc/lib/libdummythreading.tex b/Doc/lib/libdummythreading.tex
new file mode 100644
index 0000000..7eb7076
--- /dev/null
+++ b/Doc/lib/libdummythreading.tex
@@ -0,0 +1,22 @@
+\section{\module{dummy_thread} ---
+ Drop-in replacement for the \module{threading} module}
+
+\declaremodule[dummythreading]{standard}{dummy_threading}
+\modulesynopsis{Drop-in replacement for the threading module.}
+
+This module provides a duplicate interface to the \refmodule{threading} module. It
+is meant to be imported when the \module{threading} module is not provided on a
+platform.
+
+Suggested usage is:
+
+\begin{verbatim}
+try:
+ import threading as _threading
+except ImportError:
+ import dummy_threading as _threading
+\end{verbatim}
+
+Be careful to not use this module where deadlock might occur from a thread
+being created that blocks waiting for another thread to be created. This
+often occurs with blocking I/O.