[issue15580] fix True/False/None reST markup

R. David Murray report at bugs.python.org
Fri Feb 8 17:10:40 CET 2013


R. David Murray added the comment:

They should be capitalized and marked up as code if they refer to the objects.  If they refer only to (to use bad english) the truthiness or falsiness of the value in question, then they should be lower case and not marked up as code.  Quickly scanning the start of the patch in 17074, about half the changes to true/false markup were incorrect.

Ideally we should never have True unless it is marked up as ``True`` (same for False), but there are *many* cases in the docs where true or false is correct.  My guess would be that those cases outnumber the cases where ``True`` or ``False`` is correct, but I haven't tried to measure :)

----------

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue15580>
_______________________________________


More information about the Python-bugs-list mailing list