[Python-Dev] PEP 362 Third Revision

[Terry Reedy]

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