Home
Main website
Display Sidebar
Hide Ads
Recent Changes
View Source:
autoheader(1)
Edit
PageHistory
Diff
Info
LikePages
AUTOHEADER !!!AUTOHEADER NAME SYNOPSIS DESCRIPTION SEE ALSO AUTHORS ---- !!NAME autoheader - creates a template file of C #define's for use by configure. !!SYNOPSIS __autoheader__ [[ __--help__ | __-h__ ] [[ __--version__ | __-V__ ] [[ __--verbose__ | __-v__ ] [[ __--debug__ | __-d__ ] [[ __--autoconf-dir=__''dir'' | __-A__ ''dir'' ] [[ __--localdir=__''dir'' | __-l__ ''dir'' ] [[ __--warnings=__''category'' | __-W__ ''category'' ] !!DESCRIPTION The __autoheader__ program can create a template file of C __#define__ statements for __configure__ to use. If __configure.ac__ invokes __AC_CONFIG_HEADER(FILE)__, __autoheader__ creates __FILE.in__; if multiple file arguments are given, the first one is used. Otherwise, __autoheader__ creates __config.h.in__. If you give __autoheader__ an argument, it uses that file instead of __configure.ac__ and writes the header file to the standard output instead of to __config.h.in__. If you give __autoheader__ an argument of __-__, it reads the standard input instead of __configure.ac__ and writes the header file to the standard output. __autoheader__ scans __configure.ac__ 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__, __autoheader__ generates comments and __#undef__ statements itself rather than copying them from a file, since the possible symbols are effectively limitless. The file that __autoheader__ creates contains mainly __#define__ and __#undef__ statements and their accompanying comments. If __./acconfig.h__ contains the string __@TOP@__, __autoheader__ 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@__, __autoheader__ 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, __autoheader__ 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__. __autoheader__ accepts the following options: __--help__ __-h__ Print a summary of the command line options and exit. __--version__ __-V__ Print the version number of Autoconf and exit. __--verbose__ __-v__ Report processing steps. __--debug__ __-d__ Don't remove the temporary files. __--autoconf-dir=__''dir'' __-A__ ''dir'' Look for the installed macro files in directory ''dir''. You can also set the __AC_MACRODIR__ environment variable to a directory; this option overrides the environment variable. __--localdir=__''dir'' __-l__ ''dir'' Look for the package file __aclocal.m4__ in directory ''dir'' instead of in the current directory. __--warnings=__''category'' __-W__ ''category'' Report the warnings related to ''category'' (which can actually be a comma separated list). Special values for ''category'' include __all__ to report all warnings, __none__ to report no warnings, and __error__ to treat warnings as errors. See the Texinfo documentation for a list of categories and additional information. !!SEE ALSO autoconf(1), autoreconf(1), autoscan(1), autoupdate(1), ifnames(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 autoconf__ package. ----
6 pages link to
autoheader(1)
:
ifnames(1)
autoconf(1)
autoreconf(1)
autoscan(1)
autoupdate(1)
Man1a
This page is a man page (or other imported legacy content). We are unable to automatically determine the license status of this page.
