From: Jesse Noller <jnoller@gmail.com>
Date: Thu, 22 Jan 2009 21:53:22 +0000 (+0000)
Subject: Issue 4593: apply() documentation is unclear
X-Git-Tag: v2.7a1~2221
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=403c6632e6c3bc45309b2b234dc6e2267742b0d5;p=thirdparty%2FPython%2Fcpython.git

Issue 4593: apply() documentation is unclear
---

diff --git a/Doc/library/multiprocessing.rst b/Doc/library/multiprocessing.rst
index fe54f9b2a78f..ee92a7cccc45 100644
--- 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]]])