summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorMiss Islington (bot) <31488909+miss-islington@users.noreply.github.com>2021-09-07 18:44:16 (GMT)
committerGitHub <noreply@github.com>2021-09-07 18:44:16 (GMT)
commit31be544721670516fa9700e088c022ff38b0c5fe (patch)
treedb05aec5345432bb1fa83a9b4296adb0059f817e
parentbe33e58699f10762f6d24d925bd376fa730e9f15 (diff)
downloadcpython-31be544721670516fa9700e088c022ff38b0c5fe.zip
cpython-31be544721670516fa9700e088c022ff38b0c5fe.tar.gz
cpython-31be544721670516fa9700e088c022ff38b0c5fe.tar.bz2
bpo-24888: Clarify subprocess.check_call propagates exceptions if unable to start process (GH-28018)
(cherry picked from commit 19a304ba990481f0381a5316096b6b3cf2dff381) Co-authored-by: DonnaDia <37962843+DonnaDia@users.noreply.github.com>
-rw-r--r--Doc/library/subprocess.rst2
1 files changed, 2 insertions, 0 deletions
diff --git a/Doc/library/subprocess.rst b/Doc/library/subprocess.rst
index af54633..21a96a4 100644
--- a/Doc/library/subprocess.rst
+++ b/Doc/library/subprocess.rst
@@ -1149,6 +1149,8 @@ calls these functions.
code was zero then return, otherwise raise :exc:`CalledProcessError`. The
:exc:`CalledProcessError` object will have the return code in the
:attr:`~CalledProcessError.returncode` attribute.
+ If :func:`check_call` was unable to start the process it will propagate the exception
+ that was raised.
Code needing to capture stdout or stderr should use :func:`run` instead::