Document .skip(WhateverCode)

Author: lizmat

doc/Type/Any.pod6

@@ -562,9 +562,10 @@ Defined As:
 Creates a Seq from 1-item list's iterator and uses
 L«C<Seq.skip>|/type/List#method_skip» on it.
 
-    say Any.skip;     # OUTPUT: «()␤»
-    say Any.skip(5);  # OUTPUT: «()␤»
-    say Any.skip(-1); # OUTPUT: «((Any))␤»
+    say Any.skip;      # OUTPUT: «()␤»
+    say Any.skip(5);   # OUTPUT: «()␤»
+    say Any.skip(-1);  # OUTPUT: «((Any))␤»
+    say Any.skip(*-1); # OUTPUT: «((Any))␤»
 
 =head2 method prepend
 

doc/Type/Seq.pod6

@@ -125,15 +125,16 @@ Defined As:
     multi method skip(Int() $n = 1 --> Seq)
 
 Returns a Seq containing whatever is left of the invocant after
-throwing away C<$n> of the next available values.  May (and
-probably will) return the invocant itself.  Negative values of
-C<$n> count as 0.  Will block on lazy Seqs until the requested
+throwing away C<$n> of the next available values. Negative values of
+C<$n> count as 0.  Also can take a WhateverCode to indicate how many values
+to skip from the end.  Will block on lazy Seqs until the requested
 number of values have been discarded.
 
-    say (1..5).map({$_}).skip;     # OUTPUT: «(2,3,4,5)␤»
-    say (1..5).map({$_}).skip(3);  # OUTPUT: «(4,5)␤»
-    say (1..5).map({$_}).skip(5);  # OUTPUT: «()␤»
-    say (1..5).map({$_}).skip(-1); # OUTPUT: «(1,2,3,4,5)␤»
+    say (1..5).map({$_}).skip;      # OUTPUT: «(2,3,4,5)␤»
+    say (1..5).map({$_}).skip(3);   # OUTPUT: «(4,5)␤»
+    say (1..5).map({$_}).skip(5);   # OUTPUT: «()␤»
+    say (1..5).map({$_}).skip(-1);  # OUTPUT: «(1,2,3,4,5)␤»
+    say (1..5).map({$_}).skip(*-3); # OUTPUT: «(3,4,5)␤»
 
 =end pod