From f575588ccf27d8d54a1e99cfda944f2614b3255c Mon Sep 17 00:00:00 2001 From: aggshruti99 Date: Sat, 19 Jul 2025 13:24:39 +0100 Subject: [PATCH] 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 --- Doc/library/multiprocessing.rst | 9 +++++++-- 1 file changed, 7 insertions(+), 2 deletions(-) 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. -- 2.47.3