[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
___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com



[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
___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com



[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 the iterable and saves a copy of 
each.

--
assignee: docs@python
components: Documentation
messages: 220298
nosy: Matt.Deacalion.Stevens, docs@python
priority: normal
severity: normal
status: open
title: Ambiguous sentence explaining `cycle` in itertools documentation
versions: Python 2.7, Python 3.1, Python 3.2, Python 3.3, Python 3.4, Python 3.5

___
Python tracker rep...@bugs.python.org
http://bugs.python.org/issue21727
___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com



[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
___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com



[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 rep...@bugs.python.org
http://bugs.python.org/issue21727
___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com