[Python-Dev] [Python-checkins] cpython (3.3): Issue #17860: explicitly mention that std* streams are opened in binary mode by (original) (raw)

Ronald Oussoren ronaldoussoren at mac.com
Sat Jul 6 15:03:13 CEST 2013

Previous message: [Python-Dev] [Python-checkins] cpython (3.3): Issue #17860: explicitly mention that std* streams are opened in binary mode by
Next message: [Python-Dev] [Python-checkins] cpython (3.3): Issue #17860: explicitly mention that std* streams are opened in binary mode by
Messages sorted by: [ date ] [ thread ] [ subject ] [ author ]

On 6 Jul, 2013, at 14:09, Ronald Oussoren <ronaldoussoren at mac.com> wrote:

On 6 Jul, 2013, at 13:59, R. David Murray <rdmurray at bitdance.com> wrote:

IMO, either the default should be mentioned first, or the default should be mentioned in a parenthetical. Otherwise it sounds like newline translation is being done in both modes. Logically that makes no sense, so the above construction will likely lead to, at a minimum, an interruption in the flow for the reader, and at worse even more confusion than not mentioning it at all. You've got a point there. Converting the next text (", otherwise ...") to a parententical seems to be the cleanest fix, creating a separate sentence for the False case introduces duplication unless I restructure the text.

I didn't like the parenthentical after all. Would this work for you?:

If universal_newlines is True, the file objects stdin, stdout and
stderr will be opened as text streams in :term:universal newlines mode

If universal_newlines is False the file objects stdin, stdout and
stderr will be opened as binary streams, and no line ending conversion is done.
If universal_newlines is True, these file objects
will be opened as text streams in :term:universal newlines mode using the encoding returned by :func:`locale.getpreferredencoding(False)

<locale.getpreferredencoding>`, otherwise these streams will be opened
as binary streams. For stdin, line ending characters

<locale.getpreferredencoding>. 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

That is, a new paragraph is added before the existing one to explain the behavior of "not universal_newlines".

Ronald

Ronald

--David

Python-Dev mailing list Python-Dev at python.org http://mail.python.org/mailman/listinfo/python-dev Unsubscribe: http://mail.python.org/mailman/options/python-dev/ronaldoussoren%40mac.com

Python-Dev mailing list Python-Dev at python.org http://mail.python.org/mailman/listinfo/python-dev Unsubscribe: http://mail.python.org/mailman/options/python-dev/ronaldoussoren%40mac.com

Previous message: [Python-Dev] [Python-checkins] cpython (3.3): Issue #17860: explicitly mention that std* streams are opened in binary mode by
Next message: [Python-Dev] [Python-checkins] cpython (3.3): Issue #17860: explicitly mention that std* streams are opened in binary mode by
Messages sorted by: [ date ] [ thread ] [ subject ] [ author ]

More information about the Python-Dev mailing list