Merge: Reflow paragraphs.

(I got a merge conflict on this in urllib.request.rst, which makes no sense to
me.  Hopefully I didn't screw up the previous 3.3 commit.)
This commit is contained in:
R David Murray 2013-04-28 11:30:19 -04:00
commit d4c1b36c39
2 changed files with 13 additions and 14 deletions

View File

@ -523,10 +523,10 @@ Proxies
**urllib** will auto-detect your proxy settings and use those. This is through **urllib** will auto-detect your proxy settings and use those. This is through
the ``ProxyHandler``, which is part of the normal handler chain when a proxy the ``ProxyHandler``, which is part of the normal handler chain when a proxy
setting is detected. Normally that's setting is detected. Normally that's a good thing, but there are occasions
a good thing, but there are occasions when it may not be helpful [#]_. One way when it may not be helpful [#]_. One way to do this is to setup our own
to do this is to setup our own ``ProxyHandler``, with no proxies defined. This ``ProxyHandler``, with no proxies defined. This is done using similar steps to
is done using similar steps to setting up a `Basic Authentication`_ handler : :: setting up a `Basic Authentication`_ handler : ::
>>> proxy_support = urllib.request.ProxyHandler({}) >>> proxy_support = urllib.request.ProxyHandler({})
>>> opener = urllib.request.build_opener(proxy_support) >>> opener = urllib.request.build_opener(proxy_support)

View File

@ -129,10 +129,9 @@ The :mod:`urllib.request` module defines the following functions:
the constructor without any parameters). Instances of the following classes the constructor without any parameters). Instances of the following classes
will be in front of the *handler*\s, unless the *handler*\s contain them, will be in front of the *handler*\s, unless the *handler*\s contain them,
instances of them or subclasses of them: :class:`ProxyHandler` (if proxy instances of them or subclasses of them: :class:`ProxyHandler` (if proxy
settings are detected), settings are detected), :class:`UnknownHandler`, :class:`HTTPHandler`,
:class:`UnknownHandler`, :class:`HTTPHandler`, :class:`HTTPDefaultErrorHandler`, :class:`HTTPDefaultErrorHandler`, :class:`HTTPRedirectHandler`,
:class:`HTTPRedirectHandler`, :class:`FTPHandler`, :class:`FileHandler`, :class:`FTPHandler`, :class:`FileHandler`, :class:`HTTPErrorProcessor`.
:class:`HTTPErrorProcessor`, :class:`DataHandler`.
If the Python installation has SSL support (i.e., if the :mod:`ssl` module If the Python installation has SSL support (i.e., if the :mod:`ssl` module
can be imported), :class:`HTTPSHandler` will also be added. can be imported), :class:`HTTPSHandler` will also be added.
@ -257,12 +256,12 @@ The following classes are provided:
.. class:: ProxyHandler(proxies=None) .. class:: ProxyHandler(proxies=None)
Cause requests to go through a proxy. If *proxies* is given, it must be a Cause requests to go through a proxy. If *proxies* is given, it must be a
dictionary mapping protocol names to URLs of proxies. The default is to read the dictionary mapping protocol names to URLs of proxies. The default is to read
list of proxies from the environment variables :envvar:`<protocol>_proxy`. the list of proxies from the environment variables
If no proxy environment variables are set, then in a Windows environment proxy :envvar:`<protocol>_proxy`. If no proxy environment variables are set, then
settings are obtained from the registry's Internet Settings section, and in a in a Windows environment proxy settings are obtained from the registry's
Mac OS X environment proxy information is retrieved from the OS X System Internet Settings section, and in a Mac OS X environment proxy information
Configuration Framework. is retrieved from the OS X System Configuration Framework.
To disable autodetected proxy pass an empty dictionary. To disable autodetected proxy pass an empty dictionary.