R. David Murray <rdmur...@bitdance.com> added the comment:

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.

----------

_______________________________________
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