Pod::S...ustPod(3perl)

🌸 Pod::Simple::JustPod — just the Pod, the whole Pod, and nothing but the Pod 🌸

Perl Programmers Reference Guide · the Pod::S...ustPod(3perl) page, bestie edition

---

🎀 NAME 🎀

Pod::Simple::JustPod — just the Pod, the whole Pod, and nothing but the Pod ✨

---

💖 SYNOPSIS 💖

my $infile  = "mixed_code_and_pod.pm";
my $outfile = "just_the_pod.pod";
open my $fh, ">$outfile" or die "Can't write to $outfile: $!";

my $parser = Pod::Simple::JustPod->new();
$parser->output_fh($fh);
$parser->parse_file($infile);
close $fh or die "Can't close $outfile: $!";

---

🦋 DESCRIPTION 🦋

okay so picture this: you feed it some file, and it hands you back a copy of your input — translated into Perl's internal encoding (UTF-8) — with every single non-Pod line yeeted out. Gone. Not invited. 💅

This is a subclass of Pod::Simple::Methody and it inherits all its methods. And since that one is in turn a subclass of Pod::Simple, you get all of Pod::Simple's methods too. The way that means you can totally output to a string instead of a file, or parse from an array. Main character flexibility, honestly. 👑

It really really tries to hand back the Pod lines of the input completely unchanged, except for whatever translation into Perl's internal encoding is necessary. But it makes no effort to preserve trailing spaces on lines — those will likely get stripped. Sorry queen. 🙈 If your input pod is well-formed with no warnings and no errors, then the extracted pod should generate the exact same documentation when a Pod formatter formats it as the original file does. slay. ✨

By default, warnings go out to STDERR. 📢

---

🌈 SEE ALSO 🌈

• Pod::Simple
• Pod::Simple::Methody

---

🫶 SUPPORT 🫶

Got questions? Got thoughts? Got discussion about POD and Pod::Simple? Send it all to the <mailto:pod-people@perl.org> mail list. And if you wanna subscribe, just send an empty email to <mailto:pod-people-subscribe@perl.org>. Easy. 💌

This module lives in an open GitHub repository: <https://github.com/theory/pod-simple/>. Feel free to fork and contribute, or clone <https://github.com/theory/pod-simple.git> and send patches! 🧚

Patches against Pod::Simple are welcome, fr fr. Please send bug reports to <mailto:<bug-pod-simple@rt.cpan.org>.

---

👑 COPYRIGHT AND DISCLAIMERS 👑

Copyright (c) 2002 Sean M. Burke.

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself. 🎀

This program is distributed in the hope that it will be useful, but without any warranty; without even the implied warranty of merchantability or fitness for a particular purpose. (yeah, the all-caps is doing a lot of emotional labor there 💀)

---

💜 AUTHOR 💜

Pod::Simple was created by Sean M. Burke <sburke@cpan.org>. But don't bother him, he's retired. Let the legend rest. 😌

Pod::Simple is maintained by:

• Allison Randal "allison@perl.org"
• Hans Dieter Pearcey "hdp@cpan.org"
• David E. Wheeler "dwheeler@cpan.org"

Pod::Simple::JustPod was developed by John SJ Anderson "genehack@genehack.org", with contributions from Karl Williamson "khw@cpan.org". 💖

---

okay that's the whole page, no cap — this was perl v5.44.0, dated 2026-10-17, and you can find it filed under Pod::S...ustPod(3perl). bye bestie, go extract some pod 🦋 ✨ 🌸