From: Fred Drake <fdrake@acm.org>
Date: Thu, 1 Apr 2004 04:11:05 +0000 (+0000)
Subject: Note that reading from a socket may not always return all of the
X-Git-Tag: v2.3.4c1~79
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=3d0c8052a44bcad81d73c96cd6fbb7f7ba188dd8;p=thirdparty%2FPython%2Fcpython.git

Note that reading from a socket may not always return all of the
remaining content of a stream when expected to do so.
Closes SF bug #725265.  Backported from trunk revision 1.52.
---

diff --git a/Doc/lib/liburllib.tex b/Doc/lib/liburllib.tex
index a2ebc327e4d4..47348c1bc6f3 100644
--- a/Doc/lib/liburllib.tex
+++ b/Doc/lib/liburllib.tex
@@ -29,6 +29,10 @@ file-like object is returned.  This supports the following methods:
 \method{read()}, \method{readline()}, \method{readlines()}, \method{fileno()},
 \method{close()}, \method{info()} and \method{geturl()}.  It also has
 proper support for the iterator protocol.
+One caveat: the \method{read()} method, if the size argument is
+omitted or negative, may not read until the end of the data stream;
+there is no good way to determine that the entire stream from a socket
+has been read in the general case.
 
 Except for the \method{info()} and \method{geturl()} methods,
 these methods have the same interface as for