From 3d0c8052a44bcad81d73c96cd6fbb7f7ba188dd8 Mon Sep 17 00:00:00 2001 From: Fred Drake Date: Thu, 1 Apr 2004 04:11:05 +0000 Subject: [PATCH] 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. --- Doc/lib/liburllib.tex | 4 ++++ 1 file changed, 4 insertions(+) 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 -- 2.47.3