Document tr///

Author: zoffixznet

doc/Language/operators.pod6

@@ -183,6 +183,19 @@ warning. To execute the substitution on a variable that isn't the C<$_> this
 operator uses, alias it to C<$_> with C<given>, C<with>, or any other way.
 Alternatively, use the L«C<.subst> method|/routine/subst».
 
+=head2 C<tr///> in-place transliteration
+
+    my $str = 'old string';
+    $str ~~ tr/dol/wne/;
+    say $str; # OUTPUT: «new string␤»
+
+Operates on C<$_> topical variable, changing it in place. Behaves similar to
+L«C<Str.trans>|/routine/trans» called with a single L<Pair> argument where
+key is the matching part (characters C<dol> in example above) and value is
+the replacement part (characters C<wne> in the example above). Accepts the
+same adverbs as L«C<Str.trans>|/routine/trans». Returns L<StrDistance> object
+that measures the distance between original value and the resultant string.
+
 =head1 Assignment Operators
 
 Infix operators can be combined with the assignment operator to modify a