diff -r 4924b0ce72c0 Doc/library/functions.rst --- a/Doc/library/functions.rst Sun Nov 02 12:32:26 2014 -0500 +++ b/Doc/library/functions.rst Sun Nov 02 13:04:18 2014 -0500 @@ -358,11 +358,12 @@ .. function:: enumerate(iterable, start=0) - Return an enumerate object. *iterable* must be a sequence, an - :term:`iterator`, or some other object which supports iteration. - The :meth:`~iterator.__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 *iterable*. + Return an enumerate object which when :term`iterated ` yields a + two element :ref:`typesseq-tuple ` for each element in *iterable*, + each tuple consisting of the sequence number of the element (beginning with + *start*, which defaults to ``0``) paired with the element itself. + *iterable* must be a sequence, an iterator, or some other object which + supports iteration. >>> seasons = ['Spring', 'Summer', 'Fall', 'Winter'] >>> list(enumerate(seasons)) diff -r 4924b0ce72c0 Objects/enumobject.c --- a/Objects/enumobject.c Sun Nov 02 12:32:26 2014 -0500 +++ b/Objects/enumobject.c Sun Nov 02 13:04:18 2014 -0500 @@ -177,10 +177,12 @@ PyDoc_STRVAR(enum_doc, "enumerate(iterable[, 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 iterable, each tuple consisting of the sequence\n" +"number of the element (beginning with start, which defaults to zero)\n" +"paired with the element itself. iterable 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 = {