DhMake...dParser(3pm)

💖 NAME 💖

DhMakePerl::PodParser — the internal helper module for DhMakePerl, aka the backstage crew. Not the main character, never was, still serving looks tho.

🎀 quick vibe check bestie: this page lives in the User Contributed Perl Documentation, section 3pm — you know it, the DhMake...dParser(3pm) one. Perl module docs, we love her. 🫶

---

🦋 SYNOPSIS 🦋

So DhMakePerl uses DhMakePerl::PodParser to extract some information from the module-to-be-packaged. That's the whole job. It sub-classes from Pod::Parser, and if you want the actual documentation on that, please refer to Pod::Parser — this one is just the little sister. 💅

---

✨ METHODS ✨

set_names 🌸

Defines the names of the sections that should be fetched from the POD. You hand it your list, it remembers the list. Iconic behaviour honestly.

get 💜

Gets the contents for the specified POD section. The single argument should be one of the values given to set_names. One arg, and it's gotta be one of those names, okay? No random guesses. 🍓

cleanup 🧹

Empties the information held by the parser object. It's giving ✨ selective amnesia ✨ and honestly, sometimes that's self care.

command 👑

Overrides base class' Pod::Parser command method.

Gets each of the POD's commands (sections), and defines how it should react to each of them. In this particular implementation, it basically filters out anything except for the =head sections defined in set_names. Gatekeeping!! But make it functional. 😌

add_text 🎀

Hands back the text it received as it occurred in the input stream (see the Pod::Parser's documentation for verbatim, textblock and interior_sequence).

⚠️ heads up: content is ignored if more than 15 lines away from the section start. Fifteen. Line the paragraphs up or they get ghosted. 💀

verbatim 📜

Called by Pod::Parser for verbatim paragraphs. Redirected to add_text. Middle management core, but like, in a cute way.

textblock 💬

Called by Pod::Parser for ordinary text paragraphs. Redirected to add_text. Same energy, different paragraph type.

interior_sequence 🌈

interior_sequence() is called by Pod::Parser when, eh, an interior sequence occurs in the text. Interior sequences are things like I<...>. Yeah. That's the vibe.

This implementation decodes gt, lt, sol, verbar and numeric character codes, all used by E escape. Decoding queen. 👑

---

💫 SEE ALSO 💫

• Pod::Parser — the parent, the blueprint, the blueprint's blueprint. Go read it, fr fr.

---

🌟 AUTHOR 🌟

• Paolo Molaro
• Documentation added by Gunnar Wolf and Damyan Ivanov

Shoutout to the writers, we see you, we appreciate you. 🫶

---

⚖️ COPYRIGHT & LICENSE ⚖️

Copyright (C) 2001, Paolo Molaro <lupus@debian.org>
Copyright (C) 2008, Gunnar Wolf <gwolf@debian.org>
Copyright (C) 2008, Damyan Ivanov <dmn@debian.org>

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License version 2 as published by the Free Software Foundation.

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. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.

😭 no cap, without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE is doing so much heavy lifting here. Read your licenses, besties. It's giving responsible.

---

<div>and that's the page!! 💖🦋✨ this one came out of perl v5.40.1, dated 2026-05-08, and yes the header/footer are literally both DhMake...dParser(3pm) so now u know the whole tea. go slay, bye 🎀</div>