This issue tracker has been migrated to GitHub, and is currently read-only.
For more information, see the GitHub FAQs in the Python's Developer Guide.

Author martin.panter
Recipients larry, martin.panter, mdk, rhettinger, vstinner
Date 2016-11-25.13:35:20
SpamBayes Score -1.0
Marked as misclassified Yes
Message-id <1480080920.72.0.915421735565.issue28754@psf.upfronthosting.co.za>
In-reply-to
Content
Taking the first function, bisect_right(), as an example, I see these differences:

* bisect_right(a, x[, lo[, hi]]) -> index
This signature is removed. I think removing it is reasonable, because pydoc can extract the proper signature from the Arg Clinic metadata.

* Additional descriptions of each parameter. I tend to think these are redundant with the main text, so agree with removing them from the patch now.

* Addition of full stop (.) at end of first paragraph. I suggested this as a minor cleanup, but it could be fixed later if you prefer.

* Removal of default values in last paragraph. The first is redundant with the Arg Clinic signature, so I suggested to remove it. For the second, I would add it back if we remove the list of parameters, since it explains what the special value -1 means.

Do you want to revert all these differences?
History
Date User Action Args
2016-11-25 13:35:20martin.pantersetrecipients: + martin.panter, rhettinger, vstinner, larry, mdk
2016-11-25 13:35:20martin.pantersetmessageid: <1480080920.72.0.915421735565.issue28754@psf.upfronthosting.co.za>
2016-11-25 13:35:20martin.panterlinkissue28754 messages
2016-11-25 13:35:20martin.pantercreate