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

  man pages->Linux man pages -> autoheader2.13 (1)              



NAME    [Toc]    [Back]

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

SYNOPSIS    [Toc]    [Back]

       autoheader2.13 [  --help  |  -h	]  [  --localdir=dir  |  -l  dir  ]  [
       --macrodir=dir | -m dir ] [ --version ]

DESCRIPTION    [Toc]    [Back]

       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
       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  containing
	@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 directory.
  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
       another	directory,  they  give	you a way to put custom boilerplate in
       each individual config.h.in.

       autoheader2.13 accepts the following options:


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


       -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


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

	      Print the version number of Autoconf and exit.

SEE ALSO    [Toc]    [Back]

       autoconf2.13(1), autoreconf2.13(1), autoscan2.13(1), autoupdate2.13(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@msu.edu>
       for the Debian GNU/Linux autoconf2.13 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