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 serhiy.storchaka
Recipients Patrick Lehmann, docs@python, georg.brandl, lukasz.langa, r.david.murray, serhiy.storchaka, terry.reedy
Date 2018-06-18.16:29:59
SpamBayes Score -1.0
Marked as misclassified Yes
Message-id <1529339399.99.0.56676864532.issue28710@psf.upfronthosting.co.za>
In-reply-to
Content
What is the problem? Docstrings are not written in the reStructuredText format in general. If Sphinx complains about docstrings in the stlib, don't run Sphinx for the stdlib files or report a Sphinx bug. Even if remove all `x', docstrings still will not be valid reStructuredText. For example the last three lines will be joined in a single paragraph for the docstring in msg319848.

`name' does not have special meaning in (La)TeX. AFAIK `name' is common writing of quotes in English texts. It predates reStructuredText and was widely used in Usenet and mailing lists (as two spaces after sentence-ending punctuation, double hyphen for a dash, _n_a_m_e_ to simulate underscoring, etc). It is just a part of old computer-typing culture (or may be even pre-computer).
History
Date User Action Args
2018-06-18 16:30:00serhiy.storchakasetrecipients: + serhiy.storchaka, georg.brandl, terry.reedy, r.david.murray, docs@python, lukasz.langa, Patrick Lehmann
2018-06-18 16:29:59serhiy.storchakasetmessageid: <1529339399.99.0.56676864532.issue28710@psf.upfronthosting.co.za>
2018-06-18 16:29:59serhiy.storchakalinkissue28710 messages
2018-06-18 16:29:59serhiy.storchakacreate