--- /dev/null
+
+
+
+PCCTS(1) PCCTS Manual Pages PCCTS(1)
+
+
+N\bNA\bAM\bME\bE
+ PCCTS - The Purdue Compiler Construction Tool Set
+
+D\bDE\bES\bSC\bCR\bRI\bIP\bPT\bTI\bIO\bON\bN
+ PCCTS is a set of public domain software tools designed to
+ facilitate the implementation of compilers and other
+ translation systems. These tools currently include _\ba_\bn_\bt_\bl_\br,
+ _\bd_\bl_\bg and support code. In many ways, PCCTS is similar to a
+ highly integrated version of YACC [Joh78] and LEX [Les75];
+ where _\ba_\bn_\bt_\bl_\br (ANother Tool for Language Recognition) corre-
+ sponds to YACC and _\bd_\bl_\bg (DFA-based Lexical analyzer Genera-
+ tor) functions like LEX. However, PCCTS has many addi-
+ tional features which make it easier to use for a wider
+ range of translation problems.
+
+ PCCTS grammars contain specifications for lexical and syn-
+ tactic analysis, intermediate-form construction and error
+ reporting. Rules may employ Extended Backus Naur Form
+ (EBNF) grammar constructs and may define parameters,
+ return values and local variables. Languages described in
+ PCCTS are recognized via Strong LL(k) parsers constructed
+ in pure, human-readable, C code. As a result, standard
+ debugging tools can be used to trace and debug PCCTS
+ parsers. Breakpoints can be set so that parser execution
+ stops before or after grammar fragments of interest have
+ been recognized.
+
+ PCCTS grammars may contain predicates which allow parsing
+ to be a function of semantics as well as syntax -- con-
+ text-sensitive grammars. Backtracking can also be speci-
+ fied to recognized non-LL(k) and non-LALR(k) constructs.
+ In addition, PCCTS supports intermediate-form (such as
+ expression-trees) construction via a flexible Abstract-
+ Syntax Tree (AST) mechanism which allows trees to be built
+ explicitly or automatically. The user explicitly creates
+ trees via a LISP-like tree constructor or directs the
+ automatic tree construction facility via simple grammar
+ directives. AST nodes are user-defined and are generally
+ a function of attributes. A default transformation from
+ attributes ($\b$-variables) to AST nodes can be specified.
+ Alternatively, each tree node can be defined explicitly
+ via an AST node constructor.
+
+I\bIN\bNS\bST\bTA\bAL\bLL\bLA\bAT\bTI\bIO\bON\bN
+ PCCTS includes a number of different programs and examples
+ in the software release package--most of which like to
+ live in their own directories. The install script will
+ build a standard hierarchy. The PCCTS executables (_\ba_\bn_\bt_\bl_\br,
+ _\bd_\bl_\bg) may be placed anywhere the user wishes but the
+ install script places them in the bin directory created
+ during installation.
+
+ To begin installation, place the pccts.tar file into the
+ directory where you want to place a pccts subdirectory.
+
+
+
+PCCTS April 1994 1
+
+
+
+
+
+PCCTS(1) PCCTS Manual Pages PCCTS(1)
+
+
+ Untar the file with
+
+ tar xvf pccts.tar
+
+ and cd into it. To install PCCTS, simply type
+
+ make
+
+ which will build the standard PCCTS directory hierarchy
+ (under the directory where you ran the install script) and
+ build executable versions of antlr and dlg.
+
+ The examples associated with PCCTS have makefile variables
+ called A\bAN\bNT\bTL\bLR\bR, D\bDL\bLG\bG etc... which must be set according to
+ your personal directory structure before _\bm_\ba_\bk_\be'ing. Some
+ variables point to the PCCTS executables if the P\bPA\bAT\bTH\bH envi-
+ ronment variable does not include your b\bbi\bin\bn directory.
+ Also, there are variables that point to PCCTS include
+ directories and must be changed if you deviate from the
+ standard PCCTS installation hierarchy. _\ba_\bn_\bt_\bl_\br and _\bd_\bl_\bg can
+ be built without executable versions of themselves (_\ba_\bn_\bt_\bl_\br
+ and _\bd_\bl_\bg are written in themselves).
+
+G\bGE\bET\bTT\bTI\bIN\bNG\bG S\bST\bTA\bAR\bRT\bTE\bED\bD
+ A C program called g\bge\ben\bnm\bmk\bk.\b.c\bc is available in the s\bsu\bup\bp-\b-
+ p\bpo\bor\brt\bt/\b/g\bge\ben\bnm\bmk\bk directory of the PCCTS release.
+
+S\bSE\bEE\bE A\bAL\bLS\bSO\bO
+ dlg(1), antlr(1)
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+PCCTS April 1994 2
+
+