bpo-32146: Add documentation about frozen executables on Unix (GH-5850)
(cherry picked from commit bab4bbb4c9cd5d25ede21a1b8c99d56e3b8dae9d)
Co-authored-by: Bo Bayles <bbayles@gmail.com>
diff --git a/Doc/library/multiprocessing.rst b/Doc/library/multiprocessing.rst
index 504f3a1..c50625d 100644
--- a/Doc/library/multiprocessing.rst
+++ b/Doc/library/multiprocessing.rst
@@ -186,6 +186,13 @@
use :func:`get_context` to avoid interfering with the choice of the
library user.
+.. warning::
+
+ The ``'spawn'`` and ``'forkserver'`` start methods cannot currently
+ be used with "frozen" executables (i.e., binaries produced by
+ packages like **PyInstaller** and **cx_Freeze**) on Unix.
+ The ``'fork'`` start method does work.
+
Exchanging objects between processes
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~