[issue21727] Ambiguous sentence explaining `cycle` in itertools documentation

2014-06-12 Thread Raymond Hettinger
Raymond Hettinger added the comment: That's why the code example is there ;-) -- resolution: -> not a bug status: open -> closed ___ Python tracker ___ _

[issue21727] Ambiguous sentence explaining `cycle` in itertools documentation

2014-06-12 Thread Matt Deacalion Stevens
Matt Deacalion Stevens added the comment: It's probably just me then. The code example is what helped me grasp `cycle`, not the explanation. -- ___ Python tracker ___ __

[issue21727] Ambiguous sentence explaining `cycle` in itertools documentation

2014-06-11 Thread Raymond Hettinger
Raymond Hettinger added the comment: I see no real difference here and AFAICT the current wording has not caused any confusion since it was written a decade ago. -- assignee: docs@python -> rhettinger priority: normal -> low ___ Python tracker

[issue21727] Ambiguous sentence explaining `cycle` in itertools documentation

2014-06-11 Thread Zachary Ware
Changes by Zachary Ware : -- nosy: +rhettinger versions: -Python 3.1, Python 3.2, Python 3.3 ___ Python tracker ___ ___ Python-bugs-l

[issue21727] Ambiguous sentence explaining `cycle` in itertools documentation

2014-06-11 Thread Matt Deacalion Stevens
New submission from Matt Deacalion Stevens: https://docs.python.org/3.5/library/itertools.html#itertools.cycle The first sentence sounds a bit ambiguous: "Make an iterator returning elements from the iterable and saving a copy of each." Suggestion: "Make an iterator that returns elements from