[docs] [issue10048] urllib.request documentation confusing

[Antoine Pitrou]

New submission from Antoine Pitrou <pitrou at 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 at python
components: Documentation
messages: 118179
nosy: docs at 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 at bugs.python.org>
<http://bugs.python.org/issue10048>
_______________________________________