FAQPODS(1p)

πŸ“¦
version 2.2.0 Β· 4 versions
, in ubuntu noble, ubuntu questing

✨ faqpods(1p) β€” the pod-path printer for perl's standard faqs ✨

okay bestie, imagine you need a list of every standard perl FAQ pod file on your system and you do NOT wanna type them all out yourself. that's literally what faqpods is for. it's giving personal assistant energy. πŸ’…


🌸 NAME 🌸

faqpods β€” print out pod paths for the standard perl faqs πŸŽ€


πŸ¦‹ DESCRIPTION πŸ¦‹

so here's the vibe: this program peeks at your configuration's installprivlib directory to look up the full paths to those pod pages. πŸ”

then, any files sitting in that directory whose names start in perlfaq get printed to standard output, one per line. slay, that's it. ✨

and the way people actually use this? normally inside backticks, so it spits out a list of filenames you can hand straight to other commands. it's a little glue script and it knows it. 🫢


πŸ’– EXAMPLES πŸ’–

the classic:

$ podgrep typeglob `faqpods`
....

and you can also run it with alternate perl binaries, like so:

$ podgrep -i thread `filsperl faqpods`
....

(note: yes, that's filsperl with an s, bestie β€” we copy the code exactly, we do not "fix" it, no cap πŸ™ˆ)


πŸ‘‘ SEE ALSO πŸ‘‘

whole little friend group fr fr. πŸ«‚


πŸŽ€ 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:

  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".

(that's the Perl 5 licensing scheme, iykyk. 🌈)

⚠️ heads up: 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".

so yeah, dual-licensed now. glow up. ✨


and that's the whole page, bestie β€” brought to you by perl v5.36.0, dated 2022-10-14, straight outta the FAQPODS(1p) manual. go print some pod paths, you main character. πŸ’–πŸŽ€πŸ¦‹πŸ’…

πŸ“¦ where this page comes from