*nix Documentation Project
·  Home
 +   man pages
·  Linux HOWTOs
·  FreeBSD Tips
·  *niX Forums

  man pages->Linux man pages -> autoheader (1)              



NAME    [Toc]    [Back]

       autoheader  - creates a template file of C #define's for use by configure.

SYNOPSIS    [Toc]    [Back]

       autoheader [ --help | -h ] [ --version | -V ] [	--verbose  |  -v  ]  [
       --debug	|  -d  ] [ --autoconf-dir=dir | -A dir ] [ --localdir=dir | -l
       dir ] [ --warnings=category | -W category ]

DESCRIPTION    [Toc]    [Back]

       The autoheader program can create a template file of C  #define	statements
   for   configure	 to  use.   If	configure.ac  invokes  AC_CON-
       FIG_HEADER(FILE), autoheader creates FILE.in; if  multiple  file  arguments
  are given, the first one is used.  Otherwise, autoheader creates

       If you give autoheader an argument, it uses that file instead  of  con-
       figure.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
       autoheader  generates comments and #undef statements itself rather than
       copying them from a file, since the possible  symbols  are  effectively

       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

       autoheader accepts the following options:


       -h     Print a summary of the command line options and exit.


       -V     Print the version number of Autoconf and exit.


       -v     Report processing steps.


       -d     Don't remove the temporary files.


       -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.


       -l dir Look for the package file aclocal.m4 in directory dir instead of
	      in the current directory.


       -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    [Toc]    [Back]

       autoconf(1), autoreconf(1), autoscan(1), autoupdate(1), ifnames(1)

AUTHORS    [Toc]    [Back]

       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 autoconf package.

				   Autoconf			 AUTOHEADER(1)
[ Back ]
 Similar pages
Name OS Title
cdk_template NetBSD Creates a managed curses template widget.
autoconf2.13 Linux creates scripts to configure source code packages using templates
autoconf Linux creates scripts to configure source code packages using templates
evmtemplate Tru64 Event Manager template file
debconf-loadtemplate Linux load template file into debconf database
ldaptemplates.conf Linux configuration file for LDAP display template routines
vnconfig OpenBSD configure vnode disks for file swapping or pseudo file systems
vx_maxlink HP-UX Configure the number of links to a file
dmbuffd IRIX configure DMbufferpool file descriptor
autoupdate Linux updates an old configure.in file to version 2
Copyright © 2004-2005 DeniX Solutions SRL
newsletter delivery service