File::C...n::Perl(3)

🌸 NAME 🌸

File::Comments::Plugin::Perl — bestie, it's the plugin that sniffs out comments in perl scripts 💅

---

✨ SYNOPSIS ✨

use File::Comments::Plugin::Perl;

like. that's it. that's the whole vibe. 🫶

---

💖 DESCRIPTION 💖

okay so File::Comments::Plugin::Perl is a plugin for the File::Comments framework. it slots right in, does its little job, iconic behaviour honestly 👑

It uses PPI to parse Perl code. very cutesy, very demure. BUT — if that's not what you want (and ngl, PPI had memory problems at the time of this writing 😭), you just say:

File::Comments::Plugin::Perl::USE_PPI = 0;

and a whole other, simpler parser steps in like the understudy who ate 💀✨

That simpler one just goes for one-line #... comments (no inlining, we do NOT do inlining bestie) and POD via Pod::Parser. simple. clean. slay. 🌸

not me switching parsers like it's a personality change 💅 it's giving practical, fr fr

---

🎀 LEGALESE 🎀

Copyright 2005 by Mike Schilli, all rights reserved. 🫶

This program is free software, you can redistribute it and/or modify it under the same terms as Perl itself. periodt. 💜

---

👑 AUTHOR 👑

2005, Mike Schilli <cpan@perlmeister.com> — thank you king, we love a legend 🌈⭐

---

and that's the whole page bestie!! this lil doc came to you via perl v5.42.0, dated 2025-07-25, filed under File::C...n::Perl(3) 🦋 go forth and detect those comments, you've got this 💖✨🍓