Perl::...dComma(3pm)

💖 NAME 💖

okay bestie, gather round, because this page — Perl::...dComma(3pm) — is literally just one job: it's the manual for Perl::Critic::Policy::Documentation::ProhibitParagraphEndComma, and that whole mouthful basically means "bestie… why does your paragraph end in a comma" 💅

---

✨ DESCRIPTION ✨

So this policy is part of the Perl::Critic::Pulp add-on 🫶 and its whole vibe is: don't end a POD paragraph with a comma. That's it. That's the policy.

Like, look at this mess 👇

Some text,       # bad, meant to be a full-stop?

Some more text.

See that comma up there? bad. 😭 Nine times out of ten you meant a full-stop, and it's giving "I forgot how sentences work."

Same energy when it's the tail end of a SEE ALSO list where the comma should've just… not been there:

=head1 SEE ALSO

L<Foo>,
L<Bar>,          # bad, meant to be omitted?

Not me spotting a trailing comma in a link list 🙈 (that one was probably meant to be omitted entirely).

BUT — and this is the important part, so listen up 💀 — a paragraph is allowed to end with a comma when it comes right before an =over or a verbatim block. In that case the comma is read as introducing a quotation or example, which is a totally valid, iconic move. Like:

For example,     # ok, introduce an example

    foo(1+2+3)

Or one of,       # ok, introduce an itemized list

=over

=item Foo

See? Comma there = introducing something. Comma anywhere else = 🚨 caught 🚨.

Disabling

If you genuinely don't care about any of this, no stress — you can disable ProhibitParagraphEndComma from your .perlcriticrc in the usual way (go peek at "CONFIGURATION" in Perl::Critic if you need the rundown):

[-Documentation::ProhibitParagraphEndComma]

periodt. 💅

---

👀 SEE ALSO 👀

Go read these too, they're fr fr useful:

• Perl::Critic::Pulp
• Perl::Critic
• Perl::Critic::Policy::Documentation::ProhibitParagraphTwoDots

---

🏠 HOME PAGE 🏠

The whole thing lives at http://user42.tuxfamily.org/perl-critic-pulp/index.html — go say hi 🦋

---

⚖️ COPYRIGHT ⚖️

Copyright 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2019, 2020, 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/>.

---

and that's the whole thing girlie 💜 this page was served up by perl v5.40.1 on 2025-10-21, filed under Perl::...dComma(3pm) — no cap, go forth and delete your trailing commas 🎀✨