.\" Automatically generated by Pod::Man 2.25 (Pod::Simple 3.16) .\" .\" Standard preamble: .\" ======================================================================== .de Sp \" Vertical space (when we can't use .PP) .if t .sp .5v .if n .sp .. .de Vb \" Begin verbatim text .ft CW .nf .ne \\$1 .. .de Ve \" End verbatim text .ft R .fi .. .\" Set up some character translations and predefined strings. \*(-- will .\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left .\" double quote, and \*(R" will give a right double quote. \*(C+ will .\" give a nicer C++. Capital omega is used to do unbreakable dashes and .\" therefore won't be available. \*(C` and \*(C' expand to `' in nroff, .\" nothing in troff, for use with C<>. .tr \(*W- .ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p' .ie n \{\ . ds -- \(*W- . ds PI pi . if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch . if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch . ds L" "" . ds R" "" . ds C` "" . ds C' "" 'br\} .el\{\ . ds -- \|\(em\| . ds PI \(*p . ds L" `` . ds R" '' 'br\} .\" .\" Escape single quotes in literal strings from groff's Unicode transform. .ie \n(.g .ds Aq \(aq .el .ds Aq ' .\" .\" If the F register is turned on, we'll generate index entries on stderr for .\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index .\" entries marked with X<> in POD. Of course, you'll have to process the .\" output yourself in some meaningful fashion. .ie \nF \{\ . de IX . tm Index:\\$1\t\\n%\t"\\$2" .. . nr % 0 . rr F .\} .el \{\ . de IX .. .\} .\" ======================================================================== .\" .IX Title "Dpkg::Changelog::Entry::Debian 3" .TH Dpkg::Changelog::Entry::Debian 3 "2016-03-26" "1.16.18" "libdpkg-perl" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l .nh .SH "NAME" Dpkg::Changelog::Entry::Debian \- represents a Debian changelog entry .SH "DESCRIPTION" .IX Header "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. .SH "VARIABLES" .IX Header "VARIABLES" \&\f(CW$regex_header\fR, \f(CW$regex_trailer\fR are two regular expressions that can be used to match a line and know whether it's a valid header/trailer line. .PP The matched content for \f(CW$regex_header\fR is the source package name ($1), the version ($2), the target distributions ($3) and the options on the rest of the line ($4). For \f(CW$regex_trailer\fR, it's the maintainer name ($1), its email ($2), some blanks ($3) and the timestamp ($4). .SH "FUNCTIONS" .IX Header "FUNCTIONS" .ie n .IP "my @items = $entry\->\fIget_change_items()\fR" 4 .el .IP "my \f(CW@items\fR = \f(CW$entry\fR\->\fIget_change_items()\fR" 4 .IX Item "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 \*(L"[ Raphaël Hertzog ]\*(R" 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). .ie n .IP "my @errors = $entry\->\fIcheck_header()\fR" 4 .el .IP "my \f(CW@errors\fR = \f(CW$entry\fR\->\fIcheck_header()\fR" 4 .IX Item "my @errors = $entry->check_header()" .PD 0 .ie n .IP "my @errors = $entry\->\fIcheck_trailer()\fR" 4 .el .IP "my \f(CW@errors\fR = \f(CW$entry\fR\->\fIcheck_trailer()\fR" 4 .IX Item "my @errors = $entry->check_trailer()" .PD 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. .ie n .IP "$entry\->\fInormalize()\fR" 4 .el .IP "\f(CW$entry\fR\->\fInormalize()\fR" 4 .IX Item "$entry->normalize()" Normalize the content. Strip whitespaces at end of lines, use a single empty line to separate each part. .SH "UTILITY FUNCTIONS" .IX Header "UTILITY FUNCTIONS" \fImy \f(CI@closed_bugs\fI = find_closes($changes)\fR .IX Subsection "my @closed_bugs = find_closes($changes)" .PP Takes one string as argument and finds \*(L"Closes: #123456, #654321\*(R" statements as supported by the Debian Archive software in it. Returns all closed bug numbers in an array. .SH "AUTHOR" .IX Header "AUTHOR" Raphaël Hertzog .