Merge pull request #2923 from threadless-screw/regexes

Minor corrections to regexes section

Author: JJ

doc/Language/regexes.pod6

@@ -44,9 +44,9 @@ operators:
     $match = m/.+/; say $match; say $match.^name; # OUTPUT: «｢abc｣␤Match␤»
     $match =  /.+/; say $match; say $match.^name; # OUTPUT: «/.+/␤Regex␤»
 
-Whitespace in literal regexes is ignored insofar as the L<:sigspace>
-adverb|/language/regexes#Sigspace> is not used to make whitespace syntactically
-significant.
+Whitespace in literal regexes is ignored insofar as the
+L<C<:sigspace> adverb|/language/regexes#Sigspace> is not used to make whitespace
+syntactically significant.
 
 In addition to whitespace, comments may be used inside of regexes to improve
 their readability and comprehensibility just as in Perl6 code in general. This
@@ -261,9 +261,19 @@ Examples of word characters:
 
 =end table
 
-Note that the character classes C«<same>», C«<wb>» and C«<ww>» are
-so called zero-width assertions, which do not really match a
-character.
+The predefined character classes in the leftmost column are all of the form
+C«<name>», a hint to the fact that they are implemented as built-in
+L<named regexes|/language/regexes#Subrules>.
+As such they are subject to the usual capturing semantics. This means that if
+a character class is called with the syntax C«<name>» (i.e. as indicated in
+the leftmost column), it will not only match, but also capture, installing a
+correspondingly named L<named capture|/language/regexes#Named_captures> in the
+resulting L<Match object|/type/Match>. In case just a match and no capture is
+desired, the capture may be suppressed through the use of call syntax that
+includes a leading dot: C«<.name>».
+
+Note that the character classes C«<same>», C«<wb>» and C«<ww>» are so-called
+zero-width assertions, which do not really match any character.
 
 =head2 X«Unicode properties|regex,<:property>»
 
@@ -1250,7 +1260,7 @@ all named captures:
     }
 
 A more convenient way to get named captures is by using named regex as discussed in
-the L<Subrules|#Subrules> section.
+the L<Subrules|/language/regexes#Subrules> section.
 
 =head2 X«Capture markers: C«<( )>»|regex,<( )>»