]> git.ipfire.org Git - thirdparty/Python/cpython.git/commitdiff
[3.13] gh-109070: Document that get_context in multiprocessing have side effect ...
authorMiss Islington (bot) <31488909+miss-islington@users.noreply.github.com>
Sun, 6 Jul 2025 18:32:15 +0000 (20:32 +0200)
committerGitHub <noreply@github.com>
Sun, 6 Jul 2025 18:32:15 +0000 (18:32 +0000)
gh-109070: Document that get_context in multiprocessing have side effect (GH-136341)

Document that get_context in multiprocessing have side effect
(cherry picked from commit 77a8bd29da99e7d4fa8e7f07c4063977c2bb14d3)

Co-authored-by: AN Long <aisk@users.noreply.github.com>
Doc/library/multiprocessing.rst

index f5591a32f59dc70107d3cc95736c3ff9bc4151ee..529cd5ce03c8c47c908ca3980cef856bd5c22c2d 100644 (file)
@@ -1079,7 +1079,9 @@ Miscellaneous
    Return a context object which has the same attributes as the
    :mod:`multiprocessing` module.
 
-   If *method* is ``None`` then the default context is returned.
+   If *method* is ``None`` then the default context is returned. Note that if
+   the global start method has not been set, this will set it to the
+   default method.
    Otherwise *method* should be ``'fork'``, ``'spawn'``,
    ``'forkserver'``.  :exc:`ValueError` is raised if the specified
    start method is not available.  See :ref:`multiprocessing-start-methods`.
@@ -1090,10 +1092,10 @@ Miscellaneous
 
    Return the name of start method used for starting processes.
 
-   If the start method has not been fixed and *allow_none* is false,
-   then the start method is fixed to the default and the name is
-   returned.  If the start method has not been fixed and *allow_none*
-   is true then ``None`` is returned.
+   If the global start method has not been set and *allow_none* is
+   ``False``, then the start method is set to the default and the name
+   is returned. If the start method has not been set and *allow_none* is
+   ``True`` then ``None`` is returned.
 
    The return value can be ``'fork'``, ``'spawn'``, ``'forkserver'``
    or ``None``.  See :ref:`multiprocessing-start-methods`.