Document Pair.ACCEPTS

Fixes #1235

Author: zoffixznet

doc/Type/Pair.pod6

@@ -50,6 +50,37 @@ Any variable can be turned into a C<Pair> of its name and its value.
 
 =head1 Methods
 
+=head2 method ACCEPTS
+
+Defined as:
+
+    multi method ACCEPTS(Pair:D $: %topic)
+    multi method ACCEPTS(Pair:D $: Pair:D $topic)
+    multi method ACCEPTS(Pair:D $: Mu $topic)
+
+If C<topic> is an L<Associative>, looks up the value using invocant's key in
+it and checks invocant's value C<.ACCEPTS> that value:
+
+    say %(:42a) ~~ :42a; # OUTPUT: «True␤»
+    say %(:42a) ~~ :10a; # OUTPUT: «False␤»
+
+If C<topic> is another L<Pair>, checks the invocant's value C<.ACCEPTS> the
+C<topic's> value. Note that the keys are not considered and can be different:
+
+    say :42a ~~ :42a; # OUTPUT: «True␤»
+    say :42z ~~ :42a; # OUTPUT: «True␤»
+    say :10z ~~ :42a; # OUTPUT: «False␤»
+
+If C<topic> is any other value, uses the invocant's key as the name of the
+method to call on C<topic> and check's its L«C<.Bool>|/routine/Bool» is the same
+as C<.Bool> of the invocant's value. This form can be used to check L<Bool> values
+of multiple methods on the same object, such as L<IO::Path>, by using
+L<Junctions|/type/Junction>:
+
+    say "foo" .IO ~~ :f & :rw; # OUTPUT: «False␤»
+    say "/tmp".IO ~~ :!f;      # OUTPUT: «True␤»
+    say "."   .IO ~~ :f | :d;  # OUTPUT: «True␤»
+
 =head2 method antipair
 
 Defined as: