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 4003e3b..51a3655 100644
--- a/Doc/lib/liburllib2.tex
+++ b/Doc/lib/liburllib2.tex
@@ -33,12 +33,19 @@
\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}}