/[autoconf]/autoconf/doc/autoconf.texi
ViewVC logotype

Diff of /autoconf/doc/autoconf.texi

Parent Directory Parent Directory | Revision Log Revision Log | View Patch Patch

revision 1.702 by akim, Sun Oct 27 18:24:51 2002 UTC revision 1.703 by akim, Tue Oct 29 08:09:05 2002 UTC
# Line 111  Software Foundation raise funds for GNU Line 111  Software Foundation raise funds for GNU
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
# Line 327  M4 Quotation Line 327  M4 Quotation
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
# Line 1221  disable warnings falling into @var{categ Line 1221  disable warnings falling into @var{categ
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}]
# Line 1250  just make @var{format} as long as needed Line 1244  just make @var{format} as long as needed
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
# Line 1398  Append @var{dir} to the include path.  M Line 1392  Append @var{dir} to the include path.  M
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    
# Line 7275  Yet another great name from Lars J. Aas. Line 7309  Yet another great name from Lars J. Aas.
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:
# Line 7629  lines are ignored.  Customization is per Line 7663  lines are ignored.  Customization is per
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}:
# Line 14461  actually means to compile it with M4, wh Line 14496  actually means to compile it with M4, wh
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

Legend:
Removed from v.1.702  
changed lines
  Added in v.1.703

savannah-hackers-public@gnu.org
ViewVC Help
Powered by ViewVC 1.1.26