Copy docstring change from #27511

JuliaLang · Sep 20, 2018 · 6663c8f · 6663c8f
1 parent 8375946
commit 6663c8f
Showing 1 changed file with 5 additions and 2 deletions.
diff --git a/base/iterators.jl b/base/iterators.jl
@@ -267,8 +267,11 @@ end
 """
     zip(iters...)
 
-For a set of iterable objects, return an iterable of tuples, where the `i`th tuple contains
-the `i`th component of each input iterable.
+Run multiple iterators at the same time, until any of them is exhausted. The value type of
+the `zip` iterator is a tuple of values of its subiterators.
+
+Note: `zip` orders the calls to its subiterators in such a way that stateful iterators will
+not advance when another iterator finishes in the current iteration.
 
 # Examples
 ```jldoctest