@end table
@node Invoking autoconf, Invoking autoreconf, Invoking ifnames, Making configure Scripts
-@section Using @code{autoconf} to Create @file{configure}
+@section Using @code{autoconf} to Create @code{configure}
To create @code{configure} from @file{configure.in}, run the
@code{autoconf} program with no arguments. @code{autoconf} processes
@file{configure.in} with the @code{m4} macro processor, using the
Autoconf macros. If you give @code{autoconf} an argument, it reads that
file instead of @file{configure.in} and writes the configuration script
-to the standard output instead of to @file{configure}. If you give
+to the standard output instead of to @code{configure}. If you give
@code{autoconf} the argument @samp{-}, it reads the standard input
instead of @file{configure.in} and writes the configuration script on
the standard output.
@end table
@node Invoking autoreconf, , Invoking autoconf, Making configure Scripts
-@section Using @code{autoreconf} to Update @file{configure} Scripts
+@section Using @code{autoreconf} to Update @code{configure} Scripts
If you have a lot of Autoconf-generated @code{configure} scripts and you
get a new version of Autoconf, the @code{autoreconf} program can be
@defmac AC_CONFIG_AUX_DIR(@var{dir})
@maindex CONFIG_AUX_DIR
Use the @file{install-sh}, @file{config.sub}, @file{config.guess}, and
-Cygnus @file{configure} scripts that are in directory @var{dir}. These
+Cygnus @code{configure} scripts that are in directory @var{dir}. These
are auxiliary files used in configuration. @var{dir} can be either
absolute or relative to @file{@var{srcdir}}. The default is
@file{@var{srcdir}} or @file{@var{srcdir}/..} or
whitespace-separated list. If a given @var{dir} is not found, no error
is reported, so a @code{configure} script can configure whichever parts
of a large source tree are present. If a given @var{dir} contains
-@file{configure.in} but no @file{configure}, the Cygnus @code{configure}
+@file{configure.in} but no @code{configure}, the Cygnus @code{configure}
script found by @code{AC_CONFIG_AUXDIR} is used. The subdirectory
@code{configure} scripts are given the same command line options that
were given to this @code{configure} script, with minor changes if needed
@defmac AC_REVISION (@var{revision-info})
@maindex REVISION
-Copy revision stamp @var{revision-info} into the @file{configure}
+Copy revision stamp @var{revision-info} into the @code{configure}
script, with any dollar signs or double-quotes removed. This macro lets
-you put a revision stamp from @file{configure.in} into @file{configure}
-without RCS or CVS changing it when you check in @file{configure}. That
+you put a revision stamp from @file{configure.in} into @code{configure}
+without RCS or CVS changing it when you check in @code{configure}. That
way, you can determine easily which revision of @file{configure.in} a
-particular @file{configure} corresponds to.
+particular @code{configure} corresponds to.
It is a good idea to call this macro before @code{AC_INIT} so that the
revision number is near the top of both @file{configure.in} and
-@file{configure}. To support doing that, the @code{AC_REVISION} output
+@code{configure}. To support doing that, the @code{AC_REVISION} output
begins with @samp{#!/bin/sh}, like the normal start of a
-@file{configure} script does.
+@code{configure} script does.
For example, this line in @file{configure.in}:
@end example
@noindent
-produces this in @file{configure}:
+produces this in @code{configure}:
@example
#!/bin/sh
of a @samp{char []}. Also set output variable @code{LEX_OUTPUT_ROOT} to
the base of the file name that the lexer generates; usually
@file{lex.yy}, but sometimes something else. These results vary
-according to whether @code{lex} or @code{flex} is being used. This
-macro calls @code{AC_PROG_CPP} (or @code{AC_PROG_CXXCPP} if C++ is the
-current language, @pxref{Language Choice}) and @code{AC_PROG_LEX} if
-they haven't been called already.
+according to whether @code{lex} or @code{flex} is being used.
@end defmac
@defmac AC_PROG_AWK
If the current language is C (@pxref{Language Choice}), many of the
specific test macros use the value of @code{CPP} indirectly by calling
@code{AC_TRY_CPP}, @code{AC_CHECK_HEADER}, @code{AC_EGREP_HEADER}, or
-@code{AC_EGREP_CPP}. Those macros call this macro first if it
-hasn't been called already. It calls @code{AC_PROG_CC} if it hasn't
-been called already.
+@code{AC_EGREP_CPP}.
@end defmac
@defmac AC_PROG_CXX
If the current language is C++ (@pxref{Language Choice}), many of the
specific test macros use the value of @code{CXXCPP} indirectly by
calling @code{AC_TRY_CPP}, @code{AC_CHECK_HEADER},
-@code{AC_EGREP_HEADER}, or @code{AC_EGREP_CPP}. Those macros call
-this macro first if it hasn't been called already. This macro calls
-@code{AC_PROG_CXX} if it hasn't been called already.
+@code{AC_EGREP_HEADER}, or @code{AC_EGREP_CPP}.
@end defmac
@defmac AC_PROG_GCC_TRADITIONAL
@samp{-traditional}. That usually happens when the fixed header files
have not been installed on an old system. Since recent versions of the
GNU C compiler fix the header files automatically when installed, this
-is becoming a less prevalent problem. This macro calls
-@code{AC_PROG_CC} and @code{AC_PROG_CPP} if they haven't been called
-already.
+is becoming a less prevalent problem.
@end defmac
@defmac AC_PROG_INSTALL
@cvindex CLOSEDIR_VOID
If the @code{closedir} function does not return a meaningful value,
define @code{CLOSEDIR_VOID}. Otherwise, callers ought to check its
-return value for an error indicator. This macro calls
-@code{AC_HEADER_DIRENT} if it has not been called yet already
-(@pxref{Particular Headers}).
+return value for an error indicator.
@end defmac
@defmac AC_FUNC_GETLOADAVG
in system C libraries may be hand optimized) is to, taking @code{memchr}
for example, put it in @file{memchr.c} and use
@samp{AC_REPLACE_FUNCS(memchr)}.
-
-This macro calls @code{AC_PROG_CPP} or @code{AC_PROG_CXXCPP} (depending
-on which language is current, @pxref{Language Choice}), if it hasn't
-been called already.
@end defmac
@defmac AC_MEMORY_H
@cvindex HAVE_TZNAME
Figure out how to get the current timezone. If @code{struct tm} has a
@code{tm_zone} member, define @code{HAVE_TM_ZONE}. Otherwise, if the
-external array @code{tzname} is found, define @code{HAVE_TZNAME}. This
-macro calls @code{AC_STRUCT_TM} if it hasn't been called already.
+external array @code{tzname} is found, define @code{HAVE_TZNAME}.
@end defmac
@node Typedefs, Compiler Characteristics, Structures, Existing Tests
@cvindex inline
If the C compiler is a version of GCC that supports the keyword
@code{__inline} but not @code{inline} (such as some NeXT versions),
-define @code{inline} to be @code{__inline}. This macro calls
-@code{AC_PROG_CC} if it hasn't been called already.
+define @code{inline} to be @code{__inline}.
@end defmac
@defmac AC_C_CHAR_UNSIGNED
Also check for special libraries that some systems need in order to
compile X programs. Add any that the system needs to output
-variable @code{X_EXTRA_LIBS}. This macro calls @code{AC_PATH_X} and
-@code{AC_ISC_POSIX} (@pxref{UNIX Variants}) if they have not already
-been called. Because of the macro dependencies, if you call this macro,
-you should let it call @code{AC_PATH_X} rather than doing that yourself.
+variable @code{X_EXTRA_LIBS}.
@end defmac
@defmac AC_SYS_LONG_FILE_NAMES
@end defmac
@defmac AC_DYNIX_SEQ
-@maindex OS_DYNIX_SEQ
+@maindex DYNIX_SEQ
If on Dynix/PTX (Sequent UNIX), add @samp{-lseq} to output
variable @code{LIBS}. This macro is obsolete; instead, use
@code{AC_FUNC_GETMNTENT}.
@ovindex LIBS
If on Xenix, add @samp{-lx} to output variable @code{LIBS}. Also, if
@file{dirent.h} is being used, add @samp{-ldir} to @code{LIBS}. This
-macro calls @code{AC_DIR_HEADER} if it hasn't been called already. It
-is obsolete; use @code{AC_HEADER_DIRENT} instead.
+macro is obsolete; use @code{AC_HEADER_DIRENT} instead.
@end defmac
@node Writing Tests, Results, Existing Tests, Top
@node Examining Declarations, Examining Libraries, , Writing Tests
@section Examining Declarations
-Here is how to check whether particular header files exist. You can
-check for one at a time, or more than one if you need several header
-files to all exist for some purpose.
+The macro @code{AC_TRY_CPP} is used to check whether particular header
+files exist. You can check for one at a time, or more than one if you
+need several header files to all exist for some purpose.
@defmac AC_TRY_CPP (@var{includes}, @var{action-if-true} @r{[}, @var{action-if-false}@r{]})
@maindex TRY_CPP
while processing it, run shell commands @var{action-if-true}. Otherwise
run shell commands @var{action-if-false}.
-This macro calls @code{AC_PROG_CPP} or @code{AC_PROG_CXXCPP} (depending
-on which language is current, @pxref{Language Choice}), if it hasn't
-been called already. It uses @code{CPPFLAGS}, but not @code{CFLAGS},
-because @samp{-g}, @samp{-O}, etc. are not valid options to many C
+This macro uses @code{CPPFLAGS}, but not @code{CFLAGS}, because
+@samp{-g}, @samp{-O}, etc. are not valid options to many C
preprocessors.
@end defmac
@var{header-file} matches the @code{egrep} regular expression
@var{pattern}, execute shell commands @var{action-if-found}, otherwise
execute @var{action-if-not-found}.
-
-This macro calls @code{AC_PROG_CPP} or @code{AC_PROG_CXXCPP} (depending
-on which language is current, @pxref{Language Choice}), if it hasn't
-been called already.
-@var{action-if-not-found}.
@end defmac
To check for C preprocessor symbols, either defined by header files or
@node Examining Libraries, Run Time, Examining Declarations, Writing Tests
@section Examining Libraries
-To find out whether a library function or global variable is available,
-Autoconf tries to compile and link a small program that uses it. This
-is unlike Larry Wall's Metaconfig, which uses @code{nm} or @code{ar} on
-the C library to try to figure out which functions are available.
-Trying to link with the function is usually a more reliable approach
-because it avoids dealing with the variations in the options and output
-formats of @code{nm} and @code{ar} and in the location of the standard
-libraries. It also allows configuring for cross-compilation or checking
-a function's runtime behavior if needed. On the other hand, it can be
-slower than scanning the libraries once.
+To check for a library, a function, or a global variable, Autoconf
+@code{configure} scripts try to compile and link a small program that
+uses it. This is unlike Larry Wall's Metaconfig, which uses @code{nm}
+or @code{ar} on the C library to try to figure out which functions are
+available. Trying to link with the function is usually a more reliable
+approach because it avoids dealing with the variations in the options
+and output formats of @code{nm} and @code{ar} and in the location of the
+standard libraries. It also allows configuring for cross-compilation or
+checking a function's runtime behavior if needed. On the other hand, it
+can be slower than scanning the libraries once.
A few systems have linkers that do not return a failure exit status when
there are unresolved functions in the link. This bug makes the
The below macro is used to compile test programs to test for functions
and global variables. It is also used to check for libraries, by adding
-the library being checked for to @samp{$LIBS} temporarily and trying to
+the library being checked for to @code{LIBS} temporarily and trying to
link a small program. And it is used to check matters of C syntax, such
as whether a particular keyword is recognized---a test program using a
keyword does not compile on systems that don't support it.
Autoconf provides the @code{AC_BEFORE} macro to warn users when macros
with this kind of dependency appear out of order in a
@file{configure.in} file. The warning occurs when creating
-@file{configure} from @file{configure.in}, not when running
-@file{configure}.
+@code{configure} from @file{configure.in}, not when running
+@code{configure}.
For example, @code{AC_PROG_CPP} checks whether the C compiler
can run the C preprocessor when given the @samp{-E} option. It should
therefore be called after any macros that change which C compiler is
@evindex CONFIG_STATUS
The file name to use for the shell script that records the
configuration. The default is @file{./config.status}. This variable is
-useful when one package uses parts of another and the @file{configure}
+useful when one package uses parts of another and the @code{configure}
scripts shouldn't be merged because they are maintained separately.
@end defvar
just means that you need to distribute @file{configure.in}, and
@file{acsite.m4}, @file{aclocal.m4}, @file{acconfig.h}, and
@file{@var{config}.h.top} and @file{@var{config}.h.bot} if you use them,
-along with @file{configure}.
+along with @code{configure}.
Programs that use Autoconf scripts to configure themselves do not
automatically come under the GPL. Distributing an Autoconf
@xref{Caching Values}.
@node Invoking autoupdate, Changed Results, Changed Macros, Upgrading
-@section Using @code{autoupdate} to Modernize @file{configure}
+@section Using @code{autoupdate} to Modernize @code{configure}
The @code{autoupdate} program updates a @file{configure.in} file that
calls Autoconf macros by their old names to use the current macro names.
saying that the @code{configure} scripts were great, and asking if I had
a tool for generating them that I could send him. No, I thought, but
I should! So I started to work out how to generate them. And the
-journey from the slavery of hand-written @file{configure} scripts to the
+journey from the slavery of hand-written @code{configure} scripts to the
abundance and ease of Autoconf began.
Cygnus @code{configure}, which was being developed at around that time,
@end table
@node Invoking autoconf, Invoking autoreconf, Invoking ifnames, Making configure Scripts
-@section Using @code{autoconf} to Create @file{configure}
+@section Using @code{autoconf} to Create @code{configure}
To create @code{configure} from @file{configure.in}, run the
@code{autoconf} program with no arguments. @code{autoconf} processes
@file{configure.in} with the @code{m4} macro processor, using the
Autoconf macros. If you give @code{autoconf} an argument, it reads that
file instead of @file{configure.in} and writes the configuration script
-to the standard output instead of to @file{configure}. If you give
+to the standard output instead of to @code{configure}. If you give
@code{autoconf} the argument @samp{-}, it reads the standard input
instead of @file{configure.in} and writes the configuration script on
the standard output.
@end table
@node Invoking autoreconf, , Invoking autoconf, Making configure Scripts
-@section Using @code{autoreconf} to Update @file{configure} Scripts
+@section Using @code{autoreconf} to Update @code{configure} Scripts
If you have a lot of Autoconf-generated @code{configure} scripts and you
get a new version of Autoconf, the @code{autoreconf} program can be
@defmac AC_CONFIG_AUX_DIR(@var{dir})
@maindex CONFIG_AUX_DIR
Use the @file{install-sh}, @file{config.sub}, @file{config.guess}, and
-Cygnus @file{configure} scripts that are in directory @var{dir}. These
+Cygnus @code{configure} scripts that are in directory @var{dir}. These
are auxiliary files used in configuration. @var{dir} can be either
absolute or relative to @file{@var{srcdir}}. The default is
@file{@var{srcdir}} or @file{@var{srcdir}/..} or
whitespace-separated list. If a given @var{dir} is not found, no error
is reported, so a @code{configure} script can configure whichever parts
of a large source tree are present. If a given @var{dir} contains
-@file{configure.in} but no @file{configure}, the Cygnus @code{configure}
+@file{configure.in} but no @code{configure}, the Cygnus @code{configure}
script found by @code{AC_CONFIG_AUXDIR} is used. The subdirectory
@code{configure} scripts are given the same command line options that
were given to this @code{configure} script, with minor changes if needed
@defmac AC_REVISION (@var{revision-info})
@maindex REVISION
-Copy revision stamp @var{revision-info} into the @file{configure}
+Copy revision stamp @var{revision-info} into the @code{configure}
script, with any dollar signs or double-quotes removed. This macro lets
-you put a revision stamp from @file{configure.in} into @file{configure}
-without RCS or CVS changing it when you check in @file{configure}. That
+you put a revision stamp from @file{configure.in} into @code{configure}
+without RCS or CVS changing it when you check in @code{configure}. That
way, you can determine easily which revision of @file{configure.in} a
-particular @file{configure} corresponds to.
+particular @code{configure} corresponds to.
It is a good idea to call this macro before @code{AC_INIT} so that the
revision number is near the top of both @file{configure.in} and
-@file{configure}. To support doing that, the @code{AC_REVISION} output
+@code{configure}. To support doing that, the @code{AC_REVISION} output
begins with @samp{#!/bin/sh}, like the normal start of a
-@file{configure} script does.
+@code{configure} script does.
For example, this line in @file{configure.in}:
@end example
@noindent
-produces this in @file{configure}:
+produces this in @code{configure}:
@example
#!/bin/sh
of a @samp{char []}. Also set output variable @code{LEX_OUTPUT_ROOT} to
the base of the file name that the lexer generates; usually
@file{lex.yy}, but sometimes something else. These results vary
-according to whether @code{lex} or @code{flex} is being used. This
-macro calls @code{AC_PROG_CPP} (or @code{AC_PROG_CXXCPP} if C++ is the
-current language, @pxref{Language Choice}) and @code{AC_PROG_LEX} if
-they haven't been called already.
+according to whether @code{lex} or @code{flex} is being used.
@end defmac
@defmac AC_PROG_AWK
If the current language is C (@pxref{Language Choice}), many of the
specific test macros use the value of @code{CPP} indirectly by calling
@code{AC_TRY_CPP}, @code{AC_CHECK_HEADER}, @code{AC_EGREP_HEADER}, or
-@code{AC_EGREP_CPP}. Those macros call this macro first if it
-hasn't been called already. It calls @code{AC_PROG_CC} if it hasn't
-been called already.
+@code{AC_EGREP_CPP}.
@end defmac
@defmac AC_PROG_CXX
If the current language is C++ (@pxref{Language Choice}), many of the
specific test macros use the value of @code{CXXCPP} indirectly by
calling @code{AC_TRY_CPP}, @code{AC_CHECK_HEADER},
-@code{AC_EGREP_HEADER}, or @code{AC_EGREP_CPP}. Those macros call
-this macro first if it hasn't been called already. This macro calls
-@code{AC_PROG_CXX} if it hasn't been called already.
+@code{AC_EGREP_HEADER}, or @code{AC_EGREP_CPP}.
@end defmac
@defmac AC_PROG_GCC_TRADITIONAL
@samp{-traditional}. That usually happens when the fixed header files
have not been installed on an old system. Since recent versions of the
GNU C compiler fix the header files automatically when installed, this
-is becoming a less prevalent problem. This macro calls
-@code{AC_PROG_CC} and @code{AC_PROG_CPP} if they haven't been called
-already.
+is becoming a less prevalent problem.
@end defmac
@defmac AC_PROG_INSTALL
@cvindex CLOSEDIR_VOID
If the @code{closedir} function does not return a meaningful value,
define @code{CLOSEDIR_VOID}. Otherwise, callers ought to check its
-return value for an error indicator. This macro calls
-@code{AC_HEADER_DIRENT} if it has not been called yet already
-(@pxref{Particular Headers}).
+return value for an error indicator.
@end defmac
@defmac AC_FUNC_GETLOADAVG
in system C libraries may be hand optimized) is to, taking @code{memchr}
for example, put it in @file{memchr.c} and use
@samp{AC_REPLACE_FUNCS(memchr)}.
-
-This macro calls @code{AC_PROG_CPP} or @code{AC_PROG_CXXCPP} (depending
-on which language is current, @pxref{Language Choice}), if it hasn't
-been called already.
@end defmac
@defmac AC_MEMORY_H
@cvindex HAVE_TZNAME
Figure out how to get the current timezone. If @code{struct tm} has a
@code{tm_zone} member, define @code{HAVE_TM_ZONE}. Otherwise, if the
-external array @code{tzname} is found, define @code{HAVE_TZNAME}. This
-macro calls @code{AC_STRUCT_TM} if it hasn't been called already.
+external array @code{tzname} is found, define @code{HAVE_TZNAME}.
@end defmac
@node Typedefs, Compiler Characteristics, Structures, Existing Tests
@cvindex inline
If the C compiler is a version of GCC that supports the keyword
@code{__inline} but not @code{inline} (such as some NeXT versions),
-define @code{inline} to be @code{__inline}. This macro calls
-@code{AC_PROG_CC} if it hasn't been called already.
+define @code{inline} to be @code{__inline}.
@end defmac
@defmac AC_C_CHAR_UNSIGNED
Also check for special libraries that some systems need in order to
compile X programs. Add any that the system needs to output
-variable @code{X_EXTRA_LIBS}. This macro calls @code{AC_PATH_X} and
-@code{AC_ISC_POSIX} (@pxref{UNIX Variants}) if they have not already
-been called. Because of the macro dependencies, if you call this macro,
-you should let it call @code{AC_PATH_X} rather than doing that yourself.
+variable @code{X_EXTRA_LIBS}.
@end defmac
@defmac AC_SYS_LONG_FILE_NAMES
@end defmac
@defmac AC_DYNIX_SEQ
-@maindex OS_DYNIX_SEQ
+@maindex DYNIX_SEQ
If on Dynix/PTX (Sequent UNIX), add @samp{-lseq} to output
variable @code{LIBS}. This macro is obsolete; instead, use
@code{AC_FUNC_GETMNTENT}.
@ovindex LIBS
If on Xenix, add @samp{-lx} to output variable @code{LIBS}. Also, if
@file{dirent.h} is being used, add @samp{-ldir} to @code{LIBS}. This
-macro calls @code{AC_DIR_HEADER} if it hasn't been called already. It
-is obsolete; use @code{AC_HEADER_DIRENT} instead.
+macro is obsolete; use @code{AC_HEADER_DIRENT} instead.
@end defmac
@node Writing Tests, Results, Existing Tests, Top
@node Examining Declarations, Examining Libraries, , Writing Tests
@section Examining Declarations
-Here is how to check whether particular header files exist. You can
-check for one at a time, or more than one if you need several header
-files to all exist for some purpose.
+The macro @code{AC_TRY_CPP} is used to check whether particular header
+files exist. You can check for one at a time, or more than one if you
+need several header files to all exist for some purpose.
@defmac AC_TRY_CPP (@var{includes}, @var{action-if-true} @r{[}, @var{action-if-false}@r{]})
@maindex TRY_CPP
while processing it, run shell commands @var{action-if-true}. Otherwise
run shell commands @var{action-if-false}.
-This macro calls @code{AC_PROG_CPP} or @code{AC_PROG_CXXCPP} (depending
-on which language is current, @pxref{Language Choice}), if it hasn't
-been called already. It uses @code{CPPFLAGS}, but not @code{CFLAGS},
-because @samp{-g}, @samp{-O}, etc. are not valid options to many C
+This macro uses @code{CPPFLAGS}, but not @code{CFLAGS}, because
+@samp{-g}, @samp{-O}, etc. are not valid options to many C
preprocessors.
@end defmac
@var{header-file} matches the @code{egrep} regular expression
@var{pattern}, execute shell commands @var{action-if-found}, otherwise
execute @var{action-if-not-found}.
-
-This macro calls @code{AC_PROG_CPP} or @code{AC_PROG_CXXCPP} (depending
-on which language is current, @pxref{Language Choice}), if it hasn't
-been called already.
-@var{action-if-not-found}.
@end defmac
To check for C preprocessor symbols, either defined by header files or
@node Examining Libraries, Run Time, Examining Declarations, Writing Tests
@section Examining Libraries
-To find out whether a library function or global variable is available,
-Autoconf tries to compile and link a small program that uses it. This
-is unlike Larry Wall's Metaconfig, which uses @code{nm} or @code{ar} on
-the C library to try to figure out which functions are available.
-Trying to link with the function is usually a more reliable approach
-because it avoids dealing with the variations in the options and output
-formats of @code{nm} and @code{ar} and in the location of the standard
-libraries. It also allows configuring for cross-compilation or checking
-a function's runtime behavior if needed. On the other hand, it can be
-slower than scanning the libraries once.
+To check for a library, a function, or a global variable, Autoconf
+@code{configure} scripts try to compile and link a small program that
+uses it. This is unlike Larry Wall's Metaconfig, which uses @code{nm}
+or @code{ar} on the C library to try to figure out which functions are
+available. Trying to link with the function is usually a more reliable
+approach because it avoids dealing with the variations in the options
+and output formats of @code{nm} and @code{ar} and in the location of the
+standard libraries. It also allows configuring for cross-compilation or
+checking a function's runtime behavior if needed. On the other hand, it
+can be slower than scanning the libraries once.
A few systems have linkers that do not return a failure exit status when
there are unresolved functions in the link. This bug makes the
The below macro is used to compile test programs to test for functions
and global variables. It is also used to check for libraries, by adding
-the library being checked for to @samp{$LIBS} temporarily and trying to
+the library being checked for to @code{LIBS} temporarily and trying to
link a small program. And it is used to check matters of C syntax, such
as whether a particular keyword is recognized---a test program using a
keyword does not compile on systems that don't support it.
Autoconf provides the @code{AC_BEFORE} macro to warn users when macros
with this kind of dependency appear out of order in a
@file{configure.in} file. The warning occurs when creating
-@file{configure} from @file{configure.in}, not when running
-@file{configure}.
+@code{configure} from @file{configure.in}, not when running
+@code{configure}.
For example, @code{AC_PROG_CPP} checks whether the C compiler
can run the C preprocessor when given the @samp{-E} option. It should
therefore be called after any macros that change which C compiler is
@evindex CONFIG_STATUS
The file name to use for the shell script that records the
configuration. The default is @file{./config.status}. This variable is
-useful when one package uses parts of another and the @file{configure}
+useful when one package uses parts of another and the @code{configure}
scripts shouldn't be merged because they are maintained separately.
@end defvar
just means that you need to distribute @file{configure.in}, and
@file{acsite.m4}, @file{aclocal.m4}, @file{acconfig.h}, and
@file{@var{config}.h.top} and @file{@var{config}.h.bot} if you use them,
-along with @file{configure}.
+along with @code{configure}.
Programs that use Autoconf scripts to configure themselves do not
automatically come under the GPL. Distributing an Autoconf
@xref{Caching Values}.
@node Invoking autoupdate, Changed Results, Changed Macros, Upgrading
-@section Using @code{autoupdate} to Modernize @file{configure}
+@section Using @code{autoupdate} to Modernize @code{configure}
The @code{autoupdate} program updates a @file{configure.in} file that
calls Autoconf macros by their old names to use the current macro names.
saying that the @code{configure} scripts were great, and asking if I had
a tool for generating them that I could send him. No, I thought, but
I should! So I started to work out how to generate them. And the
-journey from the slavery of hand-written @file{configure} scripts to the
+journey from the slavery of hand-written @code{configure} scripts to the
abundance and ease of Autoconf began.
Cygnus @code{configure}, which was being developed at around that time,