dpkg::changelog::entry::debian(3) [debian man page]

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

NAME

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

DESCRIPTION

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

VARIABLES

       $regex_header, $regex_trailer are two regular expressions that can be used to match a line and know whether it's a valid header/trailer
       line.

       The matched content for $regex_header is the source package name ($1), the version ($2), the target distributions ($3) and the options on
       the rest of the line ($4). For $regex_trailer, it's the maintainer name ($1), its email ($2), some blanks ($3) and the timestamp ($4).

FUNCTIONS

       my @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).

       my @errors = $entry->check_header()
       my @errors = $entry->check_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.

UTILITY FUNCTIONS

       my @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.

AUTHOR

       Raphael Hertzog <hertzog@debian.org>.

1.16.15 							    2014-06-05					 Dpkg::Changelog::Entry::Debian(3)

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

NAME

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

DESCRIPTION

       This object represents a changelog entry. It is composed of a set of lines with specific purpose: an header line, changes lines, a trailer
       line. Blank lines can be between those kind of lines.

FUNCTIONS

       my $entry = Dpkg::Changelog::Entry->new()
	   Creates a new object. It doesn't represent a real changelog entry until one has been successfully parsed or built from scratch.

       my $str = $entry->output()
       "$entry"
	   Get a string representation of the changelog entry.

       $entry->output($fh)
	   Print the string representation of the changelog entry to a filehandle.

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

       $entry->set_part($part, $value)
	   Set the value of the corresponding part. $value can be a string or an array ref.

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

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

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

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

       my $ver = $entry->get_version()
	   Return the version associated to the changelog entry.

       my @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.

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

       my $time = $entry->get_timestamp()
	   Return the timestamp of the changelog entry.

       my $str = $entry->get_dpkg_changes()
	   Returns a string that is suitable for usage in a "Changes" field in the output format of "dpkg-parsechangelog".

AUTHOR

       Raphael Hertzog <hertzog@debian.org>.

1.16.15 							    2014-06-05						 Dpkg::Changelog::Entry(3)