This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
embed.h: Add caution about PERL_NO_SHORT_NAMES
authorKarl Williamson <khw@cpan.org>
Mon, 19 Oct 2020 21:49:27 +0000 (15:49 -0600)
committerKarl Williamson <khw@cpan.org>
Mon, 26 Oct 2020 19:38:22 +0000 (13:38 -0600)
embed.h
regen/embed.pl

diff --git a/embed.h b/embed.h
index fbd32d3..b53d015 100644 (file)
--- a/embed.h
+++ b/embed.h
@@ -20,7 +20,9 @@
 
 /* By defining PERL_NO_SHORT_NAMES (not done by default) the short forms
  * (like warn instead of Perl_warn) for the API are not defined.
- * Not defining the short forms is a good thing for cleaner embedding. */
+ * Not defining the short forms is a good thing for cleaner embedding.
+ * BEWARE that a bunch of macros don't have long names, so either must be
+ * added or don't use them if you define this symbol */
 
 #ifndef PERL_NO_SHORT_NAMES
 
index cdd9f57..f5db51d 100755 (executable)
@@ -316,7 +316,9 @@ print $em <<'END';
 
 /* By defining PERL_NO_SHORT_NAMES (not done by default) the short forms
  * (like warn instead of Perl_warn) for the API are not defined.
- * Not defining the short forms is a good thing for cleaner embedding. */
+ * Not defining the short forms is a good thing for cleaner embedding.
+ * BEWARE that a bunch of macros don't have long names, so either must be
+ * added or don't use them if you define this symbol */
 
 #ifndef PERL_NO_SHORT_NAMES