From: Benjamin Peterson Date: Sat, 12 Mar 2011 23:12:54 +0000 (-0600) Subject: clarify condition for readline to return EOF (closes #11312) X-Git-Tag: v2.7.2rc1~257^2~5 X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=4f1a665faec81725bae335ba1d995e18a29383ea;p=python clarify condition for readline to return EOF (closes #11312) --- diff --git a/Doc/library/stdtypes.rst b/Doc/library/stdtypes.rst index b532285f64..77c2da7e66 100644 --- a/Doc/library/stdtypes.rst +++ b/Doc/library/stdtypes.rst @@ -2388,11 +2388,12 @@ Files have the following methods: .. method:: file.readline([size]) - Read one entire line from the file. A trailing newline character is kept in the - string (but may be absent when a file ends with an incomplete line). [#]_ If - the *size* argument is present and non-negative, it is a maximum byte count - (including the trailing newline) and an incomplete line may be returned. An - empty string is returned *only* when EOF is encountered immediately. + Read one entire line from the file. A trailing newline character is kept in + the string (but may be absent when a file ends with an incomplete line). [#]_ + If the *size* argument is present and non-negative, it is a maximum byte + count (including the trailing newline) and an incomplete line may be + returned. When *size* is not 0, an empty string is returned *only* when EOF + is encountered immediately. .. note::