perlapi: Remove a bunch of functions from API

These functions are undocumented.  We add a flag in embed.fnc to stop
them from being listed as undocumented functions suitable for
documenting.  They should not be used explicitly, but exist only to aid
macros in handy.h that need functions to handle portions of their
functionality.  Thus the handy.h macros should be used; not these.

diff --git a/embed.fnc b/embed.fnc
index 04603ed..c84b12a 100644 (file)
--- a/embed.fnc
+++ b/embed.fnc
@@ -602,26 +602,26 @@ pR        |OP*    |invert         |NULLOK OP* cmd
 ApR    |I32    |is_lvalue_sub
 : Used in cop.h
 XopR   |I32    |was_lvalue_sub
-ApPR   |U32    |to_uni_upper_lc|U32 c
-ApPR   |U32    |to_uni_title_lc|U32 c
-ApPR   |U32    |to_uni_lower_lc|U32 c
-ApPR   |bool   |is_uni_alnum   |UV c
+AMpPR  |U32    |to_uni_upper_lc|U32 c
+AMpPR  |U32    |to_uni_title_lc|U32 c
+AMpPR  |U32    |to_uni_lower_lc|U32 c
+AMpPR  |bool   |is_uni_alnum   |UV c
 AMpPR  |bool   |is_uni_alnumc  |UV c
-ApPR   |bool   |is_uni_idfirst |UV c
-ApPR   |bool   |is_uni_alpha   |UV c
-ApPR   |bool   |is_uni_ascii   |UV c
-ApPR   |bool   |is_uni_blank   |UV c
-ApPR   |bool   |is_uni_space   |UV c
-ApPR   |bool   |is_uni_cntrl   |UV c
-ApPR   |bool   |is_uni_graph   |UV c
-ApPR   |bool   |is_uni_digit   |UV c
-ApPR   |bool   |is_uni_upper   |UV c
-ApPR   |bool   |is_uni_lower   |UV c
-ApPR   |bool   |is_uni_print   |UV c
-ApPR   |bool   |is_uni_punct   |UV c
-ApPR   |bool   |is_uni_xdigit  |UV c
-Ap     |UV     |to_uni_upper   |UV c|NN U8 *p|NN STRLEN *lenp
-Ap     |UV     |to_uni_title   |UV c|NN U8 *p|NN STRLEN *lenp
+AMpPR  |bool   |is_uni_idfirst |UV c
+AMpPR  |bool   |is_uni_alpha   |UV c
+AMpPR  |bool   |is_uni_ascii   |UV c
+AMpPR  |bool   |is_uni_blank   |UV c
+AMpPR  |bool   |is_uni_space   |UV c
+AMpPR  |bool   |is_uni_cntrl   |UV c
+AMpPR  |bool   |is_uni_graph   |UV c
+AMpPR  |bool   |is_uni_digit   |UV c
+AMpPR  |bool   |is_uni_upper   |UV c
+AMpPR  |bool   |is_uni_lower   |UV c
+AMpPR  |bool   |is_uni_print   |UV c
+AMpPR  |bool   |is_uni_punct   |UV c
+AMpPR  |bool   |is_uni_xdigit  |UV c
+AMp    |UV     |to_uni_upper   |UV c|NN U8 *p|NN STRLEN *lenp
+AMp    |UV     |to_uni_title   |UV c|NN U8 *p|NN STRLEN *lenp
 #ifdef PERL_IN_UTF8_C
 sR     |U8     |to_lower_latin1|const U8 c|NULLOK U8 *p|NULLOK STRLEN *lenp
 #endif
@@ -633,54 +633,54 @@ EMXpR     |bool   |is_utf8_X_regular_begin|NN const U8 *p
 #if defined(PERL_IN_UTF8_C) || defined(PERL_IN_PP_C)
 p      |UV     |_to_upper_title_latin1|const U8 c|NN U8 *p|NN STRLEN *lenp|const char S_or_s
 #endif
-Ap     |UV     |to_uni_lower   |UV c|NN U8 *p|NN STRLEN *lenp
-Amp    |UV     |to_uni_fold    |UV c|NN U8 *p|NN STRLEN *lenp
+AMp    |UV     |to_uni_lower   |UV c|NN U8 *p|NN STRLEN *lenp
+AMmp   |UV     |to_uni_fold    |UV c|NN U8 *p|NN STRLEN *lenp
 AMp    |UV     |_to_uni_fold_flags|UV c|NN U8 *p|NN STRLEN *lenp|const U8 flags
-ApPR   |bool   |is_uni_alnum_lc|UV c
+AMpPR  |bool   |is_uni_alnum_lc|UV c
 AMpPR  |bool   |is_uni_alnumc_lc|UV c
-ApPR   |bool   |is_uni_idfirst_lc|UV c
+AMpPR  |bool   |is_uni_idfirst_lc|UV c
 AMpR   |bool   |_is_uni_perl_idstart|UV c
-ApPR   |bool   |is_uni_alpha_lc|UV c
-ApPR   |bool   |is_uni_ascii_lc|UV c
-ApPR   |bool   |is_uni_space_lc|UV c
+AMpPR  |bool   |is_uni_alpha_lc|UV c
+AMpPR  |bool   |is_uni_ascii_lc|UV c
+AMpPR  |bool   |is_uni_space_lc|UV c
 AMpPR  |bool   |is_uni_blank_lc|UV c
-ApPR   |bool   |is_uni_cntrl_lc|UV c
-ApPR   |bool   |is_uni_graph_lc|UV c
-ApPR   |bool   |is_uni_digit_lc|UV c
-ApPR   |bool   |is_uni_upper_lc|UV c
-ApPR   |bool   |is_uni_lower_lc|UV c
-ApPR   |bool   |is_uni_print_lc|UV c
-ApPR   |bool   |is_uni_punct_lc|UV c
-ApPR   |bool   |is_uni_xdigit_lc|UV c
+AMpPR  |bool   |is_uni_cntrl_lc|UV c
+AMpPR  |bool   |is_uni_graph_lc|UV c
+AMpPR  |bool   |is_uni_digit_lc|UV c
+AMpPR  |bool   |is_uni_upper_lc|UV c
+AMpPR  |bool   |is_uni_lower_lc|UV c
+AMpPR  |bool   |is_uni_print_lc|UV c
+AMpPR  |bool   |is_uni_punct_lc|UV c
+AMpPR  |bool   |is_uni_xdigit_lc|UV c
 Anpd   |bool   |is_ascii_string|NN const U8 *s|STRLEN len
 AnpdD  |STRLEN |is_utf8_char   |NN const U8 *s
 Anpd   |STRLEN |is_utf8_char_buf|NN const U8 *buf|NN const U8 *buf_end
 Anpd   |bool   |is_utf8_string |NN const U8 *s|STRLEN len
 Anpdmb |bool   |is_utf8_string_loc|NN const U8 *s|STRLEN len|NULLOK const U8 **ep
 Anpd   |bool   |is_utf8_string_loclen|NN const U8 *s|STRLEN len|NULLOK const U8 **ep|NULLOK STRLEN *el
-ApR    |bool   |is_utf8_alnum  |NN const U8 *p
+AMpR   |bool   |is_utf8_alnum  |NN const U8 *p
 AMpR   |bool   |is_utf8_alnumc |NN const U8 *p
-ApR    |bool   |is_utf8_idfirst|NN const U8 *p
-ApR    |bool   |is_utf8_xidfirst|NN const U8 *p
+AMpR   |bool   |is_utf8_idfirst|NN const U8 *p
+AMpR   |bool   |is_utf8_xidfirst|NN const U8 *p
 AMpR   |bool   |_is_utf8_perl_idstart|NN const U8 *p
-ApR    |bool   |is_utf8_idcont |NN const U8 *p
-ApR    |bool   |is_utf8_xidcont        |NN const U8 *p
-ApR    |bool   |is_utf8_alpha  |NN const U8 *p
-ApR    |bool   |is_utf8_ascii  |NN const U8 *p
-ApR    |bool   |is_utf8_blank  |NN const U8 *p
-ApR    |bool   |is_utf8_space  |NN const U8 *p
-ApR    |bool   |is_utf8_perl_space     |NN const U8 *p
-ApR    |bool   |is_utf8_perl_word      |NN const U8 *p
-ApR    |bool   |is_utf8_cntrl  |NN const U8 *p
-ApR    |bool   |is_utf8_digit  |NN const U8 *p
-ApR    |bool   |is_utf8_posix_digit    |NN const U8 *p
-ApR    |bool   |is_utf8_graph  |NN const U8 *p
-ApR    |bool   |is_utf8_upper  |NN const U8 *p
-ApR    |bool   |is_utf8_lower  |NN const U8 *p
-ApR    |bool   |is_utf8_print  |NN const U8 *p
-ApR    |bool   |is_utf8_punct  |NN const U8 *p
-ApR    |bool   |is_utf8_xdigit |NN const U8 *p
-ApR    |bool   |is_utf8_mark   |NN const U8 *p
+AMpR   |bool   |is_utf8_idcont |NN const U8 *p
+AMpR   |bool   |is_utf8_xidcont        |NN const U8 *p
+AMpR   |bool   |is_utf8_alpha  |NN const U8 *p
+AMpR   |bool   |is_utf8_ascii  |NN const U8 *p
+AMpR   |bool   |is_utf8_blank  |NN const U8 *p
+AMpR   |bool   |is_utf8_space  |NN const U8 *p
+AMpR   |bool   |is_utf8_perl_space     |NN const U8 *p
+AMpR   |bool   |is_utf8_perl_word      |NN const U8 *p
+AMpR   |bool   |is_utf8_cntrl  |NN const U8 *p
+AMpR   |bool   |is_utf8_digit  |NN const U8 *p
+AMpR   |bool   |is_utf8_posix_digit    |NN const U8 *p
+AMpR   |bool   |is_utf8_graph  |NN const U8 *p
+AMpR   |bool   |is_utf8_upper  |NN const U8 *p
+AMpR   |bool   |is_utf8_lower  |NN const U8 *p
+AMpR   |bool   |is_utf8_print  |NN const U8 *p
+AMpR   |bool   |is_utf8_punct  |NN const U8 *p
+AMpR   |bool   |is_utf8_xdigit |NN const U8 *p
+AMpR   |bool   |is_utf8_mark   |NN const U8 *p
 : Used in perly.y
 p      |OP*    |jmaybe         |NN OP *o
 : Used in pp.c