* configure: (autoconf)configure Invocation. Configuring a package.
* autoupdate: (autoconf)autoupdate Invocation.
Automatic update of @file{configure.ac}
-* config.status: (autoconf)config.status Invocation. Recreating configurations.
+* config.status: (autoconf)Recreating a Configuration. Recreating configurations.
* testsuite: (autoconf)testsuite Invocation. Running an Autotest test suite.
@end direntry
* Manual Configuration:: Selecting features that can't be guessed
* Site Configuration:: Local defaults for @command{configure}
* Running configure Scripts:: How to use the Autoconf output
-* config.status Invocation:: Recreating a configuration
+* Recreating a Configuration:: Invoking @command{config.status}
* Obsolete Constructs:: Kept for backward compatibility
* Using Autotest:: Creating portable test suites
* FAQ:: Frequent Autoconf Questions, with answers
Making @command{configure} Scripts
-* Writing configure.ac:: What to put in an Autoconf input file
+* Writing Autoconf Input:: What to put in an Autoconf input file
* autoscan Invocation:: Semi-automatic @file{configure.ac} writing
* ifnames Invocation:: Listing the conditionals in source code
* autoconf Invocation:: How to create configuration scripts
* Shell Script Compiler:: Autoconf as solution of a problem
* Autoconf Language:: Programming in Autoconf
-* configure.ac Layout:: Standard organization of @file{configure.ac}
+* Autoconf Input Layout:: Standard organization of @file{configure.ac}
Initialization and Output Files
Obsolete Constructs
-* Obsolete config.status Use:: Different calling convention
-* acconfig.h:: Additional entries in @file{config.h.in}
+* Obsolete Recreation:: Obsolete convention for @command{config.status}
+* acconfig Header:: Additional entries in @file{config.h.in}
* autoupdate Invocation:: Automatic update of @file{configure.ac}
* Obsolete Macros:: Backward compatibility macros
* Autoconf 1:: Tips for upgrading your files
-* Autoconf 2.13:: Some fresher tips
+* 20th-century Autoconf 2:: Some fresher tips
Upgrading From Version 1
Generating Test Suites with Autotest
* Using an Autotest Test Suite:: Autotest and the user
-* Writing testsuite.at:: Autotest macros
+* Writing Testsuites:: Autotest macros
* testsuite Invocation:: Running @command{testsuite} scripts
* Making testsuite Scripts:: Using autom4te to create @command{testsuite}
* Bootstrapping:: Autoconf and @acronym{GNU} M4 require each other?
* Why Not Imake:: Why @acronym{GNU} uses @command{configure} instead of Imake
* Defining Directories:: Passing @code{datadir} to program
-* autom4te.cache:: What is it? Can I remove it?
+* Autom4te Cache:: What is it? Can I remove it?
* Present But Cannot Be Compiled:: Compiler and Preprocessor Disagree
History of Autoconf
@item
a shell script called @file{config.status} that, when run, recreates
-the files listed above (@pxref{config.status Invocation});
+the files listed above (@pxref{Recreating a Configuration});
@item
an optional shell script normally called @file{config.cache}
@end example
@menu
-* Writing configure.ac:: What to put in an Autoconf input file
+* Writing Autoconf Input:: What to put in an Autoconf input file
* autoscan Invocation:: Semi-automatic @file{configure.ac} writing
* ifnames Invocation:: Listing the conditionals in source code
* autoconf Invocation:: How to create configuration scripts
* autoreconf Invocation:: Remaking multiple @command{configure} scripts
@end menu
-@node Writing configure.ac
+@node Writing Autoconf Input
@section Writing @file{configure.ac}
To produce a @command{configure} script for a software package, create a
@menu
* Shell Script Compiler:: Autoconf as solution of a problem
* Autoconf Language:: Programming in Autoconf
-* configure.ac Layout:: Standard organization of @file{configure.ac}
+* Autoconf Input Layout:: Standard organization of @file{configure.ac}
@end menu
@node Shell Script Compiler
# Process this file with autoconf to produce a configure script.
@end example
-@node configure.ac Layout
+@node Autoconf Input Layout
@subsection Standard @file{configure.ac} Layout
The order in which @file{configure.ac} calls the Autoconf macros is not
when used in @var{output}, or the standard input when used in the
@var{inputs}. You most probably don't need to use this in
@file{configure.ac}, but it is convenient when using the command line
-interface of @file{./config.status}, see @ref{config.status Invocation},
+interface of @file{./config.status}, see @ref{Recreating a Configuration},
for more details.
The @var{inputs} may be absolute or relative file names. In the latter
so @file{config.status} ensures that @file{config.h} is considered up to
date. @xref{Output}, for more information about @code{AC_OUTPUT}.
-@xref{config.status Invocation}, for more examples of handling
+@xref{Recreating a Configuration}, for more examples of handling
configuration-related dependencies.
@node Configuration Headers
files depend upon @command{bizarre-cc} being the C compiler. If
for some reason the user runs @command{./configure} again, or if it is
run via @samp{./config.status --recheck}, (@xref{Automatic Remaking},
-and @pxref{config.status Invocation}), then the configuration can be
+and @pxref{Recreating a Configuration}), then the configuration can be
inconsistent, composed of results depending upon two different
compilers.
@item
@var{variable} is kept during automatic reconfiguration
-(@pxref{config.status Invocation}) as if it had been passed as a command
+(@pxref{Recreating a Configuration}) as if it had been passed as a command
line argument, including when no cache is used:
@example
@c ============================================== Recreating a Configuration
-@node config.status Invocation
+@node Recreating a Configuration
@chapter Recreating a Configuration
@cindex @command{config.status}
@end example
The calling convention of @file{config.status} has changed; see
-@ref{Obsolete config.status Use}, for details.
+@ref{Obsolete Recreation}, for details.
@c =================================================== Obsolete Constructs
understanding how to move to more modern constructs.
@menu
-* Obsolete config.status Use:: Different calling convention
-* acconfig.h:: Additional entries in @file{config.h.in}
+* Obsolete Recreation:: Obsolete convention for @command{config.status}
+* acconfig Header:: Additional entries in @file{config.h.in}
* autoupdate Invocation:: Automatic update of @file{configure.ac}
* Obsolete Macros:: Backward compatibility macros
* Autoconf 1:: Tips for upgrading your files
-* Autoconf 2.13:: Some fresher tips
+* 20th-century Autoconf 2:: Some fresher tips
@end menu
-@node Obsolete config.status Use
+@node Obsolete Recreation
@section Obsolete @file{config.status} Invocation
@file{config.status} now supports arguments to specify the files to
-instantiate; see @ref{config.status Invocation}, for more details.
+instantiate; see @ref{Recreating a Configuration}, for more details.
Before, environment variables had to be used.
@defvar CONFIG_COMMANDS
@file{config.status} ignores this variable.
@end defvar
-In @ref{config.status Invocation}, using this old interface, the example
+In @ref{Recreating a Configuration}, using this old interface, the example
would be:
@example
for @code{CONFIG_COMMANDS}, etc.)
-@node acconfig.h
+@node acconfig Header
@section @file{acconfig.h}
@cindex @file{acconfig.h}
encapsulate them into macros that you can share.
-@node Autoconf 2.13
+@node 20th-century Autoconf 2
@section Upgrading From Version 2.13
@cindex Upgrading autoconf
@cindex Autoconf upgrading
@menu
* Using an Autotest Test Suite:: Autotest and the user
-* Writing testsuite.at:: Autotest macros
+* Writing Testsuites:: Autotest macros
* testsuite Invocation:: Running @command{testsuite} scripts
* Making testsuite Scripts:: Using autom4te to create @command{testsuite}
@end menu
@item tested programs
The absolute file name and answers to @option{--version} of the tested
-programs (see @ref{Writing testsuite.at}, @code{AT_TESTED}).
+programs (see @ref{Writing Testsuites}, @code{AT_TESTED}).
@item configuration log
The contents of @file{config.log}, as created by @command{configure},
@end table
-@node Writing testsuite.at
+@node Writing Testsuites
@section Writing @file{testsuite.at}
The @file{testsuite.at} is a Bourne shell script making use of special
* Bootstrapping:: Autoconf and @acronym{GNU} M4 require each other?
* Why Not Imake:: Why @acronym{GNU} uses @command{configure} instead of Imake
* Defining Directories:: Passing @code{datadir} to program
-* autom4te.cache:: What is it? Can I remove it?
+* Autom4te Cache:: What is it? Can I remove it?
* Present But Cannot Be Compiled:: Compiler and Preprocessor Disagree
@end menu
@end itemize
-@node autom4te.cache
+@node Autom4te Cache
@section What is @file{autom4te.cache}?
@display