1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
|
.\" Hey, EMACS: -*- nroff -*-
.\" First parameter, NAME, should be all caps
.\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
.\" other parameters are allowed: see man(7), man(1)
.TH ANTLR 1 "July 22, 2015" antlr
.\" Please adjust this date whenever revising the manpage.
.\"
.\" Some roff macros, for reference:
.\" .nh disable hyphenation
.\" .hy enable hyphenation
.\" .ad l left justify
.\" .ad b justify to both left and right margins
.\" .nf disable filling
.\" .fi enable filling
.\" .br insert line break
.\" .sp <n> insert n+1 empty lines
.\" for manpage-specific macros, see man(7)
.SH "NAME"
ANTLR \- ANother Tool for Language Recognition, version 3
.SH "SYNOPSIS"
.B antlr3
[\fIargs\fR] \fIfile.g\fR [ \fIfile2.g\fR \fIfile3.g\fR ...]
.br
.SH "DESCRIPTION"
ANTLR (ANother Tool for Language Recognition) is a parser generator
for reading, processing, executing, or translating structured text
or binary files. It's widely used to build languages, tools, and
frameworks. From a grammar, ANTLR generates a parser that can build
and walk parse trees.
.TP
\fB\-o\fR \fIoutputDir\fR
specify output directory where all output generated.
.TP
\fB\-fo\fR \fIoutputDir\fR
same as \-o but force even files with relative paths to dir.
.TP
\fB\-lib\fR \fIdir\fR
specify location of token files.
.TP
\fB\-depend\fR
generate file dependencies.
.TP
\fB\-report\fR
print out a report about the grammar(s) processed.
.TP
\fB\-print\fR
print out the grammar without actions.
.TP
\fB\-debug\fR
generate a parser that emits debugging events.
.TP
\fB\-profile\fR
generate a parser that computes profiling information.
.TP
\fB\-trace\fR
generate a recognizer that traces rule entry/exit.
.TP
\fB\-nfa\fR
generate an NFA for each rule.
.TP
\fB\-dfa\fR
generate a DFA for each decision point.
.TP
\fB\-message-format\fR \fIname\fR
specify output style for messages.
.TP
\fB\-verbose\fR
generate ANTLR version and other information.
.TP
\fB\-make\fR
only build if generated files older than grammar.
.TP
\fB\-version\fR
print the version of ANTLR and exit.
.TP
\fB\-language\fR \fIL\fR
override language grammar option; generate L
.TP
\fB\-X\fR
display the list of extended arguments
.TP
\fB\-Xgrtree\fR
print the grammar AST
.TP
\fB\-Xdfa\fR
print DFA as text
.TP
\fB\-Xnoprune\fR
test lookahead against EBNF block exit branches
.TP
\fB\-Xnocollapse\fR
collapse incident edges into DFA states
.TP
\fB\-Xdbgconversion\fR
dump lots of info during NFA conversion
.TP
\fB\-Xconversiontimeout\fR
use to restrict NFA conversion exponentiality
.TP
\fB\-Xmultithreaded\fR
run the analysis in 2 threads
.TP
\fB\-Xnomergestopstates\fR
do not merge stop states
.TP
\fB\-Xdfaverbose\fR
generate DFA states in DOT with NFA configs
.TP
\fB\-Xwatchconversion\fR
print a message for each NFA before converting
.TP
\fB\-XdbgST\fR
put tags at start/stop of all templates in output
.TP
\fB\-Xnfastates\fR
for nondeterminisms, list NFA states for each path
.TP
\fB\-Xm\fR \fIm\fR
max number of rule invocations during conversion [4]
.TP
\fB\-Xmaxdfaedges\fR \fIm\fR
max "comfortable" number of edges for single DFA state [65534]
.TP
\fB\-Xmaxinlinedfastates\fR \fIm\fR
max DFA states before table used rather than inlining [60]
.TP
\fB\-Xmaxswitchcaselabels\fR \fIm\fR
don't generate switch() statements for dfas bigger than m [300]
.TP
\fB\-Xminswitchalts\fR \fIm\fR
don't generate switch() statements for dfas smaller than m [3]
.TP
\fB\-Xsavelexer\fR
don't delete temporary lexers generated from combined grammars
.SH "AUTHOR"
This manual page was written by Ludovic Claude <ludovic.claude@laposte.net>
.SH "SEE ALSO"
.BR java (1),
.BR runantlr (1),
.BR http://www.antlr.org/
.br
|
