Issue #7707: Documented that multiprocessing.Queue operations during
import can lead to deadlocks.
diff --git a/Doc/library/multiprocessing.rst b/Doc/library/multiprocessing.rst
index 4f3f1cd..d611278 100644
--- a/Doc/library/multiprocessing.rst
+++ b/Doc/library/multiprocessing.rst
@@ -120,7 +120,9 @@
print(q.get()) # prints "[42, None, 'hello']"
p.join()
- Queues are thread and process safe.
+ Queues are thread and process safe, but note that they must never
+ be instantiated as a side effect of importing a module: this can lead
+ to a deadlock! (see :ref:`threaded-imports`)
**Pipes**
diff --git a/Misc/NEWS b/Misc/NEWS
index 3e0de21..365b9cb 100644
--- a/Misc/NEWS
+++ b/Misc/NEWS
@@ -2879,6 +2879,9 @@
Documentation
-------------
+- Issue #7707: Document that ``multiprocessing.Queue`` operations during import
+ can lead to deadlocks.
+
- Issue #9817: Add expat COPYING file; add expat, libffi and expat licenses
to Doc/license.rst.