This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
perlapi: XS_EXTERNAL is preferred over plain XS
[perl5.git] / XSUB.h
diff --git a/XSUB.h b/XSUB.h
index d8a2f0e..2de415f 100644 (file)
--- a/XSUB.h
+++ b/XSUB.h
@@ -49,7 +49,8 @@ Used to access elements on the XSUB's stack.
 
 =for apidoc AmU||XS
 Macro to declare an XSUB and its C parameter list.  This is handled by
-C<xsubpp>.  It is the same as using the more explicit C<XS_EXTERNAL> macro.
+C<xsubpp>.  It is the same as using the more explicit C<XS_EXTERNAL> macro; the
+latter is preferred.
 
 =for apidoc AmU||XS_INTERNAL
 Macro to declare an XSUB and its C parameter list without exporting the symbols.