Pod::Html::Util(3perl)

💖 Pod::Html::Util 💖

okay so bestie, welcome to Pod::Html::Util — that's part of the Perl Programmers Reference Guide btw, iykyk. it's the lil helper-functions toolbox for Pod-Html, and yes she's serving utility, no cap 🎀

---

✨ NAME ✨

Pod::Html::Util — helper functions for Pod-Html 🫶

---

🌸 SUBROUTINES 🌸

⚠️ okay listen up because this part is important: these functions are importable on request from Pod::Html::Util, BUT they're specifically intended for use within (a) the Pod-Html distribution (modules and test programs) shipped as part of the Perl 5 core, and (b) other parts of the core such as the installhtml program. these functions may be modified or relocated within the core distribution — or removed entirely therefrom — as the core's needs evolve. so like... do NOT rely on these functions in situations other than those just described. it's giving "private, bestie, please" 💅

🧚 process_command_line()

processes command-line switches (options), and returns a reference to a hash ✨

will give you a usage message if the --help switch is present, or if the parameters are invalid. so messy of you if that happens ngl 🙈

💀 heads up: calling this subroutine may modify @ARGV. she's not sorry.

🎀 usage()

displays the customary Pod::Html usage info on STDERR. cute little reminder, slay 📢

🦋 unixify()

makes sure Pod::Html's internals and tests handle paths consistently across Unix, Windows and VMS. one path style to rule them all, periodt 🌈

💜 relativize_url()

converts an absolute URL to one relative to a base URL. assumes both end in a filename. so like, don't be weird about it 🔥

⭐ html_escape()

makes text safe for HTML. protective queen behavior fr fr 👑

🌸 htmlify()

htmlify($heading);

converts a pod section specification to a suitable section specification for HTML ✨

note that we keep spaces and special characters, except "", ?" (Netscape problem 😭) and the hyphen (writer's problem... 💀). iconic exceptions tbh

🧚 anchorify()

anchorify(@heading);

similar to htmlify(), but turns non-alphanumerics into underscores 🫶

💖 note that anchorify() is not exported by default. you gotta ask, bestie.

🍓 trim_leading_whitespace()

removes any level of indentation (spaces or tabs) from each code block, consistently ✨ adapted from:

https://metacpan.org/source/HAARG/MetaCPAN-Pod-XHTML-0.002001/lib/Pod/Simple/Role/StripVerbatimIndent.pm

---

and that's the whole vibe check, bestie 💅 this was perl v5.44.0, dated 2026-10-17 — go forth and be unbothered, you absolute main character 🎀✨💖