(automk14.info.gz) Invoking Automake
Info Catalog
(automk14.info.gz) Examples
(automk14.info.gz) Top
(automk14.info.gz) configure
4 Creating a `Makefile.in'
**************************
To create all the `Makefile.in's for a package, run the `automake'
program in the top level directory, with no arguments. `automake' will
automatically find each appropriate `Makefile.am' (by scanning
`configure.in'; configure) and generate the corresponding
`Makefile.in'. Note that `automake' has a rather simplistic view of
what constitutes a package; it assumes that a package has only one
`configure.in', at the top. If your package has multiple
`configure.in's, then you must run `automake' in each directory holding
a `configure.in'.
You can optionally give `automake' an argument; `.am' is appended to
the argument and the result is used as the name of the input file.
This feature is generally only used to automatically rebuild an
out-of-date `Makefile.in'. Note that `automake' must always be run
from the topmost directory of a project, even if being used to
regenerate the `Makefile.in' in some subdirectory. This is necessary
because `automake' must scan `configure.in', and because `automake'
uses the knowledge that a `Makefile.in' is in a subdirectory to change
its behavior in some cases.
`automake' accepts the following options:
`-a'
`--add-missing'
Automake requires certain common files to exist in certain
situations; for instance `config.guess' is required if
`configure.in' runs `AC_CANONICAL_HOST'. Automake is distributed
with several of these files; this option will cause the missing
ones to be automatically added to the package, whenever possible.
In general if Automake tells you a file is missing, try using this
option. By default Automake tries to make a symbolic link
pointing to its own copy of the missing file; this can be changed
with `--copy'.
`--amdir=DIR'
Look for Automake data files in directory DIR instead of in the
installation directory. This is typically used for debugging.
`--build-dir=DIR'
Tell Automake where the build directory is. This option is used
when including dependencies into a `Makefile.in' generated by `make
dist'; it should not be used otherwise.
`-c'
`--copy'
When used with `--add-missing', causes installed files to be
copied. The default is to make a symbolic link.
`--cygnus'
Causes the generated `Makefile.in's to follow Cygnus rules, instead
of GNU or Gnits rules. For more information, see Cygnus.
`--foreign'
Set the global strictness to `foreign'. For more information, see
Strictness.
`--gnits'
Set the global strictness to `gnits'. For more information, see
Gnits.
`--gnu'
Set the global strictness to `gnu'. For more information, see
Gnits. This is the default strictness.
`--help'
Print a summary of the command line options and exit.
`-i'
`--include-deps'
Include all automatically generated dependency information (
Dependencies) in the generated `Makefile.in'. This is generally
done when making a distribution; see Dist.
`--generate-deps'
Generate a file concatenating all automatically generated
dependency information ( Dependencies) into one file,
`.dep_segment'. This is generally done when making a
distribution; see Dist. It is useful when maintaining a
`SMakefile' or makefiles for other platforms (`Makefile.DOS',
etc.) It can only be used in conjunction with `--include-deps',
`--srcdir-name', and `--build-dir'. Note that if this option is
given, no other processing is done.
`--no-force'
Ordinarily `automake' creates all `Makefile.in's mentioned in
`configure.in'. This option causes it to only update those
`Makefile.in's which are out of date with respect to one of their
dependents.
`-o DIR'
`--output-dir=DIR'
Put the generated `Makefile.in' in the directory DIR. Ordinarily
each `Makefile.in' is created in the directory of the
corresponding `Makefile.am'. This option is used when making
distributions.
`--srcdir-name=DIR'
Tell Automake the name of the source directory associated with the
current build. This option is used when including dependencies
into a `Makefile.in' generated by `make dist'; it should not be
used otherwise.
`-v'
`--verbose'
Cause Automake to print information about which files are being
read or created.
`--version'
Print the version number of Automake and exit.
Info Catalog
(automk14.info.gz) Examples
(automk14.info.gz) Top
(automk14.info.gz) configure
automatically generated byinfo2html