From: Miss Islington (bot) <31488909+miss-islington@users.noreply.github.com> Date: Sat, 19 Jul 2025 12:58:08 +0000 (+0200) Subject: [3.13] gh-135730: Clarify multiprocessing.Queue close() documentation (GH-136803... X-Git-Tag: v3.13.6~69 X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=ff8de16c1017d9b767de8fb884ea1fb19d9ba40c;p=thirdparty%2FPython%2Fcpython.git [3.13] gh-135730: Clarify multiprocessing.Queue close() documentation (GH-136803) (GH-136807) gh-135730: Clarify multiprocessing.Queue close() documentation (GH-136803) Add a copy of the text from SimpleQueue.close() --------- (cherry picked from commit f575588ccf27d8d54a1e99cfda944f2614b3255c) Co-authored-by: aggshruti99 Co-authored-by: Petr Viktorin --- diff --git a/Doc/library/multiprocessing.rst b/Doc/library/multiprocessing.rst index 529cd5ce03c8..92d6bf9a07a3 100644 --- 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.