edit docstring

Author: ebonnal

Lib/concurrent/futures/_base.py

@@ -587,8 +587,9 @@ def map(self, fn, *iterables, timeout=None, chunksize=1, buffersize=None):
                 used by ProcessPoolExecutor; it is ignored by
                 ThreadPoolExecutor.
             buffersize: The number of results that can be buffered before being
-                yielded. If the buffer is full, the iteration over iterables
-                is paused until a result is yielded from the buffer.
+                yielded. When the buffer is full, iteration over the input
+                iterables is paused until a result is yielded from the buffer.
+                If None, buffering is unlimited.
 
         Returns:
             An iterator equivalent to: map(func, *iterables) but the calls may

Lib/concurrent/futures/process.py

@@ -817,8 +817,9 @@ def map(self, fn, *iterables, timeout=None, chunksize=1, buffersize=None):
                 chunks of size chunksize and submitted to the process pool.
                 If set to one, the items in the list will be sent one at a time.
             buffersize: The number of result chunks that can be buffered before
-                being yielded. If the buffer is full, the iteration over iterables
-                is paused until a result chunk is yielded from the buffer.
+                being yielded. When the buffer is full, iteration over the input
+                iterables is paused until a result chunk is yielded from the
+                buffer. If None, buffering is unlimited.
 
         Returns:
             An iterator equivalent to: map(func, *iterables) but the calls may