From: Fred Drake <fdrake@acm.org>
Date: Wed, 1 May 2002 03:33:02 +0000 (+0000)
Subject: Explain what os.read() returns at end of file.
X-Git-Tag: 2.1~48
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=e13ac93e9a4b4291d45fbd66dd9f397861b4ff6d;p=thirdparty%2FPython%2Fcpython.git

Explain what os.read() returns at end of file.
This closes SF bug #550409.
---

diff --git a/Doc/lib/libos.tex b/Doc/lib/libos.tex
index ca9a206d854c..d40aa076b1fc 100644
--- a/Doc/lib/libos.tex
+++ b/Doc/lib/libos.tex
@@ -453,7 +453,9 @@ Availability: \UNIX{}, Windows.
 
 \begin{funcdesc}{read}{fd, n}
 Read at most \var{n} bytes from file descriptor \var{fd}.
-Return a string containing the bytes read.
+Return a string containing the bytes read.  If the end of the file
+referred to by \var{fd} has been reached, an empty string is
+returned.
 Availability: Macintosh, \UNIX{}, Windows.
 
 Note: this function is intended for low-level I/O and must be applied