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 r.david.murray
Recipients Patrick Lehmann, docs@python, georg.brandl, lukasz.langa, r.david.murray, terry.reedy
Date 2018-06-18.15:39:04
SpamBayes Score -1.0
Marked as misclassified Yes
Message-id <1529336344.37.0.56676864532.issue28710@psf.upfronthosting.co.za>
In-reply-to
Content
Right, my opinion is that we shouldn't be putting markup in docstrings.  They are (from our point of view) pure text.

I don't know if discussion on python-dev is warranted, it seems like a fairly uncontroversial change, since it brings the docstrings in question into compliance with our general practice in the majority of the stdlib.  Unless my impression about that is wrong :)

I don't have an opinion on multiple versus single PR for this.
History
Date User Action Args
2018-06-18 15:39:04r.david.murraysetrecipients: + r.david.murray, georg.brandl, terry.reedy, docs@python, lukasz.langa, Patrick Lehmann
2018-06-18 15:39:04r.david.murraysetmessageid: <1529336344.37.0.56676864532.issue28710@psf.upfronthosting.co.za>
2018-06-18 15:39:04r.david.murraylinkissue28710 messages
2018-06-18 15:39:04r.david.murraycreate