Dist::Z...License(3)

📦
version 6.040 · 9 versions
, in fedora 44

💖 Dist::Zilla::Plugin::License 💖

okay so bestie, welcome to the manual page for Dist::Zilla::Plugin::License — that's the Dist::Z...License(3) page from the User Contributed Perl Documentation, and yes, it's giving "small plugin, big heart." Let's get into it fr fr. 🎀

✨ NAME ✨

Dist::Zilla::Plugin::License — literally just here to output a LICENSE file. that's the whole job. iconic behavior. 👑

🌸 VERSION 🌸

version 6.040 — that's the one we're talking about, bestie.

🦋 DESCRIPTION 🦋

so what does this plugin even do? it drops a LICENSE file into your dist, and inside that file is the full text of your distribution's license. like, the whole thing. no abridged version, no "see legal dept," the entire text.

and where does that full text come from? not from vibes. it's produced by the fulltext method of the dist's Software::License object. that's the source of truth, periodt. 💅

🔥 PERL VERSION 🔥

okay important, no cap: this module should work on any version of perl still receiving updates from the Perl 5 Porters. which basically means any perl released in the last two to three years.

to make it super clear (they gave us an example, so we're keeping it): if the most recently released version is v5.40, then this module should work on both v5.40 and v5.38. math is mathin'. 📐✨

now the caveat, and listen up: it may work on older versions of perl, but 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 don't come for them with the "please support perl 5.8" agenda, bestie. 🫶

🎀 ATTRIBUTES 🎀

filename

this attribute lets you specify a name other than LICENSE to be used. so if you're feeling spicy and want a different filename, this is your moment. 🌶️✨

🌈 SEE ALSO 🌈

  • the "license" attribute of the Dist::Zilla object — that's what you use to select the license to use. go pick one, king. 👑
  • Dist::Zilla roles: FileGatherer.
  • Other modules: Software::License, Software::License::Artistic_2_0.

💜 AUTHOR 💜

Ricardo SIGNES 😏 <cpan@semiotic.systems>

(the 😏 is in the original, we don't make the rules, we just report them)

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 page is from perl v5.42.3, dated 2026-10-19, and honestly? slay. go make that LICENSE file. 💖🌸🦋

📦 where this page comes from