Message129251
[Éric Araujo]
> +"L.clear() -> None -- remove all items from L");
> It looks like other methods that return None
> just omit the “-> type” part.
These kind of nitty comments really aren't helpful.
It consumes more time to talk about them than they're worth.
In this case, Eli was modeling after the docstring in dictobject.c:
PyDoc_STRVAR(clear__doc__,
"D.clear() -> None. Remove all items from D.");
Just because list.remove.__doc__ failed to consistently follow that convention doesn't make Eli's patch incorrect. |
|
Date |
User |
Action |
Args |
2011-02-24 07:01:19 | rhettinger | set | recipients:
+ rhettinger, georg.brandl, terry.reedy, ncoghlan, eric.smith, giampaolo.rodola, eric.araujo, Retro, eli.bendersky, brian.curtin, ysj.ray, xuanji |
2011-02-24 07:01:19 | rhettinger | set | messageid: <1298530879.52.0.787690016686.issue10516@psf.upfronthosting.co.za> |
2011-02-24 07:01:18 | rhettinger | link | issue10516 messages |
2011-02-24 07:01:18 | rhettinger | create | |
|