Package: dh-autoreconf Followup-For: Bug #988981 Hello. In addition, an attached patch slighty clarifies the documentation. Would you prefer a merge request?
>From c390e9d5ca35a652a1ac4174780bde38176ae25a Mon Sep 17 00:00:00 2001 From: Nicolas Boulenguez <[email protected]> Date: Mon, 23 Feb 2026 19:30:52 +0100 Subject: [PATCH 1/2] Make the documentation more accessible to newcomers
--- dh_autoreconf | 19 +++++++++++++++---- 1 file changed, 15 insertions(+), 4 deletions(-) diff --git a/dh_autoreconf b/dh_autoreconf index ed2c875..e45a49b 100755 --- a/dh_autoreconf +++ b/dh_autoreconf @@ -17,10 +17,19 @@ B<dh_autoreconf> [S<I<debhelper options>>] [B<-X>I<item>] [B<--mode=>I<mode>] =head1 DESCRIPTION -dh_autoreconf is responsible for calling autoreconf and creating the files -debian/autoreconf.before and debian/autoreconf.after which contain checksums -of all files before/after the build. It is complemented by dh_autoreconf_clean -which creates a list of all changed and added files and removes them. +The dh_autoreconf and dh_autoreconf_clean commands are usually invoked +non-interactively as described in L<dh-autoreconf(7)>. + +The B<dh_autoreconf> command is invoked before a package build. +It lets I<program> prepare the source tree, tracking created or +modified files. + +The B<dh_autoreconf_clean> command is invoked later, when cleaning a +source tree, usually after a build. +It removes all files previously created or modified by I<program>. + +By default, I<program> is B<autoreconf --force --install>, +or B<xdt-autogen> when B<configure.ac> contains B<XDT_> macros. Please note that dh_autoreconf can only be run once. Thus, if you need to run multiple commands, use a script or similar. An example is given in @@ -78,6 +87,8 @@ Run the program given by I<program> with the arguments given by I<params> instead of autoreconf -f -i. If you need to run multiple commands, put them in a script and pass the script instead (or add a target to debian/rules). +An upstream script named B<bootstrap> is usually a good candidate. + =back =head1 ENVIRONMENT -- 2.47.3
>From 6549a74db819348275c4d3abd21325ccd3e0acca Mon Sep 17 00:00:00 2001 From: Nicolas Boulenguez <[email protected]> Date: Mon, 23 Feb 2026 21:29:23 +0100 Subject: [PATCH 2/2] Pass -v to autoreconf except with the terse build option --- dh_autoreconf | 7 +++++-- 1 file changed, 5 insertions(+), 2 deletions(-) diff --git a/dh_autoreconf b/dh_autoreconf index e45a49b..60a891b 100755 --- a/dh_autoreconf +++ b/dh_autoreconf @@ -28,7 +28,8 @@ The B<dh_autoreconf_clean> command is invoked later, when cleaning a source tree, usually after a build. It removes all files previously created or modified by I<program>. -By default, I<program> is B<autoreconf --force --install>, +By default, I<program> is B<autoreconf --force --install -verbose>, +without the verbose option if the B<terse> build option is active, or B<xdt-autogen> when B<configure.ac> contains B<XDT_> macros. Please note that dh_autoreconf can only be run once. Thus, if you need to @@ -188,8 +189,10 @@ eval { if (grep_configure("^XDT_")) { $ENV{NOCONFIGURE}='1'; doit('xdt-autogen', @directories); - } else { + } elsif (get_buildoption("terse")) { doit('autoreconf', '-f', '-i', @directories); + } else { + doit('autoreconf', '-f', '-i', '-v', @directories); } } 1; -- 2.47.3
