1AUTOM4TE(1)                      User Commands                     AUTOM4TE(1)
2
3
4

NAME

6       autom4te - Generate files and scripts thanks to M4
7

SYNOPSIS

9       autom4te [OPTION]... [FILES]
10

DESCRIPTION

12       Run  GNU  M4 on the FILES, avoiding useless runs.  Output the traces if
13       tracing, the frozen file if freezing, otherwise the  expansion  of  the
14       FILES.
15
16       If  some of the FILES are named 'FILE.m4f' they are considered to be M4
17       frozen files of  all  the  previous  files  (which  are  therefore  not
18       loaded).   If 'FILE.m4f' is not found, then 'FILE.m4' will be used, to‐
19       gether with all the previous files.
20
21       Some files may be optional, i.e., will only be processed  if  found  in
22       the  include  path,  but then must end in '.m4?';  the question mark is
23       not part of the actual file name.
24
25   Operation modes:
26       -h, --help
27              print this help, then exit
28
29       -V, --version
30              print version number, then exit
31
32       -v, --verbose
33              verbosely report processing
34
35       -d, --debug
36              don't remove temporary files
37
38       -o, --output=FILE
39              save output in FILE (defaults to '-', stdout)
40
41       -f, --force
42              don't rely on cached values
43
44       -W, --warnings=CATEGORY
45              report the warnings falling in CATEGORY
46
47       -l, --language=LANG
48              specify the set of M4 macros to use
49
50       -C, --cache=DIRECTORY
51              preserve results for future runs in DIRECTORY
52
53       --no-cache
54              disable the cache
55
56       -m, --mode=OCTAL
57              change the non trace output file mode (0666)
58
59       -M, --melt
60              don't use M4 frozen files
61
62   Languages include:
63       'Autoconf'
64              create Autoconf configure scripts
65
66       'Autotest'
67              create Autotest test suites
68
69       'M4sh' create M4sh shell scripts
70
71       'M4sugar'
72              create M4sugar output
73
74   Warning categories include:
75       cross  cross compilation issues
76
77       gnu    GNU coding standards (default in gnu and gnits modes)
78
79       obsolete
80              obsolete features or constructions (default)
81
82       override
83              user redefinitions of Automake rules or variables
84
85       portability
86              portability issues (default in gnu and gnits modes)
87
88       portability-recursive
89              nested Make variables (default with -Wportability)
90
91       extra-portability
92              extra portability issues related to obscure tools
93
94       syntax dubious syntactic constructs (default)
95
96       unsupported
97              unsupported or incomplete features (default)
98
99       all    all the warnings
100
101       no-CATEGORY
102              turn off warnings in CATEGORY
103
104       none   turn off all the warnings
105
106       error  treat warnings as errors
107
108       The environment variables 'M4' and 'WARNINGS' are honored.
109
110   Library directories:
111       -B, --prepend-include=DIR
112              prepend directory DIR to search path
113
114       -I, --include=DIR
115              append directory DIR to search path
116
117   Tracing:
118       -t, --trace=MACRO[:FORMAT]
119              report the MACRO invocations
120
121       -p, --preselect=MACRO
122              prepare to trace MACRO in a future run
123
124   Freezing:
125       -F, --freeze
126              produce an M4 frozen state file for FILES
127
128   FORMAT defaults to '$f:$l:$n:$%', and can use the following escapes:
129       $$     literal $
130
131       $f     file where macro was called
132
133       $l     line where macro was called
134
135       $d     nesting depth of macro call
136
137       $n     name of the macro
138
139       $NUM   argument NUM, unquoted and with newlines
140
141       $SEP@  all arguments, with newlines, quoted, and separated by SEP
142
143       $SEP*  all arguments, with newlines, unquoted, and separated by SEP
144
145       $SEP%  all arguments, without newlines, unquoted, and separated by SEP
146
147       SEP can be empty for the default (comma for @ and *, colon  for  %),  a
148       single character for that character, or {STRING} to use a string.
149

AUTHOR

151       Written by Akim Demaille.
152

REPORTING BUGS

154       Report bugs to <bug-autoconf@gnu.org>.
155       GNU Autoconf home page: <https://www.gnu.org/software/autoconf/>.
156       General help using GNU software: <https://www.gnu.org/gethelp/>.
157

159       Copyright  ©  2021 Free Software Foundation, Inc.  License GPLv3+/Auto‐
160       conf: GNU GPL version 3 or  later  <https://gnu.org/licenses/gpl.html>,
161       <https://gnu.org/licenses/exceptions.html>
162       This  is  free  software:  you  are free to change and redistribute it.
163       There is NO WARRANTY, to the extent permitted by law.
164

SEE ALSO

166       autoconf(1), automake(1), autoreconf(1), autoupdate(1),  autoheader(1),
167       autoscan(1), config.guess(1), config.sub(1), ifnames(1), libtool(1).
168
169       The  full documentation for autom4te is maintained as a Texinfo manual.
170       If the info and autom4te programs are properly installed at your  site,
171       the command
172
173              info autom4te
174
175       should give you access to the complete manual.
176
177
178
179GNU Autoconf 2.71                January 2021                      AUTOM4TE(1)
Impressum