summaryrefslogtreecommitdiff
path: root/usr.bin/yacc/yacc.1
diff options
context:
space:
mode:
Diffstat (limited to 'usr.bin/yacc/yacc.1')
-rw-r--r--usr.bin/yacc/yacc.142
1 files changed, 19 insertions, 23 deletions
diff --git a/usr.bin/yacc/yacc.1 b/usr.bin/yacc/yacc.1
index 31977fdfdb7..262ebb7114e 100644
--- a/usr.bin/yacc/yacc.1
+++ b/usr.bin/yacc/yacc.1
@@ -1,4 +1,5 @@
-.\" $OpenBSD: yacc.1,v 1.9 2000/03/05 00:28:56 aaron Exp $
+.\" $OpenBSD: yacc.1,v 1.10 2000/03/14 14:58:27 aaron Exp $
+.\"
.\" Copyright (c) 1989, 1990 The Regents of the University of California.
.\" All rights reserved.
.\"
@@ -51,7 +52,7 @@ parser generator
.Op Fl p Ar symbol_prefix
.Ar filename
.Sh DESCRIPTION
-.Nm yacc
+.Nm
reads the grammar specification in the file
.Ar filename
and generates an
@@ -61,7 +62,7 @@ The parsers consist of a set of
.Tn LALR(1)
parsing tables and a driver routine
written in the C programming language.
-.Nm yacc
+.Nm
normally writes the parse tables and the driver routine to the file
.Pa y.tab.c .
.Pp
@@ -85,14 +86,14 @@ to be written.
If the
.Fl l
option is not specified,
-.Nm yacc
+.Nm
will insert #line directives in the generated code.
The #line directives let the C compiler relate errors in the
generated code to the user's original code.
If the
.Fl l
option is specified,
-.Nm yacc
+.Nm
will not insert the #line directives.
#line directives specified by the user will be retained.
.It Fl o Ar output_file
@@ -118,7 +119,7 @@ The default prefix is the string
The
.Fl r
option causes
-.Nm yacc
+.Nm
to produce separate files for code and tables.
The code file is named
.Pa y.code.c ,
@@ -128,7 +129,7 @@ and the tables file is named
The
.Fl t
option changes the preprocessor directives generated by
-.Nm yacc
+.Nm
so that debugging statements will be incorporated in the compiled code.
.It Fl v
The
@@ -137,20 +138,15 @@ option causes a human-readable description of the generated parser to
be written to the file
.Pa y.output .
.Sh ENVIRONMENT
-The following environment variable is referenced by
+The following environment variables affect the execution of
.Nm yacc :
.Bl -tag -width TMPDIR
.It Ev TMPDIR
-If the environment variable
-.Ev TMPDIR
-is set, the string denoted by
-.Ev TMPDIR
-will be used as the name of the directory where the temporary
-files are created.
+Name of directory where temporary files are to be created.
.El
.Sh TABLES
The names of the tables generated by this version of
-.Nm yacc
+.Nm
are
.Dq yylhs ,
.Dq yylen ,
@@ -169,6 +165,13 @@ and
are created if
.Dv YYDEBUG
is defined and non-zero.
+.Sh DIAGNOSTICS
+If there are rules that are never reduced, the number of such rules is
+written to the standard error.
+If there are any
+.Tn LALR(1)
+conflicts, the number of conflicts is also written
+to the standard error.
.Sh FILES
.Bl -tag -width /tmp/yacc.uXXXXXXXXXX -compact
.It Pa y.code.c
@@ -179,17 +182,10 @@ is defined and non-zero.
.It Pa /tmp/yacc.tXXXXXXXXXX
.It Pa /tmp/yacc.uXXXXXXXXXX
.El
-.Sh DIAGNOSTICS
-If there are rules that are never reduced, the number of such rules is
-written to the standard error.
-If there are any
-.Tn LALR(1)
-conflicts, the number of conflicts is also written
-to the standard error.
.Sh SEE ALSO
.Xr yyfix 1
.Sh STANDARDS
The
-.Nm yacc
+.Nm
utility conforms to
.St -p1003.2 .