[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 rep...@bugs.python.org http://bugs.python.org/issue21727

[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 rep...@bugs.python.org http://bugs.python.org/issue21727 ___

[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

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

2014-06-11 Thread Zachary Ware
Changes by Zachary Ware zachary.w...@gmail.com: -- nosy: +rhettinger versions: -Python 3.1, Python 3.2, Python 3.3 ___ Python tracker rep...@bugs.python.org http://bugs.python.org/issue21727 ___

[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