Terry J. Reedy <tjre...@udel.edu> added the comment:

RestructuredText, DocUtils, and Sphinx were developed independently, by people 
other than the pydev/cpython group.  (The proposal to include DocUtils in the 
stdlib was rejected.)  We converted to .rst for the Python documentation 
sources files about a decade ago.  Sphinx turns them into the .html files you 
can see online.  RestructuredText markup can now also be used in PEP, 
news/changelog, and What's New sources.  These are things that most people only 
view online or in other processed forms, not in source form.

On the other hand, stdlib docstrings are mostly viewed unprocessed in .py 
sources or as output from help() in text consoles or text widgets.  So markup 
in stdlib docstrings would impact everyone, not just core developers.

----------

_______________________________________
Python tracker <rep...@bugs.python.org>
<https://bugs.python.org/issue28710>
_______________________________________
_______________________________________________
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

Reply via email to