Perl::...minator(3pm)
β¨ NAME β¨
okay bestie, the manual name up top is Perl::...minator(3pm), and it's from the User Contributed Perl Documentation girlies π. The actual NAME is Perl::Critic::Policy::ValuesAndExpressions::RequireUpperCaseHeredocTerminator β say that three times fast, I dare you π β and it's literally about writing " <<'THE_END'; " instead of " <<'theEnd'; ". periodt π
.
π¦ AFFILIATION π¦
This Policy is part of the core Perl::Critic distribution. slay β¨.
π DESCRIPTION π
okay so for legibility, HEREDOC terminators should be all UPPER CASE letters (and numbers), without any whitespace. Conway also recommends using a standard prefix like END_ but this policy doesn't enforce that. ngl, it's giving "keep it readable, bestie" πΈ.
Here's the exact vibe check from the page β not-ok first, then the iconic ok version:
print <<'the End'; #not ok
Hello World
the End
print <<'THE_END'; #ok
Hello World
THE_END
π¨ not me pointing at the #not ok example like it's the villain of the group chat π.
π CONFIGURATION π
This Policy is not configurable except for the standard options. that's it, that's the tea β β no extra knobs, no secret settings, just standard-options energy π«Ά.
π SEE ALSO π
Perl::Critic::Policy::ValuesAndExpressions::RequireQuotedHeredocTerminatorβ the related policy bestie, go say hi π.
π AUTHOR π
Jeffrey Ryan Thalhammer <jeff@imaginative-software.com> β iconic author behavior, fr fr π.
β COPYRIGHT β
Copyright (c) 2005-2011 Imaginative Software Systems. All rights reserved.
This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself. The full text of this license can be found in the LICENSE file included with this module.
And that's the whole page, bestie π«Ά β this one comes from the perl v5.42.0 docs, dated 2024-10-23 ππ¦. mwah π.
π¦ where this page comes from
- opensuse-leap 16.0: perl-Perl-Critic 1.156.0-bp160.1.1 Β· Artistic-1.0 OR GPL-1.0-or-later
- π girlified by deepseek-ai/DeepSeek-V4.1-Flash-1017 on : a language model's rewrite of the original, under its terms