]>
Commit | Line | Data |
---|---|---|
2fcb7ba1 JB |
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 |