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,
19       together 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'
76              cross compilation issues
77
78       `gnu'  GNU coding standards (default in gnu and gnits modes)
79
80       `obsolete'
81              obsolete features or constructions
82
83       `override'
84              user redefinitions of Automake rules or variables
85
86       `portability'
87              portability issues (default in gnu and gnits modes)
88
89       `syntax'
90              dubious syntactic constructs (default)
91
92       `unsupported'
93              unsupported or incomplete features (default)
94
95       `all'  all the warnings
96
97       `no-CATEGORY'
98              turn off warnings in CATEGORY
99
100       `none' turn off all the warnings
101
102       `error'
103              treat warnings as errors
104
105       The environment variables `M4' and `WARNINGS' are honored.
106
107   Library directories:
108       -B, --prepend-include=DIR
109              prepend directory DIR to search path
110
111       -I, --include=DIR
112              append directory DIR to search path
113
114   Tracing:
115       -t, --trace=MACRO[:FORMAT]
116              report the MACRO invocations
117
118       -p, --preselect=MACRO
119              prepare to trace MACRO in a future run
120
121   Freezing:
122       -F, --freeze
123              produce an M4 frozen state file for FILES
124
125   FORMAT defaults to `$f:$l:$n:$%', and can use the following escapes:
126       $$     literal $
127
128       $f     file where macro was called
129
130       $l     line where macro was called
131
132       $d     nesting depth of macro call
133
134       $n     name of the macro
135
136       $NUM   argument NUM, unquoted and with newlines
137
138       $SEP@  all arguments, with newlines, quoted, and separated by SEP
139
140       $SEP*  all arguments, with newlines, unquoted, and separated by SEP
141
142       $SEP%  all arguments, without newlines, unquoted, and separated by SEP
143
144       SEP can be empty for the default (comma for @ and *, colon  for  %),  a
145       single character for that character, or {STRING} to use a string.
146

AUTHOR

148       Written by Akim Demaille.
149

REPORTING BUGS

151       Report bugs to <bug-autoconf@gnu.org>.
152

154       Copyright  ©  2008  Free Software Foundation, Inc.  License GPLv2+: GNU
155       GPL    version     2     or     later     <http://gnu.org/licenses/old-
156       licenses/gpl-2.0.html>
157       This  is  free  software:  you  are free to change and redistribute it.
158       There is NO WARRANTY, to the extent permitted by law.
159

SEE ALSO

161       autoconf(1), automake(1), autoreconf(1), autoupdate(1),  autoheader(1),
162       autoscan(1), config.guess(1), config.sub(1), ifnames(1), libtool(1).
163
164       The  full documentation for autom4te is maintained as a Texinfo manual.
165       If the info and autom4te programs are properly installed at your  site,
166       the command
167
168              info autom4te
169
170       should give you access to the complete manual.
171
172
173
174GNU Autoconf 2.63               September 2008                     AUTOM4TE(1)
Impressum