(original) (raw)

changeset: 82692:f334a0009586 branch: 2.7 parent: 82670:274e68e2a5a6 user: Terry Jan Reedy tjreedy@udel.edu date: Sat Mar 16 15:55:53 2013 -0400 files: Doc/library/functions.rst description: Issue #17418: specify that buffer sizes are bytes. diff -r 274e68e2a5a6 -r f334a0009586 Doc/library/functions.rst --- a/Doc/library/functions.rst Fri Mar 15 16:49:22 2013 -0400 +++ b/Doc/library/functions.rst Sat Mar 16 15:55:53 2013 -0400 @@ -874,9 +874,9 @@ The optional *buffering* argument specifies the file's desired buffer size: 0 means unbuffered, 1 means line buffered, any other positive value means use a - buffer of (approximately) that size. A negative *buffering* means to use the - system default, which is usually line buffered for tty devices and fully - buffered for other files. If omitted, the system default is used. [#]_ + buffer of (approximately) that size (in bytes). A negative *buffering* means + to use the system default, which is usually line buffered for tty devices and + fully buffered for other files. If omitted, the system default is used. [#]_ Modes ``'r+'``, ``'w+'`` and ``'a+'`` open the file for updating (note that ``'w+'`` truncates the file). Append ``'b'`` to the mode to open the file in /tjreedy@udel.edu