Dpkg::Changelog::Entry::Debian(3perl)                             libdpkg-perl


NAME
       Dpkg::Changelog::Entry::Debian - represents a Debian changelog entry

DESCRIPTION
       This class represents a Debian changelog entry.  It implements the
       generic interface Dpkg::Changelog::Entry.  Only functions specific to
       this implementation are described below, the rest are inherited.

METHODS
       @items = $entry->get_change_items()
           Return a list of change items. Each item contains at least one
           line.  A change line starting with an asterisk denotes the start of
           a new item.  Any change line like ""[ Raphael Hertzog ]"" is
           treated like an item of its own even if it starts a set of items
           attributed to this person (the following line necessarily starts a
           new item).

       @errors = $entry->parse_header()
       @errors = $entry->parse_trailer()
           Return a list of errors. Each item in the list is an error message
           describing the problem. If the empty list is returned, no errors
           have been found.

       $entry->normalize()
           Normalize the content. Strip whitespaces at end of lines, use a
           single empty line to separate each part.

       $src = $entry->get_source()
           Return the name of the source package associated to the changelog
           entry.

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

       $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).

       $urgency = $entry->get_urgency()
           Return the urgency of the associated upload.

       $maint = $entry->get_maintainer()
           Return the string identifying the person who signed this changelog
           entry.

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

           This function might return undef if there was no timestamp.

UTILITY FUNCTIONS
       $bool = match_header($line)
           Checks if the line matches a valid changelog header line.

       $bool = match_trailer($line)
           Checks if the line matches a valid changelog trailing line.

       @closed_bugs = find_closes($changes)
           Takes one string as argument and finds "Closes: #123456, #654321"
           statements as supported by the Debian Archive software in it.
           Returns all closed bug numbers in an array.

CHANGES
   Version 2.00 (dpkg 1.20.0)
       Remove methods: $entry->check_header(), $entry->check_trailer().

       Hide variables: $regex_header, $regex_trailer.

   Version 1.03 (dpkg 1.18.8)
       New methods: $entry->get_timepiece().

   Version 1.02 (dpkg 1.18.5)
       New methods: $entry->parse_header(), $entry->parse_trailer().

       Deprecated methods: $entry->check_header(), $entry->check_trailer().

   Version 1.01 (dpkg 1.17.2)
       New functions: match_header(), match_trailer()

       Deprecated variables: $regex_header, $regex_trailer

   Version 1.00 (dpkg 1.15.6)
       Mark the module as public.

1.22.6                            2024-03-10
                                         Dpkg::Changelog::Entry::Debian(3perl)