Issue 4593: apply() documentation is unclear

diff --git a/Doc/library/multiprocessing.rst b/Doc/library/multiprocessing.rst
index fe54f9b2a78ff1600ec117aacdfc516b3aa5a529..ee92a7cccc45be4ba70b63ccbaece2aeae5b3033 100644 (file)
--- a/Doc/library/multiprocessing.rst
+++ b/Doc/library/multiprocessing.rst
@@ -1524,7 +1524,9 @@ with the :class:`Pool` class.
    .. method:: apply(func[, args[, kwds]])
 
       Equivalent of the :func:`apply` builtin function.  It blocks till the
-      result is ready.
+      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]]])