diff -r 7efba48299e9 Doc/library/multiprocessing.rst --- a/Doc/library/multiprocessing.rst Tue Sep 27 20:33:58 2016 -0400 +++ b/Doc/library/multiprocessing.rst Wed Sep 28 12:47:59 2016 +1000 @@ -2112,8 +2112,12 @@ .. method:: map(func, iterable[, chunksize]) - A parallel equivalent of the :func:`map` built-in function (it supports only - one *iterable* argument though). It blocks until the result is ready. + A parallel equivalent of the built-in function. It blocks until the + result is ready. + + Unlike the built in :func:`map`, this method supports only one *iterable* + argument. For functions that require multiple arguments, see + :meth:`starmap`. 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