autoconf - Man Page

Generate configuration scripts

Examples (TL;DR)

Synopsis

autoconf [OPTION]... [TEMPLATE-FILE]

Description

Generate a configuration script from a TEMPLATE-FILE if given, or 'configure.ac' if present, or else 'configure.in'.  Output is sent to the standard output if TEMPLATE-FILE is given, else into 'configure'.

Operation modes

-h,  --help

print this help, then exit

-V,  --version

print version number, then exit

-v,  --verbose

verbosely report processing

-d,  --debug

don't remove temporary files

-f,  --force

consider all files obsolete

-o,  --output=FILE

save output in FILE (stdout is the default)

-W,  --warnings=CATEGORY

report the warnings falling in CATEGORY (comma-separated list accepted)

Warning categories are

cross

cross compilation issues

gnu

GNU coding standards (default in gnu and gnits modes)

obsolete

obsolete features or constructions (default)

override

user redefinitions of Automake rules or variables

portability

portability issues (default in gnu and gnits modes)

portability-recursive

nested Make variables (default with -Wportability)

extra-portability

extra portability issues related to obscure tools

syntax

dubious syntactic constructs (default)

unsupported

unsupported or incomplete features (default)

-W also understands

all

turn on all the warnings

none

turn off all the warnings

no-CATEGORY

turn off warnings in CATEGORY

error

treat all enabled warnings as errors

Library directories

-B,  --prepend-include=DIR

prepend directory DIR to search path

-I,  --include=DIR

append directory DIR to search path

Tracing

-t,  --trace=MACRO[:FORMAT]

report the list of calls to MACRO

-i,  --initialization

also trace Autoconf's initialization process

In tracing mode, no configuration script is created.  FORMAT defaults to '$f:$l:$n:$%'; see 'autom4te --help' for information about FORMAT.

Author

Written by David J. MacKenzie and Akim Demaille.

Reporting Bugs

Report bugs to bug-autoconf@gnu.org, or via Savannah: https://savannah.gnu.org/support/?group=autoconf.

See Also

autoconf(1), automake(1), autoreconf(1), autoupdate(1), autoheader(1), autoscan(1), config.guess(1), config.sub(1), ifnames(1), libtool(1).

The full documentation for Autoconf is maintained as a Texinfo manual. To read the manual locally, use the command

info autoconf

You can also consult the Web version of the manual at https://gnu.org/software/autoconf/manual/.

Referenced By

autoheader(1), autom4te(1), autoreconf(1), autoscan(1), autoupdate(1), daemon(7), ifnames(1), mate-autogen(1), ocaml.m4(1), pcap.3pcap(3), root-config(1), time(1).

December 2023 GNU Autoconf 2.72