Perl::...TwoDots(3pm)
π Perl::...TwoDots(3pm) β the manual, but make it cute π
okay bestie so this is the page for Perl::...TwoDots(3pm), and yes the name is a whole mood β the module's real name is Perl::Critic::Policy::Documentation::ProhibitParagraphTwoDots and we're about to unpack it. grab a snack. π
β¨ NAME β¨
Perl::Critic::Policy::Documentation::ProhibitParagraphTwoDots β literally just: don't end a paragraph with two dots. that's it. that's the whole job. π«Ά
πΈ DESCRIPTION πΈ
So this policy lives inside the Perl::Critic::Pulp add-on, and its whole thing is: bestie, please don't end a POD paragraph with two dots. like:
Some thing.. # bad
ngl it's a shockingly easy typo to make β your fingers just go twice and boom. but it's also, like, entirely cosmetic, so on that basis this policy is lowest severity and hangs out under the "cosmetic" theme (peep "POLICY THEMES" in Perl::Critic if you wanna know more). β¨
Three or more dots, as an ellipsis? totally fine, no notes:
And some more of this ... # ok
and anything inside a paragraph is fine too, we don't care:
Numbers 1 .. 10 are handled. # ok
Also β only text paragraphs get checked, okay? Verbatim paragraphs can end with literally anything at all, go wild:
This is an example,
example_code (1 .. # ok
There might be other dubious paragraph endings this policy could pick up someday, but things like ";." or ":." can arise from code or from smiley faces, so at the moment only two dots are bad. iykyk. π
π¦ Disabling π¦
If you genuinely don't care about this, you can disable ProhibitParagraphTwoDots from your .perlcriticrc in the usual way (see "CONFIGURATION" in Perl::Critic), like so:
[-Documentation::ProhibitParagraphTwoDots]
A "## no critic" directive also works in new enough Perl::Critic, but heads up β if you have an "__END__" token, then any "no critic" generally has to be before that. periodt. π
π SEE ALSO π
Perl::Critic::PulpPerl::CriticPerl::Critic::Policy::Documentation::ProhibitParagraphEndComma
π 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/>.
that's the whole page, you ate it π this one shipped with perl v5.40.1 and was dated 2025-10-21 β slay, go fix those double dots bestie πβ¨π
π¦ 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