[3.13] gh-135730: Clarify multiprocessing.Queue close() documentation (GH-136803) (GH-136807)

miss-islington · aggshruti99 · encukou · web-flow · commit ff8de16c1017 · 2025-07-19T14:58:08.000+02:00
gh-135730: Clarify multiprocessing.Queue close() documentation (GH-136803) Add a copy of the text from SimpleQueue.close() --------- (cherry picked from commit f575588) Co-authored-by: aggshruti99 <aggshruti99@gmail.com> Co-authored-by: Petr Viktorin <encukou@gmail.com>
diff --git a/Doc/library/multiprocessing.rst b/Doc/library/multiprocessing.rst
@@ -897,8 +897,13 @@ For an example of the usage of queues for interprocess communication see
 
    .. method:: close()
 
-      Indicate that no more data will be put on this queue by the current
-      process.  The background thread will quit once it has flushed all buffered
+      Close the queue: release internal resources.
+
+      A queue must not be used anymore after it is closed. For example,
+      :meth:`~Queue.get`, :meth:`~Queue.put` and :meth:`~Queue.empty`
+      methods must no longer be called.
+
+      The background thread will quit once it has flushed all buffered
       data to the pipe.  This is called automatically when the queue is garbage
       collected.
 
