mirror of
https://github.com/FirebirdSQL/firebird.git
synced 2025-01-22 22:43:03 +01:00
106 lines
2.3 KiB
Plaintext
106 lines
2.3 KiB
Plaintext
.\" %W% %R% (Berkeley) %E%
|
|
.\"
|
|
.TH YACC 1 "July\ 15,\ 1990"
|
|
.UC 6
|
|
.SH NAME
|
|
Yacc \- an LALR(1) parser generator
|
|
.SH SYNOPSIS
|
|
.B yacc [ -dlrtv ] [ -b
|
|
.I prefix
|
|
.B ] [ -S
|
|
.I skeleton file
|
|
.B ]
|
|
.I filename
|
|
.SH DESCRIPTION
|
|
.I Yacc
|
|
reads the grammar specification in the file
|
|
.I filename
|
|
and generates an LR(1) parser for it.
|
|
The parsers consist of a set of LALR(1) parsing tables and a driver routine
|
|
written in the C programming language.
|
|
.I Yacc
|
|
normally writes the parse tables and the driver routine to the file
|
|
.IR y.tab.c.
|
|
.PP
|
|
The following options are available:
|
|
.RS
|
|
.TP
|
|
\fB-b \fIprefix\fR
|
|
The
|
|
.B -b
|
|
option changes the prefix prepended to the output file names to
|
|
the string denoted by
|
|
.IR prefix.
|
|
The default prefix is derived from the input filename.
|
|
.TP
|
|
.B -d
|
|
The \fB-d\fR option causes the header file
|
|
.IR y.tab.h
|
|
to be written.
|
|
.TP
|
|
.B -l
|
|
If the
|
|
.B -l
|
|
option is not specified,
|
|
.I yacc
|
|
will insert \fB#line\fR directives in the generated code.
|
|
The \fB#line\fR directives let the C compiler relate errors in the
|
|
generated code to the user's original code.
|
|
If the \fB-l\fR option is specified,
|
|
.I yacc
|
|
will not insert the \fB#line\fR directives.
|
|
\fB#line\fR directives specified by the user will be retained.
|
|
.TP
|
|
.B -r
|
|
The
|
|
.B -r
|
|
option causes
|
|
.I yacc
|
|
to produce separate files for code and tables. The code file
|
|
is named
|
|
.IR y.code.c,
|
|
and the tables file is named
|
|
.IR y.tab.c.
|
|
.TP
|
|
.B -t
|
|
The
|
|
.B -t
|
|
option changes the preprocessor directives generated by
|
|
.I yacc
|
|
so that debugging statements will be incorporated in the compiled code.
|
|
.TP
|
|
.B -v
|
|
The
|
|
.B -v
|
|
option causes a human-readable description of the generated parser to
|
|
be written to the file
|
|
.IR y.output.
|
|
.TP
|
|
\fB-S \fIskeleton file\fR
|
|
The \fB-S\fR option causes a different skeleton file to be used. The
|
|
default skeleton file is built in to \fIyacc\fR when it is built.
|
|
.RE
|
|
.PP
|
|
If the environment variable TMPDIR is set, the string denoted by
|
|
TMPDIR will be used as the name of the directory where the temporary
|
|
files are created.
|
|
.SH FILES
|
|
.IR filename\fB.code.c
|
|
.br
|
|
.IR filename\fB.tab.c
|
|
.br
|
|
.IR filename\fB.tab.h
|
|
.br
|
|
.IR filename\fB.output
|
|
.br
|
|
.BR /tmp/yacc.aXXXXXX
|
|
.br
|
|
.BR /tmp/yacc.tXXXXXX
|
|
.br
|
|
.BR /tmp/yacc.uXXXXXX
|
|
.SH DIAGNOSTICS
|
|
If there are rules that are never reduced, the number of such rules is
|
|
reported on standard error.
|
|
If there are any LALR(1) conflicts, the number of conflicts is reported
|
|
on standard error.
|