Chromium Code Reviews
chromiumcodereview-hr@appspot.gserviceaccount.com (chromiumcodereview-hr) | Please choose your nickname with Settings | Help | Chromium Project | Gerrit Changes | Sign out
(466)

Side by Side Diff: bison/src/bison/2.4.1/bison-2.4.1-src/doc/bison.1

Issue 10807020: Add native Windows binary for bison. (Closed) Base URL: svn://chrome-svn/chrome/trunk/deps/third_party/
Patch Set: Created 8 years, 5 months ago
Use n/p to move between diff chunks; N/P to move between comments. Draft comments are only viewable by you.
Jump to:
View unified diff | Download patch | Annotate | Revision Log
OLDNEW
(Empty)
1 .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.36.
2 .TH BISON "1" "December 2008" "bison 2.4.1
3 " "User Commands"
4 .SH NAME
5 bison \- GNU Project parser generator (yacc replacement)
6 .SH SYNOPSIS
7 .B j:\Devel\bison\2.4.1\bison-2.4.1\src\bison.exe
8 [\fIOPTION\fR]... \fIFILE\fR
9 .SH DESCRIPTION
10 .I Bison
11 is a parser generator in the style of
12 .IR yacc (1).
13 It should be upwardly compatible with input files designed
14 for
15 .IR yacc .
16 .PP
17 Input files should follow the
18 .I yacc
19 convention of ending in
20 .BR .y .
21 Unlike
22 .IR yacc ,
23 the generated files do not have fixed names, but instead use the prefix
24 of the input file.
25 Moreover, if you need to put
26 .I C++
27 code in the input file, you can end his name by a C++-like extension
28 (.ypp or .y++), then bison will follow your extension to name the
29 output file (.cpp or .c++).
30 For instance, a grammar description file named
31 .B parse.yxx
32 would produce the generated parser in a file named
33 .BR parse.tab.cxx ,
34 instead of
35 .IR yacc 's
36 .B y.tab.c
37 or old
38 .I Bison
39 version's
40 .BR parse.tab.c .
41 .PP
42 This description of the options that can be given to
43 .I bison
44 is adapted from the node
45 .B Invocation
46 in the
47 .B bison.texinfo
48 manual, which should be taken as authoritative.
49 .PP
50 .I Bison
51 supports both traditional single-letter options and mnemonic long
52 option names. Long option names are indicated with
53 .B \-\-
54 instead of
55 .BR \- .
56 Abbreviations for option names are allowed as long as they
57 are unique. When a long option takes an argument, like
58 .BR \-\-file-prefix ,
59 connect the option name and the argument with
60 .BR = .
61 .PP
62 Generate LALR(1) and GLR parsers.
63 .PP
64
65 Mandatory arguments to long options are mandatory for short options too.
66 The same is true for optional arguments.
67 .PP
68
69 Operation modes:
70 .TP
71 \fB\-h\fR, \fB\-\-help\fR
72 display this help and exit
73 .TP
74 \fB\-V\fR, \fB\-\-version\fR
75 output version information and exit
76 .TP
77 \fB\-\-print\-localedir\fR
78 output directory containing locale\-dependent data
79 .TP
80 \fB\-\-print\-datadir\fR
81 output directory containing skeletons and XSLT
82 .TP
83 \fB\-y\fR, \fB\-\-yacc\fR
84 emulate POSIX Yacc
85 .TP
86 \fB\-W\fR, \fB\-\-warnings\fR=\fI[CATEGORY]\fR
87 report the warnings falling in CATEGORY
88 .PP
89
90 Parser:
91 .TP
92 \fB\-L\fR, \fB\-\-language\fR=\fILANGUAGE\fR
93 specify the output programming language
94 (this is an experimental feature)
95 .TP
96 \fB\-S\fR, \fB\-\-skeleton\fR=\fIFILE\fR
97 specify the skeleton to use
98 .TP
99 \fB\-t\fR, \fB\-\-debug\fR
100 instrument the parser for debugging
101 .TP
102 \fB\-\-locations\fR
103 enable locations computation
104 .TP
105 \fB\-p\fR, \fB\-\-name\-prefix\fR=\fIPREFIX\fR
106 prepend PREFIX to the external symbols
107 .TP
108 \fB\-l\fR, \fB\-\-no\-lines\fR
109 don't generate `#line' directives
110 .TP
111 \fB\-k\fR, \fB\-\-token\-table\fR
112 include a table of token names
113 .PP
114
115 Output:
116 .TP
117 \fB\-\-defines\fR[=\fIFILE\fR]
118 also produce a header file
119 .TP
120 \fB\-d\fR
121 likewise but cannot specify FILE (for POSIX Yacc)
122 .TP
123 \fB\-r\fR, \fB\-\-report\fR=\fITHINGS\fR
124 also produce details on the automaton
125 .TP
126 \fB\-\-report\-file\fR=\fIFILE\fR
127 write report to FILE
128 .TP
129 \fB\-v\fR, \fB\-\-verbose\fR
130 same as `\-\-report=state'
131 .TP
132 \fB\-b\fR, \fB\-\-file\-prefix\fR=\fIPREFIX\fR
133 specify a PREFIX for output files
134 .TP
135 \fB\-o\fR, \fB\-\-output\fR=\fIFILE\fR
136 leave output to FILE
137 .TP
138 \fB\-g\fR, \fB\-\-graph\fR[=\fIFILE\fR]
139 also output a graph of the automaton
140 .TP
141 \fB\-x\fR, \fB\-\-xml\fR[=\fIFILE\fR]
142 also output an XML report of the automaton
143 (the XML schema is experimental)
144 .PP
145
146 Warning categories include:
147 .TP
148 `midrule\-values'
149 unset or unused midrule values
150 .TP
151 `yacc'
152 incompatibilities with POSIX YACC
153 .TP
154 `all'
155 all the warnings
156 .TP
157 `no\-CATEGORY'
158 turn off warnings in CATEGORY
159 .TP
160 `none'
161 turn off all the warnings
162 .TP
163 `error'
164 treat warnings as errors
165 .PP
166
167 THINGS is a list of comma separated words that can include:
168 .TP
169 `state'
170 describe the states
171 .TP
172 `itemset'
173 complete the core item sets with their closure
174 .TP
175 `lookahead'
176 explicitly associate lookahead tokens to items
177 .TP
178 `solved'
179 describe shift/reduce conflicts solving
180 .TP
181 `all'
182 include all the above information
183 .TP
184 `none'
185 disable the report
186 .PP
187
188 .SH AUTHOR
189 Written by Robert Corbett and Richard Stallman.
190 .PP
191
192 Copyright (C) 2008 Free Software Foundation, Inc.
193 This is free software; see the source for copying conditions. There is NO
194 warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
195 .SH "REPORTING BUGS"
196 Report bugs to <bug\-bison@gnu.org>.
197 .SH "SEE ALSO"
198 .BR lex (1),
199 .BR flex (1),
200 .BR yacc (1).
201 .PP
202 The full documentation for
203 .B bison
204 is maintained as a Texinfo manual. If the
205 .B info
206 and
207 .B bison
208 programs are properly installed at your site, the command
209 .IP
210 .B info bison
211 .PP
212 should give you access to the complete manual.
OLDNEW
« no previous file with comments | « bison/src/bison/2.4.1/bison-2.4.1-src/doc/Makefile.in ('k') | bison/src/bison/2.4.1/bison-2.4.1-src/doc/bison.info » ('j') | no next file with comments »

Powered by Google App Engine
This is Rietveld 408576698