scripts: Document dpkg version when module versions got bumped

This has two purposes, first it will make it easier to know if the
module version needs to be bumped for the current development release,
and second it will make it easier for users to know how "old" that
module version is, and to which dpkg series and specific version it
corresponds to.

debian/changelog

@@ -194,6 +194,7 @@ dpkg (1.18.0) UNRELEASED; urgency=low
     - 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.
+    - Document dpkg version when perl module versions got bumped.
   * 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.pm

@@ -100,14 +100,14 @@ our $pkgdatadir = $DATADIR;
 
 =head1 CHANGES
 
-=head2 Version 1.01
+=head2 Version 1.01 (dpkg 1.17.0)
 
 New variables: $PROGNAME, $PROGVERSION, $CONFDIR, $ADMINDIR, $LIBDIR and
 $DATADIR.
 
 Deprecated variables: $version, $admindir, $dpkglibdir and $pkgdatadir.
 
-=head2 Version 1.00
+=head2 Version 1.00 (dpkg 1.15.6)
 
 Mark the module as public.
 

scripts/Dpkg/BuildFlags.pm

@@ -445,7 +445,7 @@ sub list {
 
 =head1 CHANGES
 
-=head2 Version 1.03
+=head2 Version 1.03 (dpkg 1.16.5)
 
 New method: $bf->get_feature_areas() to list possible values for
 $bf->get_features.
@@ -453,11 +453,11 @@ $bf->get_features.
 New method $bf->is_maintainer_modified() and new optional parameter to
 $bf->set(), $bf->append(), $bf->prepend(), $bf->strip().
 
-=head2 Version 1.02
+=head2 Version 1.02 (dpkg 1.16.2)
 
 New methods: $bf->get_features(), $bf->has_features(), $bf->set_feature().
 
-=head2 Version 1.01
+=head2 Version 1.01 (dpkg 1.16.1)
 
 New method: $bf->prepend() very similar to append(). Implement support of
 the prepend operation everywhere.
@@ -465,7 +465,7 @@ the prepend operation everywhere.
 New method: $bf->load_maintainer_config() that update the build flags
 based on the package maintainer directives.
 
-=head2 Version 1.00
+=head2 Version 1.00 (dpkg 1.15.7)
 
 Mark the module as public.
 

scripts/Dpkg/BuildOptions.pm

@@ -191,12 +191,12 @@ sub export {
 
 =head1 CHANGES
 
-=head2 Version 1.01
+=head2 Version 1.01 (dpkg 1.16.1)
 
 Enable to use another environment variable instead of DEB_BUILD_OPTIONS.
 Thus add support for the "envvar" option at creation time.
 
-=head2 Version 1.00
+=head2 Version 1.00 (dpkg 1.15.6)
 
 Mark the module as public.
 

scripts/Dpkg/BuildProfiles.pm

@@ -136,7 +136,7 @@ sub evaluate_restriction_formula {
 
 =head1 CHANGES
 
-=head2 Version 1.00
+=head2 Version 1.00 (dpkg 1.17.17)
 
 Mark the module as public.
 

scripts/Dpkg/Changelog.pm

@@ -695,7 +695,7 @@ with only one of the options specified.
 
 =head1 CHANGES
 
-=head2 Version 1.00
+=head2 Version 1.00 (dpkg 1.15.6)
 
 Mark the module as public.
 

scripts/Dpkg/Changelog/Debian.pm

@@ -205,7 +205,7 @@ L<https://www.debian.org/doc/debian-policy/ch-source.html#s-dpkgchangelog>.
 
 =head1 CHANGES
 
-=head2 Version 1.00
+=head2 Version 1.00 (dpkg 1.15.6)
 
 Mark the module as public.
 

scripts/Dpkg/Changelog/Entry.pm

@@ -299,7 +299,7 @@ sub get_dpkg_changes {
 
 =head1 CHANGES
 
-=head2 Version 1.00
+=head2 Version 1.00 (dpkg 1.15.6)
 
 Mark the module as public.
 

scripts/Dpkg/Changelog/Entry/Debian.pm

@@ -314,13 +314,13 @@ sub find_closes {
 
 =head1 CHANGES
 
-=head2 Version 1.01
+=head2 Version 1.01 (dpkg 1.17.2)
 
 New functions: match_header(), match_trailer()
 
 Deprecated variables: $regex_header, $regex_trailer
 
-=head2 Version 1.00
+=head2 Version 1.00 (dpkg 1.15.6)
 
 Mark the module as public.
 

scripts/Dpkg/Changelog/Parse.pm

@@ -167,7 +167,7 @@ sub changelog_parse {
 
 =head1 CHANGES
 
-=head2 Version 1.00
+=head2 Version 1.00 (dpkg 1.15.6)
 
 Mark the module as public.
 

scripts/Dpkg/Checksums.pm

@@ -376,7 +376,7 @@ sub export_to_control {
 
 =head1 CHANGES
 
-=head2 Version 1.02
+=head2 Version 1.02 (dpkg 1.18.0)
 
 Obsolete property: Getting the 'program' checksum property will carp() and
 return undef, the Digest module is used internally now.
@@ -384,14 +384,14 @@ return undef, the Digest module is used internally now.
 New property: Add new 'name' property with the name of the Digest algorithm
 to use.
 
-=head2 Version 1.01
+=head2 Version 1.01 (dpkg 1.17.6)
 
 New argument: Accept an options argument in $ck->export_to_string().
 
 New option: Accept new option 'update' in $ck->add_from_file() and
 $ck->add_from_control().
 
-=head2 Version 1.00
+=head2 Version 1.00 (dpkg 1.15.6)
 
 Mark the module as public.
 

scripts/Dpkg/Compression.pm

@@ -231,18 +231,18 @@ sub compression_is_valid_level {
 
 =head1 CHANGES
 
-=head2 Version 1.02
+=head2 Version 1.02 (dpkg 1.17.2)
 
 New function: compression_get_file_extension_regex()
 
 Deprecated variables: $default_compression, $default_compression_level
 and $compression_re_file_ext
 
-=head2 Version 1.01
+=head2 Version 1.01 (dpkg 1.16.1)
 
 Default compression level is not global any more, it is per compressor type.
 
-=head2 Version 1.00
+=head2 Version 1.00 (dpkg 1.15.6)
 
 Mark the module as public.
 

scripts/Dpkg/Compression/FileHandle.pm

@@ -458,11 +458,11 @@ C<*$self->{...}> to access the associated hash like in the example below:
 
 =head1 CHANGES
 
-=head2 Version 1.01
+=head2 Version 1.01 (dpkg 1.17.11)
 
 New argument: $fh->ensure_open() accepts an %opts argument.
 
-=head2 Version 1.00
+=head2 Version 1.00 (dpkg 1.15.6)
 
 Mark the module as public.
 

scripts/Dpkg/Compression/Process.pm

@@ -202,7 +202,7 @@ sub wait_end_process {
 
 =head1 CHANGES
 
-=head2 Version 1.00
+=head2 Version 1.00 (dpkg 1.15.6)
 
 Mark the module as public.
 

scripts/Dpkg/Conf.pm

@@ -178,11 +178,11 @@ sub output {
 
 =head1 CHANGES
 
-=head2 Version 1.01
+=head2 Version 1.01 (dpkg 1.15.8)
 
 New method: $conf->filter()
 
-=head2 Version 1.00
+=head2 Version 1.00 (dpkg 1.15.6)
 
 Mark the module as public.
 

scripts/Dpkg/Control.pm

@@ -202,7 +202,7 @@ sub get_type {
 
 =head1 CHANGES
 
-=head2 Version 1.00
+=head2 Version 1.00 (dpkg 1.15.6)
 
 Mark the module as public.
 

scripts/Dpkg/Control/Changelog.pm

@@ -56,7 +56,7 @@ sub new {
 
 =head1 CHANGES
 
-=head2 Version 1.00
+=head2 Version 1.00 (dpkg 1.15.6)
 
 Mark the module as public.
 

scripts/Dpkg/Control/Fields.pm

@@ -57,7 +57,7 @@ inherited from Dpkg::Control::FieldsCore.
 
 =head1 CHANGES
 
-=head2 Version 1.00
+=head2 Version 1.00 (dpkg 1.15.6)
 
 Mark the module as public.
 

scripts/Dpkg/Control/FieldsCore.pm

@@ -675,7 +675,7 @@ sub field_insert_before($$@) {
 
 =head1 CHANGES
 
-=head2 Version 1.00
+=head2 Version 1.00 (dpkg 1.17.0)
 
 Mark the module as public.
 

scripts/Dpkg/Control/Hash.pm

@@ -39,7 +39,7 @@ field knowledge.
 
 =head1 CHANGES
 
-=head2 Version 1.00
+=head2 Version 1.00 (dpkg 1.15.6)
 
 Mark the module as public.
 

scripts/Dpkg/Control/HashCore.pm

@@ -539,11 +539,11 @@ sub NEXTKEY {
 
 =head1 CHANGES
 
-=head2 Version 1.01
+=head2 Version 1.01 (dpkg 1.17.2)
 
 New method: $c->parse_error().
 
-=head2 Version 1.00
+=head2 Version 1.00 (dpkg 1.17.0)
 
 Mark the module as public.
 

scripts/Dpkg/Control/Info.pm

@@ -213,11 +213,11 @@ information.
 
 =head1 CHANGES
 
-=head2 Version 1.01
+=head2 Version 1.01 (dpkg 1.18.0)
 
 New argument: The $c->new() constructor accepts an %opts argument.
 
-=head2 Version 1.00
+=head2 Version 1.00 (dpkg 1.15.6)
 
 Mark the module as public.
 

scripts/Dpkg/Deps.pm

@@ -1464,11 +1464,11 @@ sub _evaluate_simple_dep {
 
 =head1 CHANGES
 
-=head2 Version 1.05
+=head2 Version 1.05 (dpkg 1.17.14)
 
 New function: Dpkg::Deps::deps_iterate().
 
-=head2 Version 1.04
+=head2 Version 1.04 (dpkg 1.17.10)
 
 New options: Add use_profiles, build_profiles, reduce_profiles and
 reduce_restrictions to Dpkg::Deps::deps_parse().
@@ -1476,15 +1476,15 @@ reduce_restrictions to Dpkg::Deps::deps_parse().
 New methods: Add $dep->profile_is_concerned() and $dep->reduce_profiles()
 for all dependency objects.
 
-=head2 Version 1.03
+=head2 Version 1.03 (dpkg 1.17.0)
 
 New option: Add build_arch option to Dpkg::Deps::deps_parse().
 
-=head2 Version 1.02
+=head2 Version 1.02 (dpkg 1.17.0)
 
 New function: Dpkg::Deps::deps_concat()
 
-=head2 Version 1.01
+=head2 Version 1.01 (dpkg 1.16.1)
 
 New method: Add $dep->reset() for all dependency objects.
 
@@ -1497,7 +1497,7 @@ supplementary parameters ($arch and $multiarch).
 Deprecated method: Dpkg::Deps::KnownFacts->check_package() is obsolete,
 it should not have been part of the public API.
 
-=head2 Version 1.00
+=head2 Version 1.00 (dpkg 1.15.6)
 
 Mark the module as public.
 

scripts/Dpkg/Exit.pm

@@ -91,13 +91,13 @@ $SIG{QUIT} = \&exit_handler;
 
 =head1 CHANGES
 
-=head2 Version 1.01
+=head2 Version 1.01 (dpkg 1.17.2)
 
 New functions: push_exit_handler(), pop_exit_handler(), run_exit_handlers()
 
 Deprecated variable: @handlers
 
-=head2 Version 1.00
+=head2 Version 1.00 (dpkg 1.15.6)
 
 Mark the module as public.
 

scripts/Dpkg/Gettext.pm

@@ -26,7 +26,7 @@ package Dpkg::Gettext;
 use strict;
 use warnings;
 
-our $VERSION = '1.02';
+our $VERSION = '1.01';
 our @EXPORT = qw(
     textdomain
     ngettext
@@ -150,20 +150,16 @@ sub _g ## no critic (Subroutines::ProhibitUnusedPrivateSubroutines)
 
 =head1 CHANGES
 
-=head2 Version 1.02
+=head2 Version 1.01 (dpkg 1.18.0)
 
 Now the short aliases (g_ and P_) will call domain aware functions with
 $DEFAULT_TEXT_DOMAIN.
 
-New function: C_().
-
-=head2 Version 1.01
-
-New function: g_().
+New functions: g_(), C_().
 
 Deprecated function: _g().
 
-=head2 Version 1.00
+=head2 Version 1.00 (dpkg 1.15.6)
 
 Mark the module as public.
 

scripts/Dpkg/IPC.pm

@@ -401,15 +401,15 @@ __END__
 
 =head1 CHANGES
 
-=head2 Version 1.02
+=head2 Version 1.02 (dpkg 1.18.0)
 
 Change options: wait_child() now kills the process when reaching the 'timeout'.
 
-=head2 Version 1.01
+=head2 Version 1.01 (dpkg 1.17.11)
 
 New options: spawn() now accepts 'sig' and 'delete_sig'.
 
-=head2 Version 1.00
+=head2 Version 1.00 (dpkg 1.15.6)
 
 Mark the module as public.
 

scripts/Dpkg/Index.pm

@@ -344,7 +344,7 @@ sub output {
 
 =head1 CHANGES
 
-=head2 Version 1.00
+=head2 Version 1.00 (dpkg 1.15.6)
 
 Mark the module as public.
 

scripts/Dpkg/Interface/Storable.pm

@@ -140,7 +140,7 @@ sub _stringify {
 
 =head1 CHANGES
 
-=head2 Version 1.00
+=head2 Version 1.00 (dpkg 1.15.6)
 
 Mark the module as public.
 

scripts/Dpkg/Path.pm

@@ -281,23 +281,23 @@ sub find_build_file($) {
 
 =head1 CHANGES
 
-=head2 Version 1.04
+=head2 Version 1.04 (dpkg 1.17.11)
 
 Update semantics: find_command() now handles an empty or undef argument.
 
-=head2 Version 1.03
+=head2 Version 1.03 (dpkg 1.16.1)
 
 New function: find_build_file()
 
-=head2 Version 1.02
+=head2 Version 1.02 (dpkg 1.16.0)
 
 New function: get_control_path()
 
-=head2 Version 1.01
+=head2 Version 1.01 (dpkg 1.15.8)
 
 New function: find_command()
 
-=head2 Version 1.00
+=head2 Version 1.00 (dpkg 1.15.6)
 
 Mark the module as public.
 

scripts/Dpkg/Source/Package.pm

@@ -633,14 +633,14 @@ sub write_dsc {
 
 =head1 CHANGES
 
-=head2 Version 1.01
+=head2 Version 1.01 (dpkg 1.17.2)
 
 New functions: get_default_diff_ignore_regex(), set_default_diff_ignore_regex(),
 get_default_tar_ignore_pattern()
 
 Deprecated variables: $diff_ignore_default_regexp, @tar_ignore_default_pattern
 
-=head2 Version 1.00
+=head2 Version 1.00 (dpkg 1.16.1)
 
 Mark the module as public.
 

scripts/Dpkg/Substvars.pm

@@ -389,15 +389,15 @@ sub output {
 
 =head1 CHANGES
 
-=head2 Version 1.04
+=head2 Version 1.04 (dpkg 1.18.0)
 
 New method: $s->filter().
 
-=head2 Version 1.03
+=head2 Version 1.03 (dpkg 1.17.11)
 
 New method: $s->set_as_auto().
 
-=head2 Version 1.02
+=head2 Version 1.02 (dpkg 1.16.5)
 
 New argument: Accept a $binaryversion in $s->set_version_substvars(),
 passing a single argument is still supported.
@@ -406,11 +406,11 @@ New method: $s->mark_as_used().
 
 Deprecated method: $s->no_warn(), use $s->mark_as_used() instead.
 
-=head2 Version 1.01
+=head2 Version 1.01 (dpkg 1.16.4)
 
 New method: $s->set_as_used().
 
-=head2 Version 1.00
+=head2 Version 1.00 (dpkg 1.15.6)
 
 Mark the module as public.
 

scripts/Dpkg/Vendor.pm

@@ -190,11 +190,11 @@ sub run_vendor_hook {
 
 =head1 CHANGES
 
-=head2 Version 1.01
+=head2 Version 1.01 (dpkg 1.17.0)
 
 New function: get_vendor_dir().
 
-=head2 Version 1.00
+=head2 Version 1.00 (dpkg 1.16.1)
 
 Mark the module as public.
 

scripts/Dpkg/Version.pm

@@ -440,13 +440,13 @@ sub version_check($) {
 
 =head1 CHANGES
 
-=head2 Version 1.01
+=head2 Version 1.01 (dpkg 1.17.0)
 
 New argument: Accept an options argument in $v->as_string().
 
 New method: $v->is_native().
 
-=head2 Version 1.00
+=head2 Version 1.00 (dpkg 1.15.6)
 
 Mark the module as public.