V10/cmd/bison/bison.1

.TH BISON 1 local
.SH NAME
bison \- GNU Project parser generator (yacc replacement)
.SH SYNOPSIS
.B bison
[
.B \-dvy
] file
.SH DESCRIPTION
.I Bison
is a parser generator in the style of
.IR yacc (1).
It should be upwardly compatible with input files designed
for
.IR yacc .
.PP
Input files should follow the
.I yacc
convention of ending in ``.y''.
Unlike
.IR yacc ,
the generated files do not have fixed names, but instead use the prefix
of the input file.
For instance, a grammar description file named
.B parse.y
would produce the generated parser in a file named
.BR parse.tab.c ,
instead of
.IR yacc 's
.BR y.tab.c .
.PP
.I Bison
takes three optional flags.
.TP
.B \-d
Produce a
.B .tab.h
file, similar to
.IR yacc 's
.B y.tab.h
file.
.TP
.B \-v
Be verbose. Analogous to the same flag for
.IR yacc .
.TP
.B \-y
Use fixed output file names. I.e., force the output to be in files
.BR y.tab.c ,
.BR y.tab.h ,
and so on. This is for full
.I yacc
compatibility.
.SH FILES
/usr/local/lib/bison.simple	simple parser
.br
/usr/local/lib/bison.hairy	complicated parser
.SH SEE ALSO
.IR yacc (1)
.SH DIAGNOSTICS
``Self explanatory.''
... ha!