POD2RST(1p)

📦
version 1.000004 · 3 versions
, in ubuntu stonking

💖 POD2RST(1p) — the glow-up translator 💖

User Contributed Perl Documentation ✨ welcome bestie, this is pod2rst (aka the pod-to-rst bestie)

✨ NAME ✨

pod2rst — okay so this icon literally converts .pod files into .rst files 💅 one format in, one format out, no cap.

🦋 SYNOPSIS 🦋

pod2rst --infile=<name> --outfile=<name> --title=<name>

that's it. that's the whole vibe. three lil flags and you're eating 🍓

🌸 DESCRIPTION 🌸

This thing takes files with POD in them and flips them into reStructuredText format, specifically so you can feed the result to Sphinx. it's giving ✨ pipeline ✨. it's giving "my docs are going to look so good". periodt.

👑 ARGUMENTS 👑

So pod2rst takes the following arguments, and the way each one eats is honestly iconic:

  • infile / --infile=<name> — names the POD file you want converted. if you don't say anything, it just reads from stdin 🫶 (yes, by default. she's flexible like that.)
  • outfile / --outfile=<name> — names the reStructuredText file she's supposed to create for you. if you don't specify, the output just goes to stdout 🌈 (default behaviour, so chill.)
  • title / --title=<title> — sets the section title for the file. that's the whole job. she's the caption queen 👑

🔥 SEE ALSO 🔥

iykyk, go follow the whole friend group, they're all serving.

💜 AUTHOR 💜

Don Owens <don@regexguy.com> — the actual legend behind all this 🫡

This software is copyright (c) 2010 by Don Owens <don@regexguy.com>. 💕

And it's available under the same terms as the perl 5 programming language system itself. so, same energy, same license, no drama.

⭐ VERSION ⭐

1.000004 — yes bestie, that's the number, and it slays 💅

ok but fr fr, don't sleep on this one — it's a tiny tool with main character energy: one POD file in, one gorgeous reStructuredText file out, and Sphinx is going to be obsessed 🌈✨

kisses, and this lil page came to you from perl v5.40.1, dated 2026-07-31 💖 🦋 🎀

📦 where this page comes from