Mirror
/
cpython
mirror of https://github.com/python/cpython
4
1
Fork 0
Code Issues Releases Wiki Activity

Fix markup.

This commit is contained in:
Georg Brandl 2008-08-04 06:29:36 +00:00
parent 70a6dbd46e
commit 143de623e7
1 changed files with 12 additions and 15 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

27
Doc/library/subprocess.rst
View File

@ -193,9 +193,11 @@ Instances of the :class:`Popen` class have the following methods:
Wait for child process to terminate. Set and return :attr:`returncode` Wait for child process to terminate. Set and return :attr:`returncode`
attribute. attribute.
warning:: This will deadlock if the child process generates enough output .. warning::
to a stdout or stderr pipe causing it to block waiting for the OS's pipe
buffer to accept more data. This will deadlock if the child process generates enough output to a
stdout or stderr pipe causing it to block waiting for the OS's pipe buffer
to accept more data.
.. method:: Popen.communicate(input=None) .. method:: Popen.communicate(input=None)
@ -249,35 +251,30 @@ Instances of the :class:`Popen` class have the following methods:
The following attributes are also available: The following attributes are also available:
.. warning::
Use :meth:`communicate` rather than ``.stdin.write()``, ``.stdout.read()`` or
``.stderr.read`` to avoid deadlocks due to any of the other pipe buffers
filling up and blocking the child process.
.. attribute:: Popen.stdin .. attribute:: Popen.stdin
If the *stdin* argument is ``PIPE``, this attribute is a file object that If the *stdin* argument is ``PIPE``, this attribute is a file object that
provides input to the child process. Otherwise, it is ``None``. provides input to the child process. Otherwise, it is ``None``.
warning:: Use :meth:`communicate` rather than .stdin.write() to avoid
deadlocks due to any of the other pipe buffers filling up and blocking the
child process.
.. attribute:: Popen.stdout .. attribute:: Popen.stdout
If the *stdout* argument is ``PIPE``, this attribute is a file object that If the *stdout* argument is ``PIPE``, this attribute is a file object that
provides output from the child process. Otherwise, it is ``None``. provides output from the child process. Otherwise, it is ``None``.
warning:: Use :meth:`communicate` rather than .stdout.read() to avoid
deadlocks due to any of the other pipe buffers filling up and blocking the
child process.
.. attribute:: Popen.stderr .. attribute:: Popen.stderr
If the *stderr* argument is ``PIPE``, this attribute is file object that If the *stderr* argument is ``PIPE``, this attribute is file object that
provides error output from the child process. Otherwise, it is ``None``. provides error output from the child process. Otherwise, it is ``None``.
warning:: Use :meth:`communicate` rather than .stderr.read() to avoid
deadlocks due to any of the other pipe buffers filling up and blocking the
child process.
.. attribute:: Popen.pid .. attribute:: Popen.pid