diff options
Diffstat (limited to 'man/autom4te.1')
| -rw-r--r-- | man/autom4te.1 | 192 |
1 files changed, 192 insertions, 0 deletions
diff --git a/man/autom4te.1 b/man/autom4te.1 new file mode 100644 index 0000000..674aea6 --- /dev/null +++ b/man/autom4te.1 @@ -0,0 +1,192 @@ +.\" 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. |