From: Miss Islington (bot) <31488909+miss-islington@users.noreply.github.com>
Date: Tue, 18 Jan 2022 22:03:22 +0000 (-0800)
Subject: [3.9] bpo-45554: Document multiprocessing.Process.exitcode values (GH-30142) (GH... 
X-Git-Tag: v3.9.11~158
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=0be4760d85399a308421d9229b5d7f1b4ec718a2;p=thirdparty%2FPython%2Fcpython.git

[3.9] bpo-45554: Document multiprocessing.Process.exitcode values (GH-30142) (GH-30675)



This addresses [[bpo-45554]()]() by expanding the `exitcode` documentation to also describe what `exitcode` will be in cases of normal termination, `sys.exit()` called, and on uncaught exceptions.


(cherry picked from commit 3852269b91fcc8ee668cd876b3669eba6da5b1ac)


Co-authored-by: John Marshall <jmarshall@hey.com>
---

diff --git a/Doc/library/multiprocessing.rst b/Doc/library/multiprocessing.rst
index 96bc6c153284..4966be303f42 100644
--- a/Doc/library/multiprocessing.rst
+++ b/Doc/library/multiprocessing.rst
@@ -569,8 +569,15 @@ The :mod:`multiprocessing` package mostly replicates the API of the
    .. attribute:: exitcode
 
       The child's exit code.  This will be ``None`` if the process has not yet
-      terminated.  A negative value *-N* indicates that the child was terminated
-      by signal *N*.
+      terminated.
+
+      If the child's :meth:`run` method returned normally, the exit code
+      will be 0.  If it terminated via :func:`sys.exit` with an integer
+      argument *N*, the exit code will be *N*.
+
+      If the child terminated due to an exception not caught within
+      :meth:`run`, the exit code will be 1.  If it was terminated by
+      signal *N*, the exit code will be the negative value *-N*.
 
    .. attribute:: authkey
 
diff --git a/Misc/ACKS b/Misc/ACKS
index ac893acbf3e4..25c88656d424 100644
--- a/Misc/ACKS
+++ b/Misc/ACKS
@@ -1095,6 +1095,7 @@ Vincent Marchetti
 David Marek
 Doug Marien
 Sven Marnach
+John Marshall
 Alex Martelli
 Dennis MÃ¥rtensson
 Anthony Martin