This is an automated email from the git hooks/post-receive script.

guillem pushed a commit to branch main
in repository dpkg.

View the commit online:
https://git.dpkg.org/cgit/dpkg/dpkg.git/commit/?id=0fa25abf11871c75de58e14743810609518e647e

The following commit(s) were added to refs/heads/main by this push:
     new 0fa25abf1 man: Clarify when dpkg-maintscript-helpers might need 
Pre-Depends on dpkg
0fa25abf1 is described below

commit 0fa25abf11871c75de58e14743810609518e647e (HEAD -> main)
Author: Guillem Jover <[email protected]>
AuthorDate: Sun Jun 29 21:00:20 2025 +0200

    man: Clarify when dpkg-maintscript-helpers might need Pre-Depends on dpkg
    
    We only really need the Pre-Depends when we are upgrading from a release
    where we cannot guarantee that the required version is satisfied there.
    Otherwise we can obviate it. We do not remove the current pre-dependency
    text for downstreams that might still be sitting on an older dpkg
    release.
    
    Closes: #1108386
---
 man/dpkg-maintscript-helper.pod | 16 ++++++++++------
 1 file changed, 10 insertions(+), 6 deletions(-)

diff --git a/man/dpkg-maintscript-helper.pod b/man/dpkg-maintscript-helper.pod
index ee938e911..dfdb1bdd8 100644
--- a/man/dpkg-maintscript-helper.pod
+++ b/man/dpkg-maintscript-helper.pod
@@ -300,12 +300,16 @@ easier.
 See for example L<dh_installdeb(1)>.
 
 Given that B<dpkg-maintscript-helper> is used in the B<preinst>,
-using it unconditionally requires a pre-dependency to ensure that the
-required version of B<dpkg> has been unpacked before.
-The required version
-depends on the command used, for B<rm_conffile> and B<mv_conffile>
-it is 1.15.7.2, for B<symlink_to_dir> and B<dir_to_symlink>
-it is 1.17.14:
+using it unconditionally requires a versioned pre-dependency to
+ensure that the required version of B<dpkg> has been unpacked before,
+unless we know we are upgrading from a release where the required dpkg
+version is going to be satisfied.
+The required version depends on the command used,
+for B<rm_conffile> and B<mv_conffile> it is 1.15.7.2,
+for B<symlink_to_dir> and B<dir_to_symlink> it is 1.17.14.
+For example, if we required support for B<symlink_to_dir> when upgrading
+from a release that had a dpkg version earlier than 1.17.14,
+we would need to add:
 
 =over
 

-- 
Dpkg.Org's dpkg

Reply via email to