]> granicus.if.org Git - python/commitdiff
#12642: fix args names in open() doc.
authorEzio Melotti <ezio.melotti@gmail.com>
Wed, 27 Jul 2011 05:48:52 +0000 (08:48 +0300)
committerEzio Melotti <ezio.melotti@gmail.com>
Wed, 27 Jul 2011 05:48:52 +0000 (08:48 +0300)
Doc/library/functions.rst

index c372d7d844f7cfa9c73111bd94b5dc136babe520..635b4653245d5b3ffd72c127746a64429672807d 100644 (file)
@@ -796,7 +796,7 @@ available.  They are listed here in alphabetical order.
       Formerly only returned an unsigned literal.
 
 
-.. function:: open(filename[, mode[, bufsize]])
+.. function:: open(name[, mode[, buffering]])
 
    Open a file, returning an object of the :class:`file` type described in
    section :ref:`bltin-file-objects`.  If the file cannot be opened,
@@ -804,7 +804,7 @@ available.  They are listed here in alphabetical order.
    :func:`open` instead of invoking the :class:`file` constructor directly.
 
    The first two arguments are the same as for ``stdio``'s :cfunc:`fopen`:
-   *filename* is the file name to be opened, and *mode* is a string indicating how
+   *name* is the file name to be opened, and *mode* is a string indicating how
    the file is to be opened.
 
    The most commonly-used values of *mode* are ``'r'`` for reading, ``'w'`` for
@@ -825,9 +825,9 @@ available.  They are listed here in alphabetical order.
       single: buffer size, I/O
       single: I/O control; buffering
 
-   The optional *bufsize* argument specifies the file's desired buffer size: 0
+   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 *bufsize* means to use the
+   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. [#]_