[issue18914] Confusing documentation in the urllib2 HOWTO

2013-09-03 Thread Ned Deily
Changes by Ned Deily n...@acm.org: -- nosy: +michael.foord title: Python docs link to terrible outsi - Confusing documentation in the urllib2 HOWTO ___ Python tracker rep...@bugs.python.org http://bugs.python.org/issue18914

[issue18914] Confusing documentation in the urllib2 HOWTO

2013-09-03 Thread Brian Mingus
Brian Mingus added the comment: 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

[issue18914] Confusing documentation in the urllib2 HOWTO

2013-09-03 Thread R. David Murray
R. David Murray added the comment: Suggesting using a 3rd party library in order to explain how to use the python standard library to do something isn't going to work. Would you like to propose an alternate article or an improvement to the howto, using only stdlib facilities? (Note that the

[issue18914] Confusing documentation in the urllib2 HOWTO

2013-09-03 Thread Brian Mingus
Brian Mingus added the comment: Yes - this link was a waste of my time. It would have been better if it had not been there. I propose to replace it with nothing. -- ___ Python tracker rep...@bugs.python.org http://bugs.python.org/issue18914

[issue18914] Confusing documentation in the urllib2 HOWTO

2013-09-03 Thread R. David Murray
R. David Murray added the comment: The article is *explaining* basic auth, thus the pedegogy of the presentation, and why it is a see also and not part of the docs proper. I'll admit I don't understand the first part of that comment, since the second part says you do have to put the protocol

[issue18914] Confusing documentation in the urllib2 HOWTO

2013-09-03 Thread Senthil Kumaran
Changes by Senthil Kumaran sent...@uthcode.com: -- nosy: +orsenthil ___ Python tracker rep...@bugs.python.org http://bugs.python.org/issue18914 ___ ___ Python-bugs-list

[issue18914] Confusing documentation in the urllib2 HOWTO

2013-09-03 Thread Michael Foord
Michael Foord added the comment: As David explained, the linked article *explains* basic auth as well as showing how to use the standard library support. I think the article is still of some value, it has certainly been useful to many people. -- resolution: - wont fix stage: -