summaryrefslogtreecommitdiff
path: root/Doc/library/dummy_thread.rst
diff options
context:
space:
mode:
Diffstat (limited to 'Doc/library/dummy_thread.rst')
-rw-r--r--Doc/library/dummy_thread.rst23
1 files changed, 23 insertions, 0 deletions
diff --git a/Doc/library/dummy_thread.rst b/Doc/library/dummy_thread.rst
new file mode 100644
index 0000000000..0b2cb179a6
--- /dev/null
+++ b/Doc/library/dummy_thread.rst
@@ -0,0 +1,23 @@
+
+:mod:`dummy_thread` --- Drop-in replacement for the :mod:`thread` module
+========================================================================
+
+.. module:: dummy_thread
+ :synopsis: Drop-in replacement for the thread module.
+
+
+This module provides a duplicate interface to the :mod:`thread` module. It is
+meant to be imported when the :mod:`thread` module is not provided on a
+platform.
+
+Suggested usage is::
+
+ try:
+ import thread as _thread
+ except ImportError:
+ import dummy_thread as _thread
+
+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.
+