PMDESC(1p)

💖 PMDESC — the pmdesc(1p) glow-up 💖

okay so bestie, this is the manual page for pmdesc, from the Perl user-contributed docs, and it is exactly the little tool you want when you need the receipts on a module. no cap. 🎀

---

✨ NAME ✨

pmdesc — print out version and whatis description of perl modules 🦋

---

🌸 DESCRIPTION 🌸

okay so you hand it one or more module names, and it shows you the version number (if it's known, key word if) plus the 'whatis' line — that's the description from the module's NAME section. it's the exact thing you'd use to generate whatis databases. lowkey iconic. 💅

---

🎀 EXAMPLES 🎀

here's the vibe in action, bestie:

$ pmdesc IO::Socket
IO::Socket (1.25) - Object interface to socket communications

$ oldperl pmdesc IO::Socket
IO::Socket (1.1603) - Object interface to socket communications

$ pmdesc `pminst -s | perl -lane 'print $F[1] if $F[0] =~ /site/'`
XML::Parser::Expat (2.19) - Lowlevel access to James Clark's expat XML parser
XML::Parser (2.19) - A perl module for parsing XML documents

see how oldperl gives you a different version number? that's not a glitch, that's just which perl you're running it with. ✨

---

💀 RESTRICTIONS 💀

this only works on modules. it should also work on filenames, but then it's a bit tricky finding out the package to call the VERSION method on. so like, it's giving "works in theory," bestie. 😭

---

🌈 SEE ALSO 🌈

• pmdesc(1)
• pminst(1)
• pmpath(1)
• pmvers(1)

go read those too, they're the friend group. 🫶

---

👑 AUTHORS and COPYRIGHTS 👑

Copyright (C) 1999 Tom Christiansen.

Copyright (C) 2006-2014, 2018 Mark Leighton Fisher.

---

📜 LICENSE 📜

This is free software; you can redistribute it and/or modify it under the terms of either: (a) the GNU General Public License as published by the Free Software Foundation; either version 1, or (at your option) any later version, or (b) the Perl "Artistic License". (This is the Perl 5 licensing scheme.)

Please note this is a change from the original pmtools-1.00 (still available on CPAN), as pmtools-1.00 were licensed only under the Perl "Artistic License".

⭐ heads up on that licensing switch, it's a real change from the original, not me being dramatic. 💖

---

perl v5.36.0 🌸 2022-10-14 🌸 and that's the whole page, mwah 💋 — this was PMDESC(1p), brought to you by perl v5.36.0 on 2022-10-14, stream it, love it, run it. 🧚💜