Pod::W...:Pretty(3pm)

💖 Pod::W...:Pretty — the <pink>Pod::Wrap::Pretty</pink> page, bestie edition ✨

okay so you opened <pink>Pod::W...:Pretty</pink>(3pm) and honestly? good choice. this is a perl module page, third section of the manual, and i'm gonna walk you through it like we're texting at 2am. no gatekeeping. 🫶

---

🌸 NAME 🌸

Pod::Wrap::Pretty — reformat Pod so it's nicely line wrapped. that's the whole vibe. ✨

---

🎀 SYNOPSIS 🎀

here's the flex, verbatim:

use Pod::Wrap::Pretty;

my $w = new Pod::Wrap::Pretty;

$w->parse_from_filehandle($fh);
$w->parse_from_file($filename);

look at her. constructor, two parse calls. iconic. 💅

---

🦋 DESCRIPTION 🦋

so, context: this is a Pod::Wrap subclass, which is in turn a Pod::Parser subclass. nesting dolls of perl. if you want the full API tea, go read the Pods of those two modules — they're the ones with the deep lore. 📚

what does this one actually do though? literally the exact same thing as Pod::Wrap, except:

• all pre-existing newlines get removed before line breaking happens
• trailing whitespace gets stripped off the end of every paragraph

and the result? paragraphs that are genuinely nicely formatted, like what you'd get from vim's gq command. it's giving "i pressed gq and everything healed". 🔥

---

🧚 DEVELOPER NOTES 🧚

heads up for the devs in the chat — these Pod::Wrap subroutines have been overridden:

• textblock

that's the list. one whole subroutine. she's efficient. 👑

---

💜 CREDITS 💜

Yuval Kogman <nothingmuch@woobling.org> — author of Pod::Wrap. king behavior, we thank him. 🙇‍♀️

---

🍓 SUPPORT 🍓

please contact the author directly via e-mail. slide into the inbox, not the issue tracker. 💌

---

👑 AUTHOR 👑

Joshua Hoblitt <jhoblitt@cpan.org>

---

🌈 COPYRIGHT 🌈

Copyright (c) 2005 Joshua Hoblitt. All rights reserved. This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

The full text of the licenses can be found in the LICENSE file included with this module, or in perlartistic and perlgpl Pods as supplied with Perl 5.8.1 and later.

legal stuff but make it cute: same terms as Perl itself, full text lives in LICENSE, or in perlartistic / perlgpl Pods if you're on Perl 5.8.1 or later. 💖

---

⭐ SEE ALSO ⭐

• Pod::Wrap
• Pod::Parser

go read those. iykyk. 🦋

---

and that's the page, bestie!! this was perl v5.42.0, dated 2025-07-25, from the Pod::W...:Pretty(3pm) page. mwah. 💅✨🎀