Attempt to document Pair.invert

gistfile1.txt

=head2 method invert

Defined as:

    method invert(Pair:D:)

Usage:

    PAIR.invert

Returns a new C<Pair> object with key and value exchanged, just like
L<antipair|/type/Pair#method_antipair>, unless the value of the invocant does
the L<Iterable|/type/Iterable> role. In the latter case an C<Iterable> structure
of C<Pair>s is returned since C<invert> expands iterable values into multiple
pairs.

    my Pair $p1 = (6 => 'Perl');
    say $p1.invert;                                   # Perl => 6
    say $p1.invert.WHAT;                              # (Pair)

    my Pair $p2 = ('Perl' => (5, 6));
    say $p2.invert;                                   # (5 => Perl 6 => Perl)
    say $p2.invert.WHAT;                              # (List)
    
    my Pair $p3 = ('Perl' => { cool => 'language'});
    say $p3.invert;                                   # {cool => language => Perl}
    say $p3.invert.WHAT;                              # (Hash)