Add note to Queue.get() docs about block=True (GH-2223) (GH-12538)

(cherry picked from commit 713a8ae7926472b02ee1a394633eb54aaa7912d1)

Co-authored-by: Stephen Rosen <sirosen@globus.org>

diff --git a/Doc/library/queue.rst b/Doc/library/queue.rst
index 7335a64bef84667f26b5456ec2ff349486fb9ca3..0a42da1d74a44ae4cf528fb721406d1c269edf19 100644 (file)
--- a/Doc/library/queue.rst
+++ b/Doc/library/queue.rst
@@ -152,6 +152,11 @@ provide the public methods described below.
    Otherwise (*block* is false), return an item if one is immediately available,
    else raise the :exc:`Empty` exception (*timeout* is ignored in that case).
 
+   Prior to 3.0 on POSIX systems, and for all versions on Windows, if
+   *block* is true and *timeout* is ``None``, this operation goes into
+   an uninterruptible wait on an underlying lock. This means that no exceptions
+   can occur, and in particular a SIGINT will not trigger a :exc:`KeyboardInterrupt`.
+
 
 .. method:: Queue.get_nowait()