Merging upstream version 13.16.

Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>

1 files changed, 40 insertions, 11 deletions

diff --git a/debhelper-compat-upgrade-checklist.pod b/debhelper-compat-upgrade-checklist.pod
index f271115..9a49dc3 100644
--- a/debhelper-compat-upgrade-checklist.pod
+++ b/debhelper-compat-upgrade-checklist.pod
@@ -56,6 +56,17 @@ The primary exception to this change are files such as F<debian/changelog>,
 F<debian/NEWS>, and F<debian/copyright>, where the same file is used for all
 packages by default.  These cases will remain unchanged.
 
+=item -
+
+It is now an error to use a packaging file without the package prefix for
+B<--name> even if the source package only produces one binary package. As example,
+if you had a F<debian/bar.service> with the following snippet in F<debian/rules>:
+
+ override_dh_installsystemd:
+    dh_installsystemd -p foo --name bar
+
+Then you need to rename F<debian/bar.service> to F<debian/foo.bar.service>.
+
 =back
 
 =item v14
@@ -104,7 +115,7 @@ B<dh_installinitramfs> in the default B<dh> sequence.
 
 =item -
 
-I<< This item only applies to source packages that has exactly one B<Package> stanza in F<debian/control>. >>
+I<< This item only applies to source packages that have exactly one B<Package> stanza in F<debian/control>. >>
 
 The B<dh> sequencer will warn if the B<single-binary> addon is implicitly activated to
 warn maintainers of the pending compat 15 change in B<dh_auto_install>.
@@ -195,9 +206,9 @@ L<https://lists.debian.org/debian-devel/2024/03/msg00030.html> also covers
 when the substvars need tweaking.  The most common case involves using
 the B<-d> option from B<dpkg-shlibdeps> possibly via B<dh_shlibdeps>.
 
-Note: This change changes will cause false-positives from an unfixed
-B<lintian>. Please check L<https://bugs.debian.org/1067653> for B<lintian>
-support for this change.
+Note: This change will cause false-positives from an unfixed
+B<lintian>. Please check L<https://bugs.debian.org/1067653> for
+B<lintian> support for this change.
 
 =item -
 
@@ -224,6 +235,19 @@ In compat 15 (or later), this is changed to an error.
 
 =item -
 
+It is now triggers a warning to use a packaging file without the package prefix for
+B<--name> even if the source package only produces one binary package. As example,
+if you had a F<debian/bar.service> with the following snippet in F<debian/rules>:
+
+ override_dh_installsystemd:
+    dh_installsystemd -p foo --name bar
+
+Then you need to rename F<debian/bar.service> to F<debian/foo.bar.service>.
+
+In compat 15 (or later), this is changed to an error.
+
+=item -
+
 Packages using the B<cmake> build system should be aware of the following changes:
 
 =over 4
@@ -270,12 +294,17 @@ passes extra parameters to the upstream build system should be reviewed.
 
 The F<debian/compat> file is no longer accepted as a source for specifying the
 debhelper compat level. Put the compat level in the B<X-DH-Compat> field of
-the source stanza of F<debian/control>.
+the B<Source> stanza of F<debian/control>.
 
 Note to avoid breaking packages that already migrated to compat 14 immediately,
 while it was experimental this change is first enforced when compat 14 becomes
 stable.
 
+=item -
+
+The tool B<dh_installtmpfiles> now runs with --remove on package removal, and
+--purge on package purge. systemd v256 is required for the latter.
+
 =back
 
 =item v13
@@ -331,7 +360,7 @@ are identical).
 
 The B<dh_auto_*> helpers now reset the environment variables B<HOME>
 and common B<XDG_*> variable.  Please see description of the
-environment variables in L</ENVIRONMENT> for how this is handled.
+environment variables in L<debhelper(1)/ENVIRONMENT> for how this is handled.
 
 I<This feature changed between debhelper 13 and debhelper 13.2.>
 
@@ -501,7 +530,7 @@ Note the B<--> before the B<--libexecdir> parameter.
 
 B<Retroactively removed in debhelper/13.5>:
 
-The B<dh_installdeb> tool would no longer installs the maintainer provided
+The B<dh_installdeb> tool would no longer install the maintainer provided
 F<conffiles> file as it was deemed unnecessary.  However, the
 B<remove-on-upgrade> from dpkg/1.20 made the file relevant again and
 B<dh_installdeb> now installs it again in compat levels 12+.
@@ -635,8 +664,8 @@ B<dh_installinfo> incorrectly ignore B<--sourcedir>.
 =item -
 
 The B<perl-makemaker> and B<perl-build> build systems no longer pass
-B<-I.> to perl.  Packages that still need this behaviour can emulate
-it by using the B<PERL5LIB> environment variable.  E.g. by adding
+B<-I.> to perl.  Packages that relies on this behavior can often use the
+B<PERL5LIB> environment variable as a substitute.  E.g. by adding
 B<export PERL5LIB=.> in their debian/rules file (or similar).
 
 =item -
@@ -825,7 +854,7 @@ Changes from v8 are:
 =item -
 
 Multiarch support. In particular, B<dh_auto_configure> passes
-multiarch directories to autoconf in --libdir and --libexecdir.
+multiarch directories to B<autoconf> in --libdir and --libexecdir.
 
 =item -
 
@@ -842,7 +871,7 @@ size of -dbg packages.
 =item -
 
 B<dh_auto_configure> does not include the source package name
-in --libexecdir when using autoconf.
+in --libexecdir when using B<autoconf>.
 
 =item -