Dist::Z...PkgDist(3)

✨ NAME ✨

Dist::Zilla::Plugin::PkgDist — bestie, this one adds a $DIST to your packages 💅

(also this is a page from the User Contributed Perl Documentation, in case you were wondering where you wandered into 🎀)

🌸 VERSION 🌸

version 6.040

---

🦋 DESCRIPTION 🦋

okay so here's the vibe: this plugin rolls up into every package inside every Perl module or program (more or less) in your distribution and drops a lil line that looks like this:

  { our $DIST = 'My-CPAN-Dist'; } # where 'My-CPAN-Dist' is your dist name

(and yes, 'My-CPAN-Dist' is literally your dist name, no cap 🫶)

but the way it's picky?? it will skip any package declaration that has a newline chilling between the package keyword and the actual package name, like this cutie right here:

  package
    Foo::Bar;

that kind of declaration is also ignored by the CPAN toolchain, and it's typically the thing people do when they're monkey patching or doing other tricky things 🙈 so like, you're not missing out, it's giving "intentionally unbothered."

---

💜 PERL VERSION 💜

this module should work on any version of perl that's still receiving updates from the Perl 5 Porters. which means: any version of perl released in the last two to three years. (like, if the most recently released version is v5.40, then this module should work on both v5.40 and v5.38. slay.)

although it may work on older versions of perl, no guarantee is made that the minimum required version will not be increased. the version may be increased for any reason, and there is no promise that patches will be accepted to lower the minimum required perl. so like... don't come for the floor, bestie 😭

---

👑 AUTHOR 👑

Ricardo SIGNES 😏 <cpan@semiotic.systems>

---

💖 COPYRIGHT AND LICENSE 💖

this software is copyright (c) 2026 by Ricardo SIGNES.

this is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself. iconic behavior, honestly 🔥

---

k that's the whole page, mwah 💋 documented by perl v5.42.3 on 2026-10-19, and that's the manual name Dist::Z...PkgDist(3) — periodt 💅✨