1DH-AUTORECONF(7) User Contributed Perl Documentation DH-AUTORECONF(7)
2
3
4
6 dh-autoreconf - debhelper add-on to run autoreconf during build
7
9 The dh-autoreconf package provides a sequence addon for debhelper 7 and
10 is enabled by default since compatibility level 10. For earlier
11 compatibility levels it can be enabled in the following way:
12
13 #!/usr/bin/make -f
14 %:
15 dh $@ --with autoreconf
16
17 This will call dh_autoreconf prior to dh_auto_configure and will call
18 dh_autoreconf_clean before dh_clean.
19
20 For more information on how to control the autoreconf process or how to
21 other possible options, read the dh_autoreconf(1) and
22 dh_autoreconf_clean(1) manual pages.
23
25 This package also provides /usr/share/cdbs/1/rules/autoreconf.mk for
26 packages using CDBS. The variable "DEB_DH_AUTORECONF_ARGS" can be used
27 to pass extra arguments to dh_autoreconf, and the variable
28 "DEB_DH_AUTORECONF_CLEAN_ARGS" to pass arguments to
29 dh_autoreconf_clean. See their manual pages for information on
30 available arguments.
31
33 PATCHING LTMAIN.SH FOR AS-NEEDED LINKER FLAGS
34 You can add support for -Wl,--as-needed to ltmain.sh (at least for
35 those ltmain.sh scripts changed during autoreconf) by passing the
36 argument --as-needed to dh_autoreconf, as demonstrated in the following
37 example:
38
39 override_dh_autoreconf:
40 dh_autoreconf --as-needed
41
42 and for CDBS, by adding it to the correct variable such as:
43
44 DEB_DH_AUTORECONF_ARGS = --as-needed
45
46 For more information about this feature, see dh_autoreconf(1)
47
48 RUNNING MULTIPLE COMMANDS WITH DH_AUTORECONF
49 Please note that you may run dh_autoreconf only once. If you need to
50 run multiple commands, you can put the commands into a script or your
51 debian/rules file and then pass the name of your script to
52 dh_autoreconf. For example, if your script is called debian/autogen.sh,
53 you can put the following into your debian/rules if you use dh:
54
55 override_dh_autoreconf:
56 dh_autoreconf debian/autogen.sh
57
58 Or, if you use CDBS:
59
60 DEB_DH_AUTORECONF_ARGS += debian/autogen.sh
61
63 dh_autoreconf is mostly a superset of the dh_update_autotools_config
64 debhelper command included in debhelper since version 9.20160115. When
65 using the dh sequencer, dh_update_autotools_config is run before
66 dh_autoreconf and updates the config.guess and config.sub files. This
67 is required in cases where autoreconf does not update config.guess and
68 config.sub itself.
69
70 From time to time, there might be a short breakage for those using
71 automatic ltmain.sh patching, when the patch no longer applies to the
72 ltmain.sh.
73
74 You can only run dh_autoreconf once. Future versions may be able to be
75 run multiple times, but this requires slightly more planning.
76
78 debhelper(7), dh(1), dh_autoreconf(1), dh_autoreconf_clean(1)
79
81 Julian Andres Klode <jak@debian.org>
82
83
84
85perl v5.36.0 2023-01-19 DH-AUTORECONF(7)