Gain control of macro namespace visibility

This commit undefines all macros that are visible to XS code but
shouldn't be.  This stops macro namespace pollution by perl.

It works by changing embed.h to have two modes, controlled by a #ifdef
that is set by perl.h.  perl.h now #includes embed.h twice.  The first
time works as it always has.  The second sets the #ifdef, and causes
embed.h to #undef the macros that shouldn't be visible.  This call is
just before perl.h returns to its includer, so that these macros have
come and gone before the file that #included perl.h is affected by them.

The list of macros is determined by the visibility given by the apidoc
lines documenting them, and by painstaking experiments with our test
suite.  Those experiments, and some manual inspection, have produced
three long lists of items beyond what the apidoc lines currently give.

One list is for items that the re extension to Perl requires.

A second list is for items that other Perl extensions require.

The third list is for items that at least one module shipped with perl
requires (or that I know something on CPAN requires) even though the
items aren't marked as being visible.  There are over 700 items on this
list.  And smoking cpan with this will add others.

The experiments were done automatically, and I have not manually done
much manual inspection.

I have wanted this ability to happen for a long time; and now things
have come together to enable it.

This allows us to have a clear-cut boundary with CPAN.

It means you can add macros that have internal-only use without having
to worry about making them likely not to clash with user names.

It shows precisely what our names are that are visible to CPAN, and we
can change some of them to be less likely to clash.

Author: khwilliamson

embed.h

@@ -3885,6 +3885,8 @@
 #     undef AMGf_unary
 #     undef ASCTIME_LOCK
 #     undef ASCTIME_UNLOCK
+#     undef av_tindex_skip_len_mg
+#     undef av_top_index_skip_len_mg
 #     undef BhkENTRY
 #     undef BHKf_bhk_eval
 #     undef BHKf_bhk_post_end
@@ -4017,7 +4019,6 @@
 #     undef ENV_UNLOCK
 #     undef ENVr_LOCALEr_LOCK
 #     undef ENVr_LOCALEr_UNLOCK
-#     undef ESC_NATIVE
 #     undef EVAL_INEVAL
 #     undef EVAL_INREQUIRE
 #     undef EVAL_KEEPERR

perl.h

@@ -9349,6 +9349,16 @@ END_EXTERN_C
 
 */
 
+START_EXTERN_C
+
+/* #including a second time causes it to #undef any unwanted symbols to avoid
+ * polluting the user name space */
+#  define PERL_DO_UNDEFS
+#  include "embed.h"
+#  undef PERL_DO_UNDEFS
+
+END_EXTERN_C
+
 #endif /* Include guard */
 
 /*