|
 |
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 ACLOCAL 1 "Automake"
|
|
|
c13c245 |
.SH NAME
|
|
|
c13c245 |
aclocal - automatically generate aclocal.m4 from configure.in
|
|
|
c13c245 |
.SH SYNOPSIS
|
|
|
c13c245 |
.B aclocal
|
|
|
c13c245 |
[
|
|
|
c13c245 |
.BR --acdir= DIR
|
|
|
c13c245 |
] [
|
|
|
c13c245 |
.B --help
|
|
|
c13c245 |
] [
|
|
|
c13c245 |
.B -I
|
|
|
c13c245 |
DIR ] [
|
|
|
c13c245 |
.BR --output= FILE
|
|
|
c13c245 |
] [
|
|
|
c13c245 |
.B --verbose
|
|
|
c13c245 |
] [
|
|
|
c13c245 |
.B --version
|
|
|
c13c245 |
]
|
|
|
c13c245 |
.SH DESCRIPTION
|
|
|
c13c245 |
.PP
|
|
|
c13c245 |
Automake includes a number of Autoconf macros which can be used in
|
|
|
c13c245 |
your package; some of them are actually required by Automake in certain
|
|
|
c13c245 |
situations. These macros must be defined in your
|
|
|
c13c245 |
.BR aclocal.m4 ;
|
|
|
c13c245 |
otherwise they will not be seen by
|
|
|
c13c245 |
.BR autoconf .
|
|
|
c13c245 |
.PP
|
|
|
c13c245 |
The
|
|
|
c13c245 |
.B aclocal
|
|
|
c13c245 |
program will automatically generate
|
|
|
c13c245 |
.B aclocal.m4
|
|
|
c13c245 |
files based on the contents of
|
|
|
c13c245 |
.BR configure.in .
|
|
|
c13c245 |
This provides a convenient way to get Automake-provided macros,
|
|
|
c13c245 |
without having to search around. Also, the
|
|
|
c13c245 |
.B aclocal
|
|
|
c13c245 |
mechanism is extensible for use by other packages.
|
|
|
c13c245 |
.PP
|
|
|
c13c245 |
At startup,
|
|
|
c13c245 |
.B aclocal
|
|
|
c13c245 |
scans all the
|
|
|
c13c245 |
.B .m4
|
|
|
c13c245 |
files it can find, looking for macro definitions. Then it scans
|
|
|
c13c245 |
.BR configure.in .
|
|
|
c13c245 |
Any mention of one of the macros found in the first step causes that
|
|
|
c13c245 |
macro, and any macros it in turn requires, to be put into
|
|
|
c13c245 |
.BR aclocal.m4 .
|
|
|
c13c245 |
.PP
|
|
|
c13c245 |
The contents of
|
|
|
c13c245 |
.BR acinclude.m4 ,
|
|
|
c13c245 |
if it exists, are also automatically included in
|
|
|
c13c245 |
.BR aclocal.m4 .
|
|
|
c13c245 |
This is useful for incorporating local macros into
|
|
|
c13c245 |
.BR configure .
|
|
|
c13c245 |
.PP
|
|
|
c13c245 |
.B aclocal
|
|
|
c13c245 |
accepts the following options:
|
|
|
c13c245 |
.TP
|
|
|
c13c245 |
.BI --acdir=\fRDIR
|
|
|
c13c245 |
Look for the macro files in DIR instead of the installation
|
|
|
c13c245 |
directory. This is typically used for debugging.
|
|
|
c13c245 |
.TP
|
|
|
c13c245 |
.BI --help
|
|
|
c13c245 |
Print a summary of the command line options and exit.
|
|
|
c13c245 |
.TP
|
|
|
c13c245 |
.BI -I\fR\ DIR
|
|
|
c13c245 |
Add the directory DIR to the list of directories searched for
|
|
|
c13c245 |
.B .m4
|
|
|
c13c245 |
files.
|
|
|
c13c245 |
.TP
|
|
|
c13c245 |
.BI --output=\fRFILE
|
|
|
c13c245 |
Cause the output to be put into FILE instead of
|
|
|
c13c245 |
.BR aclocal.m4 .
|
|
|
c13c245 |
.TP
|
|
|
c13c245 |
.BI --verbose
|
|
|
c13c245 |
Print the names of the files it examines.
|
|
|
c13c245 |
.TP
|
|
|
c13c245 |
.BI --version
|
|
|
c13c245 |
Print the version number of Automake and exit.
|
|
|
c13c245 |
.PP
|
|
|
c13c245 |
.SH "SEE ALSO"
|
|
|
c13c245 |
.BR automake (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.
|