Issue #23695: Explain the zip() example for clustering a data series into n-length...

diff --git a/Doc/library/functions.rst b/Doc/library/functions.rst
index e982ceb0b90e7100d21bcb9f66e487088faa3510..1321c7a4ca0ab9aadf9774c20dac43c0fb6ef661 100644 (file)
--- a/Doc/library/functions.rst
+++ b/Doc/library/functions.rst
@@ -1492,7 +1492,9 @@ are always available.  They are listed here in alphabetical order.
 
    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