Move out of a .. note into the main text. mention in the high level Process description.

gpshead · gpshead · commit 83344ece1cc4 · 2025-07-27T18:56:33.000Z
diff --git a/Doc/library/multiprocessing.rst b/Doc/library/multiprocessing.rst
@@ -97,6 +97,10 @@ To show the individual process IDs involved, here is an expanded example::
 For an explanation of why the ``if __name__ == '__main__'`` part is
 necessary, see :ref:`multiprocessing-programming`.
 
+The arguments to :class:`Process` usually need to be unpickleable from within
+the child process. If you tried typing the above example directly into REPL it
+could lead to an :exc:`AttributeError` in the child process trying to locate the
+*f* function in the ``__main__`` module.
 
 
 .. _multiprocessing-start-methods:
@@ -544,38 +548,36 @@ The :mod:`multiprocessing` package mostly replicates the API of the
    base class constructor (:meth:`Process.__init__`) before doing anything else
    to the process.
 
-   .. versionchanged:: 3.3
-      Added the *daemon* parameter.
+   In general, all arguments to :meth:`Process.__init__` must be picklable.
+   This is particularly notable when trying to create a :class:`Process` or
+   use a :class:`~concurrent.futures.ProcessPoolExecutor` from a REPL with a
+   locally defined *target* function.
 
-   .. note::
+   Passing a callable object defined in the current REPL session raises an
+   :exc:`AttributeError` exception when starting the process as such as
+   *target* must have been defined within an importable module to under to be
+   unpickled.
 
-      In general, all arguments to :meth:`Process.__init__` must be picklable.
-      This is particularly notable when trying to create a :class:`Process` or
-      use a :class:`~concurrent.futures.ProcessPoolExecutor` from a REPL with a
-      locally defined *target* function.
+   Example::
 
-      Passing a callable object defined in the current REPL session raises an
-      :exc:`AttributeError` exception when starting the process as such as
-      *target* must have been defined within an importable module to under to be
-      unpickled.
-
-      Example::
+      >>> import multiprocessing as mp
+      >>> def knigit():
+      ...     print("knee!")
+      ...
+      >>> mp.Process(target=knigit).start()
+      >>> Traceback (most recent call last):
+        File ".../multiprocessing/spawn.py", line ..., in spawn_main
+        File ".../multiprocessing/spawn.py", line ..., in _main
+      AttributeError: module '__main__' has no attribute 'knigit'
 
-         >>> import multiprocessing as mp
-         >>> def knigit():
-         ...     print("knee!")
-         ...
-         >>> mp.Process(target=knigit).start()
-         >>> Traceback (most recent call last):
-           File ".../multiprocessing/spawn.py", line ..., in spawn_main
-           File ".../multiprocessing/spawn.py", line ..., in _main
-         AttributeError: module '__main__' has no attribute 'knigit'
+   See :ref:`multiprocessing-programming-spawn`.
 
-      See :ref:`multiprocessing-programming-spawn`.
+   While this restriction is not true if using the ``"fork"`` start method,
+   as of Python ``3.14`` that is no longer the default on any platform.  See
+   :ref:`multiprocessing-start-methods`.
 
-      While this restriction is not true if using the ``"fork"`` start method,
-      as of Python ``3.14`` that is no longer the default on any platform.  See
-      :ref:`multiprocessing-start-methods`.
+   .. versionchanged:: 3.3
+      Added the *daemon* parameter.
 
    .. method:: run()
 
