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
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

AUTHOR

126       Written by Akim Demaille.
127

REPORTING BUGS

129       Report bugs to <bug-autoconf@gnu.org>.
130

132       Copyright © 2006 Free Software Foundation, Inc.
133       This is free software.  You may redistribute copies  of  it  under  the
134       terms       of       the      GNU      General      Public      License
135       <http://www.gnu.org/licenses/gpl.html>.  There is NO WARRANTY,  to  the
136       extent permitted by law.
137

SEE ALSO

139       autoconf(1),  automake(1), autoreconf(1), autoupdate(1), autoheader(1),
140       autoscan(1), config.guess(1), config.sub(1), ifnames(1), libtool(1).
141
142       The full documentation for autom4te is maintained as a Texinfo  manual.
143       If  the info and autom4te programs are properly installed at your site,
144       the command
145
146              info autom4te
147
148       should give you access to the complete manual.
149
150
151
152autom4te 2.61                    November 2006                     AUTOM4TE(1)
Impressum