Pod::Html::Util(3pm)

🎀 Pod::Html::Util 🎀

okay bestie, welcome to the Pod::Html::Util(3pm) page from the Perl Programmers Reference Guide. no cap, this is the helper functions for Pod-Html page, and the way that these little utility functions do their thing is lowkey iconic. 💖✨

🌸 NAME 🌸

Pod::Html::Util — helper functions for Pod-Html. periodt, that's the name.

🦋 SUBROUTINES 🦋

Note, bestie — this one is highkey important: While these functions are importable on request from Pod::Html::Util, they are 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. Hence, you should not rely on these functions in situations other than those just described. iykyk 💅

💅 process_command_line()

okay so this one does the command-line switch (options) thing. It returns a reference to a hash. It will provide a usage message if --help switch is present or if parameters are invalid. Also important: calling this subroutine may modify @ARGV — yes, literally, it can touch your args. 👀

🧚 usage()

Display customary Pod::Html usage information on STDERR. that's it, that's the whole function.

🦋 unixify()

Ensure that Pod::Html's internals and tests handle paths consistently across Unix, Windows and VMS. cross-platform main character energy fr fr.

🌈 relativize_url()

Convert an absolute URL to one relative to a base URL. Assumes both end in a filename. URL glow-up: absolute to relative.

🍓 html_escape()

Make text safe for HTML. safety first, bestie.

👑 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...). it's giving “convert the heading but keep the exceptions,” and the way that this dodges the Netscape and writer problems... obsessed.

🎀 anchorify()

anchorify(@heading);

Similar to htmlify(), but turns non-alphanumerics into underscores. Note that anchorify() is not exported by default. surprise, bestie — you gotta ask for this one.

💜 trim_leading_whitespace()

Remove 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. clean code blocks, clean vibe check.

---

mwah 💋 that's the whole page, bestie. this was Pod::Html::Util(3pm) from perl v5.42.3, dated 2026-11-03. this page ate, honestly. slay, go forth and use your helper functions responsibly — or at least remember the note above 😭💖✨