Martin Panter added the comment: 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? ---------- _______________________________________ Python tracker <rep...@bugs.python.org> <http://bugs.python.org/issue28754> _______________________________________ _______________________________________________ Python-bugs-list mailing list Unsubscribe: https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com
