autoconf: autoreconf Invocation
1
1 3.5 Using `autoreconf' to Update `configure' Scripts
1 ====================================================
1
1 Installing the various components of the GNU Build System can be
1 tedious: running `autopoint' for Gettext, `automake' for `Makefile.in'
1 etc. in each directory. It may be needed either because some tools
1 such as `automake' have been updated on your system, or because some of
1 the sources such as `configure.ac' have been updated, or finally,
1 simply in order to install the GNU Build System in a fresh tree.
1
1 `autoreconf' runs `autoconf', `autoheader', `aclocal', `automake',
1 `libtoolize', and `autopoint' (when appropriate) repeatedly to update
1 the GNU Build System in the specified directories and their
1 subdirectories (⇒Subdirectories). By default, it only remakes
1 those files that are older than their sources. The environment
1 variables `AUTOM4TE', `AUTOCONF', `AUTOHEADER', `AUTOMAKE', `ACLOCAL',
1 `AUTOPOINT', `LIBTOOLIZE', `M4', and `MAKE' may be used to override the
1 invocation of the respective tools.
1
1 If you install a new version of some tool, you can make `autoreconf'
1 remake _all_ of the files by giving it the `--force' option.
1
1 ⇒Automatic Remaking, for Make rules to automatically rebuild
1 `configure' scripts when their source files change. That method
1 handles the timestamps of configuration header templates properly, but
1 does not pass `--autoconf-dir=DIR' or `--localdir=DIR'.
1
1 Gettext supplies the `autopoint' command to add translation
1 infrastructure to a source package. If you use `autopoint', your
1 `configure.ac' should invoke both `AM_GNU_GETTEXT' and
11 `AM_GNU_GETTEXT_VERSION(GETTEXT-VERSION)'. ⇒Invoking the
`autopoint' Program (gettext)autopoint Invocation, for further details.
1
1 `autoreconf' accepts the following options:
1
1 `--help'
1 `-h'
1 Print a summary of the command line options and exit.
1
1 `--version'
1 `-V'
1 Print the version number of Autoconf and exit.
1
1 `--verbose'
1 `-v'
1 Print the name of each directory `autoreconf' examines and the
1 commands it runs. If given two or more times, pass `--verbose' to
1 subordinate tools that support it.
1
1 `--debug'
1 `-d'
1 Don't remove the temporary files.
1
1 `--force'
1 `-f'
1 Remake even `configure' scripts and configuration headers that are
1 newer than their input files (`configure.ac' and, if present,
1 `aclocal.m4').
1
1 `--install'
1 `-i'
1 Install the missing auxiliary files in the package. By default,
1 files are copied; this can be changed with `--symlink'.
1
1 If deemed appropriate, this option triggers calls to `automake
1 --add-missing', `libtoolize', `autopoint', etc.
1
1 `--no-recursive'
11 Do not rebuild files in subdirectories to configure (see ⇒
Subdirectories, macro `AC_CONFIG_SUBDIRS').
1
1 `--symlink'
1 `-s'
1 When used with `--install', install symbolic links to the missing
1 auxiliary files instead of copying them.
1
1 `--make'
1 `-m'
1 When the directories were configured, update the configuration by
1 running `./config.status --recheck && ./config.status', and then
1 run `make'.
1
1 `--include=DIR'
1 `-I DIR'
1 Append DIR to the include path. Multiple invocations accumulate.
1 Passed on to `aclocal', `autoconf' and `autoheader' internally.
1
1 `--prepend-include=DIR'
1 `-B DIR'
1 Prepend DIR to the include path. Multiple invocations accumulate.
1 Passed on to `autoconf' and `autoheader' internally.
1
1 `--warnings=CATEGORY'
1 `-W CATEGORY'
1 Report the warnings related to CATEGORY (which can actually be a
1 comma separated list).
1
1 `cross'
1 related to cross compilation issues.
1
1 `obsolete'
1 report the uses of obsolete constructs.
1
1 `portability'
1 portability issues
1
1 `syntax'
1 dubious syntactic constructs.
1
1 `all'
1 report all the warnings
1
1 `none'
1 report none
1
1 `error'
1 treats warnings as errors
1
1 `no-CATEGORY'
1 disable warnings falling into CATEGORY
1
1 Warnings about `syntax' are enabled by default, and the environment
1 variable `WARNINGS', a comma separated list of categories, is
1 honored as well. Passing `-W CATEGORY' actually behaves as if you
1 had passed `--warnings syntax,$WARNINGS,CATEGORY'. To disable the
1 defaults and `WARNINGS', and then enable warnings about obsolete
1 constructs, use `-W none,obsolete'.
1
1 If you want `autoreconf' to pass flags that are not listed here on
1 to `aclocal', set `ACLOCAL_AMFLAGS' in your `Makefile.am'. Due to a
1 limitation in the Autoconf implementation these flags currently must be
1 set on a single line in `Makefile.am', without any backslash-newlines.
1