Document Mu.not

Author: paultcochrane

lib/Type/Mu.pod

@@ -269,6 +269,28 @@ that is B<so>, then do this thing".  For instance,
         say "Verbose option detected in arguments";
     } #-> Verbose option detected in arguments
 
+=head2 method not
+
+    method not()
+
+Returns a C<Bool> value representing the logical negation of an expression.
+Thus it is the opposite of C<so>.
+
+    my @args = <-a -e -b>;
+    my $verbose-selected = any(@args) eq '-v' | '-V';
+    if $verbose-selected.not {
+        say "Verbose option not present in arguments";
+    } #-> Verbose option not present in arguments
+
+Since there is also a prefix version of C<not>, the above code reads better
+like so:
+
+    my @args = <-a -e -b>;
+    my $verbose-selected = any(@args) eq '-v' | '-V';
+    if not $verbose-selected {
+        say "Verbose option not present in arguments";
+    } #-> Verbose option not present in arguments
+
 =end pod
 
 # vim: expandtab shiftwidth=4 ft=perl6