This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
perlxs.pod: clarify PROTOTYPES: behaviour.
authorDavid Mitchell <davem@iabyn.com>
Thu, 3 Dec 2015 15:31:17 +0000 (15:31 +0000)
committerDavid Mitchell <davem@iabyn.com>
Thu, 3 Dec 2015 15:31:17 +0000 (15:31 +0000)
The default is to disable rather than enable.

Also mention the "Please specify prototyping behavior for Foo.xs"
warning.

dist/ExtUtils-ParseXS/lib/perlxs.pod

index d77ac1b..e887d33 100644 (file)
@@ -1257,9 +1257,13 @@ to make it a string is recommended if long version numbers are used.
 
 The PROTOTYPES: keyword corresponds to B<xsubpp>'s C<-prototypes> and
 C<-noprototypes> options.  This keyword overrides the command line options.
-Prototypes are enabled by default.  When prototypes are enabled XSUBs will
+Prototypes are disabled by default.  When prototypes are enabled, XSUBs will
 be given Perl prototypes.  This keyword may be used multiple times in an XS
 module to enable and disable prototypes for different parts of the module.
+Note that B<xsubpp> will nag you if you don't explicitly enable or disable
+prototypes, with:
+
+    Please specify prototyping behavior for Foo.xs (see perlxs manual)
 
 To enable prototypes: