[New-bugs-announce] [issue4156] Docs for BaseHandler.protocol_xxx methods are unclear

Kent Johnson report at bugs.python.org
Tue Oct 21 13:09:30 CEST 2008

New submission from Kent Johnson <kent at kentsjohnson.com>:

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.

In the Python 2.6 docs this typographic distinction has been lost
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.

assignee: georg.brandl
components: Documentation
messages: 75023
nosy: georg.brandl, kjohnson
severity: normal
status: open
title: Docs for BaseHandler.protocol_xxx methods are unclear
versions: Python 2.6

Python tracker <report at bugs.python.org>

More information about the New-bugs-announce mailing list