193 lines
4.5 KiB
Groff
193 lines
4.5 KiB
Groff
.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.40.8.
|
|
.TH AUTOM4TE "1" "April 2012" "GNU Autoconf 2.68b.25-19513" "User Commands"
|
|
.SH NAME
|
|
autom4te \- Generate files and scripts thanks to M4
|
|
.SH SYNOPSIS
|
|
.B autom4te
|
|
[\fIOPTION\fR]... [\fIFILES\fR]
|
|
.SH DESCRIPTION
|
|
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.
|
|
.PP
|
|
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.
|
|
.PP
|
|
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.
|
|
.SS "Operation modes:"
|
|
.TP
|
|
\fB\-h\fR, \fB\-\-help\fR
|
|
print this help, then exit
|
|
.TP
|
|
\fB\-V\fR, \fB\-\-version\fR
|
|
print version number, then exit
|
|
.TP
|
|
\fB\-v\fR, \fB\-\-verbose\fR
|
|
verbosely report processing
|
|
.TP
|
|
\fB\-d\fR, \fB\-\-debug\fR
|
|
don't remove temporary files
|
|
.TP
|
|
\fB\-o\fR, \fB\-\-output\fR=\fIFILE\fR
|
|
save output in FILE (defaults to `\-', stdout)
|
|
.TP
|
|
\fB\-f\fR, \fB\-\-force\fR
|
|
don't rely on cached values
|
|
.TP
|
|
\fB\-W\fR, \fB\-\-warnings\fR=\fICATEGORY\fR
|
|
report the warnings falling in CATEGORY
|
|
.TP
|
|
\fB\-l\fR, \fB\-\-language\fR=\fILANG\fR
|
|
specify the set of M4 macros to use
|
|
.TP
|
|
\fB\-C\fR, \fB\-\-cache\fR=\fIDIRECTORY\fR
|
|
preserve results for future runs in DIRECTORY
|
|
.TP
|
|
\fB\-\-no\-cache\fR
|
|
disable the cache
|
|
.TP
|
|
\fB\-m\fR, \fB\-\-mode\fR=\fIOCTAL\fR
|
|
change the non trace output file mode (0666)
|
|
.TP
|
|
\fB\-M\fR, \fB\-\-melt\fR
|
|
don't use M4 frozen files
|
|
.SS "Languages include:"
|
|
.TP
|
|
`Autoconf'
|
|
create Autoconf configure scripts
|
|
.TP
|
|
`Autotest'
|
|
create Autotest test suites
|
|
.TP
|
|
`M4sh'
|
|
create M4sh shell scripts
|
|
.TP
|
|
`M4sugar'
|
|
create M4sugar output
|
|
.SS "Warning categories include:"
|
|
.TP
|
|
`cross'
|
|
cross compilation issues
|
|
.TP
|
|
`gnu'
|
|
GNU coding standards (default in gnu and gnits modes)
|
|
.TP
|
|
`obsolete'
|
|
obsolete features or constructions
|
|
.TP
|
|
`override'
|
|
user redefinitions of Automake rules or variables
|
|
.TP
|
|
`portability'
|
|
portability issues (default in gnu and gnits modes)
|
|
.TP
|
|
`syntax'
|
|
dubious syntactic constructs (default)
|
|
.TP
|
|
`unsupported'
|
|
unsupported or incomplete features (default)
|
|
.TP
|
|
`all'
|
|
all the warnings
|
|
.TP
|
|
`no\-CATEGORY'
|
|
turn off warnings in CATEGORY
|
|
.TP
|
|
`none'
|
|
turn off all the warnings
|
|
.TP
|
|
`error'
|
|
treat warnings as errors
|
|
.PP
|
|
The environment variables `M4' and `WARNINGS' are honored.
|
|
.SS "Library directories:"
|
|
.TP
|
|
\fB\-B\fR, \fB\-\-prepend\-include\fR=\fIDIR\fR
|
|
prepend directory DIR to search path
|
|
.TP
|
|
\fB\-I\fR, \fB\-\-include\fR=\fIDIR\fR
|
|
append directory DIR to search path
|
|
.SS "Tracing:"
|
|
.TP
|
|
\fB\-t\fR, \fB\-\-trace\fR=\fIMACRO[\fR:FORMAT]
|
|
report the MACRO invocations
|
|
.TP
|
|
\fB\-p\fR, \fB\-\-preselect\fR=\fIMACRO\fR
|
|
prepare to trace MACRO in a future run
|
|
.SS "Freezing:"
|
|
.TP
|
|
\fB\-F\fR, \fB\-\-freeze\fR
|
|
produce an M4 frozen state file for FILES
|
|
.SS "FORMAT defaults to `$f:$l:$n:$%', and can use the following escapes:"
|
|
.TP
|
|
$$
|
|
literal $
|
|
.TP
|
|
$f
|
|
file where macro was called
|
|
.TP
|
|
$l
|
|
line where macro was called
|
|
.TP
|
|
$d
|
|
nesting depth of macro call
|
|
.TP
|
|
$n
|
|
name of the macro
|
|
.TP
|
|
$NUM
|
|
argument NUM, unquoted and with newlines
|
|
.TP
|
|
$SEP@
|
|
all arguments, with newlines, quoted, and separated by SEP
|
|
.TP
|
|
$SEP*
|
|
all arguments, with newlines, unquoted, and separated by SEP
|
|
.TP
|
|
$SEP%
|
|
all arguments, without newlines, unquoted, and separated by SEP
|
|
.PP
|
|
SEP can be empty for the default (comma for @ and *, colon for %),
|
|
a single character for that character, or {STRING} to use a string.
|
|
.SH AUTHOR
|
|
Written by Akim Demaille.
|
|
.SH "REPORTING BUGS"
|
|
Report bugs to <bug\-autoconf@gnu.org>.
|
|
.br
|
|
GNU Autoconf home page: <http://www.gnu.org/software/autoconf/>.
|
|
.br
|
|
General help using GNU software: <http://www.gnu.org/gethelp/>.
|
|
.SH COPYRIGHT
|
|
Copyright \(co 2012 Free Software Foundation, Inc.
|
|
License GPLv3+/Autoconf: GNU GPL version 3 or later
|
|
<http://gnu.org/licenses/gpl.html>, <http://gnu.org/licenses/exceptions.html>
|
|
.br
|
|
This is free software: you are free to change and redistribute it.
|
|
There is NO WARRANTY, to the extent permitted by law.
|
|
.SH "SEE ALSO"
|
|
.BR autoconf (1),
|
|
.BR automake (1),
|
|
.BR autoreconf (1),
|
|
.BR autoupdate (1),
|
|
.BR autoheader (1),
|
|
.BR autoscan (1),
|
|
.BR config.guess (1),
|
|
.BR config.sub (1),
|
|
.BR ifnames (1),
|
|
.BR libtool (1).
|
|
.PP
|
|
The full documentation for
|
|
.B autom4te
|
|
is maintained as a Texinfo manual. If the
|
|
.B info
|
|
and
|
|
.B autom4te
|
|
programs are properly installed at your site, the command
|
|
.IP
|
|
.B info autom4te
|
|
.PP
|
|
should give you access to the complete manual.
|