Message219204
| Author |
terry.reedy |
| Recipients |
chris.jerdonek, python-dev, rhettinger, roger.serwy, serhiy.storchaka, terry.reedy |
| Date |
2014年05月27日.06:05:52 |
| SpamBayes Score |
-1.0 |
| Marked as misclassified |
Yes |
| Message-id |
<1401170753.13.0.599052756898.issue16638@psf.upfronthosting.co.za> |
| In-reply-to |
| Content |
As I said previously, the only reason for the change was get all the docstring signature lines for builtins, after they were changed from 1 to many. I was not thrilled with having to do this. However, I felt that just presenting the arbitrary first of many lines was (and would be) a bug.
For 3.4+, this is a temporary measure until Argument Clinic is applied to enough builtins to make it sensible to switch calltips to using str(inspect.signature). See #19903. When A.C. is applied to a function, the signature is no longer in the docstring, which instead starts with 'Returns (or whatever) just as for python-coded functions.
Since A.C. and #19903 do not apply to 2.7, feel free to develop a more permanent alternative for 2.7. Perhaps just say <expand multiple line signature> and have a click on that line do the expansion instead of dismissing the box.
If you do, I can check whether the A.C conversion has been slow enough to make temporary application to 3.4 worthwhile, or if *really* slow, to 3.5. The click idea, while still needed, might be combined with using .signature, but I have to recheck its current behavior. |
|