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

NAME

6       M4 - macro processor
7

SYNOPSIS

9       m4 [OPTION]... [FILE]...
10

DESCRIPTION

12       Process  macros in FILEs.  If no FILE or if FILE is `-', standard input
13       is read.
14
15       Mandatory or optional  arguments  to  long  options  are  mandatory  or
16       optional for short options too.
17
18   Operation modes:
19       --help display this help and exit
20
21       --version
22              output version information and exit
23
24       -E, --fatal-warnings
25              stop execution after first warning
26
27       -i, --interactive
28              unbuffer output, ignore interrupts
29
30       -P, --prefix-builtins
31              force a `m4_' prefix to all builtins
32
33       -Q, --quiet, --silent
34              suppress some warnings for builtins
35
36   Preprocessor features:
37       -D, --define=NAME[=VALUE]
38              define NAME as having VALUE, or empty
39
40       -I, --include=DIRECTORY
41              append DIRECTORY to include path
42
43       -s, --synclines
44              generate `#line NUM "FILE"' lines
45
46       -U, --undefine=NAME
47              undefine NAME
48
49   Limits control:
50       -G, --traditional
51              suppress all GNU extensions
52
53       -H, --hashsize=PRIME
54              set symbol lookup hash table size [509]
55
56       -L, --nesting-limit=NUMBER
57              change artificial nesting limit [1024]
58
59   Frozen state files:
60       -F, --freeze-state=FILE
61              produce a frozen state on FILE at end
62
63       -R, --reload-state=FILE
64              reload a frozen state from FILE at start
65
66   Debugging:
67       -d, --debug[=FLAGS]
68              set debug level (no FLAGS implies `aeq')
69
70       --debugfile=FILE
71              redirect debug and trace output
72
73       -l, --arglength=NUM
74              restrict macro tracing size
75
76       -t, --trace=NAME
77              trace NAME when it is defined
78
79   FLAGS is any of:
80       a      show actual arguments
81
82       c      show before collect, after collect and after call
83
84       e      show expansion
85
86       f      say current input file name
87
88       i      show changes in input files
89
90       l      say current input line number
91
92       p      show results of path searches
93
94       q      quote values as necessary, with a or e flag
95
96       t      trace for all macro calls, not only traceon'ed
97
98       x      add a unique macro call id, useful with c flag
99
100       V      shorthand for all of the above flags
101
102       If defined, the environment variable `M4PATH' is a colon-separated list
103       of directories included after any specified by `-I'.
104
105       Exit status is 0 for success, 1 for failure, 63 for frozen file version
106       mismatch, or whatever value was passed to the m4exit macro.
107

AUTHOR

109       Written by Rene' Seindal.
110

REPORTING BUGS

112       Report bugs to <bug-m4@gnu.org>.
113

115       Copyright © 2006 Free Software Foundation, Inc.
116       This is free software; see the source for copying conditions.  There is
117       NO warranty; not even for MERCHANTABILITY or FITNESS FOR  A  PARTICULAR
118       PURPOSE.
119

SEE ALSO

121       The  full  documentation  for M4 is maintained as a Texinfo manual.  If
122       the info and M4 programs are properly installed at your site, the  com‐
123       mand
124
125              info m4
126
127       should give you access to the complete manual.
128
129
130
131FSF                              November 2006                           M4(1)
Impressum