/[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.640 by akim, Wed Jul 17 08:17:29 2002 UTC revision 1.641 by eggert, Wed Jul 17 08:30:43 2002 UTC
# Line 1089  symbols it finds in them.  This output c Line 1089  symbols it finds in them.  This output c
1089    
1090  @item --include=@var{dir}  @item --include=@var{dir}
1091  @itemx -I @var{dir}  @itemx -I @var{dir}
1092  Also look for input files in @var{dir}.  Multiple invocations  Append @var{dir} to the include path.  Multiple invocations accumulate.
1093  accumulate.  Directories are browsed from last to first.  
1094    @item --prepend-include=@var{dir}
1095    @item -B @var{dir}
1096    Prepend @var{dir} to the include path.  Multiple invocations accumulate.
1097  @end table  @end table
1098    
1099  @node ifnames Invocation  @node ifnames Invocation
# Line 1174  Remake @file{configure} even if newer th Line 1177  Remake @file{configure} even if newer th
1177    
1178  @item --include=@var{dir}  @item --include=@var{dir}
1179  @itemx -I @var{dir}  @itemx -I @var{dir}
1180  Also look for input files in @var{dir}.  Multiple invocations  Append @var{dir} to the include path.  Multiple invocations accumulate.
1181  accumulate.  Directories are browsed from last to first.  
1182    @item --prepend-include=@var{dir}
1183    @item -B @var{dir}
1184    Prepend @var{dir} to the include path.  Multiple invocations accumulate.
1185    
1186    After searching any directories specified using @option{--prepend-include}
1187    or @option{--include}, @command{autoconf} will also search the directories
1188    specified in the @code{AC_MACRO_PATH} environment variable, if set.
1189    And finally, @command{autoconf} will also search the system-wide site
1190    macro directory, which is set to
1191    @samp{$@{datadir@}/autoconf/site_macros/autoconf} by default.
1192    
1193  @item --output=@var{file}  @item --output=@var{file}
1194  @itemx -o @var{file}  @itemx -o @var{file}
# Line 1447  Instead of copying missing auxiliary fil Line 1460  Instead of copying missing auxiliary fil
1460    
1461  @item --include=@var{dir}  @item --include=@var{dir}
1462  @itemx -I @var{dir}  @itemx -I @var{dir}
1463  Also look for input files in @var{dir}.  Multiple invocations  Append @var{dir} to the include path.  Multiple invocations accumulate.
1464  accumulate.  Directories are browsed from last to first.  
1465    @item --prepend-include=@var{dir}
1466    @item -B @var{dir}
1467    Prepend @var{dir} to the include path.  Multiple invocations accumulate.
1468  @end table  @end table
1469    
1470    
# Line 2533  Remake the template file even if newer t Line 2549  Remake the template file even if newer t
2549    
2550  @item --include=@var{dir}  @item --include=@var{dir}
2551  @itemx -I @var{dir}  @itemx -I @var{dir}
2552  Also look for input files in @var{dir}.  Multiple invocations accumulate.  Append @var{dir} to include path.  Multiple invocations accumulate.
2553  Directories are browsed from last to first.  
2554    @item --prepend-include=@var{dir}
2555    @item -B @var{dir}
2556    Prepend @var{dir} to include path.  Multiple invocations accumulate.
2557    
2558  @item --warnings=@var{category}  @item --warnings=@var{category}
2559  @itemx -W @var{category}  @itemx -W @var{category}
# Line 7114  Don't remove the temporary files and be Line 7133  Don't remove the temporary files and be
7133  @item --include=@var{dir}  @item --include=@var{dir}
7134  @itemx -I @var{dir}  @itemx -I @var{dir}
7135  Also look for input files in @var{dir}.  Multiple invocations  Also look for input files in @var{dir}.  Multiple invocations
7136  accumulate.  Contrary to M4 but in agreement with common sense,  accumulate.
 directories are browsed from last to first.  
7137    
7138  @item --output=@var{file}  @item --output=@var{file}
7139  @itemx -o @var{file}  @itemx -o @var{file}
# Line 7375  create Autotest executable test suites. Line 7393  create Autotest executable test suites.
7393  @item Autoconf  @item Autoconf
7394  create Autoconf executable configure scripts.  create Autoconf executable configure scripts.
7395  @end table  @end table
7396    
7397    @item --prepend-include=@var{dir}
7398    @item -B @var{dir}
7399    Prepend directory @var{dir} to the search path.  This is used to include
7400    the language-specific files before any third-party macros.
7401    
7402    @item --include-envvar=@var{envvar}
7403    Add directories specified in the environment variable @var{envvar} to
7404    the search path.
7405    
7406    @item --site-macro-subdir=@var{subdir}
7407    If the site macro directory is set, add the subdirectory @var{subdir}
7408    of the site macro directory to the search path.
7409  @end table  @end table
7410    
7411  @cindex @file{autom4te.cfg}  @cindex @file{autom4te.cfg}
7412  As an example, if Autoconf is installed in its default location,  As an example, if Autoconf is installed in its default location,
7413  @file{/usr/local}, running @samp{autom4te -l m4sugar foo.m4} is strictly  @file{/usr/local}, running @samp{autom4te -l m4sugar foo.m4} is
7414  equivalent to running @samp{autom4te --include /usr/local/share/autoconf  strictly equivalent to running @samp{autom4te --prepend-include
7415  m4sugar/m4sugar.m4f --warning syntax foo.m4}.  Recursive expansion  /usr/local/share/autoconf m4sugar/m4sugar.m4f --warning syntax foo.m4}.
7416  applies: running @samp{autom4te -l m4sh foo.m4}, is the same as  Recursive expansion applies: running @samp{autom4te -l m4sh foo.m4},
7417  @samp{autom4te --language M4sugar m4sugar/m4sh.m4f foo.m4}, i.e.,  is the same as @samp{autom4te --language M4sugar m4sugar/m4sh.m4f
7418  @samp{autom4te --include /usr/local/share/autoconf m4sugar/m4sugar.m4f  foo.m4}, i.e., @samp{autom4te --prepend-include /usr/local/share/autoconf
7419  m4sugar/m4sh.m4f --mode 777 foo.m4}.  The definition of the languages is  m4sugar/m4sugar.m4f m4sugar/m4sh.m4f --mode 777 foo.m4}.  The definition
7420  stored in @file{autom4te.cfg}.  of the languages is stored in @file{autom4te.cfg}.
7421    
7422    
7423  @node Programming in M4sugar  @node Programming in M4sugar

Legend:
Removed from v.1.640  
changed lines
  Added in v.1.641

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