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.

classification
Title: Doctest ELLIPSIS explanation hard to follow when they're missing
Type: enhancement Stage:
Components: Documentation Versions: Python 3.9
process
Status: open Resolution:
Dependencies: Superseder:
Assigned To: docs@python Nosy List: Tim.Hatch, docs@python
Priority: normal Keywords:

Created on 2021-03-31 05:31 by Tim.Hatch, last changed 2022-04-11 14:59 by admin.

Messages (1)
msg389874 - (view) Author: Tim Hatch (Tim.Hatch) * Date: 2021-03-31 05:31
The doctest docs try to explain directives like ELLIPSIS but those directives are absent from the rendered html.

Where?

Most of the code blocks in the Directives section, and https://docs.python.org/3/library/doctest.html#directives and the one introduced by "nice approach" subsequently are missing their directive comments.

The docs today say they go with Python 3.9.2 generated by Sphinx 2.4.4.  I haven't tried generating them manually, but it appears the `pycon` lexer for Pygments handles these fine, so I assume it's a problem in reST.
History
Date User Action Args
2022-04-11 14:59:43adminsetgithub: 87842
2021-03-31 05:31:48Tim.Hatchcreate