Author terry.reedy
Recipients cheryl.sabella, chris.jerdonek, python-dev, rhettinger, roger.serwy, serhiy.storchaka, terry.reedy
Date 2019-01-17.20:29:44
SpamBayes Score -1.0
Marked as misclassified Yes
Message-id <1547756984.35.0.13069523125.issue16638@roundup.psfhosted.org>
In-reply-to
Content
The standard calltip box is two lines: signature and docstring header.  In most cases, such as int, iter, and min, the effect of this patch is to get both lines of a docstring signature, so the result is not abnormally big.  And I agree with Serhiy that getting even more lines, when needed, is a bug fix.  (My change to 'enhancement' was in respect to Raymond's proposal, hence the reversion.)

Bytes is one of the very few functions with more than two header lines, and exceptional at 5.  It could be reduced to 4 if the first and last were combined as done for other functions.  I don't want to add an option or special code for this special case.

#19903 expands the calltip by 2 lines when the signature includes '/'.  This is increasingly common as more builtins get processed by Argument Clinic. I opened #35763 to revisit and revise this behavior.
History
Date User Action Args
2019-01-17 20:29:46terry.reedysetrecipients: + terry.reedy, rhettinger, roger.serwy, chris.jerdonek, python-dev, serhiy.storchaka, cheryl.sabella
2019-01-17 20:29:44terry.reedysetmessageid: <1547756984.35.0.13069523125.issue16638@roundup.psfhosted.org>
2019-01-17 20:29:44terry.reedylinkissue16638 messages
2019-01-17 20:29:44terry.reedycreate