summaryrefslogtreecommitdiffstats
path: root/Doc/library/subprocess.rst
diff options
context:
space:
mode:
authorGareth Rees <gdr@garethrees.org>2020-06-24 03:12:10 (GMT)
committerGitHub <noreply@github.com>2020-06-24 03:12:10 (GMT)
commitbf2e515fa43406d4bd9c4c53ecc9364034d8f9f6 (patch)
tree7e3bf6bcaa6c42bfc2a8da126394c4e71168bbb4 /Doc/library/subprocess.rst
parentcde283d16d87024f455e45c6f1b4e4f7d8905836 (diff)
downloadcpython-bf2e515fa43406d4bd9c4c53ecc9364034d8f9f6.zip
cpython-bf2e515fa43406d4bd9c4c53ecc9364034d8f9f6.tar.gz
cpython-bf2e515fa43406d4bd9c4c53ecc9364034d8f9f6.tar.bz2
bpo-40707: Document that Popen.communicate sets the returncode attribute (GH-20283)
Diffstat (limited to 'Doc/library/subprocess.rst')
-rw-r--r--Doc/library/subprocess.rst9
1 files changed, 5 insertions, 4 deletions
diff --git a/Doc/library/subprocess.rst b/Doc/library/subprocess.rst
index 5988bd3..e37cc98 100644
--- a/Doc/library/subprocess.rst
+++ b/Doc/library/subprocess.rst
@@ -738,10 +738,11 @@ Instances of the :class:`Popen` class have the following methods:
.. method:: Popen.communicate(input=None, timeout=None)
Interact with process: Send data to stdin. Read data from stdout and stderr,
- until end-of-file is reached. Wait for process to terminate. The optional
- *input* argument should be data to be sent to the child process, or
- ``None``, if no data should be sent to the child. If streams were opened in
- text mode, *input* must be a string. Otherwise, it must be bytes.
+ until end-of-file is reached. Wait for process to terminate and set the
+ :attr:`~Popen.returncode` attribute. The optional *input* argument should be
+ data to be sent to the child process, or ``None``, if no data should be sent
+ to the child. If streams were opened in text mode, *input* must be a string.
+ Otherwise, it must be bytes.
:meth:`communicate` returns a tuple ``(stdout_data, stderr_data)``.
The data will be strings if streams were opened in text mode; otherwise,