diff options
Diffstat (limited to 'upstream/mageia-cauldron/man1/autom4te.1')
| -rw-r--r-- | upstream/mageia-cauldron/man1/autom4te.1 | 198 |
1 files changed, 198 insertions, 0 deletions
diff --git a/upstream/mageia-cauldron/man1/autom4te.1 b/upstream/mageia-cauldron/man1/autom4te.1 new file mode 100644 index 00000000..2174ee8a --- /dev/null +++ b/upstream/mageia-cauldron/man1/autom4te.1 @@ -0,0 +1,198 @@ +.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.49.3. +.TH AUTOM4TE "1" "December 2023" "GNU Autoconf 2.72" "User Commands" +.SH NAME +autom4te \- Generate files and scripts thanks to M4 +.SH SYNOPSIS +.B autom4te +[\fI\,OPTION\/\fR]... [\fI\,FILES\/\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=\fI\,FILE\/\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=\fI\,CATEGORY\/\fR +report the warnings falling in CATEGORY +(comma\-separated list accepted) +.TP +\fB\-l\fR, \fB\-\-language\fR=\fI\,LANG\/\fR +specify the set of M4 macros to use +.TP +\fB\-C\fR, \fB\-\-cache\fR=\fI\,DIRECTORY\/\fR +preserve results for future runs in DIRECTORY +.TP +\fB\-\-no\-cache\fR +disable the cache +.TP +\fB\-m\fR, \fB\-\-mode\fR=\fI\,OCTAL\/\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 are:" +.TP +cross +cross compilation issues +.TP +gnu +GNU coding standards (default in gnu and gnits modes) +.TP +obsolete +obsolete features or constructions (default) +.TP +override +user redefinitions of Automake rules or variables +.TP +portability +portability issues (default in gnu and gnits modes) +.TP +portability\-recursive +nested Make variables (default with \fB\-Wportability\fR) +.TP +extra\-portability +extra portability issues related to obscure tools +.TP +syntax +dubious syntactic constructs (default) +.TP +unsupported +unsupported or incomplete features (default) +.SS "-W also understands:" +.TP +all +turn on all the warnings +.TP +none +turn off all the warnings +.TP +no\-CATEGORY +turn off warnings in CATEGORY +.TP +error +treat all enabled warnings as errors +.PP +The environment variables 'M4' and 'WARNINGS' are honored. +.SS "Library directories:" +.TP +\fB\-B\fR, \fB\-\-prepend\-include\fR=\fI\,DIR\/\fR +prepend directory DIR to search path +.TP +\fB\-I\fR, \fB\-\-include\fR=\fI\,DIR\/\fR +append directory DIR to search path +.SS "Tracing:" +.TP +\fB\-t\fR, \fB\-\-trace\fR=\fI\,MACRO[\/\fR:FORMAT] +report the MACRO invocations +.TP +\fB\-p\fR, \fB\-\-preselect\fR=\fI\,MACRO\/\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 +.MT bug-autoconf@gnu.org +.ME , +or via Savannah: +.UR https://savannah.gnu.org/support/?group=autoconf +.UE . +.SH COPYRIGHT +Copyright \(co 2023 Free Software Foundation, Inc. +License GPLv3+/Autoconf: GNU GPL version 3 or later +<https://gnu.org/licenses/gpl.html>, <https://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). + +The full documentation for Autoconf is maintained as a Texinfo manual. +To read the manual locally, use the command +.IP +.B info autoconf +.PP +You can also consult the Web version of the manual at +.UR https://gnu.org/software/autoconf/manual/ +.UE . |