Attempt to document List.Capture

gistfile1.txt

=head2 method Capture

Defined as:

    method Capture() returns Capture:D

Usage:

    LIST.Capture

Returns a L<Capture|/type/Capture> where each L<Pair|/type/Pair>, if any, in
the C<List> has been converted to a named argument. All other elements in the
C<List> are converted to positional arguments in the order they are found,
i.e. the first non pair item in the list becomes the first positional argument,
the second non pair item becomes the second positional argument etc.

    my $list = (7, 5, a => 2, b => 17);
    my $capture = $list.Capture;
    my-sub(|$capture);                                # 7, 5, 2, 17

    sub my-sub($first, $second, :$a, :$b) {
        say "$first, $second, $a, $b"
    }