open() / TextIOWrapper doc: make it explicit than newline='\n' doesn't

translate newlines on output.
This commit is contained in:
Victor Stinner 2012-08-04 01:18:56 +02:00
parent 0c1c0d42dc
commit 401e17d0f0
4 changed files with 12 additions and 12 deletions

View File

@ -888,9 +888,9 @@ are always available. They are listed here in alphabetical order.
* On output, if *newline* is ``None``, any ``'\n'`` characters written are * On output, if *newline* is ``None``, any ``'\n'`` characters written are
translated to the system default line separator, :data:`os.linesep`. If translated to the system default line separator, :data:`os.linesep`. If
*newline* is ``''``, no translation takes place. If *newline* is any of *newline* is ``''`` or ``'\n'``, no translation takes place. If *newline*
the other legal values, any ``'\n'`` characters written are translated to is any of the other legal values, any ``'\n'`` characters written are
the given string. translated to the given string.
If *closefd* is ``False`` and a file descriptor rather than a filename was 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 given, the underlying file descriptor will be kept open when the file is

View File

@ -770,9 +770,9 @@ Text I/O
* On output, if *newline* is ``None``, any ``'\n'`` characters written are * On output, if *newline* is ``None``, any ``'\n'`` characters written are
translated to the system default line separator, :data:`os.linesep`. If translated to the system default line separator, :data:`os.linesep`. If
*newline* is ``''``, no translation takes place. If *newline* is any of *newline* is ``''`` or ``'\n'``, no translation takes place. If *newline*
the other legal values, any ``'\n'`` characters written are translated to is any of the other legal values, any ``'\n'`` characters written are
the given string. translated to the given string.
If *line_buffering* is ``True``, :meth:`flush` is implied when a call to If *line_buffering* is ``True``, :meth:`flush` is implied when a call to
write contains a newline character. write contains a newline character.

View File

@ -264,9 +264,9 @@ PyDoc_STRVAR(open_doc,
"\n" "\n"
"* On output, if newline is None, any '\\n' characters written are\n" "* On output, if newline is None, any '\\n' characters written are\n"
" translated to the system default line separator, os.linesep. If\n" " translated to the system default line separator, os.linesep. If\n"
" newline is '', no translation takes place. If newline is any of the\n" " newline is '' or '\n', no translation takes place. If newline is any\n"
" other legal values, any '\\n' characters written are translated to\n" " of the other legal values, any '\\n' characters written are translated\n"
" the given string.\n" " to the given string.\n"
"\n" "\n"
"If closefd is False, the underlying file descriptor will be kept open\n" "If closefd is False, the underlying file descriptor will be kept open\n"
"when the file is closed. This does not work when a file name is given\n" "when the file is closed. This does not work when a file name is given\n"

View File

@ -635,9 +635,9 @@ PyDoc_STRVAR(textiowrapper_doc,
"\n" "\n"
"* On output, if newline is None, any '\\n' characters written are\n" "* On output, if newline is None, any '\\n' characters written are\n"
" translated to the system default line separator, os.linesep. If\n" " translated to the system default line separator, os.linesep. If\n"
" newline is '', no translation takes place. If newline is any of the\n" " newline is '' or '\n', no translation takes place. If newline is any\n"
" other legal values, any '\\n' characters written are translated to\n" " of the other legal values, any '\\n' characters written are translated\n"
" the given string.\n" " to the given string.\n"
"\n" "\n"
"If line_buffering is True, a call to flush is implied when a call to\n" "If line_buffering is True, a call to flush is implied when a call to\n"
"write contains a newline character." "write contains a newline character."