Message281717
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? |
|
Date |
User |
Action |
Args |
2016-11-25 13:35:20 | martin.panter | set | recipients:
+ martin.panter, rhettinger, vstinner, larry, mdk |
2016-11-25 13:35:20 | martin.panter | set | messageid: <1480080920.72.0.915421735565.issue28754@psf.upfronthosting.co.za> |
2016-11-25 13:35:20 | martin.panter | link | issue28754 messages |
2016-11-25 13:35:20 | martin.panter | create | |
|