summaryrefslogtreecommitdiffstats
path: root/Doc/library
diff options
context:
space:
mode:
authorGregory P. Smith <greg@krypto.org>2012-11-10 21:44:50 (GMT)
committerGregory P. Smith <greg@krypto.org>2012-11-10 21:44:50 (GMT)
commitb696610c2d0e6a5a381247b3f96bf678307a08e3 (patch)
tree53025d1bac7606ca57a71b6ec200a4f2a0dc8fc1 /Doc/library
parente2c574fbe5b793a5ec2921ad82d0b05ba3f68dbe (diff)
parent6b0bdab4293684a2a7e47e8e8e70076c8670eb9b (diff)
downloadcpython-b696610c2d0e6a5a381247b3f96bf678307a08e3.zip
cpython-b696610c2d0e6a5a381247b3f96bf678307a08e3.tar.gz
cpython-b696610c2d0e6a5a381247b3f96bf678307a08e3.tar.bz2
Fixes issue #16409: The reporthook callback made by the legacy
urllib.request.urlretrieve API now properly supplies a constant non-zero block_size as it did in Python 3.2 and 2.7. This matches the behavior of urllib.request.URLopener.retrieve.
Diffstat (limited to 'Doc/library')
-rw-r--r--Doc/library/urllib.request.rst3
1 files changed, 2 insertions, 1 deletions
diff --git a/Doc/library/urllib.request.rst b/Doc/library/urllib.request.rst
index 898fe71..21255e5 100644
--- a/Doc/library/urllib.request.rst
+++ b/Doc/library/urllib.request.rst
@@ -1305,7 +1305,8 @@ some point in the future.
*filename* is not given, the filename is the output of :func:`tempfile.mktemp`
with a suffix that matches the suffix of the last path component of the input
URL. If *reporthook* is given, it must be a function accepting three numeric
- parameters. It will be called after each chunk of data is read from the
+ parameters: A chunk number, the maximum size chunks are read in and the total size of the download
+ (-1 if unknown). It will be called once at the start and after each chunk of data is read from the
network. *reporthook* is ignored for local URLs.
If the *url* uses the :file:`http:` scheme identifier, the optional *data*