SIMPLE SOLUTIONS

DH-AUTORECONF(7) - Linux man page online | Overview, conventions, and miscellany

Debhelper add-on to run autoreconf during build.

Chapter
2018-03-21
DH-AUTORECONF(7) dh-autoreconf DH-AUTORECONF(7)

NAME

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

DESCRIPTION

The dh-autoreconf package provides a sequence addon for debhelper 7 and is enabled by default since compatibility level 10. For earlier compatibility levels it can be enabled in the following way: #!/usr/bin/make -f %: dh $@ --with autoreconf This will call dh_autoreconf prior to dh_auto_configure and will call dh_autoreconf_clean before dh_clean. For more information on how to control the autoreconf process or how to other possible options, read the dh_autoreconf(1) and dh_autoreconf_clean(1) manual pages.

CDBS INTEGRATION

This package also provides /usr/share/cdbs/1/rules/autoreconf.mk for packages using CDBS. The variable "DEB_DH_AUTORECONF_ARGS" can be used to pass extra arguments to dh_autoreconf, and the variable "DEB_DH_AUTORECONF_CLEAN_ARGS" to pass arguments to dh_autoreconf_clean. See their manual pages for information on available arguments.

TIPS AND EXAMPLES

PATCHING LTMAIN.SH FOR AS-NEEDED LINKER FLAGS You can add support for -Wl,--as-needed to ltmain.sh (at least for those ltmain.sh scripts changed during autoreconf) by passing the argument --as-needed to dh_autoreconf, as demonstrated in the following example: override_dh_autoreconf: dh_autoreconf --as-needed and for CDBS, by adding it to the correct variable such as: DEB_DH_AUTORECONF_ARGS = --as-needed For more information about this feature, see dh_autoreconf(1) RUNNING MULTIPLE COMMANDS WITH DH_AUTORECONF Please note that you may run dh_autoreconf only once. If you need to run multiple commands, you can put the commands into a script or your debian/rules file and then pass the name of your script to dh_autoreconf. For example, if your script is called debian/autogen.sh, you can put the following into your debian/rules if you use dh: override_dh_autoreconf: dh_autoreconf debian/autogen.sh Or, if you use CDBS: DEB_DH_AUTORECONF_ARGS += debian/autogen.sh

CAVEATS

dh_autoreconf is mostly a superset of the dh_update_autotools_config debhelper command included in debhelper since version 9.20160115. When using the dh sequencer, dh_update_autotools_config is run before dh_autoreconf and updates the config.guess and config.sub files. This is required in cases where autoreconf does not update config.guess and config.sub itself. From time to time, there might be a short breakage for those using automatic ltmain.sh patching, when the patch no longer applies to the ltmain.sh. You can only run dh_autoreconf once. Future versions may be able to be run multiple times, but this requires slightly more planning.

SEE ALSO

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

AUTHOR

Julian Andres Klode <@debian.org>
dh-autoreconf v17 2018-03-21 DH-AUTORECONF(7)
This manual Reference Other manuals
dh-autoreconf(7) referred by dh_autoreconf(1) | dh_autoreconf_clean(1)
refer to debhelper(7) | dh(1) | dh_autoreconf(1) | dh_autoreconf_clean(1)
Download raw manual
Main page dh-autoreconf (+3) dh-autoreconf v17 (+3) № 7 (+1560)
Go top