From be864592ebc3e07555178a29b996f78b02444da6 Mon Sep 17 00:00:00 2001 From: Daniil Mayorov Date: Tue, 19 May 2026 10:50:32 +0300 Subject: [PATCH] gh-68663: clarify task definition in Pool.map docs --- Doc/library/multiprocessing.rst | 7 +++++-- 1 file changed, 5 insertions(+), 2 deletions(-) diff --git a/Doc/library/multiprocessing.rst b/Doc/library/multiprocessing.rst index 7b17df08f7dc71..2f2d1cf1d209a3 100644 --- a/Doc/library/multiprocessing.rst +++ b/Doc/library/multiprocessing.rst @@ -2508,8 +2508,11 @@ with the :class:`Pool` class. one *iterable* argument though, for multiple iterables see :meth:`starmap`). It blocks until the result is ready. - This method chops the iterable into a number of chunks which it submits to - the process pool as separate tasks. The (approximate) size of these + This method chops the iterable into a number of chunks and submits each + chunk to the process pool as a separate task. A task may therefore + process multiple items from the iterable. + + The (approximate) size of these chunks can be specified by setting *chunksize* to a positive integer. Note that it may cause high memory usage for very long iterables. Consider