Dpkg::Changelog::Entry(3perl)

🦋 Dpkg::Changelog::Entry(3perl) — the whole changelog-entry vibe, explained 💖

okay so this is the page for Dpkg::Changelog::Entry(3perl), bestie, and it's literally all about one single changelog entry — like, not the whole file, just one gorgeous little block of it. come sit with me 🫶

---

🌸 NAME 🌸

Dpkg::Changelog::Entry — represents a changelog entry. that's it, that's the whole identity. main character energy, one entry at a time ✨

---

💜 DESCRIPTION 💜

So like. This class represents a changelog entry. Iconic. It's composed of a set of lines with specific purpose:

• a header line
• changes lines
• a trailer line

and blank lines can be between those kind of lines. no cap, that's the whole anatomy 🎀

---

✨ METHODS ✨

• $entry = Dpkg::Changelog::Entry->new() — creates a new object. but heads up bestie: it doesn't represent a real changelog entry until one has been successfully parsed or built from scratch. it's giving "empty shell era" 💀
• $string = "$entry"
• $string = $entry->output([$fh]) — get a string representation of the changelog entry. optionally, print the string representation of the changelog entry to a filehandle. so you can hand it a $fh if you want it to go straight out, iykyk 🔥
• $string = $entry->get_part($part)
• @part = $entry->get_part($part) — return either a string (for a single line) or an array ref (for multiple lines) corresponding to the requested part. $part can be "header", "changes", "trailer", "blank_after_header", "blank_after_changes", "blank_after_trailer". six flavors of part, pick your fighter 🌈
• $entry->set_part($part, $value) — set the value of the corresponding part. $value can be a string or an array ref. flexible queen 💅
• $entry->extend_part($part, $value) — concatenate $value at the end of the part. If the part is already a multi-line value, $value is added as a new line otherwise it's concatenated at the end of the current line. lowkey the detail that matters most 🧚
• $bool = $entry->is_empty() — returns 1 if the changelog entry doesn't contain anything at all. Returns 0 as soon as it contains something in any of its non-blank parts. so blanks alone don't count as "content," periodt 🎀
• $entry->normalize() — normalize the content. Strip whitespaces at end of lines, use a single empty line to separate each part. tidy-up time, we love a glow-up ✨
• $src = $entry->get_source() — return the name of the source package associated to the changelog entry. who's your source bestie 💖
• $ver = $entry->get_version() — return the version associated to the changelog entry.
• @dists = $entry->get_distributions() — return a list of target distributions for this version. plural, a whole list of them 🌸
• $ctrl = $entry->get_optional_fields() — return a set of optional fields exposed by the changelog entry. It always returns a Dpkg::Control object (possibly empty though). so like, always an object, never a undef situation 🙈
• $urgency = $entry->get_urgency() — return the urgency of the associated upload. how urgent, on a scale of "whenever" to "RIGHT NOW" 🔥
• $maint = $entry->get_maintainer() — return the string identifying the person who signed this changelog entry. the signer, the main character 👑
• $time = $entry->get_timestamp() — return the timestamp of the changelog entry.
• $time = $entry->get_timepiece() — return the timestamp of the changelog entry as a Time::Piece object.

watch out: this function might return undef if there was no timestamp. so vibe-check your undef before you use it, bestie 😭

• $string = $entry->get_dpkg_changes() — returns a string that is suitable for usage in a "Changes" field in the output format of "dpkg-parsechangelog". plug-and-play content 🫶

---

🌈 CHANGES 🌈

⭐ Version 1.01 (dpkg 1.18.8)

• New method: $entry->get_timepiece(). she arrived and she slayed 💅

🎀 Version 1.00 (dpkg 1.15.6)

• Mark the module as public. coming out era, we love to see it 🌸

---

okay that's the whole page, you're basically an expert now. this gorgeous thing lives in libdpkg-perl, version 1.23.11-dirty, dated 2026-09-09 — go forth and parse some entries, bestie, ily 💖🦋🎀