]>
Commit | Line | Data |
---|---|---|
92a91d3d JB |
1 | diff -Nur autoconf-2.50.orig/doc/autoconf.texi autoconf-2.50/doc/autoconf.texi |
2 | --- autoconf-2.50.orig/doc/autoconf.texi Fri Jun 15 14:57:50 2001 | |
3 | +++ autoconf-2.50/doc/autoconf.texi Fri Jun 15 15:21:46 2001 | |
4 | @@ -27,25 +27,20 @@ | |
5 | @end ifnothtml | |
6 | ||
7 | ||
8 | -@dircategory GNU admin | |
9 | +@dircategory Programming tools: | |
10 | @direntry | |
11 | -* Autoconf: (autoconf). Create source code configuration scripts | |
12 | +* Autoconf: (autoconf). Create source code configuration scripts | |
13 | @end direntry | |
14 | ||
15 | @dircategory Individual utilities | |
16 | @direntry | |
17 | -* autoscan: (autoconf)autoscan Invocation. | |
18 | - Semi-automatic @file{configure.ac} writing | |
19 | -* ifnames: (autoconf)ifnames Invocation. | |
20 | - Listing the conditionals in source code | |
21 | -* autoconf: (autoconf)autoconf Invocation. | |
22 | - How to create configuration scripts | |
23 | -* autoreconf: (autoconf)autoreconf Invocation. | |
24 | - Remaking multiple @code{configure} scripts | |
25 | -* configure: (autoconf)configure Invocation. | |
26 | - Configuring a package | |
27 | -* config.status: (autoconf)config.status Invocation. | |
28 | - Recreating a configuration | |
29 | +* autoscan: (autoconf)autoscan. Semi-automatic @file{configure.ac} writing | |
30 | +* ifnames: (autoconf)ifnames. Listing the conditionals in source code | |
31 | +* autoconf: (autoconf)autoconf. How to create configuration scripts | |
32 | +* autoreconf: (autoconf)autoreconf. Remaking multiple @code{configure} scripts | |
33 | +* configure: (autoconf)configure. Configuring a package | |
34 | +* config.status: (autoconf)config.status. | |
35 | + Recreating a configuration | |
36 | @end direntry | |
0b43610d | 37 | |
38 | @ifinfo | |
92a91d3d JB |
39 | @@ -142,7 +137,7 @@ |
40 | * Manual Configuration:: Selecting features that can't be guessed | |
41 | * Site Configuration:: Local defaults for @code{configure} | |
42 | * Running configure scripts:: How to use the Autoconf output | |
43 | -* config.status Invocation:: Recreating a configuration | |
44 | +* config.status:: Recreating a configuration | |
45 | * Obsolete Constructs:: Kept for backward compatibility | |
46 | * Questions:: Questions about Autoconf, with answers | |
47 | * History:: History of Autoconf | |
48 | @@ -164,10 +159,10 @@ | |
49 | Making @code{configure} Scripts | |
50 | ||
51 | * Writing configure.ac:: What to put in an Autoconf input file | |
52 | -* autoscan Invocation:: Semi-automatic @file{configure.ac} writing | |
53 | -* ifnames Invocation:: Listing the conditionals in source code | |
54 | -* autoconf Invocation:: How to create configuration scripts | |
55 | -* autoreconf Invocation:: Remaking multiple @code{configure} scripts | |
56 | +* autoscan:: Semi-automatic @file{configure.ac} writing | |
57 | +* ifnames:: Listing the conditionals in source code | |
58 | +* autoconf:: How to create configuration scripts | |
59 | +* autoreconf:: Remaking multiple @code{configure} scripts | |
60 | ||
61 | Writing @file{configure.ac} | |
62 | ||
63 | @@ -199,7 +194,7 @@ | |
64 | Configuration Header Files | |
65 | ||
66 | * Header Templates:: Input for the configuration headers | |
67 | -* autoheader Invocation:: How to create configuration templates | |
68 | +* autoheader:: How to create configuration templates | |
69 | * Autoheader Macros:: How to specify CPP templates | |
70 | ||
71 | Existing Tests | |
72 | @@ -348,13 +343,13 @@ | |
73 | * System Type:: Specifying the system type | |
74 | * Sharing Defaults:: Setting site-wide defaults for @code{configure} | |
75 | * Environment Variables:: Defining environment variables. | |
76 | -* configure Invocation:: Changing how @code{configure} runs | |
77 | +* configure:: Changing how @code{configure} runs | |
78 | ||
79 | Obsolete Constructs | |
80 | ||
81 | * Obsolete config.status Use:: Different calling convention | |
82 | * acconfig.h:: Additional entries in @file{config.h.in} | |
83 | -* autoupdate Invocation:: Automatic update of @file{configure.ac} | |
84 | +* autoupdate:: Automatic update of @file{configure.ac} | |
85 | * Obsolete Macros:: Backward compatibility macros | |
86 | * Autoconf 1:: Tips for upgrading your files | |
87 | ||
88 | @@ -652,7 +647,7 @@ | |
89 | ||
90 | @item | |
91 | a shell script called @file{config.status} that, when run, will recreate | |
92 | -the files listed above (@pxref{config.status Invocation}); | |
93 | +the files listed above (@pxref{config.status}); | |
94 | ||
95 | @item | |
96 | an optional shell script normally called @file{config.cache} | |
97 | @@ -712,13 +707,13 @@ | |
98 | ||
99 | @menu | |
100 | * Writing configure.ac:: What to put in an Autoconf input file | |
101 | -* autoscan Invocation:: Semi-automatic @file{configure.ac} writing | |
102 | -* ifnames Invocation:: Listing the conditionals in source code | |
103 | -* autoconf Invocation:: How to create configuration scripts | |
104 | -* autoreconf Invocation:: Remaking multiple @code{configure} scripts | |
105 | +* autoscan:: Semi-automatic @file{configure.ac} writing | |
106 | +* ifnames:: Listing the conditionals in source code | |
107 | +* autoconf:: How to create configuration scripts | |
108 | +* autoreconf:: Remaking multiple @code{configure} scripts | |
109 | @end menu | |
110 | ||
111 | -@node Writing configure.ac, autoscan Invocation, Making configure Scripts, Making configure Scripts | |
112 | +@node Writing configure.ac, autoscan, Making configure Scripts, Making configure Scripts | |
113 | @section Writing @file{configure.ac} | |
114 | ||
115 | To produce a @code{configure} script for a software package, create a | |
116 | @@ -730,7 +725,7 @@ | |
117 | @ref{Writing Tests}, for information about them. For especially tricky | |
118 | or specialized features, @file{configure.ac} might need to contain some | |
119 | hand-crafted shell commands. The @code{autoscan} program can give you a | |
120 | -good start in writing @file{configure.ac} (@pxref{autoscan Invocation}, | |
121 | +good start in writing @file{configure.ac} (@pxref{autoscan}, | |
122 | for more information). | |
123 | ||
124 | Previous versions of Autoconf promoted the name @file{configure.in}, | |
125 | @@ -959,7 +954,7 @@ | |
126 | @end display | |
127 | ||
128 | ||
129 | -@node autoscan Invocation, ifnames Invocation, Writing configure.ac, Making configure Scripts | |
130 | +@node autoscan, ifnames, Writing configure.ac, Making configure Scripts | |
131 | @section Using @code{autoscan} to Create @file{configure.ac} | |
132 | @cindex @code{autoscan} | |
133 | ||
134 | @@ -979,7 +974,7 @@ | |
135 | configuration header file, you must add a call to | |
136 | @code{AC_CONFIG_HEADERS} (@pxref{Configuration Headers}). You might also | |
137 | have to change or add some @code{#if} directives to your program in | |
138 | -order to make it work with Autoconf (@pxref{ifnames Invocation}, for | |
139 | +order to make it work with Autoconf (@pxref{ifnames}, for | |
140 | information about a program that can help with that job). | |
141 | ||
142 | @code{autoscan} uses several data files (installed along with Autoconf) | |
143 | @@ -1017,7 +1012,7 @@ | |
144 | plays with different versions of Autoconf simultaneously. | |
145 | @end table | |
146 | ||
147 | -@node ifnames Invocation, autoconf Invocation, autoscan Invocation, Making configure Scripts | |
148 | +@node ifnames, autoconf, autoscan, Making configure Scripts | |
149 | @section Using @code{ifnames} to List Conditionals | |
150 | @cindex @code{ifnames} | |
151 | ||
152 | @@ -1026,8 +1021,7 @@ | |
153 | preprocessor conditionals. If a package has already been set up to have | |
154 | some portability, @code{ifnames} can thus help you figure out what its | |
155 | @code{configure} needs to check for. It may help fill in some gaps in a | |
156 | -@file{configure.ac} generated by @code{autoscan} (@pxref{autoscan | |
157 | -Invocation}). | |
158 | +@file{configure.ac} generated by @code{autoscan} (@pxref{autoscan}). | |
159 | ||
160 | @code{ifnames} scans all of the C source files named on the command line | |
161 | (or the standard input, if none are given) and writes to the standard | |
162 | @@ -1049,7 +1043,7 @@ | |
163 | Print the version number of Autoconf and exit. | |
164 | @end table | |
165 | ||
166 | -@node autoconf Invocation, autoreconf Invocation, ifnames Invocation, Making configure Scripts | |
167 | +@node autoconf, autoreconf, ifnames, Making configure Scripts | |
168 | @section Using @code{autoconf} to Create @code{configure} | |
169 | @cindex @code{autoconf} | |
170 | ||
171 | @@ -1311,7 +1305,7 @@ | |
172 | @end group | |
173 | @end example | |
174 | ||
175 | -@node autoreconf Invocation, , autoconf Invocation, Making configure Scripts | |
176 | +@node autoreconf, , autoconf, Making configure Scripts | |
177 | @section Using @code{autoreconf} to Update @code{configure} Scripts | |
178 | @cindex @code{autoreconf} | |
179 | ||
180 | @@ -1533,8 +1527,8 @@ | |
181 | source directory; @code{configure} checks for this file's existence to | |
182 | make sure that the directory that it is told contains the source code in | |
183 | fact does. Occasionally people accidentally specify the wrong directory | |
184 | -with @option{--srcdir}; this is a safety check. @xref{configure | |
185 | -Invocation}, for more information. | |
186 | +with @option{--srcdir}; this is a safety check. @xref{configure}, | |
187 | +for more information. | |
188 | @end defmac | |
189 | ||
190 | ||
191 | @@ -1719,7 +1713,7 @@ | |
192 | when used in @var{output}, or the standard input when used in the | |
193 | @var{inputs}. You most probably don't need to use this in | |
194 | @file{configure.ac}, but it is convenient when using the command line | |
195 | -interface of @file{./config.status}, see @ref{config.status Invocation}, | |
196 | +interface of @file{./config.status}, see @ref{config.status}, | |
197 | for more details. | |
198 | ||
199 | The @var{inputs} may be absolute or relative filenames. In the latter | |
200 | @@ -2185,7 +2179,7 @@ | |
201 | @file{config.h} is considered up to date. @xref{Output}, for more | |
202 | information about @code{AC_OUTPUT}. | |
203 | ||
204 | -@xref{config.status Invocation}, for more examples of handling | |
205 | +@xref{config.status}, for more examples of handling | |
206 | configuration-related dependencies. | |
207 | ||
208 | @node Configuration Headers, Configuration Commands, Makefile Substitutions, Setup | |
209 | @@ -2246,11 +2240,11 @@ | |
210 | ||
211 | @menu | |
212 | * Header Templates:: Input for the configuration headers | |
213 | -* autoheader Invocation:: How to create configuration templates | |
214 | +* autoheader:: How to create configuration templates | |
215 | * Autoheader Macros:: How to specify CPP templates | |
216 | @end menu | |
217 | ||
218 | -@node Header Templates, autoheader Invocation, Configuration Headers, Configuration Headers | |
219 | +@node Header Templates, autoheader, Configuration Headers, Configuration Headers | |
220 | @subsection Configuration Header Templates | |
221 | @cindex Configuration Header Template | |
222 | @cindex @file{config.h.in} | |
223 | @@ -2297,10 +2291,10 @@ | |
224 | @samp{#undef} is strongly discouraged. | |
225 | ||
226 | Since it is a tedious task to keep a template header up to date, you may | |
227 | -use @code{autoheader} to generate it, see @ref{autoheader Invocation}. | |
228 | +use @code{autoheader} to generate it, see @ref{autoheader}. | |
229 | ||
230 | ||
231 | -@node autoheader Invocation, Autoheader Macros, Header Templates, Configuration Headers | |
232 | +@node autoheader, Autoheader Macros, Header Templates, Configuration Headers | |
233 | @subsection Using @code{autoheader} to Create @file{config.h.in} | |
234 | @cindex @code{autoheader} | |
235 | ||
236 | @@ -2405,7 +2399,7 @@ | |
237 | ||
238 | ||
239 | ||
240 | -@node Autoheader Macros, , autoheader Invocation, Configuration Headers | |
241 | +@node Autoheader Macros, , autoheader, Configuration Headers | |
242 | @subsection Autoheader Macros | |
243 | ||
244 | @code{autoheader} scans @file{configure.ac} and figures out which C | |
245 | @@ -7854,7 +7848,7 @@ | |
246 | ||
247 | When the user runs @samp{autoconf -W error}, warnings from | |
248 | @code{AC_DIAGNOSE} and @code{AC_WARNING} are reported as error, see | |
249 | -@ref{autoconf Invocation}. | |
250 | +@ref{autoconf}. | |
251 | ||
252 | @node Dependencies Between Macros, Obsoleting Macros, Reporting Messages, Writing Macros | |
253 | @section Dependencies Between Macros | |
254 | @@ -8892,7 +8886,7 @@ | |
255 | ||
256 | @c ============================================== Running configure Scripts. | |
257 | ||
258 | -@node Running configure scripts, config.status Invocation, Site Configuration, Top | |
259 | +@node Running configure scripts, config.status, Site Configuration, Top | |
260 | @chapter Running @code{configure} Scripts | |
261 | @cindex @code{configure} | |
262 | ||
263 | @@ -8910,7 +8904,7 @@ | |
264 | * System Type:: Specifying the system type | |
265 | * Sharing Defaults:: Setting site-wide defaults for @code{configure} | |
266 | * Environment Variables:: Defining environment variables. | |
267 | -* configure Invocation:: Changing how @code{configure} runs | |
268 | +* configure:: Changing how @code{configure} runs | |
269 | @end menu | |
270 | ||
271 | @include install.texi | |
272 | @@ -8918,7 +8912,7 @@ | |
273 | ||
274 | @c ============================================== Recreating a Configuration | |
275 | ||
276 | -@node config.status Invocation, Obsolete Constructs, Running configure scripts, Top | |
277 | +@node config.status, Obsolete Constructs, Running configure scripts, Top | |
278 | @chapter Recreating a Configuration | |
279 | @cindex @code{config.status} | |
280 | ||
281 | @@ -9037,7 +9031,7 @@ | |
282 | ||
283 | @c =================================================== Obsolete Constructs | |
284 | ||
285 | -@node Obsolete Constructs, Questions, config.status Invocation, Top | |
286 | +@node Obsolete Constructs, Questions, config.status, Top | |
287 | @chapter Obsolete Constructs | |
288 | ||
289 | Autoconf changes, and throughout the years some constructs are obsoleted. | |
290 | @@ -9051,7 +9045,7 @@ | |
291 | @menu | |
292 | * Obsolete config.status Use:: Different calling convention | |
293 | * acconfig.h:: Additional entries in @file{config.h.in} | |
294 | -* autoupdate Invocation:: Automatic update of @file{configure.ac} | |
295 | +* autoupdate:: Automatic update of @file{configure.ac} | |
296 | * Obsolete Macros:: Backward compatibility macros | |
297 | * Autoconf 1:: Tips for upgrading your files | |
298 | @end menu | |
299 | @@ -9060,7 +9054,7 @@ | |
300 | @section Obsolete @file{config.status} Invocation | |
301 | ||
302 | @file{config.status} now supports arguments to specify the files to | |
303 | -instantiate, see @ref{config.status Invocation}, for more details. | |
304 | +instantiate, see @ref{config.status}, for more details. | |
305 | Before, environment variables had to be used. | |
306 | ||
307 | @defvar CONFIG_COMMANDS | |
308 | @@ -9091,7 +9085,7 @@ | |
309 | @file{config.status} ignores this variable. | |
310 | @end defvar | |
311 | ||
312 | -In @ref{config.status Invocation}, using this old interface, the example | |
313 | +In @ref{config.status}, using this old interface, the example | |
314 | would be: | |
315 | ||
316 | @example | |
317 | @@ -9114,7 +9108,7 @@ | |
318 | for @code{CONFIG_COMMANDS} etc.) | |
319 | ||
320 | ||
321 | -@node acconfig.h, autoupdate Invocation, Obsolete config.status Use, Obsolete Constructs | |
322 | +@node acconfig.h, autoupdate, Obsolete config.status Use, Obsolete Constructs | |
323 | @section @file{acconfig.h} | |
324 | ||
325 | @cindex @file{acconfig.h} | |
326 | @@ -9165,7 +9159,7 @@ | |
327 | self-contained, and should not depend upon @file{acconfig.h} etc. | |
328 | ||
329 | ||
330 | -@node autoupdate Invocation, Obsolete Macros, acconfig.h, Obsolete Constructs | |
331 | +@node autoupdate, Obsolete Macros, acconfig.h, Obsolete Constructs | |
332 | @section Using @code{autoupdate} to Modernize @file{configure.ac} | |
333 | @cindex @code{autoupdate} | |
334 | ||
335 | @@ -9223,7 +9217,7 @@ | |
336 | instead of in the current directory. | |
337 | @end table | |
338 | ||
339 | -@node Obsolete Macros, Autoconf 1, autoupdate Invocation, Obsolete Constructs | |
340 | +@node Obsolete Macros, Autoconf 1, autoupdate, Obsolete Constructs | |
341 | @section Obsolete Macros | |
342 | ||
343 | Several macros are obsoleted in Autoconf, for various reasons (typically | |
344 | @@ -9987,7 +9981,7 @@ | |
345 | ||
346 | If you have an @file{aclocal.m4} installed with Autoconf (as opposed to | |
347 | in a particular package's source directory), you must rename it to | |
348 | -@file{acsite.m4}. @xref{autoconf Invocation}. | |
349 | +@file{acsite.m4}. @xref{autoconf}. | |
350 | ||
351 | If you distribute @file{install.sh} with your package, rename it to | |
352 | @file{install-sh} so @code{make} builtin rules won't inadvertently | |
353 | @@ -10042,7 +10036,7 @@ | |
354 | the documentation for them. @xref{Obsolete Macros}, for a table showing the | |
355 | new names for the old macros. Use the @code{autoupdate} program to | |
356 | convert your @file{configure.ac} to using the new macro names. | |
357 | -@xref{autoupdate Invocation}. | |
358 | +@xref{autoupdate}. | |
359 | ||
360 | Some macros have been superseded by similar ones that do the job better, | |
361 | but are not call-compatible. If you get warnings about calling obsolete | |
362 | diff -Nur autoconf-2.50.orig/doc/install.texi autoconf-2.50/doc/install.texi | |
363 | --- autoconf-2.50.orig/doc/install.texi Mon Mar 19 15:28:42 2001 | |
364 | +++ autoconf-2.50/doc/install.texi Fri Jun 15 15:26:39 2001 | |
365 | @@ -215,8 +215,8 @@ | |
366 | overridden in the site shell script). | |
367 | ||
368 | ||
369 | -@node configure Invocation | |
370 | -@section @code{configure} Invocation | |
371 | +@node configure | |
372 | +@section @code{configure} | |
0b43610d | 373 | |
92a91d3d JB |
374 | @code{configure} recognizes the following options to control how it |
375 | operates. |