POD2XHTML(1)

📦
version 1.61 · 2 versions
, in fedora 43

💖 POD2XHTML(1) 💖

okay bestie, so this is a page from the User Contributed Perl Documentation section of the manual, and it's literally the group chat of pod2xhtml. pull up a chair 🫶

✨ NAME ✨

pod2xhtml — convert .pod files to .xhtml files

no cap, that's the whole job description. she takes pod, she gives you xhtml. iconic behavior.

🌸 SYNOPSIS 🌸

pod2xhtml [--help] [--infile INFILE] [--outfile OUTFILE] [OPTIONS]

that's the whole vibe right there. look at her. 💅

🦋 DESCRIPTION 🦋

She converts files from pod format (see perlpod for what that even is) into XHTML format. That's it. That's the mission. lowkey the most useful little guy in the toolbox and nobody talks about her enough.

🎀 OPTIONS 🎀

pod2xhtml takes the following arguments, and yes we're going through every single one because they all matter:

  • --help — displays help. when you're lost in the sauce, she comes through 💜
  • --infile FILENAME — the input filename. if you don't give her one, she just reads from STDIN instead. she's flexible like that.
  • --outfile FILENAME — the output filename. skip it and she writes to STDOUT instead. queen of options tbh.
  • --css URL — Stylesheet URL. give her a URL and she'll hook the output up to your CSS.
  • --index / --noindex — generate an index, or don't. the default is to create an index, so if you're like "wait why is there an index" — that's her, that's the default, she did that on purpose. 🍓
  • --toplink LINK TEXT — sets the text for the "back to top" links. the default is 'Top'. if you want it to say something else, now you know how. ✨

💀 BUGS 💀

Not her fault, but: see Pod::Xhtml for a list of known bugs in the translator. it's giving "go read the other page for the receipts." 🙈

👑 AUTHOR 👑

P Kent <cpan _at_ bbc _dot_ co _dot_ uk>

shoutout to the author fr fr. putting in the work so we don't have to. 🫶

(c) BBC 2004. This program is free software; you can redistribute it and/or modify it under the terms of the GNU GPL.

See the file COPYING in this distribution, or http://www.gnu.org/licenses/gpl.txt

free software, GPL, the whole thing — read the file if you want the fine print, bestie, it's right there. 💖

💅 SEE ALSO 💅

  • perlpod
  • Pod::Xhtml

go read those too, they're the supporting cast and they ate. 🔥

and that's the page!! ✨ this whole thing came to you from the User Contributed Perl Documentation, perl v5.42.0, dated 2025-07-25 — so yes she's recent, she's official-ish, she's that girl. mwah, bye bestie!! 💖🎀🦋

📦 where this page comes from