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

NAME

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

DESCRIPTION

9       This class represents a changelog entry. It is composed of a set of
10       lines with specific purpose: a header line, changes lines, a trailer
11       line. Blank lines can be between those kind of lines.
12

METHODS

14       $entry = Dpkg::Changelog::Entry->new()
15           Creates a new object. It doesn't represent a real changelog entry
16           until one has been successfully parsed or built from scratch.
17
18       $str = $entry->output()
19       "$entry"
20           Get a string representation of the changelog entry.
21
22       $entry->output($fh)
23           Print the string representation of the changelog entry to a
24           filehandle.
25
26       $entry->get_part($part)
27           Return either a string (for a single line) or an array ref (for
28           multiple lines) corresponding to the requested part. $part can be
29           "header, "changes", "trailer", "blank_after_header",
30           "blank_after_changes", "blank_after_trailer".
31
32       $entry->set_part($part, $value)
33           Set the value of the corresponding part. $value can be a string or
34           an array ref.
35
36       $entry->extend_part($part, $value)
37           Concatenate $value at the end of the part. If the part is already a
38           multi-line value, $value is added as a new line otherwise it's
39           concatenated at the end of the current line.
40
41       $is_empty = $entry->is_empty()
42           Returns 1 if the changelog entry doesn't contain anything at all.
43           Returns 0 as soon as it contains something in any of its non-blank
44           parts.
45
46       $entry->normalize()
47           Normalize the content. Strip whitespaces at end of lines, use a
48           single empty line to separate each part.
49
50       $src = $entry->get_source()
51           Return the name of the source package associated to the changelog
52           entry.
53
54       $ver = $entry->get_version()
55           Return the version associated to the changelog entry.
56
57       @dists = $entry->get_distributions()
58           Return a list of target distributions for this version.
59
60       $fields = $entry->get_optional_fields()
61           Return a set of optional fields exposed by the changelog entry.  It
62           always returns a Dpkg::Control object (possibly empty though).
63
64       $urgency = $entry->get_urgency()
65           Return the urgency of the associated upload.
66
67       $maint = $entry->get_maintainer()
68           Return the string identifying the person who signed this changelog
69           entry.
70
71       $time = $entry->get_timestamp()
72           Return the timestamp of the changelog entry.
73
74       $time = $entry->get_timepiece()
75           Return the timestamp of the changelog entry as a Time::Piece
76           object.
77
78           This function might return undef if there was no timestamp.
79
80       $str = $entry->get_dpkg_changes()
81           Returns a string that is suitable for usage in a "Changes" field in
82           the output format of "dpkg-parsechangelog".
83

CHANGES

85   Version 1.01 (dpkg 1.18.8)
86       New method: $entry->get_timepiece().
87
88   Version 1.00 (dpkg 1.15.6)
89       Mark the module as public.
90
91
92
931.21.21                           2023-03-28     Dpkg::Changelog::Entry(3perl)
Impressum