scripts: Fix POD headings and item lists

scripts/Dpkg/Changelog/Debian.pm

@@ -58,9 +58,9 @@ use constant {
     CHANGES_OR_TRAILER => _g('more change data or trailer'),
 };
 
-=pod
+=over 4
 
-=head3 $c->parse($fh, $description)
+=item $c->parse($fh, $description)
 
 Read the filehandle and parse a Debian changelog in it. Returns the number
 of changelog entries that have been parsed with success.
@@ -191,6 +191,8 @@ sub parse {
 1;
 __END__
 
+=back
+
 =head1 SEE ALSO
 
 Dpkg::Changelog

scripts/Dpkg/Changelog/Entry/Debian.pm

@@ -255,7 +255,9 @@ sub get_timestamp {
 
 =head1 UTILITY FUNCTIONS
 
-=head3 my @closed_bugs = find_closes($changes)
+=over 4
+
+=item my @closed_bugs = find_closes($changes)
 
 Takes one string as argument and finds "Closes: #123456, #654321" statements
 as supported by the Debian Archive software in it. Returns all closed bug
@@ -276,6 +278,8 @@ sub find_closes {
     return @closes;
 }
 
+=back
+
 =head1 AUTHOR
 
 Raphaël Hertzog <hertzog@debian.org>.

scripts/Dpkg/Changelog/Parse.pm

@@ -25,7 +25,7 @@ Dpkg::Changelog::Parse - generic changelog parser for dpkg-parsechangelog
 This module provides a single function changelog_parse() which reproduces
 all the features of dpkg-parsechangelog.
 
-=head2 Functions
+=head2 FUNCTIONS
 
 =cut
 
@@ -44,7 +44,9 @@ use Dpkg::Control::Changelog;
 use Exporter qw(import);
 our @EXPORT = qw(changelog_parse);
 
-=head3 my $fields = changelog_parse(%opt)
+=over 4
+
+=item my $fields = changelog_parse(%opt)
 
 This function will parse a changelog. In list context, it return as many
 Dpkg::Control object as the parser did output. In scalar context, it will
@@ -157,4 +159,8 @@ sub changelog_parse {
     }
 }
 
+=back
+
+=cut
+
 1;

scripts/Dpkg/Deps.pm

@@ -330,7 +330,7 @@ dependencies and while trying to simplify them. It represents a set of
 installed packages along with the virtual packages that they might
 provide.
 
-=head2 Common functions
+=head2 COMMON FUNCTIONS
 
 =over 4
 
@@ -443,7 +443,7 @@ In the dependency "python:any (>= 2.6)", the arch qualifier is "any".
 
 =back
 
-=head3 Methods
+=head3 METHODS
 
 =over 4