PODSELECT(1)

💖 PODSELECT(1) 💖

okay so bestie, welcome to podselect — a lil gem from the User Contributed Perl Documentation corner of the perl universe ✨

---

🌸 NAME 🌸

podselect — it prints out selected sections of pod documentation straight to standard output, no cap 💅

---

🦋 SYNOPSIS 🦋

podselect [-help] [-man] [-section section-spec] [file ...]

---

🎀 OPTIONS AND ARGUMENTS 🎀

• -help — prints a lil brief help message and then dips out, bye 👋
• -man — prints the manual page and exits. very meta of her, we stan 📖
• -section section-spec — tells it which section you wanna include in the output. for the format to use for section-spec, go look at "SECTION SPECIFICATIONS" in Pod::Parser. and yes bestie, this option can be given multiple times on the command line — stack 'em up 🫶
• file — the pathname of a file to grab sections of pod documentation from. defaults to standard input if you don't give one 🍓

---

✨ DESCRIPTION ✨

so here's the vibe: podselect reads the input files you hand it, goes hunting for pod documentation, and prints out — in raw pod format — every single section that matches one or more of the section specifications you gave it. and if you gave it, like, no section specifications at all? then it just outputs all the pod sections it encounters. generous queen 👑

podselect invokes the podselect() function exported by Pod::Select — please see "podselect()" in Pod::Select for more details, iykyk 🔥

---

🌈 SEE ALSO 🌈

Pod::Parser and Pod::Select 🦋

---

👑 AUTHOR 👑

please report bugs using <http://rt.cpan.org> 🐛

Brad Appleton <bradapp@enteract.com> 💜

based on code for Pod::Text::pod2text(1) written by Tom Christiansen <tchrist@mox.perl.com> 🎀

---

ngl that's the whole page bestie, go forth and select your sections 💅✨

signing off — this was perl v5.40.0, dated 2024-10-29, one iconic PODSELECT(1) moment 🫶💖