Merge pull request #2902 from chloekek/infix-z-clarify

Clarify infix Z behavior

Author: JJ

doc/Language/operators.pod6

@@ -2780,14 +2780,16 @@ other positions, it's a syntax error.
 
     sub infix:<Z>(**@lists --> Seq:D) is assoc<chain>
 
-The X<Zip operator> interleaves the lists passed to C<Z> like a zipper, stopping
-as soon as the first input list is exhausted. The returned C<Seq> contains a
-nested list with values for all C<Z> operators in a chain.
+The X<Zip operator> interleaves the lists passed to C<Z> like a zipper,
+taking index-corresponding elements from each operand. The returned C<Seq>
+contains nested lists, each with a value from every operand in the chain. If
+one of the operands runs out of elements prematurely, the zip operator will
+stop.
 
 =for code
 say (1, 2 Z <a b c> Z <+ ->).perl;
 # OUTPUT: «((1, "a", "+"), (2, "b", "-")).Seq␤»
-for <a b c> Z <1 2 3> -> [$l, $r] {
+for <a b c> Z <1 2 3 4> -> [$l, $r] {
     say "$l:$r"
 }
 # OUTPUT: «a:1␤b:2␤c:3␤»