Brett Cannon's dummy_thread and dummy_threading modules (SF patch

622537), with some nitpicking editorial changes.

1 files changed, 22 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.