bpo-34134: Advise to use imap or imap_unordered when handling long it…

bpo-34134: Advise to use imap or imap_unordered when handling long it… · python/cpython@3bab40d

Original file line number	Diff line number	Diff line change
@@ -2157,6 +2157,10 @@ with the :class:`Pool` class.
`2157`	`2157`	`the process pool as separate tasks. The (approximate) size of these`
`2158`	`2158`	`chunks can be specified by setting chunksize to a positive integer.`
`2159`	`2159`
	`2160`	`+ Note that it may cause high memory usage for very long iterables. Consider`
	`2161`	+ using :meth:`imap` or :meth:`imap_unordered` with explicit chunksize
	`2162`	`+ option for better efficiency.`
	`2163`	`+`
`2160`	`2164`	`.. method:: map_async(func, iterable[, chunksize[, callback[, error_callback]]])`
`2161`	`2165`
`2162`	`2166`	A variant of the :meth:`.map` method which returns a result object.
@@ -2175,7 +2179,7 @@ with the :class:`Pool` class.
`2175`	`2179`
`2176`	`2180`	`.. method:: imap(func, iterable[, chunksize])`
`2177`	`2181`
`2178`		- A lazier version of :meth:`map`.
	`2182`	+ A lazier version of :meth:`.map`.
`2179`	`2183`
`2180`	`2184`	The chunksize argument is the same as the one used by the :meth:`.map`
`2181`	`2185`	`method. For very long iterables using a large value for chunksize can`