Merge pull request #978 from zostay/splice-callable-args

Resolves #977: Correct callable args on splice

Author: zoffixznet

doc/Type/Array.pod6

@@ -166,13 +166,17 @@ all the elements starting from index C<$start> are deleted.
 
 Each of C<$start> and C<$elems> can be specified as a
 L<Whatever|/type/Whatever> or as a L<Callable|/type/Callable> that returns an
-C<int>-compatible value. A C<Whatever> C<$start> uses the number of elements
+C<int>-compatible value.
+
+A C<Whatever> C<$start> uses the number of elements
 of C<@list> (or invocant). A C<Callable> C<$start> is called with one
 argument—the number of elements in C<@list>—and its return value is used
-as C<$start>. A C<Whatever> C<$elems> deletes from C<$start> to end of
+as C<$start>.
+
+A C<Whatever> C<$elems> deletes from C<$start> to end of
 C<@list> (same as no C<$elems>). A C<Callable> C<$elements> is called with
-two arguments—the number of elements in C<@list> and the value of C<$start>—and its
-return value is used the value of C<$elems>.
+just one argument—the number of elements in C<@list> minus the value of
+C<$start>—and its return value is used the value of C<$elems>.
 
 Example: