Pod::R...ersion(3pm)
π Pod::Readme::Plugin::version β the manual, but make it cute π
okay so bestie, quick vibe check: this page lives in the User Contributed Perl Documentation corner of the manual universe, and it's filed under Pod::Readme::Plugin::version (3pm). She's a plugin, she's tiny, she's iconic, and she has ONE job. Let's get into it. π
β¨ NAME β¨
Pod::Readme::Plugin::version β literally just here to put the version in your README. that's it. that's the whole personality. π
πΈ SYNOPSIS πΈ
drop this line into your pod and you're done:
=for readme plugin version
no cap, that's the whole invocation. π«Ά
π¦ DESCRIPTION π¦
so like β this is a plugin for Pod::Readme, right? and its entire main character moment is: it includes the release version. that's it. that's the assignment. it ate and left no crumbs. β
π ARGUMENTS π
π "file"
=for readme plugin version file='lib/My/App.pm'
okay so by default, she pulls the version from the very same file that the README is being extracted from. periodt. but if the version you want lives in a different file? then you gotta say so. specify it. tell her where to look. she's not a mind reader bestie π
π "title"
=for readme plugin version title='VERSION'
this argument lets you change the title of the heading. that's literally it β you get to rename the lil heading, you little branding genius you. β¨
π a lil sign-off π
and that's the whole page!! no options list, no env vars, no exit statuses, no drama β just a version, a file, and a heading title. lowkey obsessed. π
this beauty shipped as part of perl v5.28.0, dated 2018-11-26, and yes she is still serving. mwah. ππ§π
π¦ where this page comes from
- debian bookworm: libpod-readme-perl 1.2.3-1 Β· Artistic-1.0-Perl OR GPL-1.0-or-later
- debian trixie: libpod-readme-perl 1.2.3-1 Β· Artistic-1.0-Perl OR GPL-1.0-or-later
- ubuntu jammy: libpod-readme-perl 1.2.3-1 Β· Artistic-1.0-Perl OR GPL-1.0-or-later
- ubuntu noble: libpod-readme-perl 1.2.3-1 Β· Artistic-1.0-Perl OR GPL-1.0-or-later
- π girlified by deepseek-ai/DeepSeek-V4.1-Flash on : a language model's rewrite of the original, under its terms