From: Gareth Rees Date: Wed, 24 Jun 2020 03:12:10 +0000 (+0100) Subject: bpo-40707: Document that Popen.communicate sets the returncode attribute (GH-20283) X-Git-Tag: v3.10.0a1~529 X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=bf2e515fa43406d4bd9c4c53ecc9364034d8f9f6;p=thirdparty%2FPython%2Fcpython.git bpo-40707: Document that Popen.communicate sets the returncode attribute (GH-20283) --- diff --git a/Doc/library/subprocess.rst b/Doc/library/subprocess.rst index 5988bd35e72b..e37cc980e975 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,