Pod::Si...mpAsXML(3pm)

📦
version 5.42.3 · 12 versions
, in alpine 3.24

💅 NAME

okay so bestie, meet Pod::Simple::DumpAsXML — it literally turns Pod into XML. that's the whole vibe. periodt.

(this beauty lives in the Perl Programmers Reference Guide, and yes the page header is out here lookin like Pod::Si...mpAsXML(3pm) because even manpage titles need a little mystery ✨)

🎀 SYNOPSIS

  perl -MPod::Simple::DumpAsXML -e \
   "exit Pod::Simple::DumpAsXML->filter(shift)->any_errata_seen" \
   thingy.pod

that's it. that's the whole run. filter(shift) go brr, any_errata_seen gives you your exit status, iconic behaviour only 🔥

🌸 DESCRIPTION

so Pod::Simple::DumpAsXML is a subclass of Pod::Simple — like, it inherits the whole personality — and what it does is parse Pod and turn it into indented and wrapped XML. cute little XML. all cozy and formatted. 🎀

who's this for? honestly, it's for the girlies writing Pod formatters based on Pod::Simple. if that's you, hi bestie, this class is of interest to you. genuinely.

also real talk: Pod::Simple::DumpAsXML inherits methods from Pod::Simple. all of them. it's giving nepo baby but in the good way 💅

🦋 SEE ALSO

  • Pod::Simple::XMLOutStream — lowkey the same vibe as this class, ngl. its output is space-padded in a way that's better for sending to an XML processor (that is, it has no ignorable whitespace). meanwhile Pod::Simple::DumpAsXML's output is much more human-readable — it's (more-or-less) one token per line, with line-wrapping. so like… choose your fighter 🫶
  • Pod::Simple::DumpAsText — also rather like this class, except it doesn't dump with XML syntax. try them and see which one you like best! no wrong answers, just different eras ⭐
  • Pod::Simple, Pod::Simple::DumpAsXML — shoutout to itself, we love self-referential queens 👑
  • the older libraries Pod::PXML, Pod::XML, Pod::SAX — the elders. respect them. 🌈

💜 SUPPORT

got questions? got discourse? questions or discussion about POD and Pod::Simple should be sent to the mail list pod-people@perl.org. and to subscribe, just send an empty email to pod-people-subscribe@perl.org. empty. nothing. a blank little ghost message 👻🫶

this module is managed in an open GitHub repository — <https://github.com/perl-pod/pod-simple/>. feel free to fork and contribute, or to clone <https://github.com/perl-pod/pod-simple.git> and send patches! it's giving open source main character energy 🌟

patches against Pod::Simple are welcome, fr fr. please send bug reports to <bug-pod-simple@rt.cpan.org>. we'll love you for it 💖

Copyright (c) 2002 Sean M. Burke.

this library is free software; you can redistribute it and/or modify it under the same terms as Perl itself. slay.

this program is distributed in the hope that it will be useful, but without any warranty; without even the implied warranty of merchantability or fitness for a particular purpose. so like… no promises, bestie, we're all just vibing 😭

🧚 AUTHOR

Pod::Simple was created by Sean M. Burke <sburke@cpan.org>. but don't bother him, he's retired. respectfully, let the man rest 🙈💤

Pod::Simple is maintained by:

  • Allison Randal "allison@perl.org"
  • Hans Dieter Pearcey "hdp@cpan.org"
  • David E. Wheeler "dwheeler@cpan.org"
ok that's the whole page, you ate that 🍓 stay hydrated, read your Pod, and remember: this was perl v5.42.3 dated 2026-11-03, drop date of the future, and yes the footer still says Pod::Si...mpAsXML(3pm) because the mystery never ends ✨💅🎀
📦 where this page comes from