Plainer(3pm)

✨ NAME ✨

Pod::Plainer — bestie, it's a Perl extension for converting Pod to old-style Pod 💖 like, it takes your fancy new Pod and gives it a lil glow-down so the ancient tools can read it.

---

🌸 SYNOPSIS 🌸

use Pod::Plainer;

my $parser = Pod::Plainer -> new ();
$parser -> parse_from_filehandle(\*STDIN);

That's it, that's the whole vibe. Make a parser, hand it a filehandle, let it cook. 👑

---

🦋 DESCRIPTION 🦋

okay so here's the tea ☕ Pod::Plainer uses Pod::Parser, and what it does is: it takes Pod that's out here using the shiny new C<< .. >> constructs, and it hands you back the old(er) style — just plain C<> — no cap. And while it's at it, < and > get swapped out for E<lt> and E<gt>. 💅

So why would you even want that? Because you can use this to pre-process your Pod before you feed it to tools that literally do not recognise the new style Pods. They're not being difficult, they just don't know. Be kind. 🫶

🎀 METHODS 🎀

• escape_ltgt — does exactly what it says on the tin: replaces < and > with E<lt> and E<gt>. iconic behaviour, no notes. ✨
• simple_delimiters — replaces delimiters with < and >. that's the whole job. she's simple, she's effective. 🌈
• textblock — this one redefines "textblock" from Pod::Parser so it uses escape_ltgt and simple_delimiters. main character energy fr fr 🔥

---

🍓 EXPORT 🍓

None by default.

like, zero. nothing. your namespace stays clean, babe. 🙈

---

👑 AUTHOR 👑

Robin Barker, rmbarker@cpan.org

---

💜 SEE ALSO 💜

See Pod::Parser. go read it, iykyk. 📚

---

🌟 COPYRIGHT AND LICENSE 🌟

Copyright (C) 2009, 2010, 2014 by Robin Barker

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself, either Perl version 5.10.1 or, at your option, any later version of Perl 5 you may have available.

---

and that's a wrap, bestie!! this page came to you courtesy of perl v5.30.0, dated 2020-05-17, and it's literally the Plainer(3pm) manual. slay, go convert some Pod, drink water, ily 💖✨🎀