[Python-checkins] cpython (3.5): Issue 14976: Note that the queue module is not designed to protect against

[raymond.hettinger]

https://hg.python.org/cpython/rev/8c00cbbd3ff9
changeset:   103495:8c00cbbd3ff9
branch:      3.5
parent:      103468:ab3d9bdb69d1
user:        Raymond Hettinger <python at rcn.com>
date:        Fri Sep 09 15:57:13 2016 -0700
summary:
  Issue 14976:  Note that the queue module is not designed to protect against reentrancy

files:
  Doc/library/queue.rst |  7 ++-----
  1 files changed, 2 insertions(+), 5 deletions(-)


diff --git a/Doc/library/queue.rst b/Doc/library/queue.rst
--- a/Doc/library/queue.rst
+++ b/Doc/library/queue.rst
@@ -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`

-- 
Repository URL: https://hg.python.org/cpython