NAME

Perl::Critic::PolicySummary - Descriptions of the Policy modules included with Perl::Critic itself.

DESCRIPTION

The following Policy modules are distributed with Perl::Critic. (There are additional Policies that can be found in add-on distributions.) The Policy modules have been categorized according to the table of contents in Damian Conway's book Perl Best Practices. Since most coding standards take the form "do this..." or "don't do that...", I have adopted the convention of naming each module RequireSomething or ProhibitSomething. Each Policy is listed here with its default severity. If you don't agree with the default severity, you can change it in your .perlcriticrc file. See the documentation of each module for its specific details.

POLICIES

END_HEADER

my $format = <<'END_POLICY'; =head2 %s

%s [Severity %d]

END_POLICY

eval { foreach my $policy (@policies) { my $module_abstract = $policy->get_raw_abstract();

    printf
        {$pod_file}
        $format,
        $policy->get_long_name(),
        $module_abstract,
        $policy->default_severity();
}

1;
}
or do {
    # Yes, an assignment and not equality test.
    if (my $exception = $EVAL_ERROR) {
        if ( ref $exception ) {
            $exception->show_trace(1);
        }

        print {*STDERR} "$exception\n";
    }
    else {
        print {*STDERR} "Failed printing abstracts for an unknown reason.\n";
    }

    exit 1;
};

print {$pod_file} <<'END_FOOTER';

VERSION

This is part of Perl::Critic version 1.101_001.

AUTHOR

Jeffrey Ryan Thalhammer <thaljef@cpan.org>

COPYRIGHT

Copyright (c) 2005-2009 Jeffrey Ryan Thalhammer. All rights reserved.

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.