merge r68862 to py3k

diff --git a/Doc/library/multiprocessing.rst b/Doc/library/multiprocessing.rst
index 50714ef8826d285f28e4365e6cd59c3f887cfea4..61788515710841c05f7b31346c65ed1add43378c 100644 (file)
--- a/Doc/library/multiprocessing.rst
+++ b/Doc/library/multiprocessing.rst
@@ -1522,7 +1522,9 @@ with the :class:`Pool` class.
    .. method:: apply(func[, args[, kwds]])
 
       Call *func* with arguments *args* and keyword arguments *kwds*.  It blocks
-      till the result is ready.
+      till the result is ready. Given this blocks - :meth:`apply_async` is better suited
+      for performing work in parallel. Additionally, the passed
+      in function is only executed in one of the workers of the pool.
 
    .. method:: apply_async(func[, args[, kwds[, callback]]])