diff -r 16dfefe67c1f Doc/library/functions.rst --- a/Doc/library/functions.rst Sun Nov 02 19:08:35 2014 +0200 +++ b/Doc/library/functions.rst Sun Nov 02 13:04:28 2014 -0500 @@ -366,11 +366,13 @@ .. function:: enumerate(sequence, start=0) - Return an enumerate object. *sequence* must be a sequence, an - :term:`iterator`, or some other object which supports iteration. The - :meth:`!next` method of the iterator returned by :func:`enumerate` returns a - tuple containing a count (from *start* which defaults to 0) and the - values obtained from iterating over *sequence*:: + + Return an enumerate object which when :term`iterated ` yields a + two element :ref:`typesseq-tuple ` for each element in *sequence*, + each tuple consisting of the sequence number of the element (beginning with + *start*, which defaults to ``0``) paired with the element itself. + *sequence* must be a sequence, an iterator, or some other object which + supports iteration. >>> seasons = ['Spring', 'Summer', 'Fall', 'Winter'] >>> list(enumerate(seasons)) diff -r 16dfefe67c1f Objects/enumobject.c --- a/Objects/enumobject.c Sun Nov 02 19:08:35 2014 +0200 +++ b/Objects/enumobject.c Sun Nov 02 13:04:28 2014 -0500 @@ -159,12 +159,14 @@ } PyDoc_STRVAR(enum_doc, -"enumerate(iterable[, start]) -> iterator for index, value of iterable\n" +"enumerate(sequence[, start]) -> iterator for index, value of iterable\n" "\n" -"Return an enumerate object. iterable must be another object that supports\n" -"iteration. The enumerate object yields pairs containing a count (from\n" -"start, which defaults to zero) and a value yielded by the iterable argument.\n" -"enumerate is useful for obtaining an indexed list:\n" +"Return an enumerate object which when iterated yields a two element tuple\n" +"for each element in sequence, each tuple consisting of the sequence\n" +"number of the element (beginning with start, which defaults to zero)\n" +"paired with the element itself. sequence must be a sequence, an\n" +"iterator, or some other object which supports iteration. enumerate is\n" +"useful for obtaining an indexed list:\n" " (0, seq[0]), (1, seq[1]), (2, seq[2]), ..."); PyTypeObject PyEnum_Type = {