This issue tracker has been migrated to GitHub, and is currently read-only.
For more information, see the GitHub FAQs in the Python's Developer Guide.

Author scop
Recipients docs@python, scop
Date 2011-02-24.21:41:43
SpamBayes Score 0.014326124
Marked as misclassified No
Message-id <1298583708.57.0.612051612173.issue11312@psf.upfronthosting.co.za>
In-reply-to
Content
http://docs.python.org/library/stdtypes.html#file.readline

"An empty string is returned only when EOF is encountered immediately."

I think this sentence is misleading especially because the word "only" in it is emphasized, because an empty string is also returned when the size argument is 0 (except for StringIO but I think that's a bug, see #11311).  I suggest rephrasing it as:

"An empty string is returned only when EOF is encountered immediately or the size argument is zero."

...or just removing the sentence altogether.  Text before it already covers the size=0 case.
History
Date User Action Args
2011-02-24 21:41:48scopsetrecipients: + scop, docs@python
2011-02-24 21:41:48scopsetmessageid: <1298583708.57.0.612051612173.issue11312@psf.upfronthosting.co.za>
2011-02-24 21:41:43scoplinkissue11312 messages
2011-02-24 21:41:43scopcreate