--- autoconf-2.52/doc/autoconf.texi.orig Tue Jul 17 18:34:55 2001 +++ autoconf-2.52/doc/autoconf.texi Wed Jul 18 23:56:19 2001 @@ -34,18 +34,15 @@ @dircategory Individual utilities @direntry -* autoscan: (autoconf)autoscan Invocation. - Semi-automatic @file{configure.ac} writing -* ifnames: (autoconf)ifnames Invocation. - Listing the conditionals in source code -* autoconf: (autoconf)autoconf Invocation. - How to create configuration scripts -* autoreconf: (autoconf)autoreconf Invocation. - Remaking multiple @code{configure} scripts -* configure: (autoconf)configure Invocation. - Configuring a package -* config.status: (autoconf)config.status Invocation. - Recreating a configuration +* autoscan: (autoconf)autoscan. Semi-automatic @file{configure.ac} + writing +* ifnames: (autoconf)ifnames. Listing the conditionals in source code +* autoconf: (autoconf)autoconf. How to create configuration scripts +* autoreconf: (autoconf)autoreconf. Remaking multiple @code{configure} + scripts +* configure: (autoconf)configure. Configuring a package +* config.status: (autoconf)config.status. + Recreating a configuration @end direntry @ifinfo @@ -146,7 +143,7 @@ * Manual Configuration:: Selecting features that can't be guessed * Site Configuration:: Local defaults for @code{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 * Questions:: Questions about Autoconf, with answers * History:: History of Autoconf @@ -168,10 +165,10 @@ Making @code{configure} Scripts * Writing configure.ac:: 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 @code{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 @code{configure} scripts Writing @file{configure.ac} @@ -369,7 +366,7 @@ * System Type:: Specifying the system type * Sharing Defaults:: Setting site-wide defaults for @code{configure} * Environment Variables:: Defining environment variables. -* configure Invocation:: Changing how @code{configure} runs +* configure:: Changing how @code{configure} runs Obsolete Constructs @@ -680,7 +677,7 @@ @item a shell script called @file{config.status} that, when run, will recreate -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} @@ -740,13 +737,13 @@ @menu * Writing configure.ac:: 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 @code{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 @code{configure} scripts @end menu -@node Writing configure.ac, autoscan Invocation, Making configure Scripts, Making configure Scripts +@node Writing configure.ac, autoscan, Making configure Scripts, Making configure Scripts @section Writing @file{configure.ac} To produce a @code{configure} script for a software package, create a @@ -759,7 +756,7 @@ or specialized features, @file{configure.ac} might need to contain some hand-crafted shell commands; see @ref{Portable Shell}. The @code{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). Previous versions of Autoconf promoted the name @file{configure.in}, which is somewhat ambiguous (the tool needed to produce this file is not @@ -987,7 +984,7 @@ @end display -@node autoscan Invocation, ifnames Invocation, Writing configure.ac, Making configure Scripts +@node autoscan, ifnames, Writing configure.ac, Making configure Scripts @section Using @code{autoscan} to Create @file{configure.ac} @cindex @code{autoscan} @@ -1009,7 +1006,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 -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 @@ -1051,7 +1048,7 @@ plays with different versions of Autoconf simultaneously. @end table -@node ifnames Invocation, autoconf Invocation, autoscan Invocation, Making configure Scripts +@node ifnames, autoconf, autoscan, Making configure Scripts @section Using @code{ifnames} to List Conditionals @cindex @code{ifnames} @@ -1060,8 +1057,7 @@ preprocessor conditionals. If a package has already been set up to have some portability, @code{ifnames} can thus help you figure out what its @code{configure} needs to check for. It may help fill in some gaps in a -@file{configure.ac} generated by @code{autoscan} (@pxref{autoscan -Invocation}). +@file{configure.ac} generated by @code{autoscan} (@pxref{autoscan}). @code{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 @@ -1083,7 +1079,7 @@ Print the version number of Autoconf and exit. @end table -@node autoconf Invocation, autoreconf Invocation, ifnames Invocation, Making configure Scripts +@node autoconf, autoreconf, ifnames, Making configure Scripts @section Using @code{autoconf} to Create @code{configure} @cindex @code{autoconf} @@ -1346,7 +1342,7 @@ @end group @end example -@node autoreconf Invocation, , autoconf Invocation, Making configure Scripts +@node autoreconf, , autoconf, Making configure Scripts @section Using @code{autoreconf} to Update @code{configure} Scripts @cindex @code{autoreconf} @@ -1568,8 +1564,8 @@ source directory; @code{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 -with @option{--srcdir}; this is a safety check. @xref{configure -Invocation}, for more information. +with @option{--srcdir}; this is a safety check. @xref{configure}, +for more information. @end defmac @@ -1755,7 +1751,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 -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 filenames. In the latter @@ -2223,7 +2219,7 @@ @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, Configuration Commands, Makefile Substitutions, Setup @@ -5621,7 +5617,7 @@ files will 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. @@ -5665,7 +5661,7 @@ @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 @@ -6670,7 +6666,7 @@ When the user runs @samp{autoconf -W error}, warnings from @code{AC_DIAGNOSE} and @code{AC_WARNING} are reported as error, see -@ref{autoconf Invocation}. +@ref{autoconf}. @node Dependencies Between Macros, Obsoleting Macros, Reporting Messages, Writing Autoconf Macros @section Dependencies Between Macros @@ -9445,7 +9441,7 @@ @c ============================================== Running configure Scripts. -@node Running configure scripts, config.status Invocation, Site Configuration, Top +@node Running configure scripts, config.status, Site Configuration, Top @chapter Running @code{configure} Scripts @cindex @code{configure} @@ -9463,7 +9459,7 @@ * System Type:: Specifying the system type * Sharing Defaults:: Setting site-wide defaults for @code{configure} * Environment Variables:: Defining environment variables. -* configure Invocation:: Changing how @code{configure} runs +* configure:: Changing how @code{configure} runs @end menu @include install.texi @@ -9471,7 +9467,7 @@ @c ============================================== Recreating a Configuration -@node config.status Invocation, Obsolete Constructs, Running configure scripts, Top +@node config.status, Obsolete Constructs, Running configure scripts, Top @chapter Recreating a Configuration @cindex @code{config.status} @@ -9590,7 +9586,7 @@ @c =================================================== Obsolete Constructs -@node Obsolete Constructs, Questions, config.status Invocation, Top +@node Obsolete Constructs, Questions, config.status, Top @chapter Obsolete Constructs Autoconf changes, and throughout the years some constructs are obsoleted. @@ -9614,7 +9610,7 @@ @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 @@ -9645,7 +9641,7 @@ @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 @@ -10572,7 +10568,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 Invocation}. +@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 won't inadvertently --- autoconf-2.52/doc/install.texi.orig Tue Jul 17 18:34:55 2001 +++ autoconf-2.52/doc/install.texi Wed Jul 18 23:53:41 2001 @@ -215,8 +215,8 @@ overridden in the site shell script). -@node configure Invocation -@section @code{configure} Invocation +@node configure +@section @code{configure} @code{configure} recognizes the following options to control how it operates.