From: nicolas@debian.org
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
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 [S>] [B<-X>I- ]
[B<--mode=>I]
=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.
+
+The B command is invoked before a package build.
+It lets I prepare the source tree, tracking created or
+modified files.
+
+The B command is invoked later, when cleaning a
+source tree, usually after a build.
+It removes all files previously created or modified by I.
+
+By default, I is B,
+or B when B contains B 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 with the arguments given
by I
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 is usually a good candidate.
+
=back
=head1 ENVIRONMENT
--
2.47.3
From 6549a74db819348275c4d3abd21325ccd3e0acca Mon Sep 17 00:00:00 2001
From: Nicolas Boulenguez
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 command is invoked later, when
cleaning a
source tree, usually after a build.
It removes all files previously created or modified by I.
-By default, I is B,
+By default, I is B,
+without the verbose option if the B build option is active,
or B when B contains B 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
--- SoupGate-Win32 v1.05
* Origin: you cannot sedate... all the things you hate (1:229/2)
|
