[issue10048] urllib.request documentation confusing

New submission from Antoine Pitrou pitrou@free.fr:
The urllib.request documentation intermingles old 2.x urllib (FancyURLopener, etc.) with urllib2-inherited (*Handler, build_opener, etc.) primitives without making any distinction. This makes it rather confusing for the reader to figure out which ones to use.
Ideally, the use of the old primitives should also be discouraged.
---------- assignee: docs@python components: Documentation messages: 118179 nosy: docs@python, orsenthil, pitrou priority: normal severity: normal stage: needs patch status: open title: urllib.request documentation confusing versions: Python 3.1, Python 3.2
_______________________________________ Python tracker report@bugs.python.org http://bugs.python.org/issue10048 _______________________________________

Changes by Senthil Kumaran orsenthil@gmail.com:
---------- assignee: docs@python -> orsenthil
_______________________________________ Python tracker report@bugs.python.org http://bugs.python.org/issue10048 _______________________________________

Changes by Ezio Melotti ezio.melotti@gmail.com:
---------- type: -> enhancement versions: +Python 3.3, Python 3.4 -Python 3.1
_______________________________________ Python tracker report@bugs.python.org http://bugs.python.org/issue10048 _______________________________________

Changes by Ezio Melotti ezio.melotti@gmail.com:
---------- nosy: +ezio.melotti
_______________________________________ Python tracker report@bugs.python.org http://bugs.python.org/issue10048 _______________________________________

Mark Lawrence added the comment:
@Senthil do you still intend to run with this or could somebody else pick it up?
---------- nosy: +BreamoreBoy versions: +Python 3.5 -Python 3.2, Python 3.3
_______________________________________ Python tracker report@bugs.python.org http://bugs.python.org/issue10048 _______________________________________

Change by Mark Lawrence breamoreboy@gmail.com:
---------- nosy: -BreamoreBoy
_______________________________________ Python tracker report@bugs.python.org https://bugs.python.org/issue10048 _______________________________________
participants (4)
-
Antoine Pitrou
-
Ezio Melotti
-
Mark Lawrence
-
Senthil Kumaran