[issue11889] 'enumerate' 'start' parameter documentation is confusing

Changes by Raymond Hettinger : -- resolution: -> fixed status: open -> closed ___ Python tracker ___ ___ Python-bugs-list mailing lis

[issue11889] 'enumerate' 'start' parameter documentation is confusing

Roundup Robot added the comment: New changeset d0df12b32522 by Raymond Hettinger in branch '3.2': Issue 11889: Clarify docs for enumerate. http://hg.python.org/cpython/rev/d0df12b32522 New changeset 9b827e3998f6 by Raymond Hettinger in branch 'default': Issue 11889: Clarify docs for enumerate.

[issue11889] 'enumerate' 'start' parameter documentation is confusing

Roundup Robot added the comment: New changeset 0ca8d90b by Raymond Hettinger in branch '2.7': Issue 11889: Clarify docs for enumerate. http://hg.python.org/cpython/rev/0ca8d90b -- nosy: +python-dev ___ Python tracker

[issue11889] 'enumerate' 'start' parameter documentation is confusing

Changes by Raymond Hettinger : -- priority: normal -> low ___ Python tracker ___ ___ Python-bugs-list mailing list Unsubscribe: http:

[issue11889] 'enumerate' 'start' parameter documentation is confusing

Peter Hammer added the comment: """ Changing the 'enumerate' doc string text from: | (0, seq[0]), (1, seq[1]), (2, seq[2]), ... to: | (start, seq[0]), (start+1, seq[1]), (start+2, seq[2]), ... would completely disambiguate the doc string at the modest cost of sixteen additional cha

[issue11889] 'enumerate' 'start' parameter documentation is confusing

Raymond Hettinger added the comment: I've got it from here. Thanks. -- ___ Python tracker ___ ___ Python-bugs-list mailing list Unsu

[issue11889] 'enumerate' 'start' parameter documentation is confusing

Éric Araujo added the comment: +1 to what David says. Terry’s patch is a good starting point; I think Raymond will commit something along its lines. -- nosy: +eric.araujo ___ Python tracker _

[issue11889] 'enumerate' 'start' parameter documentation is confusing

Terry J. Reedy added the comment: Note: 3.x correct gives the signature at enumerate(iterable, start) rather that enumerate(sequence, start). I agree that the current entry is a bit awkward. Perhaps the doc would be clearer with a reference to zipping. Removing the unneeded definition of *it

[issue11889] 'enumerate' 'start' parameter documentation is confusing

Changes by Raymond Hettinger : -- assignee: -> rhettinger components: +Documentation -None nosy: +rhettinger ___ Python tracker ___ _

[issue11889] 'enumerate' 'start' parameter documentation is confusing

R. David Murray added the comment: If you know what an iterator is, the documentation, it seems to me, is clear. That is, an iterator cannot be indexed, so the behavior you expected could not be implemented by enumerate. That doesn't meant the docs shouldn't be improved. An example with a n

[issue11889] 'enumerate' 'start' parameter documentation is confusing

New submission from Peter Hammer : """ A point of confusion using the builtin function 'enumerate' and enlightenment for those who, like me, have been confused. Note, this confusion was discussed at length at http://bugs.python.org/issue2831 prior to the 'start' parameter being added to 'enu