PMFUNC(1)

💅 PMFUNC(1) — pmfunc, but make it bestie-coded 💅

Okay bestie, this is the PMFUNC(1) page from the User Contributed Perl Documentation corner of the manual-verse. It's giving “small tool, big slay.” ✨

🌸 NAME 🌸

pmfunc - cat out a function from a module

✨ DESCRIPTION ✨

Given a fully-qualified function, this program opens up the file and attempts to display the source for that function. That's the whole mission, and it ate. 💅

🎀 EXAMPLES 🎀

Like, say you ask for Cwd::_perl_getcwd — you get this little beauty:

$ pmfunc Cwd::_perl_getcwd
sub _perl_getcwd
{
    abs_path('.');
}

😭 RESTRICTIONS 😭

Only subroutines that are defined in the normal fashion are seen, since a simple pattern-match is what does the extraction. Those loaded other ways — such as via AUTOLOAD, typeglob aliasing, or in an eval — will all necessarily be missed. No cap, that's just how the pattern-match girlies work. 💀

This is mostly here for people who are too lazy to type:

sed '/^sub getcwd/,/}/p' `pmpath Cwd`

or:

perl -ne 'print if /^sub\s+getcwd\b/ .. /}/' `pmpath Cwd`

💀 RESTRICTIONS (again — yes, the page really does this) 💀

The source lists no body text under this second RESTRICTIONS heading — it's just an empty section doing its thing. We're respecting the silence. 🫶

👀 SEE ALSO 👀

Zero entries here, bestie — the SEE ALSO section is literally empty in the source. Not a crumb, not a link, just quiet. 🍃

👑 AUTHORS and COPYRIGHTS 👑

Give these icons their flowers: 🌸

• Copyright (C) 1999 Tom Christiansen.
• Copyright (C) 2006-2014, 2018 Mark Leighton Fisher.

📜 LICENSE 📜

Bestie, legal bit: 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 — that licensing glow-up is real. ✨

---

And that's the whole page, bestie! 💖 This time capsule is from perl v5.32.1, dated 2022-01-21, and it's the PMFUNC(1) page. Out. 🎀🦋