Add doc for buffersize argument of imap and imap_unordered

Author: obaltian

Doc/library/multiprocessing.rst

@@ -2408,7 +2408,7 @@ with the :class:`Pool` class.
       Callbacks should complete immediately since otherwise the thread which
       handles the results will get blocked.
 
-   .. method:: imap(func, iterable[, chunksize])
+   .. method:: imap(func, iterable[, chunksize, buffersize])
 
       A lazier version of :meth:`.map`.
 
@@ -2422,6 +2422,18 @@ with the :class:`Pool` class.
       ``next(timeout)`` will raise :exc:`multiprocessing.TimeoutError` if the
       result cannot be returned within *timeout* seconds.
 
+      The *iterable* is collected immediately rather than lazily, unless a
+      *buffersize* is specified to limit the number of submitted tasks whose
+      results have not yet been yielded. If the buffer is full, iteration over
+      the *iterables* pauses until a result is yielded from the buffer.
+
+      To fully utilize pool's capacity, set *buffersize* to the number of
+      processes in pool (to consume *iterable* as you go) or even higher
+      (to prefetch *buffersize - processes* arguments).
+
+      .. versionadded:: 3.15
+         Added the *buffersize* parameter.
+
    .. method:: imap_unordered(func, iterable[, chunksize])
 
       The same as :meth:`imap` except that the ordering of the results from the

Misc/NEWS.d/next/Library/2025-07-20-14-41-16.gh-issue-64192._0Rbp_.rst

@@ -0,0 +1,9 @@
+Add the optional ``buffersize`` parameter to
+:meth:`multiprocessing.pool.Pool.imap` and
+:meth:`multiprocessing.pool.Pool.imap_unordered` to limit the number of
+submitted tasks whose results have not yet been yielded. If the buffer is full,
+iteration over the *iterables* pauses until a result is yielded from the buffer.
+
+To fully utilize pool's capacity, set *buffersize* to the number of
+processes in pool (to consume *iterable* as you go) or even higher
+(to prefetch *buffersize - processes* arguments).

Misc/NEWS.d/next/Library/2025-07-28-00-18-06.gh-issue-64192.t9b0XO.rst

@@ -0,0 +1,6 @@
+Add the optional ``buffersize`` parameter to
+:meth:`multiprocessing.pool.Pool.imap` and
+:meth:`multiprocessing.pool.Pool.imap_unordered` to limit the number of
+submitted tasks whose results have not yet been yielded. If the buffer is
+full, iteration over the *iterables* pauses until a result is yielded from
+the buffer.