http://bugs.python.org/review/22725/diff/13194/Doc/library/functions.rst File Doc/library/functions.rst (right): http://bugs.python.org/review/22725/diff/13194/Doc/library/functions.rst#new... Doc/library/functions.rst:361: Return an enumerate object which when :term`iterated <iterable>` yields a On 2014/11/03 07:44:04, ezio.melotti wrote:

"which when iterated" sounds a bit weird to me. Would it be better if commas were added before and after "when iterated"?

The link to "iterable" could also be moved to "enumerate object", even

It sounds weird to me with the commas, but I think this is a grey area in English and I have no objection to changing it. (In my mind the 'when iterated' is an essential part of the clause and not a separate clause, but I'm not sure that's meaningful.) though it

might be somewhat misleading if one expects it to link to the documentation of the actual enumerate object.

I don't see that that would be clearer. http://bugs.python.org/review/22725/