]> granicus.if.org Git - python/commitdiff
file.next() doc refers to itself
authorSandro Tosi <sandro.tosi@gmail.com>
Tue, 17 Jan 2012 17:57:30 +0000 (18:57 +0100)
committerSandro Tosi <sandro.tosi@gmail.com>
Tue, 17 Jan 2012 17:57:30 +0000 (18:57 +0100)
Doc/library/stdtypes.rst

index 933e326f76d7fcfcb3b9e39e446ec646facb4b73..f54d8de176dbd760391a174a7e0d24c45640c7a3 100644 (file)
@@ -2372,12 +2372,12 @@ Files have the following methods:
    A file object is its own iterator, for example ``iter(f)`` returns *f* (unless
    *f* is closed).  When a file is used as an iterator, typically in a
    :keyword:`for` loop (for example, ``for line in f: print line``), the
-   :meth:`next` method is called repeatedly.  This method returns the next input
+   :meth:`~file.next` method is called repeatedly.  This method returns the next input
    line, or raises :exc:`StopIteration` when EOF is hit when the file is open for
    reading (behavior is undefined when the file is open for writing).  In order to
    make a :keyword:`for` loop the most efficient way of looping over the lines of a
-   file (a very common operation), the :meth:`next` method uses a hidden read-ahead
-   buffer.  As a consequence of using a read-ahead buffer, combining :meth:`next`
+   file (a very common operation), the :meth:`~file.next` method uses a hidden read-ahead
+   buffer.  As a consequence of using a read-ahead buffer, combining :meth:`~file.next`
    with other file methods (like :meth:`readline`) does not work right.  However,
    using :meth:`seek` to reposition the file to an absolute position will flush the
    read-ahead buffer.