AUTOHEADER(R)                                       AUTOHEADER(R)



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 cate-
       gory ]

DESCRIPTION
       The  autoheader  program  can  create a template file of C
       #define statements for configure to use.  If  configure.ac
       invokes    AC_CONFIG_HEADER(R),    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 pre-
       processor 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 Auto-
       conf.  It also uses a file called acconfig.h in  the  cur-
       rent  directory,  if  present.  If you AC_DEFINE any addi-
       tional 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,  auto-
       header  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,  auto-
       header 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 individ-
       ual 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  val-
              ues  for  category  include all to report all warn-
              ings, none to report  no  warnings,  and  error  to
              treat warnings as errors.  See the Texinfo documen-
              tation for a  list  of  categories  and  additional
              information.

SEE ALSO
       autoconf(f),  autoreconf(f),  autoscan(n),  autoupdate(e),
       ifnames(s)

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  man-
       page  written  by  Ben Pfaff <pfaffben@debian.org> for the
       Debian GNU/Linux autoconf package.



                             Autoconf               AUTOHEADER(R)