(autoconf.info)autoreconf Invocation

Prev: autoconf Invocation Up: Making configure Scripts

3.5 Using `autoreconf' to Update `configure' Scripts

Installing the various components of the GNU Build System can be
tedious: running `autopoint' for Gettext, `automake' for `Makefile.in'
etc. in each directory.  It may be needed either because some tools
such as `automake' have been updated on your system, or because some of
the sources such as `configure.ac' have been updated, or finally,
simply in order to install the GNU Build System in a fresh tree.

   `autoreconf' runs `autoconf', `autoheader', `aclocal', `automake',
`libtoolize', and `autopoint' (when appropriate) repeatedly to update
the GNU Build System in the specified directories and their
subdirectories (Note: Subdirectories).  By default, it only remakes
those files that are older than their sources.  The environment
`LIBTOOLIZE', `M4', and `MAKE' may be used to override the invocation
of the respective tools.

   If you install a new version of some tool, you can make `autoreconf'
remake _all_ of the files by giving it the `--force' option.

   Note: Automatic Remaking, for Make rules to automatically rebuild
`configure' scripts when their source files change.  That method
handles the timestamps of configuration header templates properly, but
does not pass `--autoconf-dir=DIR' or `--localdir=DIR'.

   Gettext supplies the `autopoint' command to add translation
infrastructure to a source package.  If you use `autopoint', your
`configure.ac' should invoke both `AM_GNU_GETTEXT' and
`autopoint' Program, for further details.

`autoreconf' accepts the following options:

     Print a summary of the command line options and exit.

     Print the version number of Autoconf and exit.

     Print the name of each directory `autoreconf' examines and the
     commands it runs.  If given two or more times, pass `--verbose' to
     subordinate tools that support it.

     Don't remove the temporary files.

     Remake even `configure' scripts and configuration headers that are
     newer than their input files (`configure.ac' and, if present,

     Install the missing auxiliary files in the package.  By default,
     files are copied; this can be changed with `--symlink'.

     If deemed appropriate, this option triggers calls to `automake
     --add-missing', `libtoolize', `autopoint', etc.

     Do not rebuild files in subdirectories to configure (see *Note
     Subdirectories::, macro `AC_CONFIG_SUBDIRS').

     When used with `--install', install symbolic links to the missing
     auxiliary files instead of copying them.

     When the directories were configured, update the configuration by
     running `./config.status --recheck && ./config.status', and then
     run `make'.

`-I DIR'
     Append DIR to the include path.  Multiple invocations accumulate.
     Passed on to `autoconf' and `autoheader' internally.


`-B DIR'
     Prepend DIR to the include path.  Multiple invocations accumulate.
     Passed on to `autoconf' and `autoheader' internally.

     Report the warnings related to CATEGORY (which can actually be a
     comma separated list).

          related to cross compilation issues.

          report the uses of obsolete constructs.

          portability issues

          dubious syntactic constructs.

          report all the warnings

          report none

          treats warnings as errors

          disable warnings falling into CATEGORY

     Warnings about `syntax' are enabled by default, and the environment
     variable `WARNINGS', a comma separated list of categories, is
     honored as well.  Passing `-W CATEGORY' actually behaves as if you
     had passed `--warnings syntax,$WARNINGS,CATEGORY'.  If you want to
     disable the defaults and `WARNINGS', but (for example) enable the
     warnings about obsolete constructs, you would use `-W

   If you want `autoreconf' to pass flags that are not listed here on
to `aclocal', set `ACLOCAL_AMFLAGS' in your `Makefile.am'.  Due to a
limitation in the Autoconf implementation these flags currently must be
set on a single line in `Makefile.am', without any backslash-newlines.

automatically generated by info2www