1 --- autoconf-2.62/doc/autoconf.texi.orig 2008-04-16 20:34:45.377155963 +0200
2 +++ autoconf-2.62/doc/autoconf.texi 2008-04-16 20:39:04.079896078 +0200
7 -@dircategory Software development
8 +@dircategory Programming tools:
10 -* Autoconf: (autoconf). Create source code configuration scripts.
13 -@dircategory Individual utilities
15 -* autoscan: (autoconf)autoscan Invocation.
16 - Semi-automatic @file{configure.ac} writing
17 -* ifnames: (autoconf)ifnames Invocation. Listing conditionals in source.
18 -* autoconf-invocation: (autoconf)autoconf Invocation.
19 - How to create configuration scripts
20 -* autoreconf: (autoconf)autoreconf Invocation.
21 - Remaking multiple @command{configure} scripts
22 -* autoheader: (autoconf)autoheader Invocation.
23 - How to create configuration templates
24 -* autom4te: (autoconf)autom4te Invocation.
25 - The Autoconf executables backbone
26 -* configure: (autoconf)configure Invocation. Configuring a package.
27 -* autoupdate: (autoconf)autoupdate Invocation.
28 - Automatic update of @file{configure.ac}
29 -* config.status: (autoconf)config.status Invocation. Recreating configurations.
30 -* testsuite: (autoconf)testsuite Invocation. Running an Autotest test suite.
31 +* Autoconf: (autoconf). Create source code configuration scripts
32 +* autoscan: (autoconf)autoscan. Semi-automatic @file{configure.ac} writing
33 +* ifnames: (autoconf)ifnames. Listing conditionals in source
34 +* autoconf: (autoconf)autoconf. How to create configuration scripts
35 +* autoreconf: (autoconf)autoreconf. Remaking multiple @command{configure} scripts
36 +* autoheader: (autoconf)autoheader. How to create configuration templates
37 +* autom4te: (autoconf)autom4te. The Autoconf executables backbone
38 +* configure: (autoconf)configure. Configuring a package
39 +* autoupdate: (autoconf)autoupdate. Automatic update of @file{configure.ac}
40 +* config.status: (autoconf)config.status. Recreating configurations.
41 +* testsuite: (autoconf)testsuite. Running an Autotest test suite.
46 * Manual Configuration:: Selecting features that can't be guessed
47 * Site Configuration:: Local defaults for @command{configure}
48 * Running configure Scripts:: How to use the Autoconf output
49 -* config.status Invocation:: Recreating a configuration
50 +* config.status:: Recreating a configuration
51 * Obsolete Constructs:: Kept for backward compatibility
52 * Using Autotest:: Creating portable test suites
53 * FAQ:: Frequent Autoconf Questions, with answers
55 Making @command{configure} Scripts
57 * Writing Autoconf Input:: What to put in an Autoconf input file
58 -* autoscan Invocation:: Semi-automatic @file{configure.ac} writing
59 -* ifnames Invocation:: Listing the conditionals in source code
60 -* autoconf Invocation:: How to create configuration scripts
61 -* autoreconf Invocation:: Remaking multiple @command{configure} scripts
62 +* autoscan:: Semi-automatic @file{configure.ac} writing
63 +* ifnames:: Listing the conditionals in source code
64 +* autoconf:: How to create configuration scripts
65 +* autoreconf:: Remaking multiple @command{configure} scripts
67 Writing @file{configure.ac}
70 Configuration Header Files
72 * Header Templates:: Input for the configuration headers
73 -* autoheader Invocation:: How to create configuration templates
74 +* autoheader:: How to create configuration templates
75 * Autoheader Macros:: How to specify CPP templates
80 Using @command{autom4te}
82 -* autom4te Invocation:: A @acronym{GNU} M4 wrapper
83 +* autom4te:: A @acronym{GNU} M4 wrapper
84 * Customizing autom4te:: Customizing the Autoconf package
86 Programming in M4sugar
88 * System Type:: Specifying the system type
89 * Sharing Defaults:: Setting site-wide defaults for @command{configure}
90 * Defining Variables:: Specifying the compiler etc.
91 -* configure Invocation:: Changing how @command{configure} runs
92 +* configure:: Changing how @command{configure} runs
96 * Obsolete config.status Use:: Obsolete convention for @command{config.status}
97 * acconfig Header:: Additional entries in @file{config.h.in}
98 -* autoupdate Invocation:: Automatic update of @file{configure.ac}
99 +* autoupdate:: Automatic update of @file{configure.ac}
100 * Obsolete Macros:: Backward compatibility macros
101 * Autoconf 1:: Tips for upgrading your files
102 * Autoconf 2.13:: Some fresher tips
105 * Using an Autotest Test Suite:: Autotest and the user
106 * Writing Testsuites:: Autotest macros
107 -* testsuite Invocation:: Running @command{testsuite} scripts
108 +* testsuite:: Running @command{testsuite} scripts
109 * Making testsuite Scripts:: Using autom4te to create @command{testsuite}
111 Using an Autotest Test Suite
115 a shell script called @file{config.status} that, when run, recreates
116 -the files listed above (@pxref{config.status Invocation});
117 +the files listed above (@pxref{config.status});
120 an optional shell script normally called @file{config.cache}
121 @@ -1006,10 +996,10 @@
124 * Writing Autoconf Input:: What to put in an Autoconf input file
125 -* autoscan Invocation:: Semi-automatic @file{configure.ac} writing
126 -* ifnames Invocation:: Listing the conditionals in source code
127 -* autoconf Invocation:: How to create configuration scripts
128 -* autoreconf Invocation:: Remaking multiple @command{configure} scripts
129 +* autoscan:: Semi-automatic @file{configure.ac} writing
130 +* ifnames:: Listing the conditionals in source code
131 +* autoconf:: How to create configuration scripts
132 +* autoreconf:: Remaking multiple @command{configure} scripts
135 @node Writing Autoconf Input
136 @@ -1025,7 +1015,7 @@
137 or specialized features, @file{configure.ac} might need to contain some
138 hand-crafted shell commands; see @ref{Portable Shell}. The
139 @command{autoscan} program can give you a good start in writing
140 -@file{configure.ac} (@pxref{autoscan Invocation}, for more information).
141 +@file{configure.ac} (@pxref{autoscan}, for more information).
143 Previous versions of Autoconf promoted the name @file{configure.in},
144 which is somewhat ambiguous (the tool needed to process this file is not
145 @@ -1281,7 +1271,7 @@
149 -@node autoscan Invocation
151 @section Using @command{autoscan} to Create @file{configure.ac}
152 @cindex @command{autoscan}
154 @@ -1303,7 +1293,7 @@
155 use a configuration header file, you must add a call to
156 @code{AC_CONFIG_HEADERS} (@pxref{Configuration Headers}). You might
157 also have to change or add some @code{#if} directives to your program in
158 -order to make it work with Autoconf (@pxref{ifnames Invocation}, for
159 +order to make it work with Autoconf (@pxref{ifnames}, for
160 information about a program that can help with that job).
162 When using @command{autoscan} to maintain a @file{configure.ac}, simply
163 @@ -1342,7 +1332,7 @@
164 Prepend @var{dir} to the include path. Multiple invocations accumulate.
167 -@node ifnames Invocation
169 @section Using @command{ifnames} to List Conditionals
170 @cindex @command{ifnames}
172 @@ -1351,8 +1341,7 @@
173 preprocessor conditionals. If a package has already been set up to have
174 some portability, @command{ifnames} can thus help you figure out what its
175 @command{configure} needs to check for. It may help fill in some gaps in a
176 -@file{configure.ac} generated by @command{autoscan} (@pxref{autoscan
178 +@file{configure.ac} generated by @command{autoscan} (@pxref{autoscan}).
180 @command{ifnames} scans all of the C source files named on the command line
181 (or the standard input, if none are given) and writes to the standard
182 @@ -1374,7 +1363,7 @@
183 Print the version number of Autoconf and exit.
186 -@node autoconf Invocation
188 @section Using @command{autoconf} to Create @command{configure}
189 @cindex @command{autoconf}
191 @@ -1468,8 +1457,7 @@
192 @cindex Macro invocation stack
193 Because @command{autoconf} uses @command{autom4te} behind the scenes, it
194 displays a back trace for errors, but not for warnings; if you want
195 -them, just pass @option{-W error}. @xref{autom4te Invocation}, for some
197 +them, just pass @option{-W error}. @xref{autom4te}, for some examples.
199 @item --trace=@var{macro}[:@var{format}]
200 @itemx -t @var{macro}[:@var{format}]
201 @@ -1481,7 +1469,7 @@
203 The @var{format} is a regular string, with newlines if desired, and
204 several special escape codes. It defaults to @samp{$f:$l:$n:$%}; see
205 -@ref{autom4te Invocation}, for details on the @var{format}.
206 +@ref{autom4te}, for details on the @var{format}.
208 @item --initialization
210 @@ -1555,7 +1543,7 @@
214 -@node autoreconf Invocation
216 @section Using @command{autoreconf} to Update @command{configure} Scripts
217 @cindex @command{autoreconf}
219 @@ -1592,8 +1580,8 @@
220 Gettext supplies the @command{autopoint} command to add translation
221 infrastructure to a source package. If you use @command{autopoint},
222 your @file{configure.ac} should invoke both @code{AM_GNU_GETTEXT} and
223 -@code{AM_GNU_GETTEXT_VERSION(@var{gettext-version})}. @xref{autopoint
224 -Invocation, , Invoking the @code{autopoint} Program, gettext,
225 +@code{AM_GNU_GETTEXT_VERSION(@var{gettext-version})}.
226 +@xref{autopoint, , Invoking the @code{autopoint} Program, gettext,
227 @acronym{GNU} @code{gettext} utilities}, for further details.
230 @@ -1897,8 +1885,8 @@
231 source directory; @command{configure} checks for this file's existence to
232 make sure that the directory that it is told contains the source code in
233 fact does. Occasionally people accidentally specify the wrong directory
234 -with @option{--srcdir}; this is a safety check. @xref{configure
235 -Invocation}, for more information.
236 +with @option{--srcdir}; this is a safety check. @xref{configure},
237 +for more information.
241 @@ -2111,7 +2099,7 @@
242 when used in @var{output}, or the standard input when used in the
243 @var{inputs}. You most probably don't need to use this in
244 @file{configure.ac}, but it is convenient when using the command line
245 -interface of @file{./config.status}, see @ref{config.status Invocation},
246 +interface of @file{./config.status}, see @ref{config.status},
249 The @var{inputs} may be absolute or relative file names. In the latter
250 @@ -2971,7 +2959,7 @@
251 so @file{config.status} ensures that @file{config.h} is considered up to
252 date. @xref{Output}, for more information about @code{AC_OUTPUT}.
254 -@xref{config.status Invocation}, for more examples of handling
255 +@xref{config.status}, for more examples of handling
256 configuration-related dependencies.
258 @node Configuration Headers
259 @@ -3051,7 +3039,7 @@
262 * Header Templates:: Input for the configuration headers
263 -* autoheader Invocation:: How to create configuration templates
264 +* autoheader:: How to create configuration templates
265 * Autoheader Macros:: How to specify CPP templates
268 @@ -3106,10 +3094,10 @@
269 comments in preprocessor macros has never been a good idea.
271 Since it is a tedious task to keep a template header up to date, you may
272 -use @command{autoheader} to generate it, see @ref{autoheader Invocation}.
273 +use @command{autoheader} to generate it, see @ref{autoheader}.
276 -@node autoheader Invocation
278 @subsection Using @command{autoheader} to Create @file{config.h.in}
279 @cindex @command{autoheader}
281 @@ -8749,7 +8737,7 @@
282 files depend upon @command{bizarre-cc} being the C compiler. If
283 for some reason the user runs @command{./configure} again, or if it is
284 run via @samp{./config.status --recheck}, (@xref{Automatic Remaking},
285 -and @pxref{config.status Invocation}), then the configuration can be
286 +and @pxref{config.status}), then the configuration can be
287 inconsistent, composed of results depending upon two different
290 @@ -8802,7 +8790,7 @@
293 @var{variable} is kept during automatic reconfiguration
294 -(@pxref{config.status Invocation}) as if it had been passed as a command
295 +(@pxref{config.status}) as if it had been passed as a command
296 line argument, including when no cache is used:
299 @@ -9790,11 +9778,11 @@
300 It supports M4 extensions designed for use in tools like Autoconf.
303 -* autom4te Invocation:: A @acronym{GNU} M4 wrapper
304 +* autom4te:: A @acronym{GNU} M4 wrapper
305 * Customizing autom4te:: Customizing the Autoconf package
308 -@node autom4te Invocation
310 @subsection Invoking @command{autom4te}
312 The command line arguments are modeled after M4's:
313 @@ -10052,7 +10040,7 @@
317 -@xref{autoconf Invocation}, for examples of trace uses.
318 +@xref{autoconf}, for examples of trace uses.
320 @item --preselect=@var{macro}
321 @itemx -p @var{macro}
322 @@ -10140,8 +10128,8 @@
323 wrapped in between a @samp{begin-language: "@var{language}"},
324 @samp{end-language: "@var{language}"} pair.
326 -Customizing a language stands for appending options (@pxref{autom4te
327 -Invocation}) to the current definition of the language. Options, and
328 +Customizing a language stands for appending options (@pxref{autom4te})
329 +to the current definition of the language. Options, and
330 more generally arguments, are introduced by @samp{args:
331 @var{arguments}}. You may use the traditional shell syntax to quote the
333 @@ -11785,7 +11773,7 @@
335 When the user runs @samp{autoconf -W error}, warnings from
336 @code{m4_warn} (including those issued through @code{AC_DIAGNOSE} and
337 -@code{AC_WARNING}) are reported as errors, see @ref{autoconf Invocation}.
338 +@code{AC_WARNING}) are reported as errors, see @ref{autoconf}.
340 @node Dependencies Between Macros
341 @section Dependencies Between Macros
342 @@ -17974,16 +17962,16 @@
343 * System Type:: Specifying the system type
344 * Sharing Defaults:: Setting site-wide defaults for @command{configure}
345 * Defining Variables:: Specifying the compiler etc.
346 -* configure Invocation:: Changing how @command{configure} runs
347 +* configure:: Changing how @command{configure} runs
351 @include install.texi
354 -@c ============================================== config.status Invocation
355 +@c ============================================== config.status
357 -@node config.status Invocation
359 @chapter config.status Invocation
360 @cindex @command{config.status}
362 @@ -18129,7 +18117,7 @@
364 * Obsolete config.status Use:: Obsolete convention for @command{config.status}
365 * acconfig Header:: Additional entries in @file{config.h.in}
366 -* autoupdate Invocation:: Automatic update of @file{configure.ac}
367 +* autoupdate:: Automatic update of @file{configure.ac}
368 * Obsolete Macros:: Backward compatibility macros
369 * Autoconf 1:: Tips for upgrading your files
370 * Autoconf 2.13:: Some fresher tips
371 @@ -18139,7 +18127,7 @@
372 @section Obsolete @file{config.status} Invocation
374 @file{config.status} now supports arguments to specify the files to
375 -instantiate; see @ref{config.status Invocation}, for more details.
376 +instantiate; see @ref{config.status}, for more details.
377 Before, environment variables had to be used.
379 @defvar CONFIG_COMMANDS
380 @@ -18170,7 +18158,7 @@
381 @file{config.status} ignores this variable.
384 -In @ref{config.status Invocation}, using this old interface, the example
385 +In @ref{config.status}, using this old interface, the example
389 @@ -18244,7 +18232,7 @@
390 self-contained, and should not depend upon @file{acconfig.h} etc.
393 -@node autoupdate Invocation
395 @section Using @command{autoupdate} to Modernize @file{configure.ac}
396 @cindex @command{autoupdate}
398 @@ -19389,7 +19377,7 @@
400 If you have an @file{aclocal.m4} installed with Autoconf (as opposed to
401 in a particular package's source directory), you must rename it to
402 -@file{acsite.m4}. @xref{autoconf Invocation}.
403 +@file{acsite.m4}. @xref{autoconf}.
405 If you distribute @file{install.sh} with your package, rename it to
406 @file{install-sh} so @code{make} builtin rules don't inadvertently
407 @@ -19444,7 +19432,7 @@
408 the documentation for them. @xref{Obsolete Macros}, for a table showing the
409 new names for the old macros. Use the @command{autoupdate} program to
410 convert your @file{configure.ac} to using the new macro names.
411 -@xref{autoupdate Invocation}.
414 Some macros have been superseded by similar ones that do the job better,
415 but are not call-compatible. If you get warnings about calling obsolete
416 @@ -19980,7 +19968,7 @@
418 * Using an Autotest Test Suite:: Autotest and the user
419 * Writing Testsuites:: Autotest macros
420 -* testsuite Invocation:: Running @command{testsuite} scripts
421 +* testsuite:: Running @command{testsuite} scripts
422 * Making testsuite Scripts:: Using autom4te to create @command{testsuite}
425 @@ -20042,7 +20030,7 @@
428 @item a debugging script named @file{run} which reruns the test in
429 -@dfn{debug mode} (@pxref{testsuite Invocation}). The automatic generation
430 +@dfn{debug mode} (@pxref{testsuite}). The automatic generation
431 of debugging scripts has the purpose of easing the chase for bugs.
433 @item all the files created with @code{AT_DATA}
434 @@ -20304,7 +20292,7 @@
438 -@node testsuite Invocation
440 @section Running @command{testsuite} Scripts
441 @cindex @command{testsuite}
443 @@ -20471,7 +20459,7 @@
444 An Autotest test suite is to be configured in @var{directory}. This
445 macro requires the instantiation of @file{@var{directory}/atconfig} from
446 @file{@var{directory}/atconfig.in}, and sets the default
447 -@code{AUTOTEST_PATH} to @var{test-path} (@pxref{testsuite Invocation}).
448 +@code{AUTOTEST_PATH} to @var{test-path} (@pxref{testsuite}).
452 @@ -20825,7 +20813,7 @@
453 which can be a long process for complex @file{configure.ac}.
455 This is why all these tools, instead of running directly M4, invoke
456 -@command{autom4te} (@pxref{autom4te Invocation}) which, while answering to
457 +@command{autom4te} (@pxref{autom4te}) which, while answering to
458 a specific demand, stores additional information in
459 @file{autom4te.cache} for future runs. For instance, if you run
460 @command{autoconf}, behind the scenes, @command{autom4te} also
461 --- autoconf-2.62/doc/install.texi.orig 2007-12-08 14:58:52.000000000 +0100
462 +++ autoconf-2.62/doc/install.texi 2008-04-16 20:34:45.697178391 +0200
464 CONFIG_SHELL=/bin/bash /bin/bash ./configure CONFIG_SHELL=/bin/bash
467 -@node configure Invocation
469 @section @command{configure} Invocation
471 @command{configure} recognizes the following options to control how it
472 --- autoconf-2.62/doc/standards.texi.orig 2008-04-04 15:16:45.000000000 +0200
473 +++ autoconf-2.62/doc/standards.texi 2008-04-16 20:39:27.317224488 +0200
475 @set lastupdate February 23, 2008
478 -@dircategory GNU organization
479 +@dircategory Miscellaneous:
481 -* Standards: (standards). GNU coding standards.
482 +* Standards: (standards). GNU coding standards
485 @c @setchapternewpage odd