Merge pull request #2806 from perl6/pair-pair-method

Document Pair.Pair method
Thanks! Refs #2632 
(please refer to the issue number in the commit message)

Author: JJ

doc/Type/Pair.pod6

@@ -336,7 +336,7 @@ B<NOTE:> this method is deprecated as of B<6.d> language version. Instead,
 create a new C<Pair>, with a L<decontainerized|/language/glossary#decont> key/value.
 
 =for code :preamble<my $p>
-$p.=Map.=head.say;                # OUTPUT: «orange␤»
+$p.=Map.=head.say;                                    # OUTPUT: «orange␤»
 
 =head2 method Str
 
@@ -350,6 +350,17 @@ as I<key ~ \t ~ value>.
     my $b = eggs => 3;
     say $b.Str;                                       # OUTPUT: «eggs  3␤»
 
+=head2 method Pair
+
+Defined as:
+
+    method Pair()
+
+Returns the invocant Pair object.
+
+    my $pair = eggs => 3;
+    say $pair.Pair === $pair;                         # OUTPUT: «True␤»
+
 =end pod
 
 # vim: expandtab softtabstop=4 shiftwidth=4 ft=perl6