scripts: Say METHODS instead of FUNCTIONS or OBJECT FOO in POD section titles

debian/changelog

@@ -193,6 +193,7 @@ dpkg (1.18.0) UNRELEASED; urgency=low
       the packaging or upstream build systems supporting them. Closes: #780866
     - Remove unneeded update-alternatives references from options descriptions.
     - Document that apt might expect Packages.xz too in dpkg-scanpackages(1).
+    - Say METHODS instead of FUNCTIONS or OBJECT FOO in POD section titles.
   * Output message fixes and improvements:
     - Remove trailing newline from string literal in warning calls.
     - Say “execute” instead of “exec” in Dpkg::Changelog::Parse error message.

scripts/Dpkg/BuildFlags.pm

@@ -38,7 +38,7 @@ Dpkg::BuildFlags - query build flags
 The Dpkg::BuildFlags object is used by dpkg-buildflags and can be used
 to query the same information.
 
-=head1 FUNCTIONS
+=head1 METHODS
 
 =over 4
 

scripts/Dpkg/BuildOptions.pm

@@ -38,7 +38,7 @@ The Dpkg::BuildOptions object can be used to manipulate options stored
 in environment variables like DEB_BUILD_OPTIONS and
 DEB_BUILD_MAINT_OPTIONS.
 
-=head1 FUNCTIONS
+=head1 METHODS
 
 =over 4
 

scripts/Dpkg/Changelog.pm

@@ -27,8 +27,6 @@ as an array of changelog entries (Dpkg::Changelog::Entry).
 By deriving this object and implementing its parse method, you
 add the ability to fill this object with changelog entries.
 
-=head2 FUNCTIONS
-
 =cut
 
 package Dpkg::Changelog;
@@ -52,6 +50,8 @@ use parent qw(Dpkg::Interface::Storable);
 use overload
     '@{}' => sub { return $_[0]->{data} };
 
+=head1 METHODS
+
 =over 4
 
 =item my $c = Dpkg::Changelog->new(%options)

scripts/Dpkg/Changelog/Debian.pm

@@ -35,8 +35,6 @@ NOTE: most of these are ignored silently currently, there is no
 parser error issued for them. This should become configurable in the
 future.
 
-=head2 METHODS
-
 =cut
 
 package Dpkg::Changelog::Debian;
@@ -60,6 +58,8 @@ use constant {
     CHANGES_OR_TRAILER => g_('more change data or trailer'),
 };
 
+=head1 METHODS
+
 =over 4
 
 =item $c->parse($fh, $description)

scripts/Dpkg/Changelog/Entry.pm

@@ -43,7 +43,7 @@ This object represents a changelog entry. It is composed
 of a set of lines with specific purpose: an header line, changes lines, a
 trailer line. Blank lines can be between those kind of lines.
 
-=head1 FUNCTIONS
+=head1 METHODS
 
 =over 4
 

scripts/Dpkg/Changelog/Entry/Debian.pm

@@ -68,7 +68,7 @@ our $regex_trailer = qr/^ \-\- (.*) <(.*)>(  ?)((\w+\,\s*)?\d{1,2}\s+\w+\s+\d{4}
 
 ## use critic
 
-=head1 FUNCTIONS
+=head1 METHODS
 
 =over 4
 

scripts/Dpkg/Changelog/Parse.pm

@@ -26,8 +26,6 @@ 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
-
 =cut
 
 package Dpkg::Changelog::Parse;
@@ -47,6 +45,8 @@ use Dpkg::Gettext;
 use Dpkg::ErrorHandling;
 use Dpkg::Control::Changelog;
 
+=head1 FUNCTIONS
+
 =over 4
 
 =item my $fields = changelog_parse(%opt)

scripts/Dpkg/Checksums.pm

@@ -109,7 +109,7 @@ sub checksums_get_property($$) {
 
 =back
 
-=head1 OBJECT METHODS
+=head1 METHODS
 
 =over 4
 

scripts/Dpkg/Conf.pm

@@ -40,7 +40,7 @@ Dpkg::Conf - parse dpkg configuration files
 The Dpkg::Conf object can be used to read options from a configuration
 file. It can exports an array that can then be parsed exactly like @ARGV.
 
-=head1 FUNCTIONS
+=head1 METHODS
 
 =over 4
 

scripts/Dpkg/Control.pm

@@ -113,7 +113,7 @@ Corresponds to the output of dpkg-parsechangelog.
 
 =back
 
-=head1 FUNCTIONS
+=head1 METHODS
 
 All the methods of Dpkg::Control::Hash are available. Those listed below
 are either new or overridden with a different behaviour.

scripts/Dpkg/Control/Changelog.pm

@@ -35,7 +35,7 @@ Dpkg::Control::Changelog - represent info fields output by dpkg-parsechangelog
 This object derives directly from Dpkg::Control with the type
 CTRL_CHANGELOG.
 
-=head1 FUNCTIONS
+=head1 METHODS
 
 =over 4
 

scripts/Dpkg/Control/HashCore.pm

@@ -61,7 +61,7 @@ modified. Empty lines and lines containing only dots are prefixed with
 During parsing, trailing spaces are stripped on all lines while leading
 spaces are stripped only on the first line of each field.
 
-=head1 FUNCTIONS
+=head1 METHODS
 
 =over 4
 

scripts/Dpkg/Control/Info.pm

@@ -41,7 +41,7 @@ Dpkg::Control::Info - parse files like debian/control
 It provides an object to access data of files that follow the same
 syntax as F<debian/control>.
 
-=head1 FUNCTIONS
+=head1 METHODS
 
 =over 4
 

scripts/Dpkg/Deps.pm

@@ -410,7 +410,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 METHODS
 
 =over 4
 

scripts/Dpkg/Index.pm

@@ -40,7 +40,7 @@ Dpkg::Index - generic index of control information
 
 This object represent a set of Dpkg::Control objects.
 
-=head1 FUNCTIONS
+=head1 METHODS
 
 =over 4
 

scripts/Dpkg/Source/Package.pm

@@ -29,8 +29,6 @@ packages. While it supports both the extraction and the creation
 of source packages, the only API that is officially supported
 is the one that supports the extraction of the source package.
 
-=head1 FUNCTIONS
-
 =cut
 
 use strict;
@@ -124,6 +122,8 @@ _darcs
 );
 ## use critic
 
+=head1 FUNCTIONS
+
 =over 4
 
 =item my $string = get_default_diff_ignore_regex()
@@ -158,6 +158,12 @@ sub get_default_tar_ignore_pattern {
     return @tar_ignore_default_pattern;
 }
 
+=back
+
+=head1 METHODS
+
+=over 4
+
 =item $p = Dpkg::Source::Package->new(filename => $dscfile, options => {})
 
 Creates a new object corresponding to the source package described

scripts/Dpkg/Vendor/Default.pm

@@ -44,7 +44,7 @@ extended period. If you run an important distribution that makes use
 of vendor hooks, you'd better submit them for integration so that
 we avoid breaking your code.
 
-=head1 FUNCTIONS
+=head1 METHODS
 
 =over 4
 

scripts/Dpkg/Version.pm

@@ -72,7 +72,7 @@ an object oriented interface overriding perl operators
 to do the right thing when you compare Dpkg::Version object between
 them.
 
-=head1 OBJECT INTERFACE
+=head1 METHODS
 
 =over 4