New submission from Mark Dickinson <[EMAIL PROTECTED]>:

Grant Edwards pointed out in a comp.lang.python posting that the 
documentation for urlopen in the urllib module appears to be self-
contradictory:  at http://docs.python.org/dev/library/urllib.html
in the third-to-last paragraph for the urllib function, it says:

"Alternatively, the optional proxies argument may be used to explicitly 
specify proxies..."

and goes on to give examples.  Then the second-to-last paragraph seems 
to directly contradict this:

"The urlopen() function does not support explicit proxy specification. 
If you need to override environmental proxy settings, use URLopener, or 
a subclass such as FancyURLopener."

I suspect that this second paragraph should just be deleted in its 
entirety.

----------
assignee: georg.brandl
components: Documentation
messages: 63529
nosy: georg.brandl, marketdickinson
severity: normal
status: open
title: Confusing documentation for urllip.urlopen
versions: Python 2.5, Python 2.6, Python 3.0

__________________________________
Tracker <[EMAIL PROTECTED]>
<http://bugs.python.org/issue2288>
__________________________________
_______________________________________________
Python-bugs-list mailing list 
Unsubscribe: 
http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

Reply via email to