Dpkg: Update and fix CHANGES POD sections

Do not use actual POD =item, just normal paragraphs. Split items in
different paragraphs. Sort versions in decreasing order. Document
missing changes in public interfaces. Qualify methods with the
variable.

debian/changelog

@@ -38,6 +38,7 @@ dpkg (1.17.10) UNRELEASED; urgency=low
   * Perl modules:
     - Bump $VERSION for Dpkg::Patch, missed in 1.16.1.
     - Bump $VERSION for Dpkg::Deps, missed in 1.17.0.
+    - Update and fix CHANGES POD sections for public modules.
 
   [ Updated manpages translations ]
   * German (Helge Kreutzmann).

scripts/Dpkg/BuildFlags.pm

@@ -438,25 +438,25 @@ sub list {
 
 =head1 CHANGES
 
-=head2 Version 1.01
+=head2 Version 1.03
 
-New method: $bf->prepend() very similar to append(). Implement support of
-the prepend operation everywhere.
+New method: $bf->get_feature_areas() to list possible values for
+$bf->get_features.
 
-New method: $bf->load_maintainer_config() that update the build flags
-based on the package maintainer directives.
+New method $bf->is_maintainer_modified() and new optional parameter to
+$bf->set(), $bf->append(), $bf->prepend(), $bf->strip().
 
 =head2 Version 1.02
 
 New methods: $bf->get_features(), $bf->has_features(), $bf->set_feature().
 
-=head2 Version 1.03
+=head2 Version 1.01
 
-New method: $bf->get_feature_areas() to list possible values for
-$bf->get_features.
+New method: $bf->prepend() very similar to append(). Implement support of
+the prepend operation everywhere.
 
-New method $bf->is_maintainer_modified() and new optional parameter to
-$bf->set(), $bf->append(), $bf->prepend(), $bf->strip().
+New method: $bf->load_maintainer_config() that update the build flags
+based on the package maintainer directives.
 
 =head1 AUTHOR
 

scripts/Dpkg/Changelog/Entry/Debian.pm

@@ -312,6 +312,7 @@ sub find_closes {
 =head2 Version 1.01
 
 New functions: match_header(), match_trailer()
+
 Deprecated variables: $regex_header, $regex_trailer
 
 =head1 AUTHOR

scripts/Dpkg/Conf.pm

@@ -177,6 +177,12 @@ sub output {
 
 =back
 
+=head1 CHANGES
+
+=head2 Version 1.01
+
+New method: $conf->filter()
+
 =head1 AUTHOR
 
 Raphaël Hertzog <hertzog@debian.org>.

scripts/Dpkg/Control/HashCore.pm

@@ -534,7 +534,7 @@ sub NEXTKEY {
 
 =head2 Version 1.01
 
-New method: parse_error().
+New method: $c->parse_error().
 
 =head1 AUTHOR
 

scripts/Dpkg/Deps.pm

@@ -1446,28 +1446,20 @@ New option: Add build_arch option to Dpkg::Deps::deps_parse().
 
 =head2 Version 1.02
 
-=over
-
-=item * Add new Dpkg::deps_concat() function.
-
-=back
+New function: Dpkg::Deps::deps_concat()
 
 =head2 Version 1.01
 
-=over
+New method: Add $dep->reset() for all dependency objects.
 
-=item * Add new $dep->reset() method that all dependency objects support.
+New property: Dpkg::Deps::Simple now recognizes the arch qualifier "any"
+and stores it in the "archqual" property when present.
 
-=item * Dpkg::Deps::Simple now recognizes the arch qualifier "any" and
-stores it in the "archqual" property when present.
-
-=item * Dpkg::Deps::KnownFacts->add_installed_package() now accepts 2
+New option: Dpkg::Deps::KnownFacts->add_installed_package() now accepts 2
 supplementary parameters ($arch and $multiarch).
 
-=item * Dpkg::Deps::KnownFacts->check_package() is obsolete, it should
-not have been part of the public API.
-
-=back
+Deprecated method: Dpkg::Deps::KnownFacts->check_package() is obsolete,
+it should not have been part of the public API.
 
 =cut
 

scripts/Dpkg/Exit.pm

@@ -91,6 +91,7 @@ $SIG{QUIT} = \&exit_handler;
 =head2 Version 1.01
 
 New functions: push_exit_handler(), pop_exit_handler(), run_exit_handlers()
+
 Deprecated variable: @handlers
 
 =cut

scripts/Dpkg/Substvars.pm

@@ -330,6 +330,21 @@ sub output {
 
 =back
 
+=head1 CHANGES
+
+=head2 Version 1.02
+
+New argument: Accept a $binaryversion in $s->set_version_substvars(),
+passing a single argument is still supported.
+
+New method: $s->mark_as_used().
+
+Deprecated method: $s->no_warn(), use $s->mark_as_used() instead.
+
+=head2 Version 1.01
+
+New method: $s->set_as_used().
+
 =head1 AUTHOR
 
 Raphaël Hertzog <hertzog@debian.org>.