Login or Register to Ask a Question and Join Our Community

Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

autoconf(1) [debian man page]

AUTOCONF(1)						      General Commands Manual						       AUTOCONF(1)

NAME

       wrapper - Wrapper for distinguishing Autoconf 2.13 and 2.50

SYNOPSIS

       autoconf [ options ]
       autoheader [ options ]
       autoreconf [ options ]

DESCRIPTION

       Autoconf  is an automatic configure script builder with two major version series: 2.13 and earlier, 2.50 and later.  Versions within either
       series are largely compatible, but the two series are largely incompatible.  When both versions are installed, as they are on  your  system
       (given that you're reading this manpage), Debian selects between the two versions simultaneously.  This manpage documents how the automatic
       selection works.  If you are actually looking for the documentation for either version of Autoconf, then refer  to  the	SEE  ALSO  section
       below.

       Automatic  version  selection  works  via  a  wrapper script installed under the names autoconf, autoheader, and autoreconf.  Each of these
       attempts to detect which Autoconf is needed and run the correct version of the tool.

       There are no wrappers for autoupdate, autoscan, or ifnames.  These are not used during a package build.	Choose the proper version by hand.

       The following heuristics are used to choose an Autoconf version:

       *      If file configure.ac exists, Autoconf 2.50 is used.  Autoconf 2.13 used the name configure.in instead,  but  version  2.50  supports
	      both.

	      (Usually	autoconf  is run without nonoption arguments.  If a filename is supplied on the command line, then version 2.50 is used if
	      the filename ends in .ac.)

       *      Otherwise, configure.in (or the file specified on the command line, if any) is read.  It is checked for the presence of an AC_PREREQ
	      directive.  If it specifies a minimum version higher than 2.13, Autoconf 2.50 is used.  aclocal.m4, if present, is also scanned.

       *      Otherwise, Autoconf 2.13 is used.

       To  force  Autoconf 2.13 to be used, name the Autoconf input file configure.in and omit the use of AC_PREREQ() or specify a minimum version
       of 2.13 or earlier.  To force Autoconf 2.50 to be used, name the input file configure.ac or use AC_PREREQ(2.50).

       I recommend not calling the programs autoconf2.13 or autoconf2.50, etc., directly, instead of through the wrappers.  When  used	with  pro-
       grams like Automake, these direct calls won't propagate through into the Makefile, so later re-autoconf'ings won't use the correct version.
       It's better to use one of the methods explained above to force a particular version.

SEE ALSO

       autoconf2.13(1), autoheader2.13(1), autoreconf2.13(1), autoconf2.50(1), autoheader2.50(1),  autoreconf2.50(1),  and  the  Autoconf  manuals
       autoconf and autoconf2.13.

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 Wrapper						       AUTOCONF(1)

Check Out this Related Man Page

AUTOCONF(1)						      General Commands Manual						       AUTOCONF(1)

NAME

       autoscan2.13 - help to create a configure.in file for a software package

SYNOPSIS

       autoscan2.13 [ --help ] [ --macrodir=dir ] [ --verbose ] [ --version ]

DESCRIPTION

       The  autoscan2.13 program can help you create a configure.in file for a software package.  autoscan2.13 examines source files in the direc-
       tory tree rooted at a directory given as a command line argument, or the current directory if none is given.  It searches the source  files
       for common portability problems and creates a file configure.scan which is a preliminary configure.in for that package.

       You  should  manually  examine  configure.scan  before  renaming  it to configure.in; it will probably need some adjustments.  Occasionally
       autoscan2.13 outputs a macro in the wrong order relative to another macro, so that autoconf2.13 produces a warning; you need to	move  such
       macros  manually.   Also,  if  you want the package to use a configuration header file, you must add a call to AC_CONFIG_HEADER.  You might
       also have to change or add some #if directives to your program in order to make it work with Autoconf (see ifnames2.13(1)), for information
       about a program that can help with that job).

       autoscan2.13  uses  several  data  files, which are installed along with the distributed Autoconf macro files, to determine which macros to
       output when it finds particular symbols in a package's source files.  These files all have the same format.  Each line consists of  a  sym-
       bol, whitespace, and the Autoconf macro to output if that symbol is encountered.  Lines starting with # are comments.

       autoscan2.13 requires that a Perl interpreter is installed.

       autoscan2.13 accepts the following options:

       --help

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

       --macrodir=DIR

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

       --verbose
	      Print the names of the fiels it examines and the potentially interesting symbols it finds in them.  This output can be voluminous.

       --version
	      Print the version number of Autoconf and exit.

SEE ALSO

       autoconf2.13(1), autoheader2.13(1), autoreconf2.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							       AUTOCONF(1)
Man Page