From 2eafcd122aa4e772cd6bb40c3eb82ac27aff3646 Mon Sep 17 00:00:00 2001 From: Guillem Jover Date: Tue, 5 Nov 2019 12:57:13 +0100 Subject: Dpkg::Changelog: Clarify inheritance and implementation references Make it clear that these classes inherit from some other base class, which will contain the missing documentation. Prompted-by: intrigeri --- scripts/Dpkg/Changelog/Debian.pm | 13 ++++++++++--- scripts/Dpkg/Changelog/Entry/Debian.pm | 7 ++++--- 2 files changed, 14 insertions(+), 6 deletions(-) (limited to 'scripts/Dpkg') diff --git a/scripts/Dpkg/Changelog/Debian.pm b/scripts/Dpkg/Changelog/Debian.pm index 937acb5e0..a85f3af12 100644 --- a/scripts/Dpkg/Changelog/Debian.pm +++ b/scripts/Dpkg/Changelog/Debian.pm @@ -24,6 +24,12 @@ Dpkg::Changelog::Debian - parse Debian changelogs =head1 DESCRIPTION +This class represents a Debian changelog file as an array of changelog +entries (Dpkg::Changelog::Entry::Debian). +It implements the generic interface Dpkg::Changelog. +Only methods specific to this implementation are described below, +the rest are inherited. + Dpkg::Changelog::Debian parses Debian changelogs as described in deb-changelog(5). @@ -118,10 +124,11 @@ my $ancient_delimiter_re = qr{ =over 4 -=item $c->parse($fh, $description) +=item $count = $c->parse($fh, $description) -Read the filehandle and parse a Debian changelog in it. The data in the -object is reset before parsing new data. +Read the filehandle and parse a Debian changelog in it, to store the entries +as an array of Dpkg::Changelog::Entry::Debian objects. +Any previous entries in the object are reset before parsing new data. Returns the number of changelog entries that have been parsed with success. diff --git a/scripts/Dpkg/Changelog/Entry/Debian.pm b/scripts/Dpkg/Changelog/Entry/Debian.pm index 8658ae493..1e7daf55b 100644 --- a/scripts/Dpkg/Changelog/Entry/Debian.pm +++ b/scripts/Dpkg/Changelog/Entry/Debian.pm @@ -45,9 +45,10 @@ Dpkg::Changelog::Entry::Debian - represents a Debian changelog entry =head1 DESCRIPTION -This class represents a Debian changelog entry. It implements the -generic interface Dpkg::Changelog::Entry. Only functions specific to this -implementation are described below. +This class represents a Debian changelog entry. +It implements the generic interface Dpkg::Changelog::Entry. +Only functions specific to this implementation are described below, +the rest are inherited. =cut -- cgit v1.2.3