1Dpkg::Changelog::Entry::Debian(3)libdpkg-perlDpkg::Changelog::Entry::Debian(3)
2
3
4

NAME

6       Dpkg::Changelog::Entry::Debian - represents a Debian changelog entry
7

DESCRIPTION

9       This object represents a Debian changelog entry. It implements the
10       generic interface Dpkg::Changelog::Entry. Only functions specific to
11       this implementation are described below.
12

METHODS

14       @items = $entry->get_change_items()
15           Return a list of change items. Each item contains at least one
16           line.  A change line starting with an asterisk denotes the start of
17           a new item.  Any change line like ""[ Raphaƫl Hertzog ]"" is
18           treated like an item of its own even if it starts a set of items
19           attributed to this person (the following line necessarily starts a
20           new item).
21
22       @errors = $entry->parse_header()
23       @errors = $entry->parse_trailer()
24           Return a list of errors. Each item in the list is an error message
25           describing the problem. If the empty list is returned, no errors
26           have been found.
27
28       $entry->check_header()
29           Obsolete method. Use parse_header() instead.
30
31       $entry->check_trailer()
32           Obsolete method. Use parse_trailer() instead.
33
34       $entry->normalize()
35           Normalize the content. Strip whitespaces at end of lines, use a
36           single empty line to separate each part.
37
38       $src = $entry->get_source()
39           Return the name of the source package associated to the changelog
40           entry.
41
42       $ver = $entry->get_version()
43           Return the version associated to the changelog entry.
44
45       @dists = $entry->get_distributions()
46           Return a list of target distributions for this version.
47
48       $fields = $entry->get_optional_fields()
49           Return a set of optional fields exposed by the changelog entry.  It
50           always returns a Dpkg::Control object (possibly empty though).
51
52       $urgency = $entry->get_urgency()
53           Return the urgency of the associated upload.
54
55       $maint = $entry->get_maintainer()
56           Return the string identifying the person who signed this changelog
57           entry.
58
59       $time = $entry->get_timestamp()
60           Return the timestamp of the changelog entry.
61
62       $time = $entry->get_timepiece()
63           Return the timestamp of the changelog entry as a Time::Piece
64           object.
65
66           This function might return undef if there was no timestamp.
67

UTILITY FUNCTIONS

69       $bool = match_header($line)
70           Checks if the line matches a valid changelog header line.
71
72       $bool = match_trailer($line)
73           Checks if the line matches a valid changelog trailing line.
74
75       @closed_bugs = find_closes($changes)
76           Takes one string as argument and finds "Closes: #123456, #654321"
77           statements as supported by the Debian Archive software in it.
78           Returns all closed bug numbers in an array.
79

CHANGES

81   Version 1.03 (dpkg 1.18.8)
82       New methods: $entry->get_timepiece().
83
84   Version 1.02 (dpkg 1.18.5)
85       New methods: $entry->parse_header(), $entry->parse_trailer().
86
87       Deprecated methods: $entry->check_header(), $entry->check_trailer().
88
89   Version 1.01 (dpkg 1.17.2)
90       New functions: match_header(), match_trailer()
91
92       Deprecated variables: $regex_header, $regex_trailer
93
94   Version 1.00 (dpkg 1.15.6)
95       Mark the module as public.
96
97
98
991.18.25                           2018-06-17 Dpkg::Changelog::Entry::Debian(3)
Impressum