From: Kurt B. Kaiser <kbk@shore.net>
Date: Sun, 11 Jul 2004 02:13:17 +0000 (+0000)
Subject: Patch 851752 (fixes bug 820583)
X-Git-Tag: v2.4a2~313
X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=8932b41669d7a17c3b3749a67e5778812559d8b4;p=python

Patch 851752 (fixes bug 820583)
Patch by John J Lee
Reviewed by Jeff Epler / KBK
Doc built OK.

urlopen() may return None if no handler handles the request.

Also clarify what install_opener does.

M liburllib2.tex
---

diff --git a/Doc/lib/liburllib2.tex b/Doc/lib/liburllib2.tex
index 4003e3b404..51a3655386 100644
--- a/Doc/lib/liburllib2.tex
+++ b/Doc/lib/liburllib2.tex
@@ -33,12 +33,19 @@ This function returns a file-like object with two additional methods:
 \end{itemize}
 
 Raises \exception{URLError} on errors.
+
+Note that \code{None} may be returned if no handler handles the
+request (though the default installed global \class{OpenerDirector}
+uses \class{UnknownHandler} to ensure this never happens).
 \end{funcdesc}
 
 \begin{funcdesc}{install_opener}{opener}
-Install an \class{OpenerDirector} instance as the default opener.
-The code does not check for a real \class{OpenerDirector}, and any
-class with the appropriate interface will work.
+Install an \class{OpenerDirector} instance as the default global
+opener.  Installing an opener is only necessary if you want urlopen to
+use that opener; otherwise, simply call \method{OpenerDirector.open()}
+instead of \function{urlopen()}.  The code does not check for a real
+\class{OpenerDirector}, and any class with the appropriate interface
+will work.
 \end{funcdesc}
 
 \begin{funcdesc}{build_opener}{\optional{handler, \moreargs}}