[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-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