# Dpkg::Changelog::Entry::Debian - phpMan

## 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 ""[ Raphaël 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.

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