[Python-checkins] cpython (merge 3.3 -> default): (3.3->default) Issue #17860: explicitly mention that std* streams are opened in
ronald.oussoren
python-checkins at python.org
Sat Jul 6 10:25:20 CEST 2013
http://hg.python.org/cpython/rev/ae8b054155c1
changeset: 84454:ae8b054155c1
parent: 84452:6d278f426417
parent: 84453:a2c2ffa1a41c
user: Ronald Oussoren <ronaldoussoren at mac.com>
date: Sat Jul 06 10:25:04 2013 +0200
summary:
(3.3->default) Issue #17860: explicitly mention that std* streams are opened in binary mode by default.
The documentation does mention that the streams are opened in text mode
when univeral_newlines is true, but not that that they are opened in
binary mode when that argument is false and that seems to confuse at
least some users.
files:
Doc/library/subprocess.rst | 6 ++++--
1 files changed, 4 insertions(+), 2 deletions(-)
diff --git a/Doc/library/subprocess.rst b/Doc/library/subprocess.rst
--- a/Doc/library/subprocess.rst
+++ b/Doc/library/subprocess.rst
@@ -303,7 +303,8 @@
If *universal_newlines* is ``True``, the file objects *stdin*, *stdout* and
*stderr* will be opened as text streams in :term:`universal newlines` mode
using the encoding returned by :func:`locale.getpreferredencoding(False)
- <locale.getpreferredencoding>`. For *stdin*, line ending characters
+ <locale.getpreferredencoding>`, otherwise these streams will be opened
+ as binary streams. For *stdin*, line ending characters
``'\n'`` in the input will be converted to the default line separator
:data:`os.linesep`. For *stdout* and *stderr*, all line endings in the
output will be converted to ``'\n'``. For more information see the
@@ -547,7 +548,8 @@
If *universal_newlines* is ``True``, the file objects *stdin*, *stdout*
and *stderr* are opened as text streams in universal newlines mode, as
- described above in :ref:`frequently-used-arguments`.
+ described above in :ref:`frequently-used-arguments`, otherwise they are
+ opened as binary streams.
If given, *startupinfo* will be a :class:`STARTUPINFO` object, which is
passed to the underlying ``CreateProcess`` function.
--
Repository URL: http://hg.python.org/cpython
More information about the Python-checkins
mailing list