NAME

       Perl::Critic::Policy::Variables::ProhibitUnusedVariables - Don't ask for storage you don't
       need.

AFFILIATION

       This Policy is part of the core Perl::Critic distribution.

DESCRIPTION

       Unused variables clutter code and require the reader to do mental bookkeeping to figure
       out if the variable is actually used or not.

       At present, this Policy is very limited in order to ensure that there aren't any false
       positives.  Hopefully, this will become more sophisticated soon.

       Right now, this only looks for simply declared, uninitialized lexical variables.

           my $x;          # not ok, assuming no other appearances.
           my @y = ();     # ok, not handled yet.
           our $z;         # ok, global.
           local $w;       # ok, global.

       This module is very dumb: it does no scoping detection, i.e. if the same variable name is
       used in two different locations, even if they aren't the same variable, this Policy won't
       complain.

       Have to start somewhere.

CONFIGURATION

       This Policy is not configurable except for the standard options.

AUTHOR

       Elliot Shank "<perl@galumph.com>"

COPYRIGHT

       Copyright (c) 2008-2021 Elliot Shank.

       This program is free software; you can redistribute it and/or modify it under the same
       terms as Perl itself.  The full text of this license can be found in the LICENSE file
       included with this module.

perl v5.36.0                        Perl::Critic::Policy::Variables::ProhibitUnusedVariables(3pm)