Dist::Z...dVersion(3)

📦
version 6.040 · 9 versions
, in fedora 44

✨ Dist::Zilla::Plugin::PodVersion ✨

okay bestie so you know how you're reading a User Contributed Perl Documentation page and it's giving very "someone's evening hobby that got out of hand"? yeah. that's us. this one is Dist::Z...dVersion(3), and we're about to make it make sense. 💅

🌸 NAME 🌸

Dist::Zilla::Plugin::PodVersion — it adds a VERSION head1 to each Perl document. that's the whole job. that's the assignment. and it ate. 🔥

🎀 VERSION 🎀

version 6.040

periodt. that's the version you're dealing with. 🌟

💖 DESCRIPTION 💖

so here's the tea, bestie. 💜

this plugin adds a =head1 VERSION section to most perl files in the distribution, and it says which version of the dist is currently being built. iconic, honestly.

the way it works: it slides that VERSION section in after =head1 NAME. that's the spot. that's the vibe. 🦋

⚠️ and listen — if there's no =head1 NAME section at all? then the version section will not be added. no NAME, no VERSION. that's the rule. no exceptions.

also, heads up, this is the important part: this plugin is not useful if you're using the [PodWeaver] plugin, because [PodWeaver] also adds a =head1 VERSION section (by way of the [Version] section). so like… you'd be double-VERSION-ing. don't do that. pick one. 🙈

🌈 PERL VERSION 🌈

this module should work on any version of perl still receiving updates from the Perl 5 Porters. translating that: any version of perl released in the last two to three years. 💫

so like, if the most recently released version is v5.40, then this module should work on both v5.40 and v5.38. cute, right? 🍓

and yes, it may work on older versions of perl — but no guarantee is made that the minimum required version won't get raised. 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 it could go up, and it's not coming back down. sorry bestie, that's just how it is. 💀

⭐ SEE ALSO ⭐

  • Core Dist::Zilla plugins: PkgVersion, AutoVersion, NextRelease. go look at these if you want more of the good stuff 👑

👑 AUTHOR 👑

Ricardo SIGNES 😏 <cpan@semiotic.systems>

(the 😏 is doing a lot of heavy lifting here and honestly? respect.)

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.

and that's a wrap, bestie 🫶 this very page was rendered up by perl v5.42.3 on 2026-10-19, stamped under Dist::Z...dVersion(3). slay, go add some VERSION heads, mwah 💋

📦 where this page comes from