summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorKarl Williamson <public@khwilliamson.com>2011-09-30 08:36:57 -0600
committerKarl Williamson <public@khwilliamson.com>2011-10-01 09:58:10 -0600
commit181ab5fda42b97d8f9f8c965ae612d81db57cfa0 (patch)
tree824e141670ea9be07e73754b1942c104fbd8fd06
parent220c71bf4cd8bb46ef9f78ea76892ea2785f7871 (diff)
downloadperl-181ab5fda42b97d8f9f8c965ae612d81db57cfa0.tar.gz
handy.h: Add comments, pod change
-rw-r--r--handy.h9
1 files changed, 7 insertions, 2 deletions
diff --git a/handy.h b/handy.h
index 609109768c..e8c9b129f3 100644
--- a/handy.h
+++ b/handy.h
@@ -473,7 +473,7 @@ There are three variants for all the functions in this section. The base ones
operate using the character set of the platform Perl is running on. The ones
with an C<_A> suffix operate on the ASCII character set, and the ones with an
C<_L1> suffix operate on the full Latin1 character set. All are unaffected by
-locale.
+locale and by C<use bytes>.
For ASCII platforms, the base function with no suffix and the one with the
C<_A> suffix are identical. The function with the C<_L1> suffix imposes the
@@ -591,7 +591,9 @@ patched there. The file as of this writing is cpan/Devel-PPPort/parts/inc/misc
/* ASCII range only */
#ifdef H_PERL /* If have access to perl.h, lookup in its table */
-/* Bits for PL_charclass[] */
+/* Bits for PL_charclass[]. These use names used in l1_char_class_tab.h but
+ * their actual definitions are here. If that has a name not used here, it
+ * won't compile. */
# define _CC_ALNUMC_A (1<<0)
# define _CC_ALNUMC_L1 (1<<1)
# define _CC_ALPHA_A (1<<2)
@@ -867,6 +869,7 @@ EXTCONST U32 PL_charclass[];
#define generic_uni(macro, function, c) ((c) < 256 \
? CAT2(macro, _L1)(c) \
: function(c))
+/* Note that all ignore 'use bytes' */
#define isALNUM_uni(c) generic_uni(isWORDCHAR, is_uni_alnum, c)
#define isIDFIRST_uni(c) generic_uni(isIDFIRST, is_uni_idfirst, c)
@@ -919,6 +922,8 @@ EXTCONST U32 PL_charclass[];
*((p)+1))) \
: function(p))
+/* Note that all ignore 'use bytes' */
+
#define isALNUM_utf8(p) generic_utf8(isWORDCHAR, is_utf8_alnum, p)
/* To prevent S_scan_word in toke.c from hanging, we have to make sure that
* IDFIRST is an alnum. See