gh-135730: Clarify multiprocessing.Queue close() documentation (#136803)

aggshruti99 · saggarwal145 · encukou · web-flow · commit f575588ccf27 · 2025-07-19T14:24:39.000+02:00
Add a copy of the text from SimpleQueue.close()

---------

Co-authored-by: saggarwal145 &lt;saggarwal145@bloomberg.net&gt;
Co-authored-by: Petr Viktorin &lt;encukou@gmail.com&gt;
diff --git a/Doc/library/multiprocessing.rst b/Doc/library/multiprocessing.rst
@@ -936,8 +936,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.
 
