Perl::...SeeAlso(3pm)
π Perl::...SeeAlso(3pm) π
okay bestie, so this is a page from the User Contributed Perl Documentation (the 3pm section, if you were wondering), and it's literally about a Perl::Critic policy. come sit with me, this one's short and sweet π
β¨ NAME β¨
Perl::Critic::Policy::Documentation::ProhibitDuplicateSeeAlso β basically: don't duplicate L<> links in SEE ALSO. that's it, that's the whole vibe π
πΈ DESCRIPTION πΈ
so this policy is part of the Perl::Critic::Pulp add-on, and what it does is politely ask you β no, lowkey firmly ask you β not to repeat L<Foo> links inside a SEE ALSO section. like, once is enough, babe.
=head1 SEE ALSO
L<Foo::Bar>
L<Foo::Bar> # bad
the reasoning here? for readability, a given cross-reference should be linked just once, and a duplicate is probably a leftover from going a lil too hard with the cut-and-paste. we've all been there π«Ά this is a minor thing, so the policy is low severity and lives under the "cosmetic" theme (peep "POLICY THEMES" in Perl::Critic).
a module can show up more than once in a SEE ALSO β it just can only be L<> linked once. anything else should be C<> markup or plain text, no cap.
L<Foo::One>, L<Foo::Two>
(C<Foo::Two> runs faster) # ok
and links pointing to different parts of the same target POD? those are allowed, slay β¨
L<perlfunc/alarm>,
L<perlfunc/kill> # ok
π Disabling
if you genuinely don't care about this (and honestly, valid), you can always disable ProhibitDuplicateSeeAlso from your .perlcriticrc file in the usual way (check "CONFIGURATION" in Perl::Critic for the deets),
[-Documentation::ProhibitDuplicateSeeAlso]
π SEE ALSO π
Perl::Critic::Pulp, Perl::Critic
Perl::Critic::Policy::Documentation::ProhibitAdjacentLinks, Perl::Critic::Policy::Documentation::ProhibitLinkToSelf
π HOME PAGE π
http://user42.tuxfamily.org/perl-critic-pulp/index.html
π COPYRIGHT π
Copyright 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2019, 2021 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/>.
fr fr, that warranty disclaimer is doing the most β no warranty, no promises, GNU GPL energy only π
and that's a wrap, bestie! this page came to you courtesy of perl v5.40.1, dated 2025-10-21 π¦ go forth and never duplicate your L<> links again, mwah π
π¦ where this page comes from
- ubuntu resolute: libperl-critic-pulp-perl 100-1 Β· GPL-3.0-or-later
- ubuntu stonking: libperl-critic-pulp-perl 100-1 Β· GPL-3.0-or-later
- π girlified by deepseek-ai/DeepSeek-V4.1-Flash on : a language model's rewrite of the original, under its terms