Perl::Critic::Policy::Documentation::ProhibitDuplicateSeeAlso3pm

Overview

This policy is part of the "Perl::Critic::Pulp" add-on. It asks you not to duplicate "L<Foo>" links in a SEE ALSO section.

    =head1 SEE ALSO
    L<Foo::Bar>
    L<Foo::Bar>    # bad

The idea is that for readability a given cross-reference should be linked just once and a duplicate is likely a leftover from too much cut-and-paste etc. This is minor matter so this policy is low severity and under the "cosmetic" theme (see "POLICY THEMES" in Perl::Critic).

A module can appear more than once in a SEE ALSO, but only "L<>" linked once. Anything else should be "C<>" markup or plain text.

    L<Foo::One>, L<Foo::Two>
    (C<Foo::Two> runs faster)     # ok

Links to different parts of a target POD are allowed,

    L<perlfunc/alarm>,
    L<perlfunc/kill>     # ok

    [-Documentation::ProhibitDuplicateSeeAlso]

Home page

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