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::Pulp
  • Perl::Critic
  • Perl::Critic::Policy::Documentation::ProhibitParagraphEndComma

🏠 HOME PAGE 🏠

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


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