|
|
c13c245 |
.\" Copyright (C) 1992, 1993, 1994, 1995, 1996 Free Software Foundation, Inc.
|
|
|
c13c245 |
.\" Copyright (C) 1998 Ben Pfaff.
|
|
|
c13c245 |
.\"
|
|
|
c13c245 |
.\" Permission is granted to make and distribute verbatim copies of
|
|
|
c13c245 |
.\" this manual provided the copyright notice and this permission notice
|
|
|
c13c245 |
.\" are preserved on all copies.
|
|
|
c13c245 |
.\"
|
|
|
c13c245 |
.\" Permission is granted to copy and distribute modified versions of this
|
|
|
c13c245 |
.\" manual under the conditions for verbatim copying, provided that the entire
|
|
|
c13c245 |
.\" resulting derived work is distributed under the terms of a permission
|
|
|
c13c245 |
.\" notice identical to this one.
|
|
|
c13c245 |
.\"
|
|
|
c13c245 |
.\" Permission is granted to copy and distribute translations of this manual
|
|
|
c13c245 |
.\" into another language, under the above conditions for modified versions,
|
|
|
c13c245 |
.\" except that this permission notice may be stated in a translation approved
|
|
|
c13c245 |
.\" by the Foundation.
|
|
|
c13c245 |
.\"
|
|
|
c13c245 |
.TH AUTOMAKE 1 "28 Jan 2002"
|
|
|
c13c245 |
.SH NAME
|
|
|
c13c245 |
automake - automatically create Makefile.in's from Makefile.am's
|
|
|
c13c245 |
.SH SYNOPSIS
|
|
|
c13c245 |
.B automake
|
|
|
c13c245 |
[
|
|
|
c13c245 |
.B -a
|
|
|
c13c245 |
|
|
|
|
c13c245 |
.B --add-missing
|
|
|
c13c245 |
] [
|
|
|
c13c245 |
.BR --amdir= DIR
|
|
|
c13c245 |
] [
|
|
|
c13c245 |
.BR --build-dir= DIR
|
|
|
c13c245 |
] [
|
|
|
c13c245 |
.B -c
|
|
|
c13c245 |
|
|
|
|
c13c245 |
.B --copy
|
|
|
c13c245 |
] [
|
|
|
c13c245 |
.B --cygnus
|
|
|
c13c245 |
] [
|
|
|
c13c245 |
.B -f
|
|
|
c13c245 |
|
|
|
|
c13c245 |
.B --force-missing
|
|
|
c13c245 |
] [
|
|
|
c13c245 |
.B --foreign
|
|
|
c13c245 |
] [
|
|
|
c13c245 |
.B --gnits
|
|
|
c13c245 |
] [
|
|
|
c13c245 |
.B --gnu
|
|
|
c13c245 |
] [
|
|
|
c13c245 |
.B --help
|
|
|
c13c245 |
] [
|
|
|
c13c245 |
.B -i
|
|
|
c13c245 |
|
|
|
|
c13c245 |
.B --ignore-deps
|
|
|
c13c245 |
] [
|
|
|
c13c245 |
.B --include-deps
|
|
|
c13c245 |
] [
|
|
|
c13c245 |
.B --no-force
|
|
|
c13c245 |
] [
|
|
|
c13c245 |
.B -o
|
|
|
c13c245 |
DIR
|
|
|
c13c245 |
] [
|
|
|
c13c245 |
.BR --output-dir= DIR
|
|
|
c13c245 |
] [
|
|
|
c13c245 |
.BR --srcdir-name= DIR
|
|
|
c13c245 |
] [
|
|
|
c13c245 |
.B -v
|
|
|
c13c245 |
|
|
|
|
c13c245 |
.B --verbose
|
|
|
c13c245 |
] [
|
|
|
c13c245 |
.B --version
|
|
|
c13c245 |
] [
|
|
|
c13c245 |
.B --Werror
|
|
|
c13c245 |
|
|
|
|
c13c245 |
.B --Wno-error
|
|
|
c13c245 |
]
|
|
|
c13c245 |
.SH DESCRIPTION
|
|
|
c13c245 |
.PP
|
|
|
c13c245 |
To create all the
|
|
|
c13c245 |
.BR Makefile.in s
|
|
|
c13c245 |
for a package, run the
|
|
|
c13c245 |
.B automake
|
|
|
c13c245 |
program in the top level directory, with no arguments.
|
|
|
c13c245 |
.B automake
|
|
|
c13c245 |
will automatically find each appropriate
|
|
|
c13c245 |
.B Makefile.am
|
|
|
c13c245 |
(by scanning
|
|
|
c13c245 |
.BR configure.in )
|
|
|
c13c245 |
and generate the corresponding
|
|
|
c13c245 |
.BR Makefile.in .
|
|
|
c13c245 |
Note that
|
|
|
c13c245 |
.B automake
|
|
|
c13c245 |
has a rather simplistic view of what constitutes a package; it assumes
|
|
|
c13c245 |
that a package has only one
|
|
|
c13c245 |
.BR configure.in ,
|
|
|
c13c245 |
at the
|
|
|
c13c245 |
top. If your package has multiple
|
|
|
c13c245 |
.BR configure.in s,
|
|
|
c13c245 |
then you must run
|
|
|
c13c245 |
.B automake
|
|
|
c13c245 |
in each directory holding a
|
|
|
c13c245 |
.BR configure.in .
|
|
|
c13c245 |
.PP
|
|
|
c13c245 |
You can optionally give
|
|
|
c13c245 |
.B automake
|
|
|
c13c245 |
an argument;
|
|
|
c13c245 |
.B .am
|
|
|
c13c245 |
is appended to the argument and the result is used as the name of the
|
|
|
c13c245 |
input file. This feature is generally only used to automatically
|
|
|
c13c245 |
rebuild an out-of-date
|
|
|
c13c245 |
.BR Makefile.in .
|
|
|
c13c245 |
Note that
|
|
|
c13c245 |
.I automake
|
|
|
c13c245 |
must always be run from the topmost directory of a project, even if
|
|
|
c13c245 |
being used to regenerate the
|
|
|
c13c245 |
.B Makefile.in
|
|
|
c13c245 |
in some subdirectory. This is necessary
|
|
|
c13c245 |
because
|
|
|
c13c245 |
.I automake
|
|
|
c13c245 |
must scan
|
|
|
c13c245 |
.BR configure.in ,
|
|
|
c13c245 |
and because
|
|
|
c13c245 |
.I automake
|
|
|
c13c245 |
uses the knowledge that a
|
|
|
c13c245 |
.B Makefile.in
|
|
|
c13c245 |
is in a subdirectory to change its behavior in some cases.
|
|
|
c13c245 |
.PP
|
|
|
c13c245 |
.I automake
|
|
|
c13c245 |
accepts the following options:
|
|
|
c13c245 |
.TP
|
|
|
c13c245 |
.BI -a
|
|
|
c13c245 |
.TP
|
|
|
c13c245 |
.BI --add-missing
|
|
|
c13c245 |
Automake requires certain common files to exist in certain
|
|
|
c13c245 |
situations; for instance
|
|
|
c13c245 |
.B config.guess
|
|
|
c13c245 |
is required if
|
|
|
c13c245 |
.B configure.in
|
|
|
c13c245 |
runs
|
|
|
c13c245 |
.BR AC_CANONICAL_HOST .
|
|
|
c13c245 |
Automake is distributed with several of these files; this option will
|
|
|
c13c245 |
cause the missing ones to be automatically added to the package,
|
|
|
c13c245 |
whenever possible. In general if Automake tells you a file is
|
|
|
c13c245 |
missing, try using this option. By default Automake tries to make a
|
|
|
c13c245 |
symbolic link pointing to its own copy of the missing file; this can
|
|
|
c13c245 |
be changed with \fB--copy\fP.
|
|
|
c13c245 |
.TP
|
|
|
c13c245 |
.BI --libdir=\fRDIR
|
|
|
c13c245 |
Look for Automake data files in directory DIR instead of in the
|
|
|
c13c245 |
installation directory. This is typically used for debugging.
|
|
|
c13c245 |
.TP
|
|
|
c13c245 |
.BI -c
|
|
|
c13c245 |
.TP
|
|
|
c13c245 |
.BI --copy
|
|
|
c13c245 |
When used with \fB--add-missing\fP, causes installed files to be copied.
|
|
|
c13c245 |
The default is to make a symbolic link.
|
|
|
c13c245 |
.TP
|
|
|
c13c245 |
.BI --cygnus
|
|
|
c13c245 |
Causes the generated
|
|
|
c13c245 |
.BR Makefile.in s
|
|
|
c13c245 |
to follow Cygnus rules, instead of GNU or Gnits rules.
|
|
|
c13c245 |
.TP
|
|
|
c13c245 |
.BI -f
|
|
|
c13c245 |
.TP
|
|
|
c13c245 |
.BI --force-missing
|
|
|
c13c245 |
When used with \fB--add-missing\fP, causes standard files to be rebuilt
|
|
|
c13c245 |
even if they already exist in the source tree.
|
|
|
c13c245 |
This involves removing the file from the source tree before creating the
|
|
|
c13c245 |
new symlink (or, with \fB--copy\fP, copying the new file).
|
|
|
c13c245 |
.TP
|
|
|
c13c245 |
.BI --foreign
|
|
|
c13c245 |
Set the global strictness to
|
|
|
c13c245 |
.BR foreign .
|
|
|
c13c245 |
.TP
|
|
|
c13c245 |
.BI --gnits
|
|
|
c13c245 |
Set the global strictness to
|
|
|
c13c245 |
.BR gnits .
|
|
|
c13c245 |
.TP
|
|
|
c13c245 |
.BI --gnu
|
|
|
c13c245 |
Set the global strictness to
|
|
|
c13c245 |
.BR gnu .
|
|
|
c13c245 |
This is the default strictness.
|
|
|
c13c245 |
.TP
|
|
|
c13c245 |
.BI --help
|
|
|
c13c245 |
Print a summary of the command line options and exit.
|
|
|
c13c245 |
.TP
|
|
|
c13c245 |
.BI -i
|
|
|
c13c245 |
.TP
|
|
|
c13c245 |
.BI --ignore-deps
|
|
|
c13c245 |
This disables the dependency tracking feature.
|
|
|
c13c245 |
.TP
|
|
|
c13c245 |
.BI --include-deps
|
|
|
c13c245 |
This enables the dependency tracking feature. This feature is
|
|
|
c13c245 |
enabled by default. This option is provided for historical
|
|
|
c13c245 |
reasons only and probably should not be used.
|
|
|
c13c245 |
.TP
|
|
|
c13c245 |
.BI --no-force
|
|
|
c13c245 |
Ordinarily
|
|
|
c13c245 |
.B automake
|
|
|
c13c245 |
creates all
|
|
|
c13c245 |
.BR Makefile.in s
|
|
|
c13c245 |
mentioned in
|
|
|
c13c245 |
.BR configure.in .
|
|
|
c13c245 |
This option causes it to only update those
|
|
|
c13c245 |
.BR Makefile.in s
|
|
|
c13c245 |
which are out of date with respect to one of their dependents.
|
|
|
c13c245 |
.TP
|
|
|
c13c245 |
.BI -o\ \fRDIR
|
|
|
c13c245 |
.TP
|
|
|
c13c245 |
.BI --output-dir=\fRDIR
|
|
|
c13c245 |
Put the generated
|
|
|
c13c245 |
.B Makefile.in
|
|
|
c13c245 |
in the directory DIR. Ordinarily
|
|
|
c13c245 |
each
|
|
|
c13c245 |
.B Makefile.in
|
|
|
c13c245 |
is created in the directory of the
|
|
|
c13c245 |
corresponding
|
|
|
c13c245 |
.BR Makefile.am .
|
|
|
c13c245 |
This option is used when making
|
|
|
c13c245 |
distributions.
|
|
|
c13c245 |
.TP
|
|
|
c13c245 |
.BI -v
|
|
|
c13c245 |
.TP
|
|
|
c13c245 |
.BI --verbose
|
|
|
c13c245 |
Cause Automake to print information about which files are being read
|
|
|
c13c245 |
or created.
|
|
|
c13c245 |
.TP
|
|
|
c13c245 |
.BI --version
|
|
|
c13c245 |
Print the version number of Automake and exit.
|
|
|
c13c245 |
.TP
|
|
|
c13c245 |
.BI --Werror
|
|
|
c13c245 |
.TP
|
|
|
c13c245 |
.BI --Wno-error
|
|
|
c13c245 |
.B --Werror
|
|
|
c13c245 |
will cause all warnings issued by
|
|
|
c13c245 |
.I automake
|
|
|
c13c245 |
to become errors. Errors affect the exit status of
|
|
|
c13c245 |
\fIautomake\fP, while warnings do not.
|
|
|
c13c245 |
\fB--Wno-error\fP, the default, causes warning to be treated as warnings only.
|
|
|
c13c245 |
.PP
|
|
|
c13c245 |
.SH "SEE ALSO"
|
|
|
c13c245 |
.BR aclocal (1),
|
|
|
c13c245 |
and the Texinfo documentation for automake
|
|
|
c13c245 |
.SH AUTHORS
|
|
|
c13c245 |
Automake was written primarily by David Mackenzie and Tom Tromey.
|
|
|
c13c245 |
This manpage written by Ben Pfaff <pfaffben@pilot.msu.edu> for the
|
|
|
c13c245 |
Debian GNU/Linux
|
|
|
c13c245 |
.B automake
|
|
|
c13c245 |
package.
|