[docs] Formatting of True/False in docs (issue 19795)

georg at python.org georg at python.org
Tue Nov 26 18:37:58 CET 2013


Looks good overall, see a few comments.


http://bugs.python.org/review/19795/diff/10113/Doc/library/dis.rst
File Doc/library/dis.rst (right):

http://bugs.python.org/review/19795/diff/10113/Doc/library/dis.rst#newcode272
Doc/library/dis.rst:272: line started by this opcode (if any), otherwise
None
None should also be ``-ified :)  another patch forthcoming?

http://bugs.python.org/review/19795/diff/10113/Doc/library/logging.rst
File Doc/library/logging.rst (right):

http://bugs.python.org/review/19795/diff/10113/Doc/library/logging.rst#newcode163
Doc/library/logging.rst:163: ``False``. If specified as True, stack
information is added to the logging
you missed a True here

http://bugs.python.org/review/19795/diff/10113/Doc/library/logging.rst#newcode881
Doc/library/logging.rst:881: ``False``. If specified as True, stack
information is added to the logging
another True missed

http://bugs.python.org/review/19795/diff/10113/Doc/library/sqlite3.rst
File Doc/library/sqlite3.rst (right):

http://bugs.python.org/review/19795/diff/10113/Doc/library/sqlite3.rst#newcode245
Doc/library/sqlite3.rst:245: can call this function with *flag* as true.
Afterwards, you will get tracebacks
"with flag as true" doesn't sound right -- this could be formulated
differently while you're at it

http://bugs.python.org/review/19795/diff/10113/Doc/reference/datamodel.rst
File Doc/reference/datamodel.rst (right):

http://bugs.python.org/review/19795/diff/10113/Doc/reference/datamodel.rst#newcode203
Doc/reference/datamodel.rst:203: These represent the truth values
``False`` and ``True``.  The two objects representing
this should not be code since it's not talking about the objects, but
the (Platonic ideal) values.

http://bugs.python.org/review/19795/


More information about the docs mailing list