Document List.ACCEPTS

Author: zoffixznet

doc/Type/List.pod6

@@ -84,6 +84,38 @@ Coercion to C<Bool> also indicates if the C<List> got any elements.
 
 =head1 Methods
 
+=head2 method ACCEPTS
+
+Defined as:
+
+    multi method ACCEPTS(List:D: $topic)
+
+If C<$topic> is an L<Iterable>, returns C<True> or C<False> based on whether
+the contents of the two C<Iterables> match. A L<Whatever> element in the
+invocant matches anything in the corresponding position of the C<$topic>
+C<Iterable>. A L<HyperWhatever> matches any number of any elements, including
+no elements:
+
+    say (1, 2, 3)       ~~ (1,  *, 3);  # OUTPUT: «True␤»
+    say (1, 2, 3)       ~~ (9,  *, 5);  # OUTPUT: «False␤»
+    say (1, 2, 3)       ~~ (   **, 3);  # OUTPUT: «True␤»
+    say (1, 2, 3)       ~~ (   **, 5);  # OUTPUT: «False␤»
+    say (1, 3)          ~~ (1, **, 3); # OUTPUT: «True␤»
+    say (1, 2, 4, 5, 3) ~~ (1, **, 3); # OUTPUT: «True␤»
+    say (1, 2, 4, 5, 6) ~~ (1, **, 5); # OUTPUT: «False␤»
+    say (1, 2, 4, 5, 6) ~~ (   **   ); # OUTPUT: «True␤»
+    say ()              ~~ (   **   ); # OUTPUT: «True␤»
+
+In addition, returns C<False> if either the invocant or C<$topic>
+L<is a lazy|/routine/is-lazy> C<Iterable>, unless C<$topic> is the same object
+as the invocant, in which case C<True> is returned.
+
+If C<$topic> is I<not> an L<Iterable>, returns the invocant if the ivocant
+has no elements or its first element is a L<Match> object (this behaviour
+powers C<m:g//> smartmatch), or C<False> otherwise.
+
+=item1 C
+
 =head2 routine elems
 
 Defined as: