AUTOHEADER(1)						      General Commands Manual						     AUTOHEADER(1)

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_CON-
       FIG_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 con-
       tains the string @TOP@, autoheader2.13 copies the lines before the line containing @TOP@ into the top of the file that it generates.  Simi-
       larly,  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  direc-
       tory.  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.

								     Autoconf							     AUTOHEADER(1)