diff options
| author | Benjamin Peterson <benjamin@python.org> | 2014-01-18 00:45:56 -0500 |
|---|---|---|
| committer | Benjamin Peterson <benjamin@python.org> | 2014-01-18 00:45:56 -0500 |
| commit | 3d8814e1d30e174ddcb3591a1ff35206e962b064 (patch) | |
| tree | c070791c757be4086b8ff0c9b356c6d928ad16db /Doc | |
| parent | c3cf97b4ea05fc79b7753c66e31d861cadb0607e (diff) | |
| download | cpython-git-3d8814e1d30e174ddcb3591a1ff35206e962b064.tar.gz | |
describe type of Popen streams (closes #17814)
Patch more or less by Nikolaus Rath.
Diffstat (limited to 'Doc')
| -rw-r--r-- | Doc/library/subprocess.rst | 24 |
1 files changed, 16 insertions, 8 deletions
diff --git a/Doc/library/subprocess.rst b/Doc/library/subprocess.rst index 9f2f82d43a..4acbaa7aac 100644 --- a/Doc/library/subprocess.rst +++ b/Doc/library/subprocess.rst @@ -705,21 +705,29 @@ The following attributes are also available: .. attribute:: Popen.stdin - If the *stdin* argument was :data:`PIPE`, this attribute is a :term:`file - object` that provides input to the child process. Otherwise, it is ``None``. + If the *stdin* argument was :data:`PIPE`, this attribute is a writeable + stream object as returned by :func:`open`. If the *universal_newlines* + argument was ``True``, the stream is a text stream, otherwise it is a byte + stream. If the *stdin* argument was not :data:`PIPE`, this attribute is + ``None``. .. attribute:: Popen.stdout - If the *stdout* argument was :data:`PIPE`, this attribute is a :term:`file - object` that provides output from the child process. Otherwise, it is ``None``. - + If the *stdout* argument was :data:`PIPE`, this attribute is a readable + stream object as returned by :func:`open`. Reading from the stream provides + output from the child process. If the *universal_newlines* argument was + ``True``, the stream is a text stream, otherwise it is a byte stream. If the + *stdout* argument was not :data:`PIPE`, this attribute is ``None``. + .. attribute:: Popen.stderr - If the *stderr* argument was :data:`PIPE`, this attribute is a :term:`file - object` that provides error output from the child process. Otherwise, it is - ``None``. + If the *stderr* argument was :data:`PIPE`, this attribute is a readable + stream object as returned by :func:`open`. Reading from the stream provides + error output from the child process. If the *universal_newlines* argument was + ``True``, the stream is a text stream, otherwise it is a byte stream. If the + *stderr* argument was not :data:`PIPE`, this attribute is ``None``. .. attribute:: Popen.pid |