Clarify the status of "skip"

Also handle .skip(*) specifically and add more tests

README.md

@@ -322,6 +322,15 @@ rotor
 
 **Status**: an optimized version of the [`.rotor`](https://docs.raku.org/type/List#routine_rotor) method has been implemented for the single argument non-`Pair` case. All other cases are basically too complicated to hyper, and therefore have no specific hypering logic.
 
+skip
+----
+
+**Status**: the simple cases of `.skip()` and `.skip(N)` are handled by skipping that amount on the result iterator and returning the invocant.
+
+The case of `.skip(*)` is handled by stopping any production of values and returning an empty `Seq`.
+
+The nature of the other types of arguments on the [`.skip`](https://docs.raku.org/type/Seq#method_skip) method basically makes it impossible to hyper. Therefore, **no** specific hypering logic has been added for these cases.
+
 slice
 -----
 

doc/ParaSeq.rakudoc

@@ -407,6 +407,20 @@ has been implemented for the single argument non-C<Pair> case.  All
 other cases are basically too complicated to hyper, and therefore
 have no specific hypering logic.
 
+=head2 skip
+
+B<Status>: the simple cases of C<.skip()> and C<.skip(N)> are
+handled by skipping that amount on the result iterator and returning
+the invocant.
+
+The case of C<.skip(*)> is handled by stopping any production of
+values and returning an empty C<Seq>.
+
+The nature of the other types of arguments on the
+L<C<.skip>|https://docs.raku.org/type/Seq#method_skip> method
+basically makes it impossible to hyper.  Therefore, B<no> specific
+hypering logic has been added for these cases.
+
 =head2 slice
 
 B<Status>: the nature of the

lib/ParaSeq.rakumod

@@ -1572,6 +1572,10 @@ class ParaSeq does Sequence {
         self.iterator.skip-at-least($what);
         self
     }
+    multi method skip(ParaSeq:D: Whatever) {
+        self.stop;
+        self!pass-the-chain: Rakudo::Iterator.Empty
+    }
     multi method skip(ParaSeq:D: |c) {
         self!pass-the-chain: self.Seq.skip(|c).iterator
     }

t/06-skip.rakutest

@@ -2,7 +2,7 @@ use v6.*;  # need v6.e semantics of .skip
 use Test;
 use ParaSeq;
 
-plan 16;
+plan 20;
 
 my constant $elems = 200000;
 my constant $batch = 16;
@@ -12,6 +12,7 @@ my constant $skip   = @list.skip.List;
 my constant $skip3  = @list.skip(3).List;
 my constant $skipw3 = @list.skip(*-3).List;
 my constant $skip34 = @list.skip(3,4).List;
+my constant $skipW  = @list.skip(*).List;
 
 for 1, ParaSeq.default-degree {
     my $seq := @list.&hyperize($batch, $_).skip;
@@ -29,6 +30,10 @@ for 1, ParaSeq.default-degree {
     $seq := @list.&hyperize($batch, $_).skip(3,4);
     isa-ok $seq, $_ == 1 ?? Seq !! ParaSeq;
     is-deeply $seq.List, $skip34, "skip(3,4) with degree = $_";
+
+    $seq := @list.&hyperize($batch, $_).skip(*);
+    isa-ok $seq, $_ == 1 ?? Seq !! ParaSeq;
+    is-deeply $seq.List, $skipW, "skip(*) with degree = $_";
 }
 
 # vim: expandtab shiftwidth=4