summaryrefslogtreecommitdiffstats
path: root/Doc
diff options
context:
space:
mode:
authorFred Drake <fdrake@acm.org>2004-03-25 16:51:12 (GMT)
committerFred Drake <fdrake@acm.org>2004-03-25 16:51:12 (GMT)
commit504ca68e20e01a42d89431a4562b3a72c9d62961 (patch)
tree037c46c3a18513825e108a75db65abecf4194c8d /Doc
parent267b062432f2ccda3531080d874cc03afd0fdf22 (diff)
downloadcpython-504ca68e20e01a42d89431a4562b3a72c9d62961.zip
cpython-504ca68e20e01a42d89431a4562b3a72c9d62961.tar.gz
cpython-504ca68e20e01a42d89431a4562b3a72c9d62961.tar.bz2
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. Should be backported to Python 2.3.x.
Diffstat (limited to 'Doc')
-rw-r--r--Doc/lib/liburllib.tex4
1 files changed, 4 insertions, 0 deletions
diff --git a/Doc/lib/liburllib.tex b/Doc/lib/liburllib.tex
index a2ebc32..47348c1 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