Author rhettinger
Recipients docs@python, ethan.furman, ezio.melotti, georg.brandl, r.david.murray, rhettinger, terry.reedy, vy0123
Date 2014-11-01.01:04:22
SpamBayes Score -1.0
Marked as misclassified Yes
Message-id <1414803862.16.0.552820399567.issue22725@psf.upfronthosting.co.za>
In-reply-to
Content
The "sequence" parameter name is an unfortunate hold-over from olden times were many things that accepted iterables were marked as taking sequences.

This was fixed in Python 3, but it can't be changed in Py2.7 because the parameter name is exposed as a keyword argument:

    >>> list(enumerate(sequence='abc', start=2))
    [(2, 'a'), (3, 'b'), (4, 'c')]

The rest docs for Python 2.7 read just fine, "Return an enumerate object. sequence must be a sequence, an iterator, or some other object which supports iteration."   I think that is sufficient to clarify any confusion caused by the unfortunate choice of keyword argument name.
History
Date User Action Args
2014-11-01 01:04:22rhettingersetrecipients: + rhettinger, georg.brandl, terry.reedy, ezio.melotti, r.david.murray, docs@python, ethan.furman, vy0123
2014-11-01 01:04:22rhettingersetmessageid: <1414803862.16.0.552820399567.issue22725@psf.upfronthosting.co.za>
2014-11-01 01:04:22rhettingerlinkissue22725 messages
2014-11-01 01:04:22rhettingercreate