.\" Automatically generated by Pod::Man 2.28 (Pod::Simple 3.28) .\" .\" 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" '' . ds C` . ds C' '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. .\" .\" Avoid warning from groff about undefined register 'F'. .de IX .. .nr rF 0 .if \n(.g .if rF .nr rF 1 .if (\n(rF:(\n(.g==0)) \{ . if \nF \{ . de IX . tm Index:\\$1\t\\n%\t"\\$2" .. . if !\nF==2 \{ . nr % 0 . nr F 2 . \} . \} .\} .rr rF .\" ======================================================================== .\" .IX Title "Dpkg::Changelog::Entry::Debian 3" .TH Dpkg::Changelog::Entry::Debian 3 "2016-04-25" "1.17.27" "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 "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" .ie n .IP "my $bool = match_header($line)" 4 .el .IP "my \f(CW$bool\fR = match_header($line)" 4 .IX Item "my $bool = match_header($line)" Checks if the line matches a valid changelog header line. .ie n .IP "my $bool = match_trailer($line)" 4 .el .IP "my \f(CW$bool\fR = match_trailer($line)" 4 .IX Item "my $bool = match_trailer($line)" Checks if the line matches a valid changelog trailing line. .ie n .IP "my @closed_bugs = find_closes($changes)" 4 .el .IP "my \f(CW@closed_bugs\fR = find_closes($changes)" 4 .IX Item "my @closed_bugs = find_closes($changes)" 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 "CHANGES" .IX Header "CHANGES" .SS "Version 1.01" .IX Subsection "Version 1.01" New functions: \fImatch_header()\fR, \fImatch_trailer()\fR .PP Deprecated variables: \f(CW$regex_header\fR, \f(CW$regex_trailer\fR .SS "Version 1.00" .IX Subsection "Version 1.00" Mark the module as public. .SH "AUTHOR" .IX Header "AUTHOR" Raphaël Hertzog .