deprecated
exiting
experimental
+ experimental::autoderef
+ experimental::const_attr
experimental::lexical_subs
experimental::lexical_topic
+ experimental::postderef
+ experimental::re_strict
+ experimental::refaliasing
experimental::regex_sets
+ experimental::signatures
experimental::smartmatch
+ experimental::win32_perlio
glob
imprecision
io
layer
newline
pipe
+ syscalls
unopened
+ locale
misc
+ missing
numeric
once
overflow
portable
recursion
redefine
+ redundant
regexp
severe
debugging
nonchar
surrogate
void
+ void_unusual
y2k
);
strict->import;
warnings->import;
warnings->import(FATAL => @WARNING_CATEGORIES);
- warnings->import(NONFATAL => @V2_NONFATAL);
+ warnings->unimport(FATAL => @V2_NONFATAL);
+ warnings->import(@V2_NONFATAL);
warnings->unimport(@V2_DISABLE);
if (_want_extra($opts->{file})) {
C<.git>, C<.svn>, or C<.hg> is present two directories up along with
C<dist.ini> (which would indicate we are in a C<dzil test> operation, via
L<Dist::Zilla>) -- or when the C<PERL_STRICTURES_EXTRA> environment variable is
-set, in which case
+set, in which case it also does the equivalent of
- use strictures 2;
-
-is equivalent to
-
- use strict;
- use warnings FATAL => 'all';
- use warnings NONFATAL => qw(
- exec
- recursion
- internal
- malloc
- newline
- experimental
- deprecated
- portable
- );
- no warnings 'once';
no indirect 'fatal';
no multidimensional;
no bareword::filehandles;
mechanism of this code will result in a sub-version increase (e.g. 1.000000 to
1.000001 (1.0.1)).
+=head1 CATEGORY SELECTIONS
+
+strictures does not enable fatal warnings for all categories.
+
+=over 4
+
+=item exec
+
+Includes a warning that can cause your program to continue running
+unintentionally after an internal fork. Not safe to fatalize.
+
+=item recursion
+
+Infinite recursion will end up overflowing the stack eventually anyway.
+
+=item internal
+
+Triggers deep within perl, in places that are not safe to trap.
+
+=item malloc
+
+Triggers deep within perl, in places that are not safe to trap.
+
+=item newline
+
+Includes a warning for using stat on a valid but suspect filename, ending in a
+newline.
+
+=item experimental
+
+Experimental features are used intentionally.
+
+=item deprecated
+
+Deprecations will inherently be added to in the future in unexpected ways,
+so making them fatal won't be reliable.
+
+=item portable
+
+Doesn't indicate an actual problem with the program, only that it may not
+behave properly if run on a different machine.
+
+=item once
+
+Can't be fatalized. Also triggers very inconsistently, so we just disable it.
+
+=back
+
=head1 VERSIONS
Depending on the version of strictures requested, different warnings will be
use strict;
use warnings FATAL => 'all';
- use warnings NONFATAL => 'deprecated', 'experimental';
+ use warnings NONFATAL => qw(
+ exec
+ recursion
+ internal
+ malloc
+ newline
+ experimental
+ deprecated
+ portable
+ );
+ no warnings 'once';
+
# and if in dev mode:
no indirect 'fatal';
no multidimensional;
no bareword::filehandles;
+Additionally, any warnings created by modules using L<warnings::register> or
+C<warnings::register_categories()> will not be fatalized.
+
=head2 VERSION 1
Equivalent to: