AUTOHEADER(1) General Commands Manual AUTOHEADER(1)
NAME
autoheader2.13 - creates a template file of C #define's for use by con-
figure.
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_CON-
FIG_HEADER(FILE), autoheader2.13 creates FILE.in; if multiple file ar-
guments 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 in-
stalled with Autoconf. It also uses a file called acconfig.h in the
current directory, if present. If you AC_DEFINE any additional sym-
bols, you must create that file with entries for them. For symbols de-
fined 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 con-
taining @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 direc-
tory. 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 an-
other 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 cur-
rent 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@de-
bian.org> for the Debian GNU/Linux autoconf2.13 package.
Autoconf AUTOHEADER(1)
Generated by dwww version 1.15 on Sat Jun 29 02:27:40 CEST 2024.