Message281717
| 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: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 |
|