summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorKarl Williamson <public@khwilliamson.com>2011-11-12 13:36:53 -0700
committerKarl Williamson <public@khwilliamson.com>2012-12-23 14:23:40 -0700
commit5b48d9bbd702cd2c0a0863c898b3d4b120daf256 (patch)
tree41ee0578a202e19cdd4d0d2cccba8ec166eb727e
parenteba68aa09a0b159ee4eef3cee1bd58ee95fdb81a (diff)
downloadperl-5b48d9bbd702cd2c0a0863c898b3d4b120daf256.tar.gz
perlhack: in-line functions need extra care
-rw-r--r--pod/perlhack.pod9
1 files changed, 9 insertions, 0 deletions
diff --git a/pod/perlhack.pod b/pod/perlhack.pod
index 0dccf9a6f1..e5347ff074 100644
--- a/pod/perlhack.pod
+++ b/pod/perlhack.pod
@@ -387,6 +387,15 @@ Do not declare variables using "register". It may be counterproductive
with modern compilers, and is deprecated in C++, under which the Perl
source is regularly compiled.
+=item *
+
+In-line functions that are in headers that are accessible to XS code
+need to be able to compile without warnings with commonly used extra
+compilation flags, such as gcc's C<-Wswitch-default> which warns
+whenever a switch statement does not have a "default" case. The use of
+these extra flags is to catch potential problems in legal C code, and is
+often used by Perl aggregators, such as Linux distributors.
+
=back
=head3 Test suite