1DH-AUTORECONF(7)      User Contributed Perl Documentation     DH-AUTORECONF(7)
2
3
4

NAME

6       dh-autoreconf - debhelper add-on to run autoreconf during build
7

DESCRIPTION

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

CDBS INTEGRATION

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

TIPS AND EXAMPLES

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

CAVEATS

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

SEE ALSO

78       debhelper(7), dh(1), dh_autoreconf(1), dh_autoreconf_clean(1)
79

AUTHOR

81       Julian Andres Klode <jak@debian.org>
82
83
84
85perl v5.36.0                      2022-07-21                  DH-AUTORECONF(7)