This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
regcomp.sym: Update node comments
authorKarl Williamson <khw@cpan.org>
Wed, 18 Mar 2020 15:07:15 +0000 (09:07 -0600)
committerKarl Williamson <khw@cpan.org>
Fri, 16 Oct 2020 13:01:40 +0000 (07:01 -0600)
pod/perldebguts.pod
regcomp.sym
regnodes.h

index f965b1f..20a3ea4 100644 (file)
@@ -686,19 +686,20 @@ will be lost.
                              (string folded)
 
  EXACTFAA         str        Like EXACT, but match using /iaa rules;
-                             (string folded except in non-UTF8 patterns:
-                             MICRO, SHARP S; folded length <= unfolded)
+                             (string folded except MICRO in non-UTF8
+                             patterns; doesn't contain SHARP S unless
+                             UTF-8; folded length <= unfolded)
 
  EXACTFUP         str        Like EXACT, but match using /iu rules;
-                             (string not UTF-8, folded except MICRO,
-                             SHARP S: hence Problematic)
+                             (string not UTF-8, folded except MICRO:
+                             hence Problematic)
 
  EXACTFLU8        str        Like EXACTFU, but use /il, UTF-8, (string
                              is folded, and everything in it is above
                              255
- EXACTFAA_NO_TRIE str        Like EXACT, but match using /iaa rules
-                             (string not UTF-8, not guaranteed to be
-                             folded, not currently trie-able)
+ EXACTFAA_NO_TRIE str        Like EXACTFAA, (string not UTF-8, folded
+                             except: MICRO, SHARP S; folded length <=
+                             unfolded, not currently trie-able)
 
  EXACT_REQ8       str        Like EXACT, but only UTF-8 encoded targets
                              can match
index 1554ec9..8ef8684 100644 (file)
@@ -144,11 +144,11 @@ EXACTFU     EXACT,      str         ; Like EXACT, but match using /iu rules; (string f
 # they would fold to something that requires UTF-8.  SHARP S would normally
 # fold to 'ss', but because of /aa, it instead folds to a pair of LATIN SMALL
 # LETTER LONG S characters (U+017F)
-EXACTFAA    EXACT,      str      ; Like EXACT, but match using /iaa rules; (string folded except in non-UTF8 patterns: MICRO, SHARP S; folded length <= unfolded)
+EXACTFAA    EXACT,      str      ; Like EXACT, but match using /iaa rules; (string folded except MICRO in non-UTF8 patterns; doesn't contain SHARP S unless UTF-8; folded length <= unfolded)
 
 # End of important relative ordering.
 
-EXACTFUP    EXACT,      str      ; Like EXACT, but match using /iu rules; (string not UTF-8, folded except MICRO, SHARP S: hence Problematic)
+EXACTFUP    EXACT,      str      ; Like EXACT, but match using /iu rules; (string not UTF-8, folded except MICRO: hence Problematic)
 # In order for a non-UTF-8 EXACTFAA to think the pattern is pre-folded when
 # matching a UTF-8 target string, there would have to be something like an
 # EXACTFAA_MICRO which would not be considered pre-folded for UTF-8 targets,
@@ -156,7 +156,7 @@ EXACTFUP    EXACT,      str   ; Like EXACT, but match using /iu rules; (string n
 # representable in the UTF-8 target string.
 
 EXACTFLU8   EXACT,      str      ; Like EXACTFU, but use /il, UTF-8, (string is folded, and everything in it is above 255
-EXACTFAA_NO_TRIE  EXACT, str     ; Like EXACT, but match using /iaa rules (string not UTF-8, not guaranteed to be folded, not currently trie-able)
+EXACTFAA_NO_TRIE  EXACT, str     ; Like EXACTFAA, (string not UTF-8, folded except: MICRO, SHARP S; folded length <= unfolded, not currently trie-able)
 
 
 EXACT_REQ8   EXACT,      str      ; Like EXACT, but only UTF-8 encoded targets can match
index d504d82..91cb10e 100644 (file)
 
 #define EXACTFAA                     46     /* 0x2e Like EXACT, but match using
                                                /iaa rules; (string folded
-                                               except in non-UTF8 patterns:
-                                               MICRO, SHARP S; folded length <=
+                                               except MICRO in non-UTF8
+                                               patterns; doesn't contain SHARP
+                                               S unless UTF-8; folded length <=
                                                unfolded) */
 #define EXACTFAA_tb_pb                 184  /*      0x0b8 */
 #define EXACTFAA_tb_p8                 185  /*      0x0b9 */
 
 #define EXACTFUP                     47     /* 0x2f Like EXACT, but match using
                                                /iu rules; (string not UTF-8,
-                                               folded except MICRO, SHARP S:
-                                               hence Problematic) */
+                                               folded except MICRO: hence
+                                               Problematic) */
 #define EXACTFUP_tb_pb                 188  /*      0x0bc */
 #define EXACTFUP_tb_p8                 189  /*      0x0bd */
 #define EXACTFUP_t8_pb                 190  /*      0x0be */
 #define EXACTFLU8_t8_pb                194  /*      0x0c2 */
 #define EXACTFLU8_t8_p8                195  /*      0x0c3 */
 
-#define EXACTFAA_NO_TRIE             49     /* 0x31 Like EXACT, but match using
-                                               /iaa rules (string not UTF-8,
-                                               not guaranteed to be folded, not
-                                               currently trie-able) */
+#define EXACTFAA_NO_TRIE             49     /* 0x31 Like EXACTFAA, (string not
+                                               UTF-8, folded except: MICRO,
+                                               SHARP S; folded length <=
+                                               unfolded, not currently
+                                               trie-able) */
 #define EXACTFAA_NO_TRIE_tb_pb         196  /*      0x0c4 */
 #define EXACTFAA_NO_TRIE_tb_p8         197  /*      0x0c5 */
 #define EXACTFAA_NO_TRIE_t8_pb         198  /*      0x0c6 */