From: aggshruti99 Date: Sat, 19 Jul 2025 12:24:39 +0000 (+0100) Subject: gh-135730: Clarify multiprocessing.Queue close() documentation (#136803) X-Git-Tag: v3.15.0a1~938 X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=f575588ccf27d8d54a1e99cfda944f2614b3255c;p=thirdparty%2FPython%2Fcpython.git gh-135730: Clarify multiprocessing.Queue close() documentation (#136803) Add a copy of the text from SimpleQueue.close() --------- Co-authored-by: saggarwal145 Co-authored-by: Petr Viktorin --- diff --git a/Doc/library/multiprocessing.rst b/Doc/library/multiprocessing.rst index 546876bd925d..c80f78e61481 100644 --- 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.