mirror of
git://git.sv.gnu.org/autoconf
synced 2024-12-15 02:20:10 +08:00
156 lines
3.6 KiB
Groff
156 lines
3.6 KiB
Groff
.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.33.
|
|
.TH AUTOM4TE "1" "January 2005" "autom4te 2.59c" "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
|
|
.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 variable `WARNINGS' is 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
|
|
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
|
|
.SH AUTHOR
|
|
Written by Akim Demaille.
|
|
.SH "REPORTING BUGS"
|
|
Report bugs to <bug-autoconf@gnu.org>.
|
|
.SH COPYRIGHT
|
|
Copyright \(co 2005 Free Software Foundation, Inc.
|
|
.br
|
|
This is free software; see the source for copying conditions. There is NO
|
|
warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
|
|
.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.
|