
python-checkins at python
Aug 14, 2012, 12:40 AM
Post #9 of 13
(139 views)
Permalink
|
|
cpython (merge 3.2 -> default): merge with 3.2
[In reply to]
|
|
http://hg.python.org/cpython/rev/891e3555ed3f changeset: 78559:891e3555ed3f parent: 78557:71918a3c89ef parent: 78558:1c9f1c2bd840 user: Georg Brandl <georg [at] python> date: Tue Aug 14 09:40:26 2012 +0200 summary: merge with 3.2 files: Doc/library/functions.rst | 27 ++++++++++++--------------- Doc/library/io.rst | 27 ++++++++++++--------------- 2 files changed, 24 insertions(+), 30 deletions(-) diff --git a/Doc/library/functions.rst b/Doc/library/functions.rst --- a/Doc/library/functions.rst +++ b/Doc/library/functions.rst @@ -878,22 +878,19 @@ mode). It can be ``None``, ``''``, ``'\n'``, ``'\r'``, and ``'\r\n'``. It works as follows: - * When reading input from the stream, if *newline* is ``None``, - universal newlines mode is enabled. Lines in the input can end - in ``'\n'``, ``'\r'``, or ``'\r\n'``, and these are translated - into ``'\n'`` before being returned to the caller. If it is - ``''``, universal newline mode is enabled, but line endings are - returned to the caller untranslated. If it has any of the other - legal values, input lines are only terminated by the given - string, and the line ending is returned to the caller - untranslated. + * When reading input from the stream, if *newline* is ``None``, universal + newlines mode is enabled. Lines in the input can end in ``'\n'``, + ``'\r'``, or ``'\r\n'``, and these are translated into ``'\n'`` before + being returned to the caller. If it is ``''``, universal newline mode is + enabled, but line endings are returned to the caller untranslated. If it + has any of the other legal values, input lines are only terminated by the + given string, and the line ending is returned to the caller untranslated. - * When writing output to the stream, if *newline* is ``None``, any - ``'\n'`` characters written are translated to the system default - line separator, :data:`os.linesep`. If *newline* is ``''`` or - ``'\n'``, no translation takes place. If *newline* is any of the - other legal values, any ``'\n'`` characters written are - translated to the given string. + * When writing output to the stream, if *newline* is ``None``, any ``'\n'`` + characters written are translated to the system default line separator, + :data:`os.linesep`. If *newline* is ``''`` or ``'\n'``, no translation + takes place. If *newline* is any of the other legal values, any ``'\n'`` + characters written are translated to the given string. If *closefd* is ``False`` and a file descriptor rather than a filename was given, the underlying file descriptor will be kept open when the file is diff --git a/Doc/library/io.rst b/Doc/library/io.rst --- a/Doc/library/io.rst +++ b/Doc/library/io.rst @@ -771,22 +771,19 @@ *newline* controls how line endings are handled. It can be ``None``, ``''``, ``'\n'``, ``'\r'``, and ``'\r\n'``. It works as follows: - * When reading input from the stream, if *newline* is ``None``, - universal newlines mode is enabled. Lines in the input can end - in ``'\n'``, ``'\r'``, or ``'\r\n'``, and these are translated - into ``'\n'`` before being returned to the caller. If it is - ``''``, universal newline mode is enabled, but line endings are - returned to the caller untranslated. If it has any of the other - legal values, input lines are only terminated by the given - string, and the line ending is returned to the caller - untranslated. + * When reading input from the stream, if *newline* is ``None``, universal + newlines mode is enabled. Lines in the input can end in ``'\n'``, + ``'\r'``, or ``'\r\n'``, and these are translated into ``'\n'`` before + being returned to the caller. If it is ``''``, universal newline mode is + enabled, but line endings are returned to the caller untranslated. If it + has any of the other legal values, input lines are only terminated by the + given string, and the line ending is returned to the caller untranslated. - * When writing output to the stream, if *newline* is ``None``, any - ``'\n'`` characters written are translated to the system default - line separator, :data:`os.linesep`. If *newline* is ``''`` or - ``'\n'``, no translation takes place. If *newline* is any of the - other legal values, any ``'\n'`` characters written are - translated to the given string. + * When writing output to the stream, if *newline* is ``None``, any ``'\n'`` + characters written are translated to the system default line separator, + :data:`os.linesep`. If *newline* is ``''`` or ``'\n'``, no translation + takes place. If *newline* is any of the other legal values, any ``'\n'`` + characters written are translated to the given string. If *line_buffering* is ``True``, :meth:`flush` is implied when a call to write contains a newline character. -- Repository URL: http://hg.python.org/cpython
|