NAME¶
autoheader2.13 - creates a template file of C #define's for use by configure.
SYNOPSIS¶
autoheader2.13 [
--help |
-h ] [
--localdir=dir |
-l dir ] [
--macrodir=dir |
-m dir ] [
--version ]
DESCRIPTION¶
The
autoheader2.13 program can create a template file of C
#define
statements for
configure to use. If
configure.in invokes
AC_CONFIG_HEADER(FILE),
autoheader2.13 creates
FILE.in;
if multiple file arguments are given, the first one is used. Otherwise,
autoheader2.13 creates
config.h.in.
If you give
autoheader2.13 an argument, it uses that file instead of
configure.in and writes the header file to the standard output instead
of to
config.h.in. If you give
autoheader2.13 an argument of
-, it reads the standard input instead of
configure.in and
writes the header file to the standard output.
autoheader2.13 scans
configure.in and figures out which C
preprocessor symbols it might define. It copies comments and
#define
and
#undef statements from a file called
acconfig.h, which comes
with and is installed with Autoconf. It also uses a file called
acconfig.h in the current directory, if present. If you
AC_DEFINE any additional symbols, you must create that file with
entries for them. For symbols defined by
AC_CHECK_HEADERS,
AC_CHECK_FUNCS,
AC_CHECK_SIZEOF, or
AC_CHECK_LIB,
autoheader2.13 generates comments and
#undef statements itself
rather than copying them from a file, since the possible symbols are
effectively limitless.
The file that
autoheader2.13 creates contains mainly
#define and
#undef statements and their accompanying comments. If
./acconfig.h contains the string
@TOP@,
autoheader2.13
copies the lines before the line containing
@TOP@ into the top of the
file that it generates. Similarly, if
./acconfig.h contains the string
@BOTTOM@,
autoheader2.13 copies the lines after that line to the
end of the file it generates. Either or both of those strings may be omitted.
An alternate way to produce the same effect is to create the files
FILE.top (typically
config.h.top) and/or
FILE.bot in the
current directory. If they exist,
autoheader2.13 copies them to the
beginning and end, respectively, of its output. Their use is discouraged
because they have file names that contain two periods, and so can not be
stored on MS-DOS; also, they are two more files to clutter up the directory.
But if you use the
--localdir=DIR option to use an
acconfig.h in
another directory, they give you a way to put custom boilerplate in each
individual
config.h.in.
autoheader2.13 accepts the following options:
- --help
- -h
- Print a summary of the command line options and exit.
- --localdir=DIR
- -l DIR
- Look for the package files aclocal.m4 and acconfig.h (but
not FILE.top and FILE.bot) in directory DIR instead of in
the current directory.
- --macrodir=DIR
- -m DIR
- Look for the installed macro files and acconfig.h in directory DIR.
You can also set the AC_MACRODIR environment variable to a
directory; this option overrides the environment variable.
- --version
- Print the version number of Autoconf and exit.
SEE ALSO¶
autoconf2.13(1),
autoreconf2.13(1),
autoscan2.13(1),
autoupdate2.13(1),
ifnames2.13(1)
AUTHORS¶
David MacKenzie, with help from Franc,ois Pinard, Karl Berry, Richard Pixley,
Ian Lance Taylor, Roland McGrath, Noah Friedman, David D. Zuhn, and many
others. This manpage written by Ben Pfaff <pfaffben@debian.org> for the
Debian GNU/Linux
autoconf2.13 package.
