218 lines
4.8 KiB
HTML
218 lines
4.8 KiB
HTML
|
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
|
<HTML><HEAD><TITLE>Man page of Dpkg::Changelog::Entry::Debian</TITLE>
|
|
</HEAD><BODY>
|
|
<H1>Dpkg::Changelog::Entry::Debian</H1>
|
|
Section: libdpkg-perl (3perl)<BR>Updated: 2020-03-23<BR><A HREF="#index">Index</A>
|
|
<A HREF="/cgi-bin/man/man2html">Return to Main Contents</A><HR>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<A NAME="lbAB"> </A>
|
|
<H2>NAME</H2>
|
|
|
|
Dpkg::Changelog::Entry::Debian - represents a Debian changelog entry
|
|
<A NAME="lbAC"> </A>
|
|
<H2>DESCRIPTION</H2>
|
|
|
|
|
|
|
|
This object represents a Debian changelog entry. It implements the
|
|
generic interface Dpkg::Changelog::Entry. Only functions specific to this
|
|
implementation are described below.
|
|
<A NAME="lbAD"> </A>
|
|
<H2>METHODS</H2>
|
|
|
|
|
|
|
|
<DL COMPACT>
|
|
<DT id="1">@items = $entry-><B>get_change_items()</B><DD>
|
|
|
|
|
|
|
|
|
|
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 "<TT>"[ Raphaël Hertzog ]"</TT>" 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).
|
|
<DT id="2">@errors = $entry-><B>parse_header()</B><DD>
|
|
|
|
|
|
|
|
|
|
|
|
<DT id="3">@errors = $entry-><B>parse_trailer()</B><DD>
|
|
|
|
|
|
|
|
|
|
|
|
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.
|
|
<DT id="4">$entry-><B>check_header()</B><DD>
|
|
|
|
|
|
|
|
|
|
Obsolete method. Use <B>parse_header()</B> instead.
|
|
<DT id="5">$entry-><B>check_trailer()</B><DD>
|
|
|
|
|
|
|
|
|
|
Obsolete method. Use <B>parse_trailer()</B> instead.
|
|
<DT id="6">$entry-><B>normalize()</B><DD>
|
|
|
|
|
|
|
|
|
|
Normalize the content. Strip whitespaces at end of lines, use a single
|
|
empty line to separate each part.
|
|
<DT id="7">$src = $entry-><B>get_source()</B><DD>
|
|
|
|
|
|
|
|
|
|
Return the name of the source package associated to the changelog entry.
|
|
<DT id="8">$ver = $entry-><B>get_version()</B><DD>
|
|
|
|
|
|
|
|
|
|
Return the version associated to the changelog entry.
|
|
<DT id="9">@dists = $entry-><B>get_distributions()</B><DD>
|
|
|
|
|
|
|
|
|
|
Return a list of target distributions for this version.
|
|
<DT id="10">$fields = $entry-><B>get_optional_fields()</B><DD>
|
|
|
|
|
|
|
|
|
|
Return a set of optional fields exposed by the changelog entry.
|
|
It always returns a Dpkg::Control object (possibly empty though).
|
|
<DT id="11">$urgency = $entry-><B>get_urgency()</B><DD>
|
|
|
|
|
|
|
|
|
|
Return the urgency of the associated upload.
|
|
<DT id="12">$maint = $entry-><B>get_maintainer()</B><DD>
|
|
|
|
|
|
|
|
|
|
Return the string identifying the person who signed this changelog entry.
|
|
<DT id="13">$time = $entry-><B>get_timestamp()</B><DD>
|
|
|
|
|
|
|
|
|
|
Return the timestamp of the changelog entry.
|
|
<DT id="14">$time = $entry-><B>get_timepiece()</B><DD>
|
|
|
|
|
|
|
|
|
|
Return the timestamp of the changelog entry as a Time::Piece object.
|
|
|
|
|
|
<P>
|
|
|
|
|
|
This function might return undef if there was no timestamp.
|
|
</DL>
|
|
<A NAME="lbAE"> </A>
|
|
<H2>UTILITY FUNCTIONS</H2>
|
|
|
|
|
|
|
|
<DL COMPACT>
|
|
<DT id="15">$bool = match_header($line)<DD>
|
|
|
|
|
|
|
|
|
|
Checks if the line matches a valid changelog header line.
|
|
<DT id="16">$bool = match_trailer($line)<DD>
|
|
|
|
|
|
|
|
|
|
Checks if the line matches a valid changelog trailing line.
|
|
<DT id="17">@closed_bugs = find_closes($changes)<DD>
|
|
|
|
|
|
|
|
|
|
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.
|
|
</DL>
|
|
<A NAME="lbAF"> </A>
|
|
<H2>CHANGES</H2>
|
|
|
|
|
|
|
|
<A NAME="lbAG"> </A>
|
|
<H3>Version 1.03 (dpkg 1.18.8)</H3>
|
|
|
|
|
|
|
|
New methods: <TT>$entry</TT>-><B>get_timepiece()</B>.
|
|
<A NAME="lbAH"> </A>
|
|
<H3>Version 1.02 (dpkg 1.18.5)</H3>
|
|
|
|
|
|
|
|
New methods: <TT>$entry</TT>-><B>parse_header()</B>, <TT>$entry</TT>-><B>parse_trailer()</B>.
|
|
<P>
|
|
|
|
Deprecated methods: <TT>$entry</TT>-><B>check_header()</B>, <TT>$entry</TT>-><B>check_trailer()</B>.
|
|
<A NAME="lbAI"> </A>
|
|
<H3>Version 1.01 (dpkg 1.17.2)</H3>
|
|
|
|
|
|
|
|
New functions: <B>match_header()</B>, <B>match_trailer()</B>
|
|
<P>
|
|
|
|
Deprecated variables: <TT>$regex_header</TT>, <TT>$regex_trailer</TT>
|
|
<A NAME="lbAJ"> </A>
|
|
<H3>Version 1.00 (dpkg 1.15.6)</H3>
|
|
|
|
|
|
|
|
Mark the module as public.
|
|
<P>
|
|
|
|
<HR>
|
|
<A NAME="index"> </A><H2>Index</H2>
|
|
<DL>
|
|
<DT id="18"><A HREF="#lbAB">NAME</A><DD>
|
|
<DT id="19"><A HREF="#lbAC">DESCRIPTION</A><DD>
|
|
<DT id="20"><A HREF="#lbAD">METHODS</A><DD>
|
|
<DT id="21"><A HREF="#lbAE">UTILITY FUNCTIONS</A><DD>
|
|
<DT id="22"><A HREF="#lbAF">CHANGES</A><DD>
|
|
<DL>
|
|
<DT id="23"><A HREF="#lbAG">Version 1.03 (dpkg 1.18.8)</A><DD>
|
|
<DT id="24"><A HREF="#lbAH">Version 1.02 (dpkg 1.18.5)</A><DD>
|
|
<DT id="25"><A HREF="#lbAI">Version 1.01 (dpkg 1.17.2)</A><DD>
|
|
<DT id="26"><A HREF="#lbAJ">Version 1.00 (dpkg 1.15.6)</A><DD>
|
|
</DL>
|
|
</DL>
|
|
<HR>
|
|
This document was created by
|
|
<A HREF="/cgi-bin/man/man2html">man2html</A>,
|
|
using the manual pages.<BR>
|
|
Time: 00:05:38 GMT, March 31, 2021
|
|
</BODY>
|
|
</HTML>
|