255 lines
7.5 KiB
HTML
255 lines
7.5 KiB
HTML
|
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
|
<HTML><HEAD><TITLE>Man page of AUTOM4TE</TITLE>
|
|
</HEAD><BODY>
|
|
<H1>AUTOM4TE</H1>
|
|
Section: User Commands (1)<BR>Updated: January 2020<BR><A HREF="#index">Index</A>
|
|
<A HREF="/cgi-bin/man/man2html">Return to Main Contents</A><HR>
|
|
|
|
<A NAME="lbAB"> </A>
|
|
<H2>NAME</H2>
|
|
|
|
autom4te - Generate files and scripts thanks to M4
|
|
<A NAME="lbAC"> </A>
|
|
<H2>SYNOPSIS</H2>
|
|
|
|
<B>autom4te</B>
|
|
|
|
[<I>,OPTION/</I>]... [<I>,FILES/</I>]
|
|
<A NAME="lbAD"> </A>
|
|
<H2>DESCRIPTION</H2>
|
|
|
|
Run GNU M4 on the FILES, avoiding useless runs. Output the traces if tracing,
|
|
the frozen file if freezing, otherwise the expansion of the FILES.
|
|
<P>
|
|
|
|
If some of the FILES are named `FILE.m4f' they are considered to be M4
|
|
frozen files of all the previous files (which are therefore not loaded).
|
|
If `FILE.m4f' is not found, then `FILE.m4' will be used, together with
|
|
all the previous files.
|
|
<P>
|
|
|
|
Some files may be optional, i.e., will only be processed if found in the
|
|
include path, but then must end in `.m4?'; the question mark is not part of
|
|
the actual file name.
|
|
<A NAME="lbAE"> </A>
|
|
<H3>Operation modes:</H3>
|
|
|
|
<DL COMPACT>
|
|
<DT id="1"><B>-h</B>, <B>--help</B><DD>
|
|
print this help, then exit
|
|
<DT id="2"><B>-V</B>, <B>--version</B><DD>
|
|
print version number, then exit
|
|
<DT id="3"><B>-v</B>, <B>--verbose</B><DD>
|
|
verbosely report processing
|
|
<DT id="4"><B>-d</B>, <B>--debug</B><DD>
|
|
don't remove temporary files
|
|
<DT id="5"><B>-o</B>, <B>--output</B>=<I>,FILE/</I><DD>
|
|
save output in FILE (defaults to `-', stdout)
|
|
<DT id="6"><B>-f</B>, <B>--force</B><DD>
|
|
don't rely on cached values
|
|
<DT id="7"><B>-W</B>, <B>--warnings</B>=<I>,CATEGORY/</I><DD>
|
|
report the warnings falling in CATEGORY
|
|
<DT id="8"><B>-l</B>, <B>--language</B>=<I>,LANG/</I><DD>
|
|
specify the set of M4 macros to use
|
|
<DT id="9"><B>-C</B>, <B>--cache</B>=<I>,DIRECTORY/</I><DD>
|
|
preserve results for future runs in DIRECTORY
|
|
<DT id="10"><B>--no-cache</B><DD>
|
|
disable the cache
|
|
<DT id="11"><B>-m</B>, <B>--mode</B>=<I>,OCTAL/</I><DD>
|
|
change the non trace output file mode (0666)
|
|
<DT id="12"><B>-M</B>, <B>--melt</B><DD>
|
|
don't use M4 frozen files
|
|
</DL>
|
|
<A NAME="lbAF"> </A>
|
|
<H3>Languages include:</H3>
|
|
|
|
<DL COMPACT>
|
|
<DT id="13">`Autoconf'<DD>
|
|
create Autoconf configure scripts
|
|
<DT id="14">`Autotest'<DD>
|
|
create Autotest test suites
|
|
<DT id="15">`M4sh'<DD>
|
|
create M4sh shell scripts
|
|
<DT id="16">`M4sugar'<DD>
|
|
create M4sugar output
|
|
</DL>
|
|
<A NAME="lbAG"> </A>
|
|
<H3>Warning categories include:</H3>
|
|
|
|
<DL COMPACT>
|
|
<DT id="17">`cross'<DD>
|
|
cross compilation issues
|
|
<DT id="18">`gnu'<DD>
|
|
GNU coding standards (default in gnu and gnits modes)
|
|
<DT id="19">`obsolete'<DD>
|
|
obsolete features or constructions
|
|
<DT id="20">`override'<DD>
|
|
user redefinitions of Automake rules or variables
|
|
<DT id="21">`portability'<DD>
|
|
portability issues (default in gnu and gnits modes)
|
|
<DT id="22">`syntax'<DD>
|
|
dubious syntactic constructs (default)
|
|
<DT id="23">`unsupported'<DD>
|
|
unsupported or incomplete features (default)
|
|
<DT id="24">`all'<DD>
|
|
all the warnings
|
|
<DT id="25">`no-CATEGORY'<DD>
|
|
turn off warnings in CATEGORY
|
|
<DT id="26">`none'<DD>
|
|
turn off all the warnings
|
|
<DT id="27">`error'<DD>
|
|
treat warnings as errors
|
|
</DL>
|
|
<P>
|
|
|
|
The environment variables `M4' and `WARNINGS' are honored.
|
|
<A NAME="lbAH"> </A>
|
|
<H3>Library directories:</H3>
|
|
|
|
<DL COMPACT>
|
|
<DT id="28"><B>-B</B>, <B>--prepend-include</B>=<I>,DIR/</I><DD>
|
|
prepend directory DIR to search path
|
|
<DT id="29"><B>-I</B>, <B>--include</B>=<I>,DIR/</I><DD>
|
|
append directory DIR to search path
|
|
</DL>
|
|
<A NAME="lbAI"> </A>
|
|
<H3>Tracing:</H3>
|
|
|
|
<DL COMPACT>
|
|
<DT id="30"><B>-t</B>, <B>--trace</B>=<I>,MACRO[/</I>:FORMAT]<DD>
|
|
report the MACRO invocations
|
|
<DT id="31"><B>-p</B>, <B>--preselect</B>=<I>,MACRO/</I><DD>
|
|
prepare to trace MACRO in a future run
|
|
</DL>
|
|
<A NAME="lbAJ"> </A>
|
|
<H3>Freezing:</H3>
|
|
|
|
<DL COMPACT>
|
|
<DT id="32"><B>-F</B>, <B>--freeze</B><DD>
|
|
produce an M4 frozen state file for FILES
|
|
</DL>
|
|
<A NAME="lbAK"> </A>
|
|
<H3>FORMAT defaults to `$f:$l:$n:$%', and can use the following escapes:</H3>
|
|
|
|
<DL COMPACT>
|
|
<DT id="33">$$<DD>
|
|
literal $
|
|
<DT id="34">$f<DD>
|
|
file where macro was called
|
|
<DT id="35">$l<DD>
|
|
line where macro was called
|
|
<DT id="36">$d<DD>
|
|
nesting depth of macro call
|
|
<DT id="37">$n<DD>
|
|
name of the macro
|
|
<DT id="38">$NUM<DD>
|
|
argument NUM, unquoted and with newlines
|
|
<DT id="39">$SEP@<DD>
|
|
all arguments, with newlines, quoted, and separated by SEP
|
|
<DT id="40">$SEP*<DD>
|
|
all arguments, with newlines, unquoted, and separated by SEP
|
|
<DT id="41">$SEP%<DD>
|
|
all arguments, without newlines, unquoted, and separated by SEP
|
|
</DL>
|
|
<P>
|
|
|
|
SEP can be empty for the default (comma for @ and *, colon for %),
|
|
a single character for that character, or {STRING} to use a string.
|
|
<A NAME="lbAL"> </A>
|
|
<H2>AUTHOR</H2>
|
|
|
|
Written by Akim Demaille.
|
|
<A NAME="lbAM"> </A>
|
|
<H2>REPORTING BUGS</H2>
|
|
|
|
Report bugs to <<A HREF="mailto:bug-autoconf@gnu.org">bug-autoconf@gnu.org</A>>.
|
|
<BR>
|
|
|
|
GNU Autoconf home page: <<A HREF="http://www.gnu.org/software/autoconf/">http://www.gnu.org/software/autoconf/</A>>.
|
|
<BR>
|
|
|
|
General help using GNU software: <<A HREF="http://www.gnu.org/gethelp/">http://www.gnu.org/gethelp/</A>>.
|
|
<A NAME="lbAN"> </A>
|
|
<H2>COPYRIGHT</H2>
|
|
|
|
Copyright © 2012 Free Software Foundation, Inc.
|
|
License GPLv3+/Autoconf: GNU GPL version 3 or later
|
|
<<A HREF="http://gnu.org/licenses/gpl.html">http://gnu.org/licenses/gpl.html</A>>, <<A HREF="http://gnu.org/licenses/exceptions.html">http://gnu.org/licenses/exceptions.html</A>>
|
|
<BR>
|
|
|
|
This is free software: you are free to change and redistribute it.
|
|
There is NO WARRANTY, to the extent permitted by law.
|
|
<A NAME="lbAO"> </A>
|
|
<H2>SEE ALSO</H2>
|
|
|
|
<B><A HREF="/cgi-bin/man/man2html?1+autoconf">autoconf</A></B>(1),
|
|
|
|
<B><A HREF="/cgi-bin/man/man2html?1+automake">automake</A></B>(1),
|
|
|
|
<B><A HREF="/cgi-bin/man/man2html?1+autoreconf">autoreconf</A></B>(1),
|
|
|
|
<B><A HREF="/cgi-bin/man/man2html?1+autoupdate">autoupdate</A></B>(1),
|
|
|
|
<B><A HREF="/cgi-bin/man/man2html?1+autoheader">autoheader</A></B>(1),
|
|
|
|
<B><A HREF="/cgi-bin/man/man2html?1+autoscan">autoscan</A></B>(1),
|
|
|
|
<B><A HREF="/cgi-bin/man/man2html?1+config.guess">config.guess</A></B>(1),
|
|
|
|
<B><A HREF="/cgi-bin/man/man2html?1+config.sub">config.sub</A></B>(1),
|
|
|
|
<B><A HREF="/cgi-bin/man/man2html?1+ifnames">ifnames</A></B>(1),
|
|
|
|
<B><A HREF="/cgi-bin/man/man2html?1+libtool">libtool</A></B>(1).
|
|
|
|
<P>
|
|
|
|
The full documentation for
|
|
<B>autom4te</B>
|
|
|
|
is maintained as a Texinfo manual. If the
|
|
<B>info</B>
|
|
|
|
and
|
|
<B>autom4te</B>
|
|
|
|
programs are properly installed at your site, the command
|
|
<DL COMPACT>
|
|
<DT id="42"><DD>
|
|
<B>info autom4te</B>
|
|
|
|
</DL>
|
|
<P>
|
|
|
|
should give you access to the complete manual.
|
|
<P>
|
|
|
|
<HR>
|
|
<A NAME="index"> </A><H2>Index</H2>
|
|
<DL>
|
|
<DT id="43"><A HREF="#lbAB">NAME</A><DD>
|
|
<DT id="44"><A HREF="#lbAC">SYNOPSIS</A><DD>
|
|
<DT id="45"><A HREF="#lbAD">DESCRIPTION</A><DD>
|
|
<DL>
|
|
<DT id="46"><A HREF="#lbAE">Operation modes:</A><DD>
|
|
<DT id="47"><A HREF="#lbAF">Languages include:</A><DD>
|
|
<DT id="48"><A HREF="#lbAG">Warning categories include:</A><DD>
|
|
<DT id="49"><A HREF="#lbAH">Library directories:</A><DD>
|
|
<DT id="50"><A HREF="#lbAI">Tracing:</A><DD>
|
|
<DT id="51"><A HREF="#lbAJ">Freezing:</A><DD>
|
|
<DT id="52"><A HREF="#lbAK">FORMAT defaults to `$f:$l:$n:$%', and can use the following escapes:</A><DD>
|
|
</DL>
|
|
<DT id="53"><A HREF="#lbAL">AUTHOR</A><DD>
|
|
<DT id="54"><A HREF="#lbAM">REPORTING BUGS</A><DD>
|
|
<DT id="55"><A HREF="#lbAN">COPYRIGHT</A><DD>
|
|
<DT id="56"><A HREF="#lbAO">SEE ALSO</A><DD>
|
|
</DL>
|
|
<HR>
|
|
This document was created by
|
|
<A HREF="/cgi-bin/man/man2html">man2html</A>,
|
|
using the manual pages.<BR>
|
|
Time: 00:05:07 GMT, March 31, 2021
|
|
</BODY>
|
|
</HTML>
|