Merge pull request #1717 from 0/regex

Minor adjustments

Author: tisonkun

doc/Language/regexes.pod6

@@ -523,13 +523,12 @@ string of non-whitespace characters.
 
 =head1 X<Longest Alternation: C<|>|regex,|>
 
-In short, in regexes branches separated by C<|>, the longest token match wins,
-independent of the textual ordering in the regexes. However, what C<|> really
+In short, in regex branches separated by C<|>, the longest token match wins,
+independent of the textual ordering in the regex. However, what C<|> really
 does is more than that.
-
-C<|> does not decide which branch to win after finishing the whole match,
-but follows the L<longest token match, for short, LTM|
-https://design.perl6.org/S05.html#Longest-token_matching> strategy.
+It does not decide which branch wins after finishing the whole match,
+but follows the L<longest-token matching (LTM) strategy|
+https://design.perl6.org/S05.html#Longest-token_matching>.
 
 Briefly, what C<|> does is this:
 

doc/Language/traps.pod6

@@ -593,17 +593,15 @@ say %h.perl
 
 =head2 C«<{$x}>» vs C«$($x)»: Implicit EVAL
 
-Sometimes you may need to match a generated string in a regex. The
-right way to do it is to use C<$(…)> or C«<{…}>» syntax.
+Sometimes you may need to match a generated string in a regex. This can be done
+using C<$(…)> or C«<{…}>» syntax:
 
 =for code
 my $x = ‘ailemac’;
 say ‘I ♥ camelia’ ~~ / $($x.flip) /; # OUTPUT: «｢camelia｣␤»
-my $x = ‘ailemac’;
 say ‘I ♥ camelia’ ~~ / <{$x.flip}> /; # OUTPUT: «｢camelia｣␤»
 
-However, there is a wrong way to write it, and the problem is that
-it works I<sometimes>.
+However, the latter only works I<sometimes>.
 
 Internally C«<{…}>» EVAL-s the given string inside an anonymous regex, while
 C<$(…)> lexically interpolates the given string. So C«<{…}>» immediately breaks
@@ -613,7 +611,7 @@ with more complicated inputs. For example:
 my $x = ‘ailemac#’;
 say ‘I ♥ #camelia’ ~~ / $($x.flip) /; # OUTPUT: «｢#camelia｣␤»
 #                    ⚠ ↓↓ WRONG ↓↓ ⚠
-say ‘I ♥ camelia’ ~~ / <{$x.flip}> /; # OUTPUT: «｢camelia｣␤»
+say ‘I ♥ #camelia’ ~~ / <{$x.flip}> /;
 # OUTPUT:
 # ===SORRY!===
 # Regex not terminated.
@@ -639,13 +637,13 @@ thrown, and should not introduce security issues.
 To match one of several possible alternatives, C<||> or C<|> will be used. But
 they are so different.
 
-While there are more alternations than one matched, for those separated by
+When there are multiple matching alternations, for those separated by
 C<||>, the first matching alternation wins; for those separated by C<|>,
 which to win is decided by LTM strategy. See also:
 L<documentation on C<||>|/language/regexes#Alternation:_||> and
 L<documentation on C<|>|/language/regexes#Longest_Alternation:_|>.
 
-For advice of which to use: for simple regexes just using C<||> instead of C<|>
+For simple regexes just using C<||> instead of C<|>
 will get you familiar semantics, but if writing grammars then it's useful to
 learn about LTM and declarative prefixes and prefer C<|>. And keep yourself
 away from using them in one regex. When you have to do that, add parentheses