dh_autoreconf(1) [debian man page]

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

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 which can be used 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:

	   #!/usr/bin/make -f
	   %:
	       dh $@ --with autoreconf
	   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 a superset of the autotools-dev debhelper addons, so you do not need --with=autotools_dev if you use --with=autoreconf. In
       fact, in most cases they should not be used together, as it may lead to unpredictable behaviour.

       From time to time, there might be a short breakage for those using automatic ltmain.sh patching, when the patch now 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 <jak@debian.org>

dh-autoreconf v7						    2012-11-22							  DH-AUTORECONF(7)

Linux and UNIX Man Pages

dh_autoreconf(1) [debian man page]

Check Out this Related Man Page