—##############################################################################
# $URL: http://perlcritic.tigris.org/svn/perlcritic/trunk/Perl-Critic-More/lib/Perl/Critic/More.pm $
# $Date: 2008-05-04 15:05:26 -0500 (Sun, 04 May 2008) $
# $Author: clonezone $
# $Revision: 2311 $
##############################################################################
package
Perl::Critic::More;
use
5.006;
use
warnings;
use
strict;
our
$VERSION
=
'0.999_001'
;
1;
__END__
=pod
=for stopwords metacode RJBS gauge
=head1 NAME
Perl::Critic::More - Supplemental policies for Perl::Critic
=head1 SYNOPSIS
perl -MCPAN -e'install Perl::Critic::More'
perlcritic -theme more lib/Foo.pm
=head1 AFFILIATION
This file has no functionality, but instead is a placeholder for a loose
collection of Perl::Critic policies. All of those policies will have an
"Affiliation" section announcing their participation in this grouping.
=head1 DESCRIPTION
This is a collection of L<Perl::Critic> policies that are not included in
the Perl::Critic core for a variety of reasons:
=over
=item * Experimental
Some policies need some time to work out their kinks, test usability, or gauge
community interest. A subset of these will end up in the core Perl::Critic
someday.
=item * Requires special dependencies
For example, some policies require development versions of PPI (or some other
CPAN module). These will likely end up in the Perl::Critic core when their
dependencies are fulfilled.
=item * Peripheral to Perl
For example, the C<Editor::RequireEmacsFileVariables> policy is metacode.
These are not part of Perl::Critic's mission.
=item * Special purpose
For example, policies like C<CodeLayout::RequireASCII> designed to scratch
itches not felt by most of the community. These will always remain in a
Perl::Critic supplement instead of in the core.
=back
All of these policies have the theme C<more> so they can be turned off as a
group via F<.perlcriticrc> by adding this line:
theme = not more
The special purpose ones may be part of the C<notrecommended> theme. Avoid
these via:
theme = not notrecommended
Sorry about the double-negative... See L<Perl::Critic/"CONFIGURATION"> for
details on how to interact with themes.
=head1 SEE ALSO
L<Perl::Critic>
L<Perl::Critic::Bangs> - Andy Lester's fantastic list of code pet peeves
L<Perl::Critic::Lax> - RJBS' more-lenient versions of some core Perl::Critic policies
L<parrot> - the parrot team has developed a few specialized Perl::Critic
policies of their own
=head1 AUTHOR
Chris Dolan <cdolan@cpan.org>
The included policies may have other authors -- please see them individually.
This distribution is controlled by the Perl::Critic team. If you want to add
a policy to this collection, check out our Subversion repository and mailing lists at
=head1 COPYRIGHT
Copyright (c) 2006-2008 Chris Dolan
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.
=cut
# Local Variables:
# mode: cperl
# cperl-indent-level: 4
# fill-column: 78
# indent-tabs-mode: nil
# c-indentation-style: bsd
# End:
# ex: set ts=8 sts=4 sw=4 tw=78 ft=perl expandtab shiftround :