GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  PERL::CRITIC::POLICY::COMPATIBILITY::PODMINIMUMVERSION (3)

.ds Aq ’

NAME

Perl::Critic::Policy::Compatibility::PodMinimumVersion - check Perl version declared against POD features used

CONTENTS

DESCRIPTION

This policy is part of the Perl::Critic::Pulp add-on. It checks that the POD features you use don’t exceed your target Perl version as indicated by use 5.008 etc.



    use 5.005;

    =pod

    C<< something >>    # bad, double angles needs 5.006



POD doesn’t affect how the code runs, so this policy is low priority, and under the compatibility theme (see POLICY THEMES in Perl::Critic).

See Pod::MinimumVersion for the POD version checks applied. The key idea is for example when targeting Perl 5.005 you avoid things like double-angles C<< >>, since pod2man in 5.005 didn’t support them. It may be possible to get newer versions of the POD translators from CPAN, but whether they run on an older Perl and whether you want to require that of users is another matter.

Adding the sort of use 5.006 etc to declare a target Perl can be a bit tedious. The config option below lets you set a base version you use. As always if you don’t care at all about this sort of thing you can disable the policy from your .perlcriticrc in the usual way (see CONFIGURATION in Perl::Critic),



    [-Compatibility::PodMinimumVersion]



CWRequirePodLinksIncludeText Policy

The Documentation::RequirePodLinksIncludeText policy asks you to use the L<target|display> style always. That feature is new in Perl 5.005 and will be reported by PodMinimumVersion unless you’ve got use 5.005 or higher or set above_version below.

CONFIGURATION

above_version (version string, default none) Report only things about Perl versions above this. The string is anything the version.pm module understands. For example if you always use Perl 5.6 or higher then set



    [Compatibility::PodMinimumVersion]
    above_version = 5.006



The effect is that all POD features up to and including Perl 5.6 are allowed, only things above that will be reported (and still only those exceeding any use 5.xxx in the file).

SEE ALSO

Perl::Critic::Pulp, Pod::MinimumVersion, Perl::Critic

Perl::Critic::Policy::Documentation::RequirePodLinksIncludeText, Perl::Critic::Policy::Compatibility::PerlMinimumVersionAndWhy, Perl::Critic::Policy::Modules::PerlMinimumVersion

HOME PAGE

http://user42.tuxfamily.org/perl-critic-pulp/index.html

COPYRIGHT

Copyright 2009, 2010, 2011, 2012, 2013, 2014, 2015 Kevin Ryde

Perl-Critic-Pulp is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 3, or (at your option) any later version.

Perl-Critic-Pulp is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with Perl-Critic-Pulp. If not, see <http://www.gnu.org/licenses/>.

Search for    or go to Top of page |  Section 3 |  Main Index


perl v5.20.3 PERL::CRITIC::POLICY::COMPATIBILITY::PODMINIMUMVERSION (3) 2015-01-04

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.