This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
perlreapi: Update as little as possible for 5.14
authorKarl Williamson <public@khwilliamson.com>
Sat, 9 Apr 2011 22:33:07 +0000 (16:33 -0600)
committerKarl Williamson <public@khwilliamson.com>
Tue, 12 Apr 2011 18:34:50 +0000 (12:34 -0600)
This keeps the docs at parity with earlier Perls.

pod/perlreapi.pod

index 7028650..1c694a7 100644 (file)
@@ -120,21 +120,26 @@ TODO: Document those cases.
 
 =item C</p> - RXf_PMf_KEEPCOPY
 
 
 =item C</p> - RXf_PMf_KEEPCOPY
 
-=back
-
-Additional flags:
-
-=over 4
-
-=item RXf_PMf_LOCALE
-
-Set if C<use locale> is in effect. If present in C<< rx->extflags >>
+=item Character set
+
+The character set semantics are determined by an enum that is contained
+in this field.  This is still experimental and subject to change, but
+the current interface returns the rules by use of the in-line function
+C<get_regex_charset(const U32 flags)>.  The only currently documented
+value returned from it is REGEX_LOCALE_CHARSET, which is set if
+C<use locale> is in effect. If present in C<< rx->extflags >>
 C<split> will use the locale dependent definition of whitespace under
 when RXf_SKIPWHITE or RXf_WHITE are in effect. Under ASCII whitespace
 is defined as per L<isSPACE|perlapi/isSPACE>, and by the internal
 macros C<is_utf8_space> under UTF-8 and C<isSPACE_LC> under C<use
 locale>.
 
 C<split> will use the locale dependent definition of whitespace under
 when RXf_SKIPWHITE or RXf_WHITE are in effect. Under ASCII whitespace
 is defined as per L<isSPACE|perlapi/isSPACE>, and by the internal
 macros C<is_utf8_space> under UTF-8 and C<isSPACE_LC> under C<use
 locale>.
 
+=back
+
+Additional flags:
+
+=over 4
+
 =item RXf_UTF8
 
 Set if the pattern is L<SvUTF8()|perlapi/SvUTF8>, set by Perl_pmruntime.
 =item RXf_UTF8
 
 Set if the pattern is L<SvUTF8()|perlapi/SvUTF8>, set by Perl_pmruntime.