Merge pull request #1460 from dmaestro/xor-operator

Add documentation of loose xor operator

Author: coke

doc/Language/operators.pod6

@@ -2264,7 +2264,7 @@ behaviour:
 
 =head2 infix C«or»
 
-Same as C<infix ||>, except with looser precedence.
+Same as L<infix C<||>|#infix || >, except with looser precedence.
 
 Returns the first argument that evaluates to C<True> in boolean context,
 or otherwise the last argument, it short-circuits. Please note that C<or> is easy
@@ -2301,6 +2301,20 @@ while a L<Failure> never is:
     meows-processor3;           # OUTPUT: «something's wrong␤»
     meows-processor3;           # OUTPUT: «🐱␤»
 
+=head2 infix C«xor»
+
+Same as L<infix C<^^>|#infix ^^>, except with looser precedence.
+
+Returns the operand that evaluates to C<True> in boolean context, if and
+only if the other operand evaluates to C<False> in boolean context. If
+both operands evaluate to C<False>, returns the last argument. If both
+operands evalute to C<True>, returns C<Nil>.
+
+When chaining, returns the operand that evaluates to C<True>, if and
+only if there is one such operand. If more than one operand is true,
+it short-cicuits after evaluating the second and returns C<Nil>. If all
+operands are false, returns the last one.
+
 =head1 Sequencer Precedence
 
 =head2 infix C«==>»