[Python-Dev] PEP 362 Third Revision (original) (raw)

Terry Reedy tjreedy at udel.edu
Thu Jun 14 19:51:59 CEST 2012

On 6/14/2012 6:00 AM, Nick Coghlan wrote:

> Just a thought: Do we want to include the docstring? A function's > docstring is often intimately tied to its signature. (Or at least, a > lot of us try to write docstrings that effectively describe the > function's signature)

No, combining the signature with other details like the name and docstring is the task of higher level interfaces like pydoc.

Idle tooltips are potentially two lines: the signature and the first line of the docstring. (Some builtins need a better first line, but thats another issue.)

-- Terry Jan Reedy

More information about the Python-Dev mailing list