autoconf-info.patch

   1 --- autoconf-2.54/doc/autoconf.texi.orig        Fri Oct  4 23:19:09 2002
   2 +++ autoconf-2.54/doc/autoconf.texi     Fri Oct  4 23:24:43 2002
   3 @@ -94,33 +94,19 @@
   4
   5
   6
   7 -@dircategory GNU programming tools
   8 +@dircategory Programming tools:
   9  @direntry
  10 -* Autoconf: (autoconf).         Create source code configuration scripts
  11 -@end direntry
  12 -
  13 -@dircategory Individual utilities
  14 -@direntry
  15 -* autoscan: (autoconf)autoscan Invocation.
  16 -                                Semi-automatic @file{configure.ac} writing
  17 -* ifnames: (autoconf)ifnames Invocation.
  18 -                                Listing the conditionals in source code
  19 -* autoconf: (autoconf)autoconf Invocation.
  20 -                                How to create configuration scripts
  21 -* autoreconf: (autoconf)autoreconf Invocation.
  22 -                                Remaking multiple @command{configure} scripts
  23 -* autoheader: (autoconf)autoheader Invocation.
  24 -                                How to create configuration templates
  25 -* autom4te: (autoconf)Invoking autom4te.
  26 -                                The Autoconf executables backbone
  27 -* configure: (autoconf)configure Invocation.
  28 -                                Configuring a package
  29 -* autoupdate: (autoconf)autoupdate Invocation.
  30 -                                Automatic update of @file{configure.ac}
  31 -* config.status: (autoconf)config.status Invocation.
  32 -                                Recreating a configuration
  33 -* testsuite: (autoconf)testsuite Invocation.
  34 -                                Running an Autotest test suite
  35 +* Autoconf: (autoconf).                        Create source code configuration scripts
  36 +* autoscan: (autoconf)autoscan.                Semi-automatic @file{configure.ac} writing
  37 +* ifnames: (autoconf)ifnames.          Listing the conditionals in source code
  38 +* autoconf: (autoconf)autoconf.                How to create configuration scripts
  39 +* autoreconf: (autoconf)autoreconf.    Remaking multiple @command{configure} scripts
  40 +* autoheader: (autoconf)autoheader.    How to create configuration templates
  41 +* autom4te: (autoconf)autom4te.                The Autoconf executables backbone
  42 +* configure: (autoconf)configure.      Configuring a package
  43 +* autoupdate: (autoconf)autoupdate.    Automatic update of @file{configure.ac}
  44 +* config.status: (autoconf)config.status.  Recreating a configuration
  45 +* testsuite: (autoconf)testsuite.      Running an Autotest test suite
  46  @end direntry
  47
  48  @titlepage
  49 @@ -160,7 +146,7 @@
  50  * Manual Configuration::        Selecting features that can't be guessed
  51  * Site Configuration::          Local defaults for @command{configure}
  52  * Running configure Scripts::   How to use the Autoconf output
  53 -* config.status Invocation::    Recreating a configuration
  54 +* config.status::               Recreating a configuration
  55  * Obsolete Constructs::         Kept for backward compatibility
  56  * Using Autotest::              Creating portable test suites
  57  * FAQ::                         Frequent Autoconf Questions, with answers
  58 @@ -180,10 +166,10 @@
  59  Making @command{configure} Scripts
  60
  61  * Writing configure.ac::        What to put in an Autoconf input file
  62 -* autoscan Invocation::         Semi-automatic @file{configure.ac} writing
  63 -* ifnames Invocation::          Listing the conditionals in source code
  64 -* autoconf Invocation::         How to create configuration scripts
  65 -* autoreconf Invocation::       Remaking multiple @command{configure} scripts
  66 +* autoscan::                    Semi-automatic @file{configure.ac} writing
  67 +* ifnames::                     Listing the conditionals in source code
  68 +* autoconf::                    How to create configuration scripts
  69 +* autoreconf::                  Remaking multiple @command{configure} scripts
  70
  71  Writing @file{configure.ac}
  72
  73 @@ -216,7 +202,7 @@
  74  Configuration Header Files
  75
  76  * Header Templates::            Input for the configuration headers
  77 -* autoheader Invocation::       How to create configuration templates
  78 +* autoheader::                  How to create configuration templates
  79  * Autoheader Macros::           How to specify CPP templates
  80
  81  Existing Tests
  82 @@ -388,13 +374,13 @@
  83  * System Type::                 Specifying the system type
  84  * Sharing Defaults::            Setting site-wide defaults for @command{configure}
  85  * Defining Variables::          Specifying the compiler etc.
  86 -* configure Invocation::        Changing how @command{configure} runs
  87 +* configure::                   Changing how @command{configure} runs
  88
  89  Obsolete Constructs
  90
  91  * Obsolete config.status Use::  Different calling convention
  92  * acconfig.h::                  Additional entries in @file{config.h.in}
  93 -* autoupdate Invocation::       Automatic update of @file{configure.ac}
  94 +* autoupdate::                  Automatic update of @file{configure.ac}
  95  * Obsolete Macros::             Backward compatibility macros
  96  * Autoconf 1::                  Tips for upgrading your files
  97  * Autoconf 2.13::               Some fresher tips
  98 @@ -418,7 +404,7 @@
  99
 100  * Using an Autotest Test Suite::  Autotest and the user
 101  * Writing testsuite.at::        Autotest macros
 102 -* testsuite Invocation::        Running @command{testsuite} scripts
 103 +* testsuite::                   Running @command{testsuite} scripts
 104  * Making testsuite Scripts::    Using autom4te to create @command{testsuite}
 105
 106  Using an Autotest Test Suite
 107 @@ -729,7 +715,7 @@
 108
 109  @item
 110  a shell script called @file{config.status} that, when run, will recreate
 111 -the files listed above (@pxref{config.status Invocation});
 112 +the files listed above (@pxref{config.status});
 113
 114  @item
 115  an optional shell script normally called @file{config.cache}
 116 @@ -789,10 +775,10 @@
 117
 118  @menu
 119  * Writing configure.ac::        What to put in an Autoconf input file
 120 -* autoscan Invocation::         Semi-automatic @file{configure.ac} writing
 121 -* ifnames Invocation::          Listing the conditionals in source code
 122 -* autoconf Invocation::         How to create configuration scripts
 123 -* autoreconf Invocation::       Remaking multiple @command{configure} scripts
 124 +* autoscan::                    Semi-automatic @file{configure.ac} writing
 125 +* ifnames::                     Listing the conditionals in source code
 126 +* autoconf::                    How to create configuration scripts
 127 +* autoreconf::                  Remaking multiple @command{configure} scripts
 128  @end menu
 129
 130  @node Writing configure.ac
 131 @@ -808,7 +794,7 @@
 132  or specialized features, @file{configure.ac} might need to contain some
 133  hand-crafted shell commands; see @ref{Portable Shell}.  The
 134  @command{autoscan} program can give you a good start in writing
 135 -@file{configure.ac} (@pxref{autoscan Invocation}, for more information).
 136 +@file{configure.ac} (@pxref{autoscan}, for more information).
 137
 138  Previous versions of Autoconf promoted the name @file{configure.in},
 139  which is somewhat ambiguous (the tool needed to process this file is not
 140 @@ -1036,7 +1022,7 @@
 141  @end display
 142
 143
 144 -@node autoscan Invocation
 145 +@node autoscan
 146  @section Using @command{autoscan} to Create @file{configure.ac}
 147  @cindex @command{autoscan}
 148
 149 @@ -1058,7 +1044,7 @@
 150  use a configuration header file, you must add a call to
 151  @code{AC_CONFIG_HEADERS} (@pxref{Configuration Headers}).  You might
 152  also have to change or add some @code{#if} directives to your program in
 153 -order to make it work with Autoconf (@pxref{ifnames Invocation}, for
 154 +order to make it work with Autoconf (@pxref{ifnames}, for
 155  information about a program that can help with that job).
 156
 157  When using @command{autoscan} to maintain a @file{configure.ac}, simply
 158 @@ -1097,7 +1083,7 @@
 159  Prepend @var{dir} to the include path.  Multiple invocations accumulate.
 160  @end table
 161
 162 -@node ifnames Invocation
 163 +@node ifnames
 164  @section Using @command{ifnames} to List Conditionals
 165  @cindex @command{ifnames}
 166
 167 @@ -1106,8 +1092,7 @@
 168  preprocessor conditionals.  If a package has already been set up to have
 169  some portability, @command{ifnames} can thus help you figure out what its
 170  @command{configure} needs to check for.  It may help fill in some gaps in a
 171 -@file{configure.ac} generated by @command{autoscan} (@pxref{autoscan
 172 -Invocation}).
 173 +@file{configure.ac} generated by @command{autoscan} (@pxref{autoscan}).
 174
 175  @command{ifnames} scans all of the C source files named on the command line
 176  (or the standard input, if none are given) and writes to the standard
 177 @@ -1129,7 +1114,7 @@
 178  Print the version number of Autoconf and exit.
 179  @end table
 180
 181 -@node autoconf Invocation
 182 +@node autoconf
 183  @section Using @command{autoconf} to Create @command{configure}
 184  @cindex @command{autoconf}
 185
 186 @@ -1389,7 +1374,7 @@
 187  @end group
 188  @end example
 189
 190 -@node autoreconf Invocation
 191 +@node autoreconf
 192  @section Using @command{autoreconf} to Update @command{configure} Scripts
 193  @cindex @command{autoreconf}
 194
 195 @@ -1623,8 +1608,8 @@
 196  source directory; @command{configure} checks for this file's existence to
 197  make sure that the directory that it is told contains the source code in
 198  fact does.  Occasionally people accidentally specify the wrong directory
 199 -with @option{--srcdir}; this is a safety check.  @xref{configure
 200 -Invocation}, for more information.
 201 +with @option{--srcdir}; this is a safety check.  @xref{configure},
 202 +for more information.
 203  @end defmac
 204
 205
 206 @@ -1790,7 +1775,7 @@
 207  when used in @var{output}, or the standard input when used in the
 208  @var{inputs}.  You most probably don't need to use this in
 209  @file{configure.ac}, but it is convenient when using the command line
 210 -interface of @file{./config.status}, see @ref{config.status Invocation},
 211 +interface of @file{./config.status}, see @ref{config.status},
 212  for more details.
 213
 214  The @var{inputs} may be absolute or relative filenames.  In the latter
 215 @@ -2387,7 +2372,7 @@
 216  @file{config.h} is considered up to date.  @xref{Output}, for more
 217  information about @code{AC_OUTPUT}.
 218
 219 -@xref{config.status Invocation}, for more examples of handling
 220 +@xref{config.status}, for more examples of handling
 221  configuration-related dependencies.
 222
 223  @node Configuration Headers
 224 @@ -2448,7 +2433,7 @@
 225
 226  @menu
 227  * Header Templates::            Input for the configuration headers
 228 -* autoheader Invocation::       How to create configuration templates
 229 +* autoheader::                  How to create configuration templates
 230  * Autoheader Macros::           How to specify CPP templates
 231  @end menu
 232
 233 @@ -2499,10 +2484,10 @@
 234  @samp{#undef} is strongly discouraged.
 235
 236  Since it is a tedious task to keep a template header up to date, you may
 237 -use @command{autoheader} to generate it, see @ref{autoheader Invocation}.
 238 +use @command{autoheader} to generate it, see @ref{autoheader}.
 239
 240
 241 -@node autoheader Invocation
 242 +@node autoheader
 243  @subsection Using @command{autoheader} to Create @file{config.h.in}
 244  @cindex @command{autoheader}
 245
 246 @@ -6215,7 +6200,7 @@
 247  files will depend upon @command{bizarre-cc} being the C compiler.  If
 248  for some reason the user runs @command{./configure} again, or if it is
 249  run via @samp{./config.status --recheck}, (@xref{Automatic Remaking},
 250 -and @pxref{config.status Invocation}), then the configuration can be
 251 +and @pxref{config.status}), then the configuration can be
 252  inconsistent, composed of results depending upon two different
 253  compilers.
 254
 255 @@ -6267,7 +6252,7 @@
 256
 257  @item
 258  @var{variable} is kept during automatic reconfiguration
 259 -(@pxref{config.status Invocation}) as if it had been passed as a command
 260 +(@pxref{config.status}) as if it had been passed as a command
 261  line argument, including when no cache is used:
 262
 263  @example
 264 @@ -7394,7 +7379,7 @@
 265  not.
 266  @end table
 267
 268 -@xref{autoconf Invocation}, for examples of trace uses.
 269 +@xref{autoconf}, for examples of trace uses.
 270
 271  @item --preselect=@var{macro}
 272  @itemx -p @var{macro}
 273 @@ -7845,7 +7830,7 @@
 274
 275  When the user runs @samp{autoconf -W error}, warnings from
 276  @code{AC_DIAGNOSE} and @code{AC_WARNING} are reported as error, see
 277 -@ref{autoconf Invocation}.
 278 +@ref{autoconf}.
 279
 280  @node Dependencies Between Macros
 281  @section Dependencies Between Macros
 282 @@ -11642,7 +11627,7 @@
 283  * System Type::                 Specifying the system type
 284  * Sharing Defaults::            Setting site-wide defaults for @command{configure}
 285  * Defining Variables::          Specifying the compiler etc.
 286 -* configure Invocation::        Changing how @command{configure} runs
 287 +* configure::                   Changing how @command{configure} runs
 288  @end menu
 289
 290  @set autoconf
 291 @@ -11651,7 +11636,7 @@
 292
 293  @c ============================================== Recreating a Configuration
 294
 295 -@node config.status Invocation
 296 +@node config.status
 297  @chapter Recreating a Configuration
 298  @cindex @command{config.status}
 299
 300 @@ -11785,7 +11770,7 @@
 301  @menu
 302  * Obsolete config.status Use::  Different calling convention
 303  * acconfig.h::                  Additional entries in @file{config.h.in}
 304 -* autoupdate Invocation::       Automatic update of @file{configure.ac}
 305 +* autoupdate::                  Automatic update of @file{configure.ac}
 306  * Obsolete Macros::             Backward compatibility macros
 307  * Autoconf 1::                  Tips for upgrading your files
 308  * Autoconf 2.13::               Some fresher tips
 309 @@ -11795,7 +11780,7 @@
 310  @section Obsolete @file{config.status} Invocation
 311
 312  @file{config.status} now supports arguments to specify the files to
 313 -instantiate; see @ref{config.status Invocation}, for more details.
 314 +instantiate; see @ref{config.status}, for more details.
 315  Before, environment variables had to be used.
 316
 317  @defvar CONFIG_COMMANDS
 318 @@ -11826,7 +11811,7 @@
 319  @file{config.status} ignores this variable.
 320  @end defvar
 321
 322 -In @ref{config.status Invocation}, using this old interface, the example
 323 +In @ref{config.status}, using this old interface, the example
 324  would be:
 325
 326  @example
 327 @@ -11900,7 +11885,7 @@
 328  self-contained, and should not depend upon @file{acconfig.h} etc.
 329
 330
 331 -@node autoupdate Invocation
 332 +@node autoupdate
 333  @section Using @command{autoupdate} to Modernize @file{configure.ac}
 334  @cindex @command{autoupdate}
 335
 336 @@ -12750,7 +12735,7 @@
 337
 338  If you have an @file{aclocal.m4} installed with Autoconf (as opposed to
 339  in a particular package's source directory), you must rename it to
 340 -@file{acsite.m4}.  @xref{autoconf Invocation}.
 341 +@file{acsite.m4}.  @xref{autoconf}.
 342
 343  If you distribute @file{install.sh} with your package, rename it to
 344  @file{install-sh} so @code{make} builtin rules won't inadvertently
 345 @@ -12805,7 +12790,7 @@
 346  the documentation for them.  @xref{Obsolete Macros}, for a table showing the
 347  new names for the old macros.  Use the @command{autoupdate} program to
 348  convert your @file{configure.ac} to using the new macro names.
 349 -@xref{autoupdate Invocation}.
 350 +@xref{autoupdate}.
 351
 352  Some macros have been superseded by similar ones that do the job better,
 353  but are not call-compatible.  If you get warnings about calling obsolete
 354 @@ -13302,7 +13287,7 @@
 355  @menu
 356  * Using an Autotest Test Suite::  Autotest and the user
 357  * Writing testsuite.at::        Autotest macros
 358 -* testsuite Invocation::        Running @command{testsuite} scripts
 359 +* testsuite::                   Running @command{testsuite} scripts
 360  * Making testsuite Scripts::    Using autom4te to create @command{testsuite}
 361  @end menu
 362
 363 @@ -13564,7 +13549,7 @@
 364  @end defmac
 365
 366
 367 -@node testsuite Invocation
 368 +@node testsuite
 369  @section Running @command{testsuite} Scripts
 370  @cindex @command{testsuite}
 371
 372 @@ -13706,7 +13691,7 @@
 373  An Autotest test suite is to be configured in @var{directory}.  This
 374  macro requires the instantiation of @file{@var{directory}/atconfig} from
 375  @file{@var{directory}/atconfig.in}, and sets the default
 376 -@code{AUTOTEST_PATH} to @var{test-path} (@pxref{testsuite Invocation}).
 377 +@code{AUTOTEST_PATH} to @var{test-path} (@pxref{testsuite}).
 378  @end defmac
 379
 380  @item
 381 --- autoconf-2.54/doc/install.texi.orig Tue Aug 27 10:28:06 2002
 382 +++ autoconf-2.54/doc/install.texi      Fri Oct  4 23:27:28 2002
 383 @@ -225,7 +225,7 @@
 384  overridden in the site shell script).
 385
 386
 387 -@node configure Invocation
 388 +@node configure
 389  @section @command{configure} Invocation
 390
 391  @command{configure} recognizes the following options to control how it