From: AN Long Date: Sun, 6 Jul 2025 18:26:26 +0000 (+0900) Subject: gh-109070: Document that get_context in multiprocessing have side effect (#136341) X-Git-Tag: v3.15.0a1~1080 X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=77a8bd29da99e7d4fa8e7f07c4063977c2bb14d3;p=thirdparty%2FPython%2Fcpython.git gh-109070: Document that get_context in multiprocessing have side effect (#136341) Document that get_context in multiprocessing have side effect --- diff --git a/Doc/library/multiprocessing.rst b/Doc/library/multiprocessing.rst index fc3c1134f97c..546876bd925d 100644 --- a/Doc/library/multiprocessing.rst +++ b/Doc/library/multiprocessing.rst @@ -1118,7 +1118,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`. @@ -1129,10 +1131,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`.