mirrors
/
cpython
mirror of https://github.com/python/cpython.git
2
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

Issue #13597: Fix the documentation of the "-u" command-line option, and wording of "What's new in Python 3.0" about standard streams.

This commit is contained in:
Antoine Pitrou 2011-12-21 11:24:47 +01:00
parent de911b2915 08c08eb93c
commit d5ec134d82
2 changed files with 9 additions and 4 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

3
Doc/using/cmdline.rst
View File

@ -249,7 +249,8 @@ Miscellaneous options
Force the binary layer of the stdin, stdout and stderr streams (which is Force the binary layer of the stdin, stdout and stderr streams (which is
available as their ``buffer`` attribute) to be unbuffered. The text I/O available as their ``buffer`` attribute) to be unbuffered. The text I/O
layer will still be line-buffered. layer will still be line-buffered if writing to the console, or
block-buffered if redirected to a non-interactive file.
See also :envvar:`PYTHONUNBUFFERED`. See also :envvar:`PYTHONUNBUFFERED`.

10
Doc/whatsnew/3.0.rst
View File

@ -301,6 +301,12 @@ changed.
There is no longer any need for using the encoding-aware streams There is no longer any need for using the encoding-aware streams
in the :mod:`codecs` module. in the :mod:`codecs` module.
* The initial values of :data:`sys.stdin`, :data:`sys.stdout` and
:data:`sys.stderr` are now unicode-only text files (i.e., they are
instances of :class:`io.TextIOBase`). To read and write bytes data
with these streams, you need to use their :data:`io.TextIOBase.buffer`
attribute.
* Filenames are passed to and returned from APIs as (Unicode) strings. * Filenames are passed to and returned from APIs as (Unicode) strings.
This can present platform-specific problems because on some This can present platform-specific problems because on some
platforms filenames are arbitrary byte strings. (On the other hand, platforms filenames are arbitrary byte strings. (On the other hand,
@ -511,9 +517,7 @@ consulted for longer descriptions.
produces a literal of type :class:`bytes`. produces a literal of type :class:`bytes`.
* :ref:`pep-3116`. The :mod:`io` module is now the standard way of * :ref:`pep-3116`. The :mod:`io` module is now the standard way of
doing file I/O, and the initial values of :data:`sys.stdin`, doing file I/O. The built-in :func:`open` function is now an
:data:`sys.stdout` and :data:`sys.stderr` are now instances of
:class:`io.TextIOBase`. The built-in :func:`open` function is now an
alias for :func:`io.open` and has additional keyword arguments alias for :func:`io.open` and has additional keyword arguments
*encoding*, *errors*, *newline* and *closefd*. Also note that an *encoding*, *errors*, *newline* and *closefd*. Also note that an
invalid *mode* argument now raises :exc:`ValueError`, not invalid *mode* argument now raises :exc:`ValueError`, not