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