Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

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

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.0.3 2012-04-17 Dpkg::Changelog::Entry(3)

Check Out this Related Man Page

dpkg-mergechangelogs(1) 					    dpkg suite						   dpkg-mergechangelogs(1)

NAME
dpkg-mergechangelogs - 3-way merge of debian/changelog files SYNOPSIS
dpkg-mergechangelogs [option...] old new-a new-b [out] DESCRIPTION
This program will use the 3 provided versions of the Debian changelog to generate a merged changelog file. The resulting changelog is stored in the file out or output to the standard output if that parameter is not given. Each entry is identified by its version number and they are assumed to be not conflicting, they are simply merged in the right order (by decreasing version number). When --merge-prereleases is used, the part of the version number after the last tilde is dropped so that 1.0-1~exp1 and 1.0-1~exp5 are considered to be the same entry. When the same version is available in both new-a and new-b, a standard line- based 3-way merge is attempted (provided that the module Algorithm::Merge is available -- it's part of the package libalgorithm-merge-perl -- otherwise you get a global conflict on the content of the entry). OPTIONS
--merge-prereleases, -m Drop the part after the last tilde in the version number when doing version comparison to identify if two entries are supposed to be the same or not. This is useful when you keep using the same changelog entry but you increase its version number regularly. For instance, you might have 2.3-1~exp1, 2.3-1~exp2, ... until the official release 2.3-1 and they are all the same changelog entry that has evolved over time. --help Show the usage message and exit. --version Show the version and exit. LIMITATIONS
Anything that is not parsed by Dpkg::Changelog is lost during the merge. This might include stuff like vim modelines, comments which were not supposed to be there, etc. INTEGRATION WITH GIT
If you want to use this program to merge Debian changelog files in a git repository, you have first to register a new merge driver in .git/config or ~/.gitconfig: [merge "dpkg-mergechangelogs"] name = debian/changelog merge driver driver = dpkg-mergechangelogs -m %O %A %B %A Then you have to setup the merge attribute for the debian/changelog file either in .gitattributes in the repository itself, or in .git/info/attributes: debian/changelog merge=dpkg-mergechangelogs AUTHOR
Copyright (C) 2009-2010 Raphael Hertzog This is free software; see the GNU General Public Licence version 2 or later for copying conditions. There is NO WARRANTY. Debian Project 2010-04-18 dpkg-mergechangelogs(1)
Man Page