---- autoconf-2.62/doc/autoconf.texi.orig 2008-04-16 20:34:45.377155963 +0200
-+++ autoconf-2.62/doc/autoconf.texi 2008-04-16 20:39:04.079896078 +0200
-@@ -203,29 +203,19 @@
+--- autoconf-2.69/doc/autoconf.texi.orig 2013-10-15 07:44:41.594844773 +0200
++++ autoconf-2.69/doc/autoconf.texi 2013-10-15 07:45:45.782179984 +0200
+@@ -217,29 +217,19 @@
@end direntry
@titlepage
-@@ -267,7 +257,7 @@
+@@ -282,7 +272,7 @@
* 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
* Obsolete Constructs:: Kept for backward compatibility
* Using Autotest:: Creating portable test suites
* FAQ:: Frequent Autoconf Questions, with answers
-@@ -288,10 +278,10 @@
+@@ -303,10 +293,10 @@
Making @command{configure} Scripts
* Writing Autoconf Input:: What to put in an Autoconf input file
Writing @file{configure.ac}
-@@ -326,7 +316,7 @@
+@@ -341,7 +331,7 @@
Configuration Header Files
* Header Templates:: Input for the configuration headers
* Autoheader Macros:: How to specify CPP templates
Existing Tests
-@@ -443,7 +433,7 @@
+@@ -460,7 +450,7 @@
Using @command{autom4te}
--* autom4te Invocation:: A @acronym{GNU} M4 wrapper
-+* autom4te:: A @acronym{GNU} M4 wrapper
+-* autom4te Invocation:: A GNU M4 wrapper
++* autom4te:: A GNU M4 wrapper
* Customizing autom4te:: Customizing the Autoconf package
Programming in M4sugar
-@@ -559,13 +549,13 @@
+@@ -601,13 +591,13 @@
* System Type:: Specifying the system type
* Sharing Defaults:: Setting site-wide defaults for @command{configure}
* Defining Variables:: Specifying the compiler etc.
* Obsolete Macros:: Backward compatibility macros
* Autoconf 1:: Tips for upgrading your files
* Autoconf 2.13:: Some fresher tips
-@@ -590,7 +580,7 @@
+@@ -632,7 +622,7 @@
* Using an Autotest Test Suite:: Autotest and the user
* Writing Testsuites:: Autotest macros
* Making testsuite Scripts:: Using autom4te to create @command{testsuite}
Using an Autotest Test Suite
-@@ -946,7 +936,7 @@
+@@ -992,7 +982,7 @@
@item
a shell script called @file{config.status} that, when run, recreates
@item
an optional shell script normally called @file{config.cache}
-@@ -1006,10 +996,10 @@
+@@ -1073,10 +1063,10 @@
@menu
* Writing Autoconf Input:: What to put in an Autoconf input file
@end menu
@node Writing Autoconf Input
-@@ -1025,7 +1015,7 @@
+@@ -1092,7 +1082,7 @@
or specialized features, @file{configure.ac} might need to contain some
- hand-crafted shell commands; see @ref{Portable Shell}. The
- @command{autoscan} program can give you a good start in writing
--@file{configure.ac} (@pxref{autoscan Invocation}, for more information).
-+@file{configure.ac} (@pxref{autoscan}, for more information).
+ hand-crafted shell commands; see @ref{Portable Shell, , Portable Shell
+ Programming}. The @command{autoscan} program can give you a good start
+-in writing @file{configure.ac} (@pxref{autoscan Invocation}, for more
++in writing @file{configure.ac} (@pxref{autoscan} Invocation, for more
+ information).
Previous versions of Autoconf promoted the name @file{configure.in},
- which is somewhat ambiguous (the tool needed to process this file is not
-@@ -1281,7 +1271,7 @@
+@@ -1380,7 +1370,7 @@
@end display
@section Using @command{autoscan} to Create @file{configure.ac}
@cindex @command{autoscan}
-@@ -1303,7 +1293,7 @@
+@@ -1402,7 +1392,7 @@
use a configuration header file, you must add a call to
@code{AC_CONFIG_HEADERS} (@pxref{Configuration Headers}). You might
also have to change or add some @code{#if} directives to your program in
information about a program that can help with that job).
When using @command{autoscan} to maintain a @file{configure.ac}, simply
-@@ -1342,7 +1332,7 @@
+@@ -1445,7 +1435,7 @@
Prepend @var{dir} to the include path. Multiple invocations accumulate.
@end table
@section Using @command{ifnames} to List Conditionals
@cindex @command{ifnames}
-@@ -1351,8 +1341,7 @@
+@@ -1454,8 +1444,7 @@
preprocessor conditionals. If a package has already been set up to have
some portability, @command{ifnames} can thus help you figure out what its
@command{configure} needs to check for. It may help fill in some gaps in a
@command{ifnames} scans all of the C source files named on the command line
(or the standard input, if none are given) and writes to the standard
-@@ -1374,7 +1363,7 @@
+@@ -1477,7 +1466,7 @@
Print the version number of Autoconf and exit.
@end table
@section Using @command{autoconf} to Create @command{configure}
@cindex @command{autoconf}
-@@ -1468,8 +1457,7 @@
+@@ -1571,8 +1560,7 @@
@cindex Macro invocation stack
Because @command{autoconf} uses @command{autom4te} behind the scenes, it
displays a back trace for errors, but not for warnings; if you want
@item --trace=@var{macro}[:@var{format}]
@itemx -t @var{macro}[:@var{format}]
-@@ -1481,7 +1469,7 @@
+@@ -1584,7 +1572,7 @@
The @var{format} is a regular string, with newlines if desired, and
several special escape codes. It defaults to @samp{$f:$l:$n:$%}; see
@item --initialization
@itemx -i
-@@ -1555,7 +1543,7 @@
+@@ -1658,7 +1646,7 @@
@end group
@end example
@section Using @command{autoreconf} to Update @command{configure} Scripts
@cindex @command{autoreconf}
-@@ -1592,8 +1580,8 @@
+@@ -1695,8 +1683,8 @@
Gettext supplies the @command{autopoint} command to add translation
infrastructure to a source package. If you use @command{autopoint},
your @file{configure.ac} should invoke both @code{AM_GNU_GETTEXT} and
-Invocation, , Invoking the @code{autopoint} Program, gettext,
+@code{AM_GNU_GETTEXT_VERSION(@var{gettext-version})}.
+@xref{autopoint, , Invoking the @code{autopoint} Program, gettext,
- @acronym{GNU} @code{gettext} utilities}, for further details.
+ GNU @code{gettext} utilities}, for further details.
@noindent
-@@ -1897,8 +1885,8 @@
+@@ -2032,8 +2020,8 @@
source directory; @command{configure} checks for this file's existence to
make sure that the directory that it is told contains the source code in
fact does. Occasionally people accidentally specify the wrong directory
@end defmac
-@@ -2111,7 +2099,7 @@
+@@ -2247,7 +2235,7 @@
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
for more details.
The @var{inputs} may be absolute or relative file names. In the latter
-@@ -2971,7 +2959,7 @@
+@@ -3182,7 +3170,7 @@
so @file{config.status} ensures that @file{config.h} is considered up to
date. @xref{Output}, for more information about @code{AC_OUTPUT}.
configuration-related dependencies.
@node Configuration Headers
-@@ -3051,7 +3039,7 @@
+@@ -3262,7 +3250,7 @@
@menu
* Header Templates:: Input for the configuration headers
* Autoheader Macros:: How to specify CPP templates
@end menu
-@@ -3106,10 +3094,10 @@
- comments in preprocessor macros has never been a good idea.
+@@ -3304,7 +3292,7 @@
+ generated header.
Since it is a tedious task to keep a template header up to date, you may
-use @command{autoheader} to generate it, see @ref{autoheader Invocation}.
+use @command{autoheader} to generate it, see @ref{autoheader}.
+ During the instantiation of the header, each @samp{#undef} line in the
+ template file for each symbol defined by @samp{AC_DEFINE} is changed to an
+@@ -3342,7 +3330,7 @@
+ probably use @samp{AH_BOTTOM} to append the @samp{#include} directive.
+
-@node autoheader Invocation
+@node autoheader
@subsection Using @command{autoheader} to Create @file{config.h.in}
@cindex @command{autoheader}
-@@ -8749,7 +8737,7 @@
+@@ -7424,7 +7412,7 @@
+ And finally, the default for @var{action-if-universal} is to ensure that
+ @samp{WORDS_BIGENDIAN} is defined if and only if a universal build is
+ detected and the current code is big-endian; this default works only if
+-@command{autoheader} is used (@pxref{autoheader Invocation}).
++@command{autoheader} is used (@pxref{autoheader}).
+
+ If you use this macro without specifying @var{action-if-universal}, you
+ should also use @code{AC_CONFIG_HEADERS}; otherwise
+@@ -8013,10 +8001,8 @@
+ @code{ac_cv_f77_libs} or @code{ac_cv_fc_libs}, respectively.
+ @end defmac
+
+-@defmac AC_F77_DUMMY_MAIN (@ovar{action-if-found}, @dvar{action-if-not-found, @
+- AC_MSG_FAILURE})
+-@defmacx AC_FC_DUMMY_MAIN (@ovar{action-if-found}, @dvar{action-if-not-found, @
+- AC_MSG_FAILURE})
++@defmac AC_F77_DUMMY_MAIN (@ovar{action-if-found}, @dvar{action-if-not-found, @AC_MSG_FAILURE})
++@defmacx AC_FC_DUMMY_MAIN (@ovar{action-if-found}, @dvar{action-if-not-found, @AC_MSG_FAILURE})
+ @acindex{F77_DUMMY_MAIN}
+ @cvindex F77_DUMMY_MAIN
+ @acindex{FC_DUMMY_MAIN}
+@@ -8201,10 +8187,8 @@
+ to call Fortran routines from some language other than C/C++.
+ @end defmac
+
+-@defmac AC_FC_SRCEXT (@var{ext}, @ovar{action-if-success}, @
+- @dvar{action-if-failure, AC_MSG_FAILURE})
+-@defmacx AC_FC_PP_SRCEXT (@var{ext}, @ovar{action-if-success}, @
+- @dvar{action-if-failure, AC_MSG_FAILURE})
++@defmac AC_FC_SRCEXT (@var{ext}, @ovar{action-if-success}, @@dvar{action-if-failure, AC_MSG_FAILURE})
++@defmacx AC_FC_PP_SRCEXT (@var{ext}, @ovar{action-if-success}, @@dvar{action-if-failure, AC_MSG_FAILURE})
+ @acindex{FC_SRCEXT}
+ @acindex{FC_PP_SRCEXT}
+ @caindex fc_srcext_@var{ext}
+@@ -8267,8 +8251,7 @@
+ @code{ac_cv_fc_pp_srcext_@var{ext}} variables, respectively.
+ @end defmac
+
+-@defmac AC_FC_PP_DEFINE (@ovar{action-if-success}, @dvar{action-if-failure, @
+- AC_MSG_FAILURE})
++@defmac AC_FC_PP_DEFINE (@ovar{action-if-success}, @dvar{action-if-failure, @AC_MSG_FAILURE})
+ @acindex{FC_PP_DEFINE}
+ @caindex fc_pp_define
+
+@@ -8286,8 +8269,7 @@
+ variable.
+ @end defmac
+
+-@defmac AC_FC_FREEFORM (@ovar{action-if-success}, @dvar{action-if-failure, @
+- AC_MSG_FAILURE})
++@defmac AC_FC_FREEFORM (@ovar{action-if-success}, @dvar{action-if-failure, @AC_MSG_FAILURE})
+ @acindex{FC_FREEFORM}
+ @caindex fc_freeform
+
+@@ -8313,8 +8295,7 @@
+ the @code{ac_cv_fc_freeform} variable.
+ @end defmac
+
+-@defmac AC_FC_FIXEDFORM (@ovar{action-if-success}, @dvar{action-if-failure, @
+- AC_MSG_FAILURE})
++@defmac AC_FC_FIXEDFORM (@ovar{action-if-success}, @dvar{action-if-failure, @AC_MSG_FAILURE})
+ @acindex{FC_FIXEDFORM}
+ @caindex fc_fixedform
+
+@@ -8375,10 +8356,8 @@
+ variable.
+ @end defmac
+
+-@defmac AC_F77_IMPLICIT_NONE (@ovar{action-if-success}, @
+- @dvar{action-if-failure, AC_MSG_FAILURE})
+-@defmacx AC_FC_IMPLICIT_NONE (@ovar{action-if-success}, @
+- @dvar{action-if-failure, AC_MSG_FAILURE})
++@defmac AC_F77_IMPLICIT_NONE (@ovar{action-if-success}, @@dvar{action-if-failure, AC_MSG_FAILURE})
++@defmacx AC_FC_IMPLICIT_NONE (@ovar{action-if-success}, @@dvar{action-if-failure, AC_MSG_FAILURE})
+ @acindex{F77_IMPLICIT_NONE}
+ @acindex{FC_IMPLICIT_NONE}
+ @caindex f77_implicit_none
+@@ -9914,7 +9893,7 @@
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},
inconsistent, composed of results depending upon two different
compilers.
-@@ -8802,7 +8790,7 @@
+@@ -9967,7 +9946,7 @@
@item
@var{variable} is kept during automatic reconfiguration
line argument, including when no cache is used:
@example
-@@ -9790,11 +9778,11 @@
+@@ -11113,11 +11092,11 @@
It supports M4 extensions designed for use in tools like Autoconf.
@menu
--* autom4te Invocation:: A @acronym{GNU} M4 wrapper
-+* autom4te:: A @acronym{GNU} M4 wrapper
+-* autom4te Invocation:: A GNU M4 wrapper
++* autom4te:: A GNU M4 wrapper
* Customizing autom4te:: Customizing the Autoconf package
@end menu
@subsection Invoking @command{autom4te}
The command line arguments are modeled after M4's:
-@@ -10052,7 +10040,7 @@
+@@ -11376,7 +11355,7 @@
not.
@end table
@item --preselect=@var{macro}
@itemx -p @var{macro}
-@@ -10140,8 +10128,8 @@
+@@ -11464,8 +11443,8 @@
wrapped in between a @samp{begin-language: "@var{language}"},
@samp{end-language: "@var{language}"} pair.
more generally arguments, are introduced by @samp{args:
@var{arguments}}. You may use the traditional shell syntax to quote the
@var{arguments}.
-@@ -11785,7 +11773,7 @@
+@@ -13793,8 +13772,7 @@
+ undefined if expansion of an indirect variable does not result in a
+ literal variable name.
+
+-@defmac AS_LITERAL_IF (@var{expression}, @ovar{if-literal}, @ovar{if-not}, @
+- @dvar{if-simple-ref, @var{if-not}})
++@defmac AS_LITERAL_IF (@var{expression}, @ovar{if-literal}, @ovar{if-not}, @@dvar{if-simple-ref, @var{if-not}})
+ @defmacx AS_LITERAL_WORD_IF (@var{expression}, @ovar{if-literal}, @
+ @ovar{if-not}, @dvar{if-simple-ref, @var{if-not}})
+ @asindex{LITERAL_IF}
+@@ -14446,7 +14424,7 @@
When the user runs @samp{autoconf -W error}, warnings from
@code{m4_warn} (including those issued through @code{AC_DIAGNOSE} and
@node Dependencies Between Macros
@section Dependencies Between Macros
-@@ -17974,16 +17962,16 @@
+@@ -22640,16 +22618,16 @@
* System Type:: Specifying the system type
* Sharing Defaults:: Setting site-wide defaults for @command{configure}
* Defining Variables:: Specifying the compiler etc.
@chapter config.status Invocation
@cindex @command{config.status}
-@@ -18129,7 +18117,7 @@
+@@ -22818,7 +22796,7 @@
@menu
* Obsolete config.status Use:: Obsolete convention for @command{config.status}
* acconfig Header:: Additional entries in @file{config.h.in}
* Obsolete Macros:: Backward compatibility macros
* Autoconf 1:: Tips for upgrading your files
* Autoconf 2.13:: Some fresher tips
-@@ -18139,7 +18127,7 @@
+@@ -22828,7 +22806,7 @@
@section Obsolete @file{config.status} Invocation
@file{config.status} now supports arguments to specify the files to
Before, environment variables had to be used.
@defvar CONFIG_COMMANDS
-@@ -18170,7 +18158,7 @@
+@@ -22859,7 +22837,7 @@
@file{config.status} ignores this variable.
@end defvar
would be:
@example
-@@ -18244,7 +18232,7 @@
+@@ -22933,7 +22911,7 @@
self-contained, and should not depend upon @file{acconfig.h} etc.
@section Using @command{autoupdate} to Modernize @file{configure.ac}
@cindex @command{autoupdate}
-@@ -19389,7 +19377,7 @@
+@@ -24111,7 +24089,7 @@
If you have an @file{aclocal.m4} installed with Autoconf (as opposed to
in a particular package's source directory), you must rename it to
+@file{acsite.m4}. @xref{autoconf}.
If you distribute @file{install.sh} with your package, rename it to
- @file{install-sh} so @code{make} builtin rules don't inadvertently
-@@ -19444,7 +19432,7 @@
+ @file{install-sh} so @command{make} builtin rules don't inadvertently
+@@ -24166,7 +24144,7 @@
the documentation for them. @xref{Obsolete Macros}, for a table showing the
new names for the old macros. Use the @command{autoupdate} program to
convert your @file{configure.ac} to using the new macro names.
Some macros have been superseded by similar ones that do the job better,
but are not call-compatible. If you get warnings about calling obsolete
-@@ -19980,7 +19968,7 @@
+@@ -24703,7 +24681,7 @@
@menu
* Using an Autotest Test Suite:: Autotest and the user
* Writing Testsuites:: Autotest macros
* Making testsuite Scripts:: Using autom4te to create @command{testsuite}
@end menu
-@@ -20042,7 +20030,7 @@
+@@ -24765,7 +24743,7 @@
@itemize @bullet
@item a debugging script named @file{run} which reruns the test in
of debugging scripts has the purpose of easing the chase for bugs.
@item all the files created with @code{AT_DATA}
-@@ -20304,7 +20292,7 @@
+@@ -25125,8 +25103,7 @@
+ be a single shell word that expands into a single file name.
+ @end defmac
+
+-@defmac AT_CHECK (@var{commands}, @dvar{status, 0}, @ovar{stdout}, @
+- @ovar{stderr}, @ovar{run-if-fail}, @ovar{run-if-pass})
++@defmac AT_CHECK (@var{commands}, @dvar{status, 0}, @ovar{stdout}, @@ovar{stderr}, @ovar{run-if-fail}, @ovar{run-if-pass})
+ @defmacx AT_CHECK_UNQUOTED (@var{commands}, @dvar{status, 0}, @ovar{stdout}, @
+ @ovar{stderr}, @ovar{run-if-fail}, @ovar{run-if-pass})
+ @atindex{CHECK}
+@@ -25270,7 +25247,7 @@
@end defmac
@section Running @command{testsuite} Scripts
@cindex @command{testsuite}
-@@ -20471,7 +20459,7 @@
+@@ -25465,7 +25442,7 @@
An Autotest test suite is to be configured in @var{directory}. This
- macro requires the instantiation of @file{@var{directory}/atconfig} from
- @file{@var{directory}/atconfig.in}, and sets the default
--@code{AUTOTEST_PATH} to @var{test-path} (@pxref{testsuite Invocation}).
-+@code{AUTOTEST_PATH} to @var{test-path} (@pxref{testsuite}).
+ macro causes @file{@var{directory}/atconfig} to be created by
+ @command{config.status} and sets the default @code{AUTOTEST_PATH} to
+-@var{test-path} (@pxref{testsuite Invocation}).
++@var{test-path} (@pxref{testsuite}).
@end defmac
@item
-@@ -20825,7 +20813,7 @@
+@@ -25858,7 +25835,7 @@
which can be a long process for complex @file{configure.ac}.
This is why all these tools, instead of running directly M4, invoke
projects / packages / autoconf.git / blobdiff