summaryrefslogtreecommitdiff
path: root/regen
diff options
context:
space:
mode:
authorKarl Williamson <khw@cpan.org>2019-08-29 16:52:45 -0600
committerKarl Williamson <khw@cpan.org>2019-09-02 21:52:10 -0600
commitbb3eff5d3d7e45d422801f5cc0f329daf0c4766d (patch)
treef03e4d09e197cfffa3180205d5ccf011e382f07b /regen
parent91bad5a4f7b0ea7217f0f1fc7cdfa5ede59c1b50 (diff)
downloadperl-bb3eff5d3d7e45d422801f5cc0f329daf0c4766d.tar.gz
warnings.h: Add pod about finding the XS warning category
The XS category names are easily derivable from the chart of perl-space categories.
Diffstat (limited to 'regen')
-rw-r--r--regen/warnings.pl7
1 files changed, 7 insertions, 0 deletions
diff --git a/regen/warnings.pl b/regen/warnings.pl
index d761e5d3d2..56186c5fa0 100644
--- a/regen/warnings.pl
+++ b/regen/warnings.pl
@@ -388,6 +388,13 @@ EOM
=head1 Warning and Dieing
+In all these calls, the C<U32 wI<n>> parameters are warning category
+constants. You can see the ones currently available in
+L<warnings/Category Hierarchy>, just capitalize all letters in the names
+and prefix them by C<WARN_>. So, for example, the category C<void> used in a
+perl program becomes C<WARN_VOID> when used in XS code and passed to one of
+the calls below.
+
=for apidoc Am|bool|ckWARN|U32 w
Returns a boolean as to whether or not warnings are enabled for the warning