From 36b03e2bee4497aef85033f4f900f5d89d5dc55e Mon Sep 17 00:00:00 2001 From: Daniel Baumann Date: Mon, 26 Aug 2024 12:17:26 +0200 Subject: Merging upstream version 13.17. Signed-off-by: Daniel Baumann --- debhelper-compat-upgrade-checklist.pod | 75 +++++++++++++++++++++++++++++----- 1 file changed, 64 insertions(+), 11 deletions(-) (limited to 'debhelper-compat-upgrade-checklist.pod') diff --git a/debhelper-compat-upgrade-checklist.pod b/debhelper-compat-upgrade-checklist.pod index 9a49dc3..6f58834 100644 --- a/debhelper-compat-upgrade-checklist.pod +++ b/debhelper-compat-upgrade-checklist.pod @@ -32,17 +32,15 @@ Changes from v14 are: =item - -The B tool no longer defaults to B<< --destdir=debian/I >> -for source packages only producing a single binary. If this behaviour is wanted, -the package should explicitly activate the B dh addon (e.g., by adding -B to B) or pass B<--destdir> to -B. +The B add-on for B is no longer implicitly activated by +source packages that have a single B stanza in F. If +the package needs the short-cuts for single-binary packages, it must explicitly +activate the B add-in. -The rationale for this change is to avoid "surprises" when adding a second binary package -later. Previously, debhelper would silently change behaviour often resulting in empty -binary packages being uploaded to the archive by mistake. With the new behaviour, -the B addon will detect the mismatch and warn the maintainer of what is -about to happen. +This can be done via a B on B. + +Any B<--without single-binary> passed to B to avoid the warning in compat 14 +can now be removed to simplify F without triggering the warning. =item - @@ -93,6 +91,30 @@ Packages using the B sequencer should be aware the following changes: =item - +The order and placement has changed for B, +B, and B. Previously, these three commands +were run in the listed order between B and +B. + +Their new placement is after B (arch:all) or +B (arch:any) and before B. Additionally, +their new order is B, B, and +then B. + +This change may require updates to third-party add-ons that use either +of these three commands as anchor or to hook targets for any of these +commands that made assumptions about the command order. + +Additionally, B and B plus any commands added +by third-party add-ons using these as anchors will no longer be able to rely on the +mode/ownership normalization by B, which may expose bugs in the form +of incorrect mode or ownership in the resulting deb. + +Please file any such bugs against the relevant tool. Feel free to include the +B maintainers in CC. + +=item - + The tool B is now included in the default sequence. This helper tool will process systemd sysusers files. @@ -117,8 +139,18 @@ B in the default B sequence. I<< This item only applies to source packages that have exactly one B stanza in F. >> +The B command now unconditionally uses B<--destdir=debian/tmp> by default. The special-case +for source packages building a single binary package is now moved to B B addon. Note, this +add-on is activated by default in compat 14 but not in compat 15 (see next bullet item). + +=item - + +I<< This item only applies to source packages that have exactly one B stanza in F. >> + The B sequencer will warn if the B addon is implicitly activated to -warn maintainers of the pending compat 15 change in B. +warn maintainers of the pending compat 15 change in B. The implicit +activation is a transitional feature to reduce the changes of risks with this change. +In compat 15, the implicit activation will no longer trigger. Maintainers are urged to either explicitly activate the B addon to preserve the existing behaviour (e.g., by adding B to @@ -220,6 +252,12 @@ will not have to do anything for this migration. =item - +The debhelper configuration files are subject to the following changes: + +=over 4 + +=item - + It now triggers a warning to use package-less versions of debhelper configuration files when there are 2 or more binary packages listed in F in most cases. Legacy files should be renamed to F<< debian/I.foo >> @@ -248,6 +286,21 @@ In compat 15 (or later), this is changed to an error. =item - +The default look up rules for B based tools now assumes that configuration +files are no longer named (B<--name>) nor support architecture restrictions by default. +If you work with a third-party debhelper-like tool and need support for either of these +features, please file a bug against the tool asking it to declare its configuration +file with the relevant options in its B call. + +Note that B itself tweaked its rules for most of its tools as well based on +analysis of usage via B. Should you be relying on a feature like +architecture restrictions for a given config file that is no longer supported, please +file a feature request for the use-case and it might be restored. + +=back + +=item - + Packages using the B build system should be aware of the following changes: =over 4 -- cgit v1.2.3