#10705: document what the values of debuglevel are and mean.

diff --git a/Doc/library/http.client.rst b/Doc/library/http.client.rst
index 714ebf3047e27d5228fce5a68f94d442a13e90b4..761be86260f805ad1c2def7cbdf3e4a170d9a3b4 100644 (file)
--- a/Doc/library/http.client.rst
+++ b/Doc/library/http.client.rst
@@ -405,8 +405,10 @@ HTTPConnection Objects
 
 .. method:: HTTPConnection.set_debuglevel(level)
 
-   Set the debugging level (the amount of debugging output printed). The default
-   debug level is ``0``, meaning no debugging output is printed.
+   Set the debugging level.  The default debug level is ``0``, meaning no
+   debugging output is printed.  Any value greater than ``0`` will cause all
+   currently defined debug output to be printed to stdout.  The ``debuglevel``
+   is passed to any new :class:`HTTPResponse` objects that are created.
 
    .. versionadded:: 3.1