Author rhettinger
Recipients Retro, brian.curtin, eli.bendersky, eric.araujo, eric.smith, georg.brandl, giampaolo.rodola, ncoghlan, rhettinger, terry.reedy, xuanji, ysj.ray
Date 2011-02-24.07:01:18
SpamBayes Score 1.38702e-06
Marked as misclassified No
Message-id <1298530879.52.0.787690016686.issue10516@psf.upfronthosting.co.za>
In-reply-to
Content
[É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.
History
Date User Action Args
2011-02-24 07:01:19rhettingersetrecipients: + 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:19rhettingersetmessageid: <1298530879.52.0.787690016686.issue10516@psf.upfronthosting.co.za>
2011-02-24 07:01:18rhettingerlinkissue10516 messages
2011-02-24 07:01:18rhettingercreate