![[BACK]](/cvsweb/icons/back.gif){kind=icon}
Return to bison.1 CVS log ![[TXT]](/cvsweb/icons/text.gif){kind=icon}
![[DIR]](/cvsweb/icons/dir.gif){kind=icon}
Up to [Apple XNU] / GNUtools / bison|
Return to bison.1 CVS log | Up to [Apple XNU] / GNUtools / bison |
1.1 root 1: .TH BISON 1 local
2: .SH NAME
3: bison \- GNU Project parser generator (yacc replacement)
4: .SH SYNOPSIS
5: .B bison
6: [
7: .BI \-b " file-prefix"
8: ] [
9: .BI \-\-file-prefix= file-prefix
10: ] [
11: .B \-d
12: ] [
13: .B \-\-defines
14: ] [
15: .B \-l
16: ] [
17: .B \-\-no-lines
18: ] [
19: .BI \-o " outfile"
20: ] [
21: .BI \-\-output-file= outfile
22: ] [
23: .BI \-p " prefix"
24: ] [
25: .BI \-\-name-prefix= prefix
26: ] [
27: .B \-t
28: ] [
29: .B \-\-debug
30: ] [
31: .B \-v
32: ] [
33: .B \-\-verbose
34: ] [
35: .B \-V
36: ] [
37: .B \-\-version
38: ] [
39: .B \-y
40: ] [
41: .B \-\-yacc
42: ] [
43: .B \-h
44: ] [
45: .B \-\-help
46: ] [
47: .B \-\-fixed-output-files
48: ]
49: file
50: .SH DESCRIPTION
51: .I Bison
52: is a parser generator in the style of
53: .IR yacc (1).
54: It should be upwardly compatible with input files designed
55: for
56: .IR yacc .
57: .PP
58: Input files should follow the
59: .I yacc
60: convention of ending in
61: .BR .y .
62: Unlike
63: .IR yacc ,
64: the generated files do not have fixed names, but instead use the prefix
65: of the input file.
66: For instance, a grammar description file named
67: .B parse.y
68: would produce the generated parser in a file named
69: .BR parse.tab.c ,
70: instead of
71: .IR yacc 's
72: .BR y.tab.c .
73: .PP
74: This description of the options that can be given to
75: .I bison
76: is adapted from the node
77: .B Invocation
78: in the
79: .B bison.texinfo
80: manual, which should be taken as authoritative.
81: .PP
82: .I Bison
83: supports both traditional single-letter options and mnemonic long
84: option names. Long option names are indicated with
85: .B \-\-
86: instead of
87: .BR \- .
88: Abbreviations for option names are allowed as long as they
89: are unique. When a long option takes an argument, like
90: .BR \-\-file-prefix ,
91: connect the option name and the argument with
92: .BR = .
93: .SS OPTIONS
94: .TP
95: .BI \-b " file-prefix"
96: .br
97: .ns
98: .TP
99: .BI \-\-file-prefix= file-prefix
100: Specify a prefix to use for all
101: .I bison
102: output file names. The names are
103: chosen as if the input file were named
104: \fIfile-prefix\fB.c\fR.
105: .TP
106: .B \-d
107: .br
108: .ns
109: .TP
110: .B \-\-defines
111: Write an extra output file containing macro definitions for the token
112: type names defined in the grammar and the semantic value type
113: .BR YYSTYPE ,
114: as well as a few
115: .B extern
116: variable declarations.
117: .sp
118: If the parser output file is named
119: \fIname\fB.c\fR
120: then this file
121: is named
122: \fIname\fB.h\fR.
123: .sp
124: This output file is essential if you wish to put the definition of
125: .B yylex
126: in a separate source file, because
127: .B yylex
128: needs to be able to refer to token type codes and the variable
129: .BR yylval .
130: .TP
131: .B \-l
132: .br
133: .ns
134: .TP
135: .B \-\-no-lines
136: Don't put any
137: .B #line
138: preprocessor commands in the parser file.
139: Ordinarily
140: .I bison
141: puts them in the parser file so that the C compiler
142: and debuggers will associate errors with your source file, the
143: grammar file. This option causes them to associate errors with the
144: parser file, treating it an independent source file in its own right.
145: .TP
146: .BI \-o " outfile"
147: .br
148: .ns
149: .TP
150: .BI \-\-output-file= outfile
151: Specify the name
152: .I outfile
153: for the parser file.
154: .sp
155: The other output files' names are constructed from
156: .I outfile
157: as described under the
158: .B \-v
159: and
160: .B \-d
161: switches.
162: .TP
163: .BI \-p " prefix"
164: .br
165: .ns
166: .TP
167: .BI \-\-name-prefix= prefix
168: Rename the external symbols used in the parser so that they start with
169: .I prefix
170: instead of
171: .BR yy .
172: The precise list of symbols renamed is
173: .BR yyparse ,
174: .BR yylex ,
175: .BR yyerror ,
176: .BR yylval ,
177: .BR yychar ,
178: and
179: .BR yydebug .
180: .sp
181: For example, if you use
182: .BR "\-p c" ,
183: the names become
184: .BR cparse ,
185: .BR clex ,
186: and so on.
187: .TP
188: .B \-t
189: .br
190: .ns
191: .TP
192: .B \-\-debug
193: Output a definition of the macro
194: .B YYDEBUG
195: into the parser file,
196: so that the debugging facilities are compiled.
197: .TP
198: .B \-v
199: .br
200: .ns
201: .TP
202: .B \-\-verbose
203: Write an extra output file containing verbose descriptions of the
204: parser states and what is done for each type of look-ahead token in
205: that state.
206: .sp
207: This file also describes all the conflicts, both those resolved by
208: operator precedence and the unresolved ones.
209: .sp
210: The file's name is made by removing
211: .B .tab.c
212: or
213: .B .c
214: from the parser output file name, and adding
215: .B .output
216: instead.
217: .sp
218: Therefore, if the input file is
219: .BR foo.y ,
220: then the parser file is called
221: .B foo.tab.c
222: by default. As a consequence, the verbose
223: output file is called
224: .BR foo.output .
225: .TP
226: .B \-V
227: .br
228: .ns
229: .TP
230: .B \-\-version
231: Print the version number of
232: .I bison
233: and exit.
234: .TP
235: .B \-h
236: .br
237: .ns
238: .B \-\-help
239: Print a summary of the options to
240: .I bison
241: and exit.
242: .TP
243: .B \-y
244: .br
245: .ns
246: .TP
247: .B \-\-yacc
248: .br
249: .ns
250: .TP
251: .B \-\-fixed-output-files
252: Equivalent to
253: .BR "\-o y.tab.c" ;
254: the parser output file is called
255: .BR y.tab.c ,
256: and the other outputs are called
257: .B y.output
258: and
259: .BR y.tab.h .
260: The purpose of this switch is to imitate
261: .IR yacc 's
262: output file name conventions.
263: Thus, the following shell script can substitute for
264: .IR yacc :
265: .sp
266: .RS
267: .ft B
268: bison \-y $*
269: .ft R
270: .sp
271: .RE
272: .PP
273: The long-named options can be introduced with `+' as well as `\-\-',
274: for compatibility with previous releases. Eventually support for `+'
275: will be removed, because it is incompatible with the POSIX.2 standard.
276: .SH FILES
277: /usr/local/lib/bison.simple simple parser
278: .br
279: /usr/local/lib/bison.hairy complicated parser
280: .SH SEE ALSO
281: .IR yacc (1)
282: .br
283: The
284: .IR "Bison Reference Manual" ,
285: included as the file
286: .B bison.texinfo
287: in the
288: .I bison
289: source distribution.
290: .SH DIAGNOSTICS
291: Self explanatory.
292:
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.