summaryrefslogtreecommitdiff
path: root/pod/perllexwarn.pod
diff options
context:
space:
mode:
authorFather Chrysostomos <sprout@cpan.org>2012-09-15 21:56:25 -0700
committerFather Chrysostomos <sprout@cpan.org>2012-09-15 22:45:10 -0700
commit6f87cb125dd0271ae560192c05c67ba062a4f16b (patch)
tree13805908b1b10f4bfe6163e458d571132bb2ebb5 /pod/perllexwarn.pod
parentad0cc46c82c89c5da407ee3163b95c03d5a31426 (diff)
downloadperl-6f87cb125dd0271ae560192c05c67ba062a4f16b.tar.gz
Add experimental warnings categ and :lexical_subs warn ID
I reindented the tree in perllexwarn because I was simply copying and pasting the output from: perl regen/warnings.pl tree
Diffstat (limited to 'pod/perllexwarn.pod')
-rw-r--r--pod/perllexwarn.pod216
1 files changed, 115 insertions, 101 deletions
diff --git a/pod/perllexwarn.pod b/pod/perllexwarn.pod
index e63135915b..3b6b827a36 100644
--- a/pod/perllexwarn.pod
+++ b/pod/perllexwarn.pod
@@ -212,107 +212,109 @@ to be enabled/disabled in isolation.
The current hierarchy is:
- all -+
- |
- +- closure
- |
- +- deprecated
- |
- +- exiting
- |
- +- glob
- |
- +- io -----------+
- | |
- | +- closed
- | |
- | +- exec
- | |
- | +- layer
- | |
- | +- newline
- | |
- | +- pipe
- | |
- | +- unopened
- |
- +- imprecision
- |
- +- misc
- |
- +- numeric
- |
- +- once
- |
- +- overflow
- |
- +- pack
- |
- +- portable
- |
- +- recursion
- |
- +- redefine
- |
- +- regexp
- |
- +- severe -------+
- | |
- | +- debugging
- | |
- | +- inplace
- | |
- | +- internal
- | |
- | +- malloc
- |
- +- signal
- |
- +- substr
- |
- +- syntax -------+
- | |
- | +- ambiguous
- | |
- | +- bareword
- | |
- | +- digit
- | |
- | +- illegalproto
- | |
- | +- parenthesis
- | |
- | +- precedence
- | |
- | +- printf
- | |
- | +- prototype
- | |
- | +- qw
- | |
- | +- reserved
- | |
- | +- semicolon
- |
- +- taint
- |
- +- threads
- |
- +- uninitialized
- |
- +- unpack
- |
- +- untie
- |
- +- utf8----------+
- | |
- | +- surrogate
- | |
- | +- non_unicode
- | |
- | +- nonchar
- |
- +- void
+ all -+
+ |
+ +- closure
+ |
+ +- deprecated
+ |
+ +- exiting
+ |
+ +- experimental
+ |
+ +- glob
+ |
+ +- imprecision
+ |
+ +- io ------------+
+ | |
+ | +- closed
+ | |
+ | +- exec
+ | |
+ | +- layer
+ | |
+ | +- newline
+ | |
+ | +- pipe
+ | |
+ | +- unopened
+ |
+ +- misc
+ |
+ +- numeric
+ |
+ +- once
+ |
+ +- overflow
+ |
+ +- pack
+ |
+ +- portable
+ |
+ +- recursion
+ |
+ +- redefine
+ |
+ +- regexp
+ |
+ +- severe --------+
+ | |
+ | +- debugging
+ | |
+ | +- inplace
+ | |
+ | +- internal
+ | |
+ | +- malloc
+ |
+ +- signal
+ |
+ +- substr
+ |
+ +- syntax --------+
+ | |
+ | +- ambiguous
+ | |
+ | +- bareword
+ | |
+ | +- digit
+ | |
+ | +- illegalproto
+ | |
+ | +- parenthesis
+ | |
+ | +- precedence
+ | |
+ | +- printf
+ | |
+ | +- prototype
+ | |
+ | +- qw
+ | |
+ | +- reserved
+ | |
+ | +- semicolon
+ |
+ +- taint
+ |
+ +- threads
+ |
+ +- uninitialized
+ |
+ +- unpack
+ |
+ +- untie
+ |
+ +- utf8 ----------+
+ | |
+ | +- non_unicode
+ | |
+ | +- nonchar
+ | |
+ | +- surrogate
+ |
+ +- void
Just like the "strict" pragma any of these categories can be combined
@@ -335,6 +337,18 @@ Note: In Perl 5.6.1, the lexical warnings category "deprecated" was a
sub-category of the "syntax" category. It is now a top-level category
in its own right.
+=head2 Individual Warning IDs
+
+The "experimental" warnings category, added in Perl 5.18,
+contains IDs for individual warnings, so that each warning can
+be turned on or off. Currently there is only one such warning,
+labelled "experimental:lexical_subs". You enable and disable
+it like this:
+
+ use warnings "experimental:lexical_subs";
+ no warnings "experimental:lexical_subs";
+
+The plan is to extend this convention to all warnings in a future release.
=head2 Fatal Warnings
X<warning, fatal>