Raymond Hettinger added the comment: Pydoc isn't the only tool for looking at docstrings.
I'm worried that you're systematically killing-off useful docstrings because of a world view that all tools will use pydoc and signatures. As a result, IDLE's tooltips are now useless (this comes up every single day when I teach python courses). BPython is thrown-off, etc. Here's one of many problem examples of the docstring losing information: Python 3.4.4 (v3.4.4:737efcadf5a6, Dec 19 2015, 20:38:52) [GCC 4.2.1 (Apple Inc. build 5666) (dot 3)] on darwin Type "help", "copyright", "credits" or "license" for more information. >>> print(sorted.__doc__) sorted(iterable, key=None, reverse=False) --> new sorted list >>> print(sorted.__doc__) Return a new list containing all items from the iterable in ascending order. A custom key function can be supplied to customize the sort order, and the reverse flag can be set to request the result in descending order. ---------- _______________________________________ Python tracker <rep...@bugs.python.org> <http://bugs.python.org/issue30959> _______________________________________ _______________________________________________ Python-bugs-list mailing list Unsubscribe: https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com