[Python-checkins] cpython: Issue #23695: Explain the zip() example for clustering a data series into

[raymond.hettinger]

https://hg.python.org/cpython/rev/f7d82e40e472
changeset:   96015:f7d82e40e472
user:        Raymond Hettinger <python at rcn.com>
date:        Wed May 13 02:34:38 2015 -0700
summary:
  Issue #23695:  Explain the  zip() example for clustering a data series into n-length groups.

files:
  Doc/library/functions.rst |  4 +++-
  1 files changed, 3 insertions(+), 1 deletions(-)


diff --git a/Doc/library/functions.rst b/Doc/library/functions.rst
--- a/Doc/library/functions.rst
+++ b/Doc/library/functions.rst
@@ -1492,7 +1492,9 @@
 
    The left-to-right evaluation order of the iterables is guaranteed. This
    makes possible an idiom for clustering a data series into n-length groups
-   using ``zip(*[iter(s)]*n)``.
+   using ``zip(*[iter(s)]*n)``.  This repeats the *same* iterator ``n`` times
+   so that each output tuple has the result of ``n`` calls to the iterator.
+   This has the effect of dividing the input into n-length chunks.
 
    :func:`zip` should only be used with unequal length inputs when you don't
    care about trailing, unmatched values from the longer iterables.  If those

-- 
Repository URL: https://hg.python.org/cpython