- added patch for AC_SYS_LARGEFILE etc.

[packages/autoconf.git] / autoconf-info.patch

--- autoconf-2.72/doc/autoconf.texi.orig	2023-12-25 17:45:48.441111910 +0100
+++ autoconf-2.72/doc/autoconf.texi	2023-12-25 17:49:20.953293966 +0100
@@ -225,29 +225,19 @@ entitled ``GNU Free Documentation Licens
 
 
 
-@dircategory Software development
+@dircategory Programming tools:
 @direntry
-* Autoconf: (autoconf).         Create source code configuration scripts.
-@end direntry
-
-@dircategory Individual utilities
-@direntry
-* autoscan: (autoconf)autoscan Invocation.
-                                Semi-automatic @file{configure.ac} writing
-* ifnames: (autoconf)ifnames Invocation.        Listing conditionals in source.
-* autoconf-invocation: (autoconf)autoconf Invocation.
-                                How to create configuration scripts
-* autoreconf: (autoconf)autoreconf Invocation.
-                                Remaking multiple @command{configure} scripts
-* autoheader: (autoconf)autoheader Invocation.
-                                How to create configuration templates
-* autom4te: (autoconf)autom4te Invocation.
-                                The Autoconf executables backbone
-* 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.
-* testsuite: (autoconf)testsuite Invocation.    Running an Autotest test suite.
+* Autoconf: (autoconf).			Create source code configuration scripts
+* autoscan: (autoconf)autoscan.		Semi-automatic @file{configure.ac} writing
+* ifnames: (autoconf)ifnames.		Listing conditionals in source
+* autoconf: (autoconf)autoconf.		How to create configuration scripts
+* autoreconf: (autoconf)autoreconf.	Remaking multiple @command{configure} scripts
+* autoheader: (autoconf)autoheader.	How to create configuration templates
+* autom4te: (autoconf)autom4te.		The Autoconf executables backbone
+* configure: (autoconf)configure.	Configuring a package
+* autoupdate: (autoconf)autoupdate.	Automatic update of @file{configure.ac}
+* config.status: (autoconf)config.status.  Recreating configurations.
+* testsuite: (autoconf)testsuite.	Running an Autotest test suite.
 @end direntry
 
 @titlepage
@@ -290,7 +280,7 @@ entitled ``GNU Free Documentation Licens
 * 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
+* config.status::               Recreating a configuration
 * Obsolete Constructs::         Kept for backward compatibility
 * Using Autotest::              Creating portable test suites
 * FAQ::                         Frequent Autoconf Questions, with answers
@@ -311,10 +301,10 @@ The GNU Build System
 Making @command{configure} Scripts
 
 * 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
+* autoscan::                    Semi-automatic @file{configure.ac} writing
+* ifnames::                     Listing the conditionals in source code
+* autoconf::                    How to create configuration scripts
+* autoreconf::                  Remaking multiple @command{configure} scripts
 
 Writing @file{configure.ac}
 
@@ -349,7 +339,7 @@ Substitutions in Makefiles
 Configuration Header Files
 
 * Header Templates::            Input for the configuration headers
-* autoheader Invocation::       How to create configuration templates
+* autoheader::                  How to create configuration templates
 * Autoheader Macros::           How to specify CPP templates
 
 Existing Tests
@@ -468,7 +458,7 @@ M4 Quotation
 
 Using @command{autom4te}
 
-* autom4te Invocation::         A GNU M4 wrapper
+* autom4te::                    A GNU M4 wrapper
 * Customizing autom4te::        Customizing the Autoconf package
 
 Programming in M4sugar
@@ -607,13 +597,13 @@ Running @command{configure} Scripts
 * System Types::                Specifying a system type
 * Sharing Defaults::            Setting site-wide defaults for @command{configure}
 * Defining Variables::          Specifying the compiler etc.
-* configure Invocation::        Changing how @command{configure} runs
+* configure::                   Changing how @command{configure} runs
 
 Obsolete Constructs
 
 * Obsolete config.status Use::  Obsolete convention for @command{config.status}
 * acconfig Header::             Additional entries in @file{config.h.in}
-* autoupdate Invocation::       Automatic update of @file{configure.ac}
+* autoupdate::                  Automatic update of @file{configure.ac}
 * Obsolete Macros::             Backward compatibility macros
 * Autoconf 1::                  Tips for upgrading your files
 * Autoconf 2.13::               Some fresher tips
@@ -638,7 +628,7 @@ Generating Test Suites with Autotest
 
 * Using an Autotest Test Suite::  Autotest and the user
 * Writing Testsuites::          Autotest macros
-* testsuite Invocation::        Running @command{testsuite} scripts
+* testsuite::                   Running @command{testsuite} scripts
 * Making testsuite Scripts::    Using autom4te to create @command{testsuite}
 
 Using an Autotest Test Suite
@@ -999,7 +989,7 @@ containing @code{#define} directives (@p
 
 @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{config.status});
 
 @item
 an optional shell script normally called @file{config.cache}
@@ -1079,10 +1069,10 @@ Makefile.in ---'                    `->
 
 @menu
 * 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
+* autoscan::                    Semi-automatic @file{configure.ac} writing
+* ifnames::                     Listing the conditionals in source code
+* autoconf::                    How to create configuration scripts
+* autoreconf::                  Remaking multiple @command{configure} scripts
 @end menu
 
 @node Writing Autoconf Input
@@ -1098,7 +1088,7 @@ you can use Autoconf template macros to
 or specialized features, @file{configure.ac} might need to contain some
 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).
 
 @cindex @file{configure.in}
@@ -1397,7 +1387,7 @@ checks for system services
 @end display
 
 
-@node autoscan Invocation
+@node autoscan
 @section Using @command{autoscan} to Create @file{configure.ac}
 @cindex @command{autoscan}
 
@@ -1419,7 +1409,7 @@ you need to move such macros manually.
 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
-order to make it work with Autoconf (@pxref{ifnames Invocation}, for
+order to make it work with Autoconf (@pxref{ifnames}, for
 information about a program that can help with that job).
 
 When using @command{autoscan} to maintain a @file{configure.ac}, simply
@@ -1462,7 +1452,7 @@ Append @var{dir} to the include path.  M
 Prepend @var{dir} to the include path.  Multiple invocations accumulate.
 @end table
 
-@node ifnames Invocation
+@node ifnames
 @section Using @command{ifnames} to List Conditionals
 @cindex @command{ifnames}
 
@@ -1471,8 +1461,7 @@ package.  It prints the identifiers that
 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
-@file{configure.ac} generated by @command{autoscan} (@pxref{autoscan
-Invocation}).
+@file{configure.ac} generated by @command{autoscan} (@pxref{autoscan}).
 
 @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
@@ -1494,7 +1483,7 @@ Print a summary of the command line opti
 Print the version number of Autoconf and exit.
 @end table
 
-@node autoconf Invocation
+@node autoconf
 @section Using @command{autoconf} to Create @command{configure}
 @cindex @command{autoconf}
 
@@ -1596,7 +1585,7 @@ just make @var{format} as long as needed
 
 The @var{format} is a regular string, with newlines if desired, and
 several special escape codes.  It defaults to @samp{$f:$l:$n:$%}; see
-@ref{autom4te Invocation}, for details on the @var{format}.
+@ref{autom4te}, for details on the @var{format}.
 
 @item --initialization
 @itemx -i
@@ -1670,7 +1659,7 @@ AUTOMAKE|:::::|automake|:::::|$missing_d
 @end group
 @end example
 
-@node autoreconf Invocation
+@node autoreconf
 @section Using @command{autoreconf} to Update @command{configure} Scripts
 @cindex @command{autoreconf}
 
@@ -1709,7 +1698,7 @@ infrastructure to a source package.  If
 your @file{configure.ac} should invoke @code{AM_GNU_GETTEXT} and
 one of @code{AM_GNU_GETTEXT_VERSION(@var{gettext-version})} or
 @code{AM_GNU_GETTEXT_REQUIRE_VERSION(@var{min-gettext-version})}.
-@xref{autopoint Invocation, , Invoking the @code{autopoint} Program,
+@xref{autopoint, , Invoking the @code{autopoint} Program,
 gettext, GNU @code{gettext} utilities}, for further details.
 
 @noindent
@@ -2124,7 +2113,7 @@ this package.  @command{configure} will
 
 Use of this macro is strongly recommended.  It protects against people
 accidentally specifying the wrong directory with @option{--srcdir}.
-@xref{configure Invocation}, for more information.
+@xref{configure}, for more information.
 @end defmac
 
 Packages that use @command{aclocal} to generate @file{aclocal.m4}
@@ -2379,7 +2368,7 @@ The special value @samp{-} might be used
 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{config.status},
 for more details.
 
 The @var{inputs} may be absolute or relative file names.  In the latter
@@ -3340,7 +3329,7 @@ AC_CONFIG_FILES([stamp-h], [echo timesta
 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{config.status}, for more examples of handling
 configuration-related dependencies.
 
 @node Configuration Headers
@@ -3427,7 +3416,7 @@ AC_CONFIG_COMMANDS_PRE(
 
 @menu
 * Header Templates::            Input for the configuration headers
-* autoheader Invocation::       How to create configuration templates
+* autoheader::                  How to create configuration templates
 * Autoheader Macros::           How to specify CPP templates
 @end menu
 
@@ -3469,7 +3458,7 @@ once.  Other preprocessor lines, such as
 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
@@ -3507,7 +3496,7 @@ config header template.  If you are usin
 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}
 
@@ -7559,7 +7548,7 @@ abort configure and tell the installer h
 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
@@ -8373,10 +8362,8 @@ information other than through the C pre
 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}
@@ -8547,10 +8534,8 @@ The result of the macro is cached in the
 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
@@ -10331,7 +10316,7 @@ dangerous.  If for instance the user run
 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{config.status}), then the configuration can be
 inconsistent, composed of results depending upon two different
 compilers.
 
@@ -10384,7 +10369,7 @@ to a warning only, but the old value is
 
 @item
 @var{variable} is kept during automatic reconfiguration
-(@pxref{config.status Invocation}) as if it had been passed as a command
+(@pxref{config.status}) as if it had been passed as a command
 line argument, including when no cache is used:
 
 @example
@@ -11546,11 +11531,11 @@ Yet another great name from Lars J. Aas.
 It supports M4 extensions designed for use in tools like Autoconf.
 
 @menu
-* autom4te Invocation::         A GNU M4 wrapper
+* autom4te::                    A GNU M4 wrapper
 * Customizing autom4te::        Customizing the Autoconf package
 @end menu
 
-@node autom4te Invocation
+@node autom4te
 @subsection Invoking @command{autom4te}
 
 The command line arguments are modeled after M4's:
@@ -11800,7 +11785,7 @@ newlines in the @samp{separator}), while
 not.
 @end table
 
-@xref{autoconf Invocation}, for examples of trace uses.
+@xref{autoconf}, for examples of trace uses.
 
 @item --preselect=@var{macro}
 @itemx -p @var{macro}
@@ -11888,8 +11873,8 @@ lines are ignored.  Customization is per
 wrapped in between a @samp{begin-language: "@var{language}"},
 @samp{end-language: "@var{language}"} pair.
 
-Customizing a language stands for appending options (@pxref{autom4te
-Invocation}) to the current definition of the language.  Options, and
+Customizing a language stands for appending options (@pxref{autom4te})
+to the current definition of the language.  Options, and
 more generally arguments, are introduced by @samp{args:
 @var{arguments}}.  You may use the traditional shell syntax to quote the
 @var{arguments}.
@@ -23306,7 +23291,7 @@ may use comes with Autoconf.
 * System Types::                Specifying a system type
 * Sharing Defaults::            Setting site-wide defaults for @command{configure}
 * Defining Variables::          Specifying the compiler etc.
-* configure Invocation::        Changing how @command{configure} runs
+* configure::                   Changing how @command{configure} runs
 @end menu
 
 @set autoconf
@@ -23315,7 +23300,7 @@ may use comes with Autoconf.
 
 @c ============================================== config.status Invocation
 
-@node config.status Invocation
+@node config.status
 @chapter config.status Invocation
 @cindex @command{config.status}
 
@@ -23484,7 +23469,7 @@ understanding how to move to more modern
 @menu
 * Obsolete config.status Use::  Obsolete convention for @command{config.status}
 * acconfig Header::             Additional entries in @file{config.h.in}
-* autoupdate Invocation::       Automatic update of @file{configure.ac}
+* autoupdate::                  Automatic update of @file{configure.ac}
 * Obsolete Macros::             Backward compatibility macros
 * Autoconf 1::                  Tips for upgrading your files
 * Autoconf 2.13::               Some fresher tips
@@ -23494,7 +23479,7 @@ understanding how to move to more modern
 @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{config.status}, for more details.
 Before, environment variables had to be used.
 
 @defvar CONFIG_COMMANDS
@@ -23525,7 +23510,7 @@ The symbolic links to establish.  The de
 @file{config.status} ignores this variable.
 @end defvar
 
-In @ref{config.status Invocation}, using this old interface, the example
+In @ref{config.status}, using this old interface, the example
 would be:
 
 @example
@@ -23599,7 +23584,7 @@ Using only the @code{AH_} macros, @file{
 self-contained, and should not depend upon @file{acconfig.h} etc.
 
 
-@node autoupdate Invocation
+@node autoupdate
 @section Using @command{autoupdate} to Modernize @file{configure.ac}
 @cindex @command{autoupdate}
 
@@ -24836,7 +24821,7 @@ Autoconf distribution.
 
 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 Invocation}.
+@file{acsite.m4}.  @xref{autoconf}.
 
 If you distribute @file{install.sh} with your package, rename it to
 @file{install-sh} so @command{make} builtin rules don't inadvertently
@@ -24891,7 +24876,7 @@ use the old names, but the new ones are
 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.
-@xref{autoupdate Invocation}.
+@xref{autoupdate}.
 
 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
@@ -25428,7 +25413,7 @@ interactive tool testing, which is proba
 @menu
 * Using an Autotest Test Suite::  Autotest and the user
 * Writing Testsuites::          Autotest macros
-* testsuite Invocation::        Running @command{testsuite} scripts
+* testsuite::                   Running @command{testsuite} scripts
 * Making testsuite Scripts::    Using autom4te to create @command{testsuite}
 @end menu
 
@@ -25490,7 +25475,7 @@ the test group, and they include:
 
 @itemize @bullet
 @item a debugging script named @file{run} which reruns the test in
-@dfn{debug mode} (@pxref{testsuite Invocation}).  The automatic generation
+@dfn{debug mode} (@pxref{testsuite}).  The automatic generation
 of debugging scripts has the purpose of easing the chase for bugs.
 
 @item all the files created with @code{AT_DATA}
@@ -25762,7 +25747,7 @@ variables or reset them to safe values i
 @var{shell-code} is only executed if at least one test is going to be
 run.  In particular, it will not be executed if any of the @option{--help},
 @option{--version}, @option{--list}, or @option{--clean} options are
-given to @command{testsuite} (@pxref{testsuite Invocation}).
+given to @command{testsuite} (@pxref{testsuite}).
 @end defmac
 
 @defmac AT_PREPARE_EACH_TEST (@var{shell-code})
@@ -25897,8 +25882,7 @@ command substitution (@samp{`}), and bac
 on @var{contents}.
 @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}
@@ -26058,7 +26042,7 @@ individual unit tests.
 @end defmac
 
 
-@node testsuite Invocation
+@node testsuite
 @section Running @command{testsuite} Scripts
 @cindex @command{testsuite}
 
@@ -26253,7 +26237,7 @@ Invoke @code{AC_CONFIG_TESTDIR} in your
 An Autotest test suite is to be configured in @var{directory}.  This
 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
@@ -26668,7 +26652,7 @@ check the GNU Build System components th
 which can be a long process for complex @file{configure.ac}.
 
 This is why all these tools, instead of running directly M4, invoke
-@command{autom4te} (@pxref{autom4te Invocation}) which, while answering to
+@command{autom4te} (@pxref{autom4te}) which, while answering to
 a specific demand, stores additional information in
 @file{autom4te.cache} for future runs.  For instance, if you run
 @command{autoconf}, behind the scenes, @command{autom4te} also
--- autoconf-2.70/doc/install.texi.orig	2020-12-01 15:47:57.000000000 +0100
+++ autoconf-2.70/doc/install.texi	2021-01-07 21:58:37.050901476 +0100
@@ -372,7 +372,7 @@
 CONFIG_SHELL=/bin/bash ./configure CONFIG_SHELL=/bin/bash
 @end example
 
-@node configure Invocation
+@node configure
 @section @command{configure} Invocation
 
 @command{configure} recognizes the following options to control how it
--- autoconf-2.72/doc/standards.texi.orig	2023-12-25 17:45:48.491111639 +0100
+++ autoconf-2.72/doc/standards.texi	2023-12-25 17:49:44.189834749 +0100
@@ -6,9 +6,9 @@
 @set lastupdate August 17, 2021
 @c %**end of header
 
-@dircategory GNU organization
+@dircategory GNU organization:
 @direntry
-* Standards: (standards).       GNU coding standards.
+* Standards: (standards).		GNU coding standards
 @end direntry
 
 @c @setchapternewpage odd