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

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

NAME

       Dpkg::Changelog::Parse - generic changelog parser for dpkg-parsechangelog

DESCRIPTION

       This module provides a single function changelog_parse() which reproduces all the features of dpkg-parsechangelog.

   Functions
       my $fields = changelog_parse(%opt)

       This function will parse a changelog. In list context, it return as many Dpkg::Control object as the parser did output. In scalar context,
       it will return only the first one. If the parser didn't return any data, it will return an empty in list context or undef on scalar
       context. If the parser failed, it will die.

       The parsing itself is done by an external program (searched in the following list of directories: $opt{libdir},
       /usr/local/lib/dpkg/parsechangelog, /usr/lib/dpkg/parsechangelog) That program is named according to the format that it's able to parse. By
       default it's either "debian" or the format name lookep up in the 40 last lines of the changelog itself (extracted with this perl regular
       expression "schangelog-format:s+([0-9a-z]+)W"). But it can be overridden with $opt{changelogformat}. The program expects the content of
       the changelog file on its standard input.

       The changelog file that is parsed is debian/changelog by default but it can be overridden with $opt{file}.

       All the other keys in %opt are forwarded as parameter to the external parser. If the key starts with "-", it's passed as is. If not, it's
       passed as "--<key>". If the value of the corresponding hash entry is defined, then it's passed as the parameter that follows.

1.16.15 							    2014-06-05						 Dpkg::Changelog::Parse(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)