Fixes antipairs refs #1731

Author: JJ

doc/Type/Any.pod6

@@ -974,14 +974,15 @@ Defined as:
     multi method antipairs(Any:U:)
     multi method antipairs(Any:D:)
 
-Converts the invocant to a L<List|/type/List> via the C<list> method and returns
-the result of L<List.antipairs|/type/List#routine_antipairs> on it. Returns an
-empty L<List|/type/List> if the invocant is undefined:
+Returns an
+empty L<List|/type/List> if the invocant is a type object
 
-    my $a;
-    say $a.antipairs;      # OUTPUT: «()»
-    $a = Any.new;
-    say $a.antipairs;      # OUTPUT: «(Any.new => 0)»
+    Range.antipairs.say; # OUTPUT: «()␤»
+
+If it's a value object, it returns the inverted list of pairs after converting
+it to a list of pairs; the values will become keys and the other way round.
+
+    %(s => 1, t=> 2, u => 3).antipairs.say ;# OUTPUT: «(2 => t 1 => s 3 => u)␤»
 
 =head2 method invert