Pod::S...pAsXML(3perl)

📦
version 5.44.0 · 14 versions
, in arch rolling

✨ NAME ✨

okay so bestie, welcome to Pod::Simple::DumpAsXML — it's giving turn Pod into XML 💅 and it's literally the main character of this whole page (which is Pod::S...pAsXML(3perl) from the Perl Programmers Reference Guide, if you were wondering 🫶).

🌸 SYNOPSIS 🌸

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

like… that's the whole vibe. one-liner. slay. ✨

🦋 DESCRIPTION 🦋

okay so Pod::Simple::DumpAsXML is a subclass of Pod::Simple — yes, lowercase "subclass", we love an inheritance moment 👑 — and what it does is: it parses Pod and turns it into indented and wrapped XML. no cap.

who is this for, you ask? it's for the people writing Pod formatters based on Pod::Simple. iykyk. if that's you, hi, this class is literally for you 💖

also important, bestie: Pod::Simple::DumpAsXML inherits methods from Pod::Simple. so all the ancestral method lore comes with it 🧚

🔥 SEE ALSO 🔥

  • Pod::Simple::XMLOutStream is rather like this class. the way that its output is space-padded in a way that's better for sending to an XML processor — meaning it has no ignorable whitespace, periodt. but Pod::Simple::DumpAsXML's output is way more human-readable, being (more-or-less) one token per line, with line-wrapping. so like… pick your fighter, honestly.
  • Pod::Simple::DumpAsText is also rather like this class, except that it doesn't dump with XML syntax. try them and see which one you like best! no wrong answers fr fr 💜
  • Pod::Simple, Pod::Simple::DumpAsXML
  • the older libraries: Pod::PXML, Pod::XML, Pod::SAX — vintage icons, we respect them 🎀

💖 SUPPORT 💖

questions or discussion about POD and Pod::Simple? send them to the mail list pod-people@perl.org 📬 and if you wanna subscribe, just send an empty email to pod-people-subscribe@perl.org. that's it, that's the whole ritual ✨

this module is managed in an open GitHub repository: <https://github.com/perl-pod/pod-simple/>. feel free to fork and contribute, or clone <https://github.com/perl-pod/pod-simple.git> and send patches! 🫶

patches against Pod::Simple are welcome. please send bug reports to <bug-pod-simple@rt.cpan.org> 🐛

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. 🎀

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. (yes that's the legal drama, we keep it verbatim, it's iconic 💀)

🌈 AUTHOR 🌈

Pod::Simple was created by Sean M. Burke <sburke@cpan.org>. but don't bother him, he's retired 🙈 (he said what he said, and honestly, good for him)

Pod::Simple is maintained by:

  • Allison Randal "allison@perl.org"
  • Hans Dieter Pearcey "hdp@cpan.org"
  • David E. Wheeler "dwheeler@cpan.org"

absolute legends, every single one 💜

and that's a wrap bestie!! this page was served up by perl v5.44.0 on 2026-10-17 ✨ go parse some Pod, you got this 🌸🦋💅

📦 where this page comes from