DH_AUTORECONF(1) dh-autoreconf DH_AUTORECONF(1)NAME
dh_autoreconf - Call autoreconf -f -i and keep track of the changed files.
SYNOPSIS
dh_autoreconf [debhelper options] [-Xitem] [--mode=mode] [program -- params]
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.
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 dh-autoreconf(7).
FILES
debian/autoreconf
This file can contain a list of directories. If present, dh_autoreconf will only scan the given directories for changes. If no special
command is given to dh_autoreconf, it will also forward the directory list to autoreconf which causes it to be run only on those sub
directories.
OPTIONS -Xitem --exclude=item
Exclude files that contain "item" anywhere in their filename from being checked for changes. This means that those files won't be
deleted by "dh_autoreconf_clean" even if there are changes. You may use this option multiple times to build up a list of things to
exclude.
Starting with version 3, the directories of common version control systems such as cvs, git, hg, svn, and bzr are excluded
automatically.
--mode=mode
Change the way in which modifications to files are detected. The default mode is md5 for using MD5 checksums, but there is also
timesize for using the time of the last modification and the file size.
--as-needed
Enable support for -Wl,--as-needed in all ltmain.sh files identical to the one of the libtool package. This only works in the MD5 mode
(the default one). The changes are reverted in dh_autoreconf_clean. You should not prevent LIBTOOLIZE from running with this, as it
only works correctly with libtoolize running.
program -- params
Run the program given by program with the arguments given by 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).
ENVIRONMENT
For each tool executed by autoreconf(1), one can export a variable with the uppercase name of the tool to the specific program which shall
be run, including true to prevent the tool in question from being run. The following example shows the beginning of a debian/rules for a
package where automake 1.10 shall be run instead of the default automake version and libtoolize shall not be run:
#!/usr/bin/make -f
export AUTOMAKE = automake1.10
export LIBTOOLIZE = true
SEE ALSO debhelper(7), dh_autoreconf_clean(1), dh-autoreconf(7)AUTHOR
Julian Andres Klode <jak@debian.org>
dh-autoreconf v7 2012-11-22 DH_AUTORECONF(1)
Check Out this Related Man Page
AUTORECONF(1) User Commands AUTORECONF(1)NAME
autoreconf - Update generated configuration files
SYNOPSIS
autoreconf [OPTION] ... [CONFIGURE-AC or DIRECTORY] ...
DESCRIPTION
Run `autoconf' (and `autoheader', `aclocal', `automake', `autopoint' (formerly `gettextize'), and `libtoolize' where appropriate) repeat-
edly to remake the GNU Build System files in the DIRECTORIES or the directory trees driven by CONFIGURE-AC (defaulting to `.').
By default, it only remakes those files that are older than their predecessors. If you install new versions of the GNU Build System, run-
ning `autoreconf' remakes all of the files by giving it the `--force' option.
Operation modes:
-h, --help
print this help, then exit
-V, --version
print version number, then exit
-v, --verbose
verbosely report processing
-d, --debug
don't remove temporary files
-f, --force
consider all files obsolete
-i, --install
copy missing auxiliary files
-s, --symlink
with -i, install symbolic links instead of copies
-m, --make
when applicable, re-run ./configure && make
-W, --warnings=CATEGORY
report the warnings falling in CATEGORY [syntax]
Warning categories include:
`cross'
cross compilation issues
`gnu' GNU coding standards (default in gnu and gnits modes)
`obsolete'
obsolete features or constructions
`override'
user redefinitions of Automake rules or variables
`portability'
portability issues
`syntax'
dubious syntactic constructs (default)
`unsupported'
unsupported or incomplete features (default)
`all' all the warnings
`no-CATEGORY'
turn off warnings in CATEGORY
`none' turn off all the warnings
`error'
treat warnings as errors
The environment variable `WARNINGS' is honored. Some subtools might support other warning types, using `all' is encouraged.
Library directories:
-B, --prepend-include=DIR
prepend directory DIR to search path
-I, --include=DIR
append directory DIR to search path
The environment variables AUTOCONF, AUTOHEADER, AUTOMAKE, ACLOCAL, AUTOPOINT, LIBTOOLIZE are honored.
AUTHOR
Written by David J. MacKenzie and Akim Demaille.
REPORTING BUGS
Report bugs to <bug-autoconf@gnu.org>.
COPYRIGHT
Copyright (C) 2003 Free Software Foundation, Inc.
This is free software; see the source for copying conditions. There is NO warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICU-
LAR PURPOSE.
SEE ALSO autoconf(1), automake(1), autoreconf(1), autoupdate(1), autoheader(1), autoscan(1), config.guess(1), config.sub(1), ifnames(1), libtool(1).
The Debian project regards the full documentation for autoreconf to be non-free, so it is not included in Debian. Nevertheless, the non-
free distribution that accompanies Debian includes the manual in its autoconf-doc package. Otherwise, you may be able to access the Auto-
conf manual online.
autoreconf 2.59 September 2005 AUTORECONF(1)