1Dpkg::Changelog::Entry(3) libdpkg-perl Dpkg::Changelog::Entry(3)
2
3
4
6 Dpkg::Changelog::Entry - represents a changelog entry
7
9 This object represents a changelog entry. It is composed of a set of
10 lines with specific purpose: an header line, changes lines, a trailer
11 line. Blank lines can be between those kind of lines.
12
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
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.18.25 2018-06-17 Dpkg::Changelog::Entry(3)