[Python-checkins] cpython: Add links to discussion of multiprocessing spawn/forkserver feature.

[r.david.murray]

http://hg.python.org/cpython/rev/e36d03a1fadb
changeset:   88102:e36d03a1fadb
user:        R David Murray <rdmurray at bitdance.com>
date:        Fri Dec 20 17:23:57 2013 -0500
summary:
  Add links to discussion of multiprocessing spawn/forkserver feature.

files:
  Doc/library/multiprocessing.rst |   4 +++-
  Doc/whatsnew/3.4.rst            |  19 +++++++++++--------
  2 files changed, 14 insertions(+), 9 deletions(-)


diff --git a/Doc/library/multiprocessing.rst b/Doc/library/multiprocessing.rst
--- a/Doc/library/multiprocessing.rst
+++ b/Doc/library/multiprocessing.rst
@@ -101,6 +101,8 @@
 Contexts and start methods
 ~~~~~~~~~~~~~~~~~~~~~~~~~~
 
+.. _multiprocessing-start-methods:
+
 Depending on the platform, :mod:`multiprocessing` supports three ways
 to start a process.  These *start methods* are
 
@@ -147,7 +149,7 @@
 is a serious matter since the system allows only a limited number, and
 they will not be automatically unlinked until the next reboot.)
 
-To select the a start method you use the :func:`set_start_method` in
+To select a start method you use the :func:`set_start_method` in
 the ``if __name__ == '__main__'`` clause of the main module.  For
 example::
 
diff --git a/Doc/whatsnew/3.4.rst b/Doc/whatsnew/3.4.rst
--- a/Doc/whatsnew/3.4.rst
+++ b/Doc/whatsnew/3.4.rst
@@ -114,8 +114,8 @@
 * New :mod:`pickle` :ref:`protocol 4 <whatsnew-protocol-4>` (:pep:`3154`)
 * :ref:`SHA-3 (Keccak) support <whatsnew-sha3>` for :mod:`hashlib`.
 * :ref:`TLSv1.1 and TLSv1.2 support <whatsnew-tls-11-12>` for :mod:`ssl`.
-* :mod:`multiprocessing` now has option to avoid using :func:`os.fork`
-  on Unix (:issue:`8713`).
+* :mod:`multiprocessing` now has :ref:`an option to avoid using os.fork
+  on Unix <whatsnew-multiprocessing-no-fork>` (:issue:`8713`).
 * :mod:`email` has a new submodule, :mod:`~email.contentmanager`, and
   a new :mod:`~email.message.Message` subclass
   (:class:`~email.contentmanager.EmailMessage`) that simplify MIME handling.
@@ -633,14 +633,17 @@
 multiprocessing
 ---------------
 
-On Unix, two new *start methods* (``spawn`` and ``forkserver``) have been
-added for starting processes using :mod:`multiprocessing`.  These make
-the mixing of processes with threads more robust, and the ``spawn``
-method matches the semantics that multiprocessing has always used on
-Windows. (Contributed by Richard Oudkerk in :issue:`8713`).
+.. _whatsnew-multiprocessing-no-fork:
+
+On Unix, two new :ref:`start methods <multiprocessing-start-methods>`
+(``spawn`` and ``forkserver``) have been added for starting processes using
+:mod:`multiprocessing`.  These make the mixing of processes with threads more
+robust, and the ``spawn`` method matches the semantics that multiprocessing has
+always used on Windows. (Contributed by Richard Oudkerk in :issue:`8713`).
 
 Also, except when using the old *fork* start method, child processes
-will no longer inherit unneeded handles/file descriptors from their parents.
+will no longer inherit unneeded handles/file descriptors from their parents
+(part of :issue:`8713`).
 
 :mod:`multiprocessing` now relies on :mod:`runpy` (which implements the
 ``-m`` switch) to initialise ``__main__`` appropriately in child processes

-- 
Repository URL: http://hg.python.org/cpython