From 08f25f90db8dd53b2f85c1e094aeff4122ae0e89 Mon Sep 17 00:00:00 2001
From: Lars Brinkhoff <lars@nocrew.org>
Date: Mon, 28 Jan 2019 08:51:49 +0100
Subject: [PATCH] YACC - parser generator.

Binary file originally from ES; TS YACC, timestamped 1978-05-21.  The
help file is from a TOPS-20 machine; timestamp 1981-08-25.
---
 bin/c/ts.yacc   | Bin 0 -> 64874 bytes
 doc/c/oyacc.hlp | 341 ++++++++++++++++++++++++++++++++++++++++++++++++
 doc/programs.md |   1 +
 3 files changed, 342 insertions(+)
 create mode 100644 bin/c/ts.yacc
 create mode 100644 doc/c/oyacc.hlp

diff --git a/bin/c/ts.yacc b/bin/c/ts.yacc
new file mode 100644
index 0000000000000000000000000000000000000000..5dffc0ca418c3c96fc873379e9f401eb37c0440f
GIT binary patch
literal 64874
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

literal 0
HcmV?d00001

diff --git a/doc/c/oyacc.hlp b/doc/c/oyacc.hlp
new file mode 100644
index 00000000..8e6b3df0
--- /dev/null
+++ b/doc/c/oyacc.hlp
@@ -0,0 +1,341 @@
+                    YACC - Use and Operation
+                              - 2 -
+
+
+1.  Introduction
+
+This paper describes  the use and  operation of a  LALR(1) parser
+generator YACC (Yet Another Compiler-Compiler).  YACC  accepts as
+input a BNF-like grammar  and, if possible, produces as  output a
+set of  tables for a  table-driven shift-reduce  parsing routine.
+The parsing routine and  the tables together form a  parser which
+recognizes  the  language  defined by  the  grammar.   The parser
+generated by YACC can be used as the core of a syntax analyzer by
+including in the grammar calls to user-provided  action routines.
+These calls are made by  the parser at the appropriate  points in
+the analysis of the input string.
+
+The class of LALR(1) grammars is a subclass of the class of LR(1)
+grammars, those which can be parsed by a  deterministic bottom-up
+parser using one symbol  of lookahead.  The LALR(1)  grammars are
+those LR(1) grammars for which  a parser can be constructed  by a
+relatively efficient  process.  Theoretically,  all deterministic
+context-free languages have a LR(1) grammar, but  not necessarily
+a LALR(1)  grammar.  Practically, however,  it has  been observed
+that most  common programming  languages have  "natural" grammars
+which are easily converted to be LALR(1).
+
+The original YACC was designed and implemented on a PDP-11/45 and
+a  Honeywell 6000  by S.  C. Johnson  at Bell  Laboratories.  The
+version described in this paper was implemented on the  PDP-10 by
+Alan Snyder.
+                              - 3 -
+
+
+2.  Using YACC
+
+In the simplest  case, the input to  YACC is a file  containing a
+BNF-like grammar  for the  language.  The  grammar consists  of a
+sequence of rules, which have the following syntax:
+
+         rule:               lhs ':' rhs_list
+         lhs:                symbol
+         rhs_list:           rhs | rhs_list '|' rhs
+         rhs:                symbol_sequence
+         symbol_sequence:    symbol | symbol_sequence symbol
+ 
+The above rules for rules are examples of rules.  Another example
+is the following simple grammar for expressions:
+
+         e:        e '+' t  |  e '-' t  |  t
+         t:        t '*' p  |  t '/' p  |  p
+         p:        idn  |  '(' e ')'
+ 
+A symbol  is any sequence  of alphanumeric  characters, including
+underlines, dollar signs, and periods.  In addition, a symbol may
+be any sequence of characters enclosed in single quotes.
+
+The symbols which appear as the left-hand-sides of rules  are the
+non-terminal symbols; all other symbols appearing in  the grammar
+are assumed to be terminal symbols.  The symbol appearing  as the
+left-hand-side of the  first rule is  considered to be  the start
+symbol of the grammar.
+
+After a file containing  the grammar  has been prepared,  YACC may  be
+run.  YACC will respond by  asking for the name of the file containing
+the grammar.  After  the file  name is  entered,   YACC will   analyze
+the grammar  and  construct the parsing tables.  YACC will print  some
+messages on  the  terminal to  indicate  its progress.   When  it  has
+finished, a listing will have been placed on the file  YACC OUTPUT and
+the parsing  tables will have been written onto the file YACC TABLES.
+
+In the process  of constructing  a  parser for the  grammar, YACC
+may discover conflicts in the grammar.  These  conflicts indicate
+that the grammar is not LALR(1).  The conflicts, which are listed
+in  the OUTPUT  file, may  be of  two types.   The first  type of
+conflict  is  a   shift/reduce  conflict,  abbreviated   S/R.   A
+shift/reduce conflict indicates that, in the given state and with
+the given input symbol, the constructed parser could legitimately
+either shift the input symbol onto the stack or make an immediate
+reduction.  Shift/reduce conflicts are resolved by YACC  in favor
+of  shifting.  The  second type  of conflict  is  a reduce/reduce
+conflict,  abbreviated R/R.   A reduce/reduce  conflict indicates
+that, in  the given state  and with the  given input  symbol, the
+parser  could  legitimately   make  either  of   two  reductions.
+Reduce/reduce  conflicts are  resolved by  YACC in  favor  of the
+production appearing earlier in the input file.
+
+The relation  of a conflict  to a problem  in the grammar  can be
+                              - 4 -
+
+
+determined by examining  the description of the  particular state
+in the action table section  of the OUTPUT file.  The  first part
+of the description  is a set  of items, where  an item is  a rule
+which contains a marker ('.') in the right-hand-side.  The marker
+indicates how much  of the right-hand-side  has been seen  by the
+parser when the parser is in that state.  Thus, the collection of
+items represents the set of possibilities being considered by the
+parser when in that state.  A conflict indicates that  the parser
+cannot  discard one  of  two possibilities  on the  basis  of the
+current  input symbol,  yet  any action  it takes  will  have the
+effect of eliminating one of the two possibilities.
+                              - 5 -
+
+
+3.  Interfacing with a Lexical Analyzer
+
+The  parsing tables  produced by  YACC  are in  the form  of  a C
+program, ready  to be compiled  by the C  compiler (CC).   This C
+program may  be loaded  together with the  compiled version  of a
+parsing routine in  order to construct  a working parser  for the
+language.  A standard parsing routine, called PARSE, may be found
+in the file "<C>YPARSE.C".
+
+PARSE assumes the existence of a lexical routine,  called GETTOK,
+which it  can call in  order to obtain  the next  terminal symbol
+from the input stream.  GETTOK  is expected to set the  values of
+three integer global  variables, LEXTYPE, LEXINDEX,  and LEXLINE.
+LEXTYPE should  be set  to an  integer which  distinguishes which
+terminal  symbol  has  been  read.   The  correspondence  between
+integers  and  terminal  symbols is  listed  in  the  OUTPUT file
+produced by YACC.  However, it is more convenient when  an actual
+parser  is  to  be  constructed to  specify  in  the  grammar the
+correspondence between  integers and  terminal symbols.   This is
+done by listing at the beginning of the file the terminal symbols
+of the  grammar.  They will  be numbered  consecutively, starting
+with 3.  (The integer 1 is to be returned by the  lexical routine
+to  indicate  the end  of  the  input stream;  the  integer  2 is
+reserved for an error  recovery method.) The listing  of terminal
+symbols in the grammar should be separated from the list of rules
+by the symbol '\\'.  For example, the grammar
+
+         '+' '-' '*' '/' '(' ')' idn
+
+         \\
+
+         e:        e '+' t  |  e '-' t  |  t
+         t:        t '*' p  |  t '/' p  |  p
+         p:        idn  |  '(' e ')'
+ 
+defines the following representations of terminal symbols:
+
+         eof       1
+         +         3
+         -         4
+         *         5
+         /         6
+         (         7
+         )         8
+         idn       9
+ 
+The variable  LEXLINE should  be set  to the  line number  in the
+input file on which the terminal symbol being  returned appeared;
+this value is used by  PARSE when reporting syntax errors  and is
+made available to any action routines.  The variable  LEXINDEX is
+used only when performing translations (see next section).
+
+In addition,  PARSE requires  a routine  PTOKEN which  will print
+some symbolic  representation of  a token;  this routine  is used
+when reporting syntax errors.
+                              - 6 -
+
+
+4.  Performing Translations
+
+As described so far,  the parser performs only  recognition; that
+is, given an  input string of  terminal symbols, it  will produce
+error messages if  the string is not  in the language  defined by
+the grammar and  do nothing otherwise.   YACC is capable  also of
+producing tables  for a parser  which performs  translations, for
+example,  the  syntax  analyzer  of  a  compiler.   The following
+extension is  made in order  to support translation:   the parser
+associates with each  terminal symbol (received from  the lexical
+routine) and each nonterminal symbol (resulting from a reduction)
+a  word (integer,  pointer)  called a  translation  element.  The
+translation  element for  a terminal  symbol is  produced  by the
+lexical  routine;  it is  communicated  to PARSE  via  the global
+variable  LEXINDEX.   Typically, the  translation  element  for a
+terminal  symbol  is   used  to  distinguish   between  different
+identifiers  and  constants.   The  translation  element   for  a
+nonterminal symbol is obtained by calling a  user-provided action
+routine when a reduction  is made which produces  the nonterminal
+symbol.   This  action  routine  is  specified  by  following the
+production  rule in  the grammar  with the  body of  the routine,
+enclosed  in   braces.   The  action   routine  may   access  the
+translation elements  associated with the  symbols on  the right-
+hand-side of the production  using the notation #n, where  "n" is
+the  number of  the symbol  (i.e., #1  refers to  the translation
+element for the first symbol of the right-hand-side).  The action
+routine specifies the value for the left-hand-side by setting the
+global variable VAL.  A typical action routine in a  parser which
+produces tree representations is
+
+         {val=node(node_type,#1,#2,#3);}
+ 
+where node is  a routine which constructs  nodes of the  tree and
+node_type is  a tag  which indicates  the type  of the  node.  An
+action routine  may also specify  a line-number to  be associated
+with the left-hand-side by setting the global variable  LINE; the
+line-numbers of the symbols on the right-hand-side are accessible
+through the global variable  PL (i.e., pl[3] refers to  the line-
+number of the third symbol on the right-hand-side).
+                              - 7 -
+
+
+5.  Disambiguation
+
+YACC is capable of disambiguating ambiguous grammars  through the
+use  of  precedence  and  associativity  information.    This  is
+especially useful in the case of arithmetic expressions  since it
+allows  a much  simpler  grammar to  be used.   For  example, the
+grammar for expressions given above could be written:
+
+         '+' '-' '*' '/' '(' ')' idn
+
+         \<  '+' '-'
+         \<  '*' '/'
+
+         \\
+
+         e:          e '+' e
+                   | e '-' e
+                   | e '*' e
+                   | e '/' e
+                   | idn
+                   | '(' e ')'
+ 
+The two lines following  the list of terminal symbols  create two
+levels of precedence in increasing order and assign  those levels
+to the terminal symbols appearing on those lines.  The '\<' which
+begins a  new precedence  level also  indicates left-association.
+One  may  also  specify  '\>'  for  right-association   and  '\2'
+indicating that association is  not permitted (is to  be regarded
+as a syntax  error).  This last feature  may be used  to prohibit
+the  misleading  association  of  operators  such  as comparision
+operators.
+                              - 8 -
+
+
+6.  The Operation of YACC
+
+The operation  of YACC  is performed in  five steps.   First, the
+input file is read and an internal representation of  the grammar
+is  created.   Second,  certain  auxiliary  data  structures  are
+constructed which contain information about the grammar  which is
+used by later steps.   Third, the canonical LR(0) parser  for the
+grammar is constructed.  Fourth, the LR(0) parser is  analyzed by
+computing and applying lookahead in order to resolve conflicts in
+the LR(0) parser.  Finally, a listing is written onto  the OUTPUT
+file  containing  the  remaining  conflicts  in  the  parser, the
+grammar, and the parser  itself, and the tables are  written onto
+the TABLES file.
+
+6.1  Constructing the Canonical LR(0) Parser
+
+The canonical LR(0) parser for the grammar is constructed  by the
+following method:   First, the grammar  is augmented by  adding a
+production
+
+         $accept:  S -|
+ 
+where the symbol $accept is a distinguished nonterminal  added by
+YACC, S represents the  starting symbol of the  original grammar,
+and -|  represents the end-of-file  symbol.  Second,  the initial
+state of the parser is created containing the item
+
+         $accept  ->  . S -|
+ 
+and its closure.  The closure of  a set of items I is  defined to
+be  the smallest  set of  items  C containing  I such  that  if C
+contains an item of the form
+
+         A  ->  a . B b
+ 
+for some nonterminal B and  strings a and b, then C  contains all
+items of the form
+
+         B  ->  . w
+ 
+for string w.  The final step in constructing the canonical LR(0)
+parser consists of constructing the set of states  accesible from
+the initial state.  The set of accesible states is defined  to be
+the smallest set of states containing the initial state such that
+for each state i in S, if  j is the successor state of i  on some
+symbol x, then j is in S.  The successor state j of a state  i on
+a symbol x is constructed in two steps:  First, for each  item in
+state i of the form
+
+         A  ->  a . x b
+ 
+for nonterminal A and strings a and b, the item
+
+         A  ->  a x . b
+ 
+                              - 9 -
+
+
+is added to state j.  Second, the closure of the set of  items in
+state j is added to state j.
+
+6.2  Applying Lookahead to the LR(0) Parser
+
+The constructed  LR(0) parser  will generally  contain conflicts,
+that is, states in which  more than one action is valid  for some
+input symbol.  An item of the form
+
+         A -> a .
+ 
+is called a reduce  item (reduction) since it indicates  that the
+entire right-hand-side of a  rule has been recognized and  can be
+reduced to the left-hand-side.  An item of the form
+
+         A -> a . x b
+ 
+where x  is a terminal  symbol, is called  a shift item  since it
+indicates that if x is  the current input symbol, then  it should
+be shifted onto the  stack and control passed to  the x-successor
+state, which will contain the item
+
+         A -> a x . b
+ 
+If a state in the LR(0) parser contains a reduce item and  one or
+more shift items,  or more than one  reduce item, then  the state
+contains a conflict.  Such conflicts may be resolved if it can be
+determined that the reductions  are valid only for  certain input
+symbols.   In  any state,  if  the sets  of  valid  input symbols
+("lookahead sets")  for each  reduction and  the set  of terminal
+symbols for which successor states exist are disjoint, then there
+is no conflict in that  state, since the parser can  determine by
+looking  at  the current  input  symbol whether  to  shift  or to
+reduce, and what reduction to make.
+
+In YACC, the lookahead sets are computed one terminal symbol at a
+time; that is, for  each terminal symbol, it is  determined which
+reductions are applicable (contain that terminal symbol  in their
+lookahead set).  Then, each state of the LR(0) parser  is checked
+for conflicts on  that terminal symbol.   If there are  more than
+one  applicable  reduction,  then  a  reduce/reduce  conflict  is
+announced.  If there is a successor state on that terminal symbol
+and  one  or  more  applicable  reductions,  then  a shift/reduce
+conflict is announced.
diff --git a/doc/programs.md b/doc/programs.md
index 900a8ac5..af59e2f7 100644
--- a/doc/programs.md
+++ b/doc/programs.md
@@ -341,6 +341,7 @@
 - XGP, PDP-11 controller for the Xerox Graphics Printer.
 - XGPSPL, spooler for the Xerox Graphics Printer.
 - XXFILE, feed scripted input to a STY session.
+- YACC, parser generator.
 - YAHTZE, the game of Yahtzee.
 - YOW, print Zippyisms.
 - ZAP, dump TV bitmap as an XGP scan file.