SylvainDe added the comment:
Regarding the `sorted.__doc__` issue, it seems like the signature does not
appear in the `__doc__` member but it does appear when using `help(sorted)`
which is probably what really matters.
In any case, I find PEP 257 about this part a bit ambiguous : "The one-line
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
New submission from Serhiy Storchaka:
The docstring of namedtuple class starts with the signature of the constructor.
But pydoc now outputs the signature of the constructor for classes (see
issue29338). As a result, the signature is duplicated in the output.
For example:
$ ./python -m pydoc f