➜

This issue tracker has been migrated to GitHub, and is currently read-only.
For more information, see the GitHub FAQs in the Python's Developer Guide.

Author mingus
Recipients docs@python, michael.foord, mingus, r.david.murray
Date 2013-09-03.19:02:28
SpamBayes Score -1.0
Marked as misclassified Yes
Message-id <1378234948.5.0.446808276805.issue18914@psf.upfronthosting.co.za>
In-reply-to
Content 
The documentation is confusing. Consider this comment:

# All calls to urllib2.urlopen will now use our handler
# Make sure not to include the protocol in with the URL, or
# HTTPPasswordMgrWithDefaultRealm will be very confused.
# You must (of course) use it when fetching the page though.

In the actual code he provides, he uses the protocol. Furthermore, before showing a simple way to use the libary, he shows a godawfully complex way. 

Either the documentation should made beautiful and comprehensible, or it should not be linked to.
History
Date User Action Args
2013-09-03 19:02:28mingussetrecipients: + mingus, r.david.murray, michael.foord, docs@python
2013-09-03 19:02:28mingussetmessageid: <1378234948.5.0.446808276805.issue18914@psf.upfronthosting.co.za>
2013-09-03 19:02:28minguslinkissue18914 messages
2013-09-03 19:02:28minguscreate