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 kjohnson
Recipients georg.brandl, kjohnson
Date 2008-10-21.11:09:28
SpamBayes Score 0.00024559858
Marked as misclassified No
Message-id <1224587370.27.0.33419504535.issue4156@psf.upfronthosting.co.za>
In-reply-to
Content
In the docs for urllib2.BaseHandler previous to Python 2.6, the names of
the protocol_xxx() methods were spelled with 'protocol' in italics to
indicate that it is a placeholder; the actual method name is e.g.
http_opener().
http://www.python.org/doc/2.5.2/lib/base-handler-objects.html

In the Python 2.6 docs this typographic distinction has been lost
http://docs.python.org/library/urllib2.html#basehandler-objects
so it is not so clear that e.g. protocol_open() is not an actual method.

I suggest either restoring the italics or using a spelling such as
<protocol>_open() for the method names. If this is difficult then the
body of the descriptions should be rewritten to make it clear that the
'given protocol' is indicated by the name of the method.
History
Date User Action Args
2008-10-21 11:09:30kjohnsonsetrecipients: + kjohnson, georg.brandl
2008-10-21 11:09:30kjohnsonsetmessageid: <1224587370.27.0.33419504535.issue4156@psf.upfronthosting.co.za>
2008-10-21 11:09:29kjohnsonlinkissue4156 messages
2008-10-21 11:09:28kjohnsoncreate