From: Miss Islington (bot) <31488909+miss-islington@users.noreply.github.com> Date: Fri, 22 Jun 2018 21:30:45 +0000 (-0700) Subject: bpo-33885: Replace "hook function" with "callable" (GH-7765) X-Git-Tag: v3.7.1rc1~387 X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=e4db73058b6c31f71c64d0f87a10547f3cf72f20;p=python bpo-33885: Replace "hook function" with "callable" (GH-7765) (cherry picked from commit c45cb479074b5d25f0d382d3109f527520a9f03c) Co-authored-by: Andrés Delfino --- diff --git a/Doc/library/urllib.request.rst b/Doc/library/urllib.request.rst index b7116fabcd..0a9d9dae21 100644 --- a/Doc/library/urllib.request.rst +++ b/Doc/library/urllib.request.rst @@ -1339,9 +1339,9 @@ some point in the future. The second argument, if present, specifies the file location to copy to (if absent, the location will be a tempfile with a generated name). The third - argument, if present, is a hook function that will be called once on + argument, if present, is a callable that will be called once on establishment of the network connection and once after each block read - thereafter. The hook will be passed three arguments; a count of blocks + thereafter. The callable will be passed three arguments; a count of blocks transferred so far, a block size in bytes, and the total size of the file. The third argument may be ``-1`` on older FTP servers which do not return a file size in response to a retrieval request.