111 |
Remaking multiple @command{configure} scripts |
Remaking multiple @command{configure} scripts |
112 |
* autoheader: (autoconf)autoheader Invocation. |
* autoheader: (autoconf)autoheader Invocation. |
113 |
How to create configuration templates |
How to create configuration templates |
114 |
* autom4te: (autoconf)Invoking autom4te. |
* autom4te: (autoconf)autom4te Invocation. |
115 |
The Autoconf executables backbone |
The Autoconf executables backbone |
116 |
* configure: (autoconf)configure Invocation. |
* configure: (autoconf)configure Invocation. |
117 |
Configuring a package |
Configuring a package |
327 |
|
|
328 |
Using @command{autom4te} |
Using @command{autom4te} |
329 |
|
|
330 |
* Invoking autom4te:: A GNU M4 wrapper |
* autom4te Invocation:: A GNU M4 wrapper |
331 |
* Customizing autom4te:: Customizing the Autoconf package |
* Customizing autom4te:: Customizing the Autoconf package |
332 |
|
|
333 |
Programming in M4sugar |
Programming in M4sugar |
1221 |
|
|
1222 |
Warnings about @samp{syntax} are enabled by default, and the environment |
Warnings about @samp{syntax} are enabled by default, and the environment |
1223 |
variable @code{WARNINGS}, a comma separated list of categories, is |
variable @code{WARNINGS}, a comma separated list of categories, is |
1224 |
honored. @samp{autoconf -W @var{category}} will actually |
honored. Passing @samp{-W @var{category}} will actually behave as if |
1225 |
behave as if you had run: |
you had passed @samp{--warnings=syntax,$WARNINGS,@var{category}}. If |
1226 |
|
you want to disable the defaults and @code{WARNINGS}, but (for example) |
1227 |
@example |
enable the warnings about obsolete constructs, you would use @option{-W |
1228 |
autoconf --warnings=syntax,$WARNINGS,@var{category} |
none,obsolete}. |
|
@end example |
|
|
|
|
|
@noindent |
|
|
If you want to disable @command{autoconf}'s defaults and @code{WARNINGS}, |
|
|
but (for example) enable the warnings about obsolete constructs, you |
|
|
would use @option{-W none,obsolete}. |
|
1229 |
|
|
1230 |
@cindex Back trace |
@cindex Back trace |
1231 |
@cindex Macro invocation stack |
@cindex Macro invocation stack |
1232 |
Because @command{autoconf} uses @command{autom4te} behind the scenes, it |
Because @command{autoconf} uses @command{autom4te} behind the scenes, it |
1233 |
displays a back trace for errors, but not for warnings; if you want |
displays a back trace for errors, but not for warnings; if you want |
1234 |
them, just pass @option{-W error}. @xref{Invoking autom4te}, for some |
them, just pass @option{-W error}. @xref{autom4te Invocation}, for some |
1235 |
examples. |
examples. |
1236 |
|
|
1237 |
@item --trace=@var{macro}[:@var{format}] |
@item --trace=@var{macro}[:@var{format}] |
1244 |
|
|
1245 |
The @var{format} is a regular string, with newlines if desired, and |
The @var{format} is a regular string, with newlines if desired, and |
1246 |
several special escape codes. It defaults to @samp{$f:$l:$n:$%}; see |
several special escape codes. It defaults to @samp{$f:$l:$n:$%}; see |
1247 |
@ref{Invoking autom4te}, for details on the @var{format}. |
@ref{autom4te Invocation}, for details on the @var{format}. |
1248 |
|
|
1249 |
@item --initialization |
@item --initialization |
1250 |
@itemx -i |
@itemx -i |
1392 |
@item --prepend-include=@var{dir} |
@item --prepend-include=@var{dir} |
1393 |
@item -B @var{dir} |
@item -B @var{dir} |
1394 |
Prepend @var{dir} to the include path. Multiple invocations accumulate. |
Prepend @var{dir} to the include path. Multiple invocations accumulate. |
1395 |
|
|
1396 |
|
@item --warnings=@var{category} |
1397 |
|
@itemx -W @var{category} |
1398 |
|
@evindex WARNINGS |
1399 |
|
Report the warnings related to @var{category} (which can actually be a |
1400 |
|
comma separated list). |
1401 |
|
|
1402 |
|
@table @samp |
1403 |
|
@item cross |
1404 |
|
related to cross compilation issues. |
1405 |
|
|
1406 |
|
@item obsolete |
1407 |
|
report the uses of obsolete constructs. |
1408 |
|
|
1409 |
|
@item portability |
1410 |
|
portability issues |
1411 |
|
|
1412 |
|
@item syntax |
1413 |
|
dubious syntactic constructs. |
1414 |
|
|
1415 |
|
@item all |
1416 |
|
report all the warnings |
1417 |
|
|
1418 |
|
@item none |
1419 |
|
report none |
1420 |
|
|
1421 |
|
@item error |
1422 |
|
treats warnings as errors |
1423 |
|
|
1424 |
|
@item no-@var{category} |
1425 |
|
disable warnings falling into @var{category} |
1426 |
|
@end table |
1427 |
|
|
1428 |
|
Warnings about @samp{syntax} are enabled by default, and the environment |
1429 |
|
variable @code{WARNINGS}, a comma separated list of categories, is |
1430 |
|
honored. Passing @samp{-W @var{category}} will actually behave as if |
1431 |
|
you had passed @samp{--warnings=syntax,$WARNINGS,@var{category}}. If |
1432 |
|
you want to disable the defaults and @code{WARNINGS}, but (for example) |
1433 |
|
enable the warnings about obsolete constructs, you would use @option{-W |
1434 |
|
none,obsolete}. |
1435 |
@end table |
@end table |
1436 |
|
|
1437 |
|
|
7309 |
@command{m4} itself. |
@command{m4} itself. |
7310 |
|
|
7311 |
@menu |
@menu |
7312 |
* Invoking autom4te:: A GNU M4 wrapper |
* autom4te Invocation:: A GNU M4 wrapper |
7313 |
* Customizing autom4te:: Customizing the Autoconf package |
* Customizing autom4te:: Customizing the Autoconf package |
7314 |
@end menu |
@end menu |
7315 |
|
|
7316 |
@node Invoking autom4te |
@node autom4te Invocation |
7317 |
@subsection Invoking @command{autom4te} |
@subsection Invoking @command{autom4te} |
7318 |
|
|
7319 |
The command line arguments are modeled after M4's: |
The command line arguments are modeled after M4's: |
7663 |
wrapped in between a @samp{begin-language: "@var{language}"}, |
wrapped in between a @samp{begin-language: "@var{language}"}, |
7664 |
@samp{end-language: "@var{language}"} pair. |
@samp{end-language: "@var{language}"} pair. |
7665 |
|
|
7666 |
Customizing a language stands for appending options (@pxref{Invoking |
Customizing a language stands for appending options (@pxref{autom4te |
7667 |
autom4te}) to the current definition of the language. Options, and more |
Invocation}) to the current definition of the language. Options, and |
7668 |
generally arguments, are introduced by @samp{args: @var{arguments}}. |
more generally arguments, are introduced by @samp{args: |
7669 |
You may use the traditional shell syntax to quote the @var{arguments}. |
@var{arguments}}. You may use the traditional shell syntax to quote the |
7670 |
|
@var{arguments}. |
7671 |
|
|
7672 |
As an example, to disable Autoconf caches (@file{autom4te.cache}) |
As an example, to disable Autoconf caches (@file{autom4te.cache}) |
7673 |
globally, include the following lines in @file{~/.autom4te.cfg}: |
globally, include the following lines in @file{~/.autom4te.cfg}: |
14496 |
for complex @file{configure.ac}. |
for complex @file{configure.ac}. |
14497 |
|
|
14498 |
This is why all these tools, instead of running directly M4, invoke |
This is why all these tools, instead of running directly M4, invoke |
14499 |
@command{autom4te} (@pxref{Invoking autom4te}) which, while answering to |
@command{autom4te} (@pxref{autom4te Invocation}) which, while answering to |
14500 |
a specific demand, stores additional information in |
a specific demand, stores additional information in |
14501 |
@file{autom4te.cache} for future runs. For instance, if you run |
@file{autom4te.cache} for future runs. For instance, if you run |
14502 |
@command{autoconf}, behind the scenes, @command{autom4te} will also |
@command{autoconf}, behind the scenes, @command{autom4te} will also |