changeset:   103495:8c00cbbd3ff9
branch:      3.5
parent:      103468:ab3d9bdb69d1
user:        Raymond Hettinger <python@rcn.com>
date:        Fri Sep 09 15:57:13 2016 -0700
files:       Doc/library/queue.rst
description:
Issue 14976:  Note that the queue module is not designed to protect against reentrancy


diff -r ab3d9bdb69d1 -r 8c00cbbd3ff9 Doc/library/queue.rst
--- a/Doc/library/queue.rst	Fri Sep 09 14:26:31 2016 -0700
+++ b/Doc/library/queue.rst	Fri Sep 09 15:57:13 2016 -0700
@@ -22,6 +22,8 @@
 the entries are kept sorted (using the :mod:`heapq` module) and the
 lowest valued entry is retrieved first.
 
+Internally, the module uses locks to temporarily block competing threads;
+however, it is not designed to handle reentrancy within a thread.
 
 The :mod:`queue` module defines the following classes and exceptions:
 
@@ -186,11 +188,6 @@
         t.join()
 
 
-.. note::
-
-   The :mod:`queue` module is not safe for use from :mod:`signal` handlers as
-   it uses :mod:`threading` locks.
-
 .. seealso::
 
    Class :class:`multiprocessing.Queue`