diff options
| author | Antoine Pitrou <solipsis@pitrou.net> | 2011-12-21 10:24:47 (GMT) |
|---|---|---|
| committer | Antoine Pitrou <solipsis@pitrou.net> | 2011-12-21 10:24:47 (GMT) |
| commit | d5ec134d82dc56cafdadbae2e03f054076a27dd5 (patch) | |
| tree | cf3580df2f5f719b3695fb1462aae55f42414809 /Doc | |
| parent | de911b2915476938c66855d91df6fa4bbd77b39f (diff) | |
| parent | 08c08eb93cc0b67215d1922adc55f3ebf40b5122 (diff) | |
| download | cpython-d5ec134d82dc56cafdadbae2e03f054076a27dd5.zip cpython-d5ec134d82dc56cafdadbae2e03f054076a27dd5.tar.gz cpython-d5ec134d82dc56cafdadbae2e03f054076a27dd5.tar.bz2 | |
Issue #13597: Fix the documentation of the "-u" command-line option, and wording of "What's new in Python 3.0" about standard streams.
Diffstat (limited to 'Doc')
| -rw-r--r-- | Doc/using/cmdline.rst | 3 | ||||
| -rw-r--r-- | Doc/whatsnew/3.0.rst | 10 |
2 files changed, 9 insertions, 4 deletions
diff --git a/Doc/using/cmdline.rst b/Doc/using/cmdline.rst index bc38542..d9cf954 100644 --- a/Doc/using/cmdline.rst +++ b/Doc/using/cmdline.rst @@ -249,7 +249,8 @@ Miscellaneous options 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 - 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`. diff --git a/Doc/whatsnew/3.0.rst b/Doc/whatsnew/3.0.rst index 523b34e..55b65ba 100644 --- a/Doc/whatsnew/3.0.rst +++ b/Doc/whatsnew/3.0.rst @@ -301,6 +301,12 @@ changed. There is no longer any need for using the encoding-aware streams 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. This can present platform-specific problems because on some 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`. * :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`, - :data:`sys.stdout` and :data:`sys.stderr` are now instances of - :class:`io.TextIOBase`. The built-in :func:`open` function is now an + doing file I/O. The built-in :func:`open` function is now an alias for :func:`io.open` and has additional keyword arguments *encoding*, *errors*, *newline* and *closefd*. Also note that an invalid *mode* argument now raises :exc:`ValueError`, not |