Author serhiy.storchaka
Recipients docs@python, rhettinger, serhiy.storchaka
Date 2017-08-09.07:42:39
SpamBayes Score -1.0
Marked as misclassified Yes
Message-id <1502264559.87.0.404253644107.issue31153@psf.upfronthosting.co.za>
In-reply-to
Content
Docstrings of some itertools functions look outdated.

1. The docstring of groupby() contains the signature "groupby(iterable[, keyfunc])". But groupby() supports keyword arguments, the name of the second parameter is "key", and its default value is None.

2. accumulate() accepts None as the second argument.

3. The equivalent code of count() has the first parameter "firstval" instead of "start". It uses the "while 1" loop instead of more idiomatic in Python 3 "while True".

4. The term "sequence" is used in the docstring of starmap(), while actually an iterable is accepted. Compare with the docstring of map(). See also issue31082.
History
Date User Action Args
2017-08-09 07:42:39serhiy.storchakasetrecipients: + serhiy.storchaka, rhettinger, docs@python
2017-08-09 07:42:39serhiy.storchakasetmessageid: <1502264559.87.0.404253644107.issue31153@psf.upfronthosting.co.za>
2017-08-09 07:42:39serhiy.storchakalinkissue31153 messages
2017-08-09 07:42:39serhiy.storchakacreate