Merged revisions 76284 via svnmerge from

svn+ssh://pythondev@svn.python.org/python/branches/py3k

................
  r76284 | senthil.kumaran | 2009-11-15 11:50:55 +0530 (Sun, 15 Nov 2009) | 9 lines

  Merged revisions 76282 via svnmerge from
  svn+ssh://pythondev@svn.python.org/python/trunk

  ........
    r76282 | senthil.kumaran | 2009-11-15 11:40:30 +0530 (Sun, 15 Nov 2009) | 3 lines

    Addition of some details in the code comments.
  ........
................

Lib/urllib/request.py

@@ -30,7 +30,9 @@ handler, the argument will be installed instead of the default.
 install_opener -- Installs a new opener as the default opener.
 
 objects of interest:
-OpenerDirector --
+
+OpenerDirector -- Sets up the User-Agent as the Python-urllib and manages the
+Handler classes while dealing with both requests and responses.
 
 Request -- An object that encapsulates the state of a request.  The
 state can be as simple as the URL.  It can also include extra HTTP
@@ -398,7 +400,7 @@ def build_opener(*handlers):
     """Create an opener object from a list of handlers.
 
     The opener will use several default handlers, including support
-    for HTTP and FTP.
+    for HTTP, FTP and when applicable HTTPS.
 
     If any of the handlers passed as arguments are subclasses of the
     default handlers, the default handlers will not be used.