summaryrefslogtreecommitdiffstats
path: root/Doc/library
diff options
context:
space:
mode:
authorGregory P. Smith <greg@krypto.org>2012-11-10 21:43:44 (GMT)
committerGregory P. Smith <greg@krypto.org>2012-11-10 21:43:44 (GMT)
commit6b0bdab4293684a2a7e47e8e8e70076c8670eb9b (patch)
tree6ec957a8c657b0e66d3fed6d6c944068137afc59 /Doc/library
parent296c2fd065f3ad026dd7169d5fd323a0fee40b31 (diff)
downloadcpython-6b0bdab4293684a2a7e47e8e8e70076c8670eb9b.zip
cpython-6b0bdab4293684a2a7e47e8e8e70076c8670eb9b.tar.gz
cpython-6b0bdab4293684a2a7e47e8e8e70076c8670eb9b.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*