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>