PODPATH(1p)

📦
version 2.2.0 · 4 versions
, in ubuntu noble, ubuntu questing

✨ PODPATH(1p) ✨

User Contributed Perl Documentation — yes bestie, this is a Perl thing, and it's about to tell you where your Pod is hiding 🫶

💖 NAME 💖

podpath — print the path to the Pod. that's it. that's the whole job. she's simple, she's iconic, she serves. 👑

🌸 DESCRIPTION 🌸

okay so here's the tea ☕ — podpath prints the path to the Pod. literally what it says on the tin, no cap.

Here's the little twist though: if the Pod name includes perl, podpath calls stdpods underneath. sneakyyyy, we love a delegation moment 💅

Otherwise (no perl in the name, bestie), it searches down @INC, and here's the vibe check:

  • if there's a separate Pod file, it prints the .pod filename 🌱
  • otherwise, it prints the pm filename 📦

Why tho? Because this accommodates systems where the Pod lives in a separate file from the module file. some setups are like that, and she's not judging, she's just flexible ✨

🎀 EXAMPLES 🎀

Lowkey the most satisfying part. Watch her work:

$ podpath Cwd
/usr/local/devperl/lib/5.00554/Cwd.pm

And she works with alternate installations, too — because she's for everyone, fr fr:

$ devperl -S podpath perlfunc
/usr/local/devperl/lib/5.00554/pod/perlfunc.pod
$ oldperl -S podpath IO::Handle
/usr/lib/perl5/i386-linux/5.00404/IO/Handle.pm
$ filsperl -S podpath Thread
/usr/local/filsperl/lib/5.00554/i686-linux-thread/Thread.pm

See how perlfunc got the .pod and the module-y ones got the .pm? that's the whole bit. ate. 🔥

👑 SEE ALSO 👑

Go read these next, besties, they're all in the same friend group:

💜 AUTHORS and COPYRIGHTS 💜

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

shoutout to the legends 🫡

🌈 LICENSE 🌈

This is free software; you can redistribute it and/or modify it under the terms of either:

  1. the GNU General Public License as published by the Free Software Foundation; either version 1, or (at your option) any later version, or
  2. 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". 📢

okay that's the whole page, you're officially educated 💖 she ships as perl v5.36.0, dated 2022-10-14, and yes she answers to PODPATH(1p) — bye bestie, go find some Pods 🌸🦋🎀

📦 where this page comes from