[Python-checkins] cpython (3.3): describe type of Popen streams (closes #17814)
benjamin.peterson
python-checkins at python.org
Sat Jan 18 06:49:38 CET 2014
http://hg.python.org/cpython/rev/946257d3c648
changeset: 88534:946257d3c648
branch: 3.3
parent: 88531:fc52b657bcd9
user: Benjamin Peterson <benjamin at python.org>
date: Sat Jan 18 00:45:56 2014 -0500
summary:
describe type of Popen streams (closes #17814)
Patch more or less by Nikolaus Rath.
files:
Doc/library/subprocess.rst | 24 ++++++++++++++++--------
1 files changed, 16 insertions(+), 8 deletions(-)
diff --git a/Doc/library/subprocess.rst b/Doc/library/subprocess.rst
--- a/Doc/library/subprocess.rst
+++ b/Doc/library/subprocess.rst
@@ -705,21 +705,29 @@
.. 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
--
Repository URL: http://hg.python.org/cpython
More information about the Python-checkins
mailing list