readme

編譯器的語法產生器

SUMMARY T-gen Version 2.2.1.

 T-gen is a general-purpose object-oriented tool for the
 automatic generation of string-to-object translators.
 It is written in Smalltalk and lives in the Smalltalk
 programming environment.  T-gen supports the generation
 of both top-down (LL) and bottom-up (LR) parsers, which
 will automatically generate derivation trees, abstract
 syntax trees, or arbitrary Smalltalk objects.  The simple
 specification syntax and graphical user interface are
 intended to enhance the learning, comprehension, and
 usefulness of T-gen.


LEGAL INFORMATION
=======================================================================
The authors make NO WARRANTY or representation, either express
or implied, with respect to this software, its quality, accuracy,
merchantability, or fitness for a particular purpose.  This software
is provided "AS IS", and you, its user, assume the entire risk as to
its quality and accuracy.

This software is copyright (c) 1992, 1994 by Justin O. Graver.
All rights reserved, except as specified below.

Permission is hereby granted to use, copy, modify, and distribute
this software (or portions thereof) for any purpose, without fee,
subject to these conditions:
(1) If any part of the source code for this software is distributed,
then this notice must be included, unaltered; and any additions,
deletions, or changes to the original files must be clearly indicated
in accompanying documentation.
(2) Permission for use of this software is granted only if the user
accepts full responsibility for any undesirable consequences; the
authors accept NO LIABILITY for damages of any kind.

Permission is NOT granted for the use of any author's name in
advertising or publicity relating to this software or products
derived from it.

We specifically permit and encourage the use of this software as the
basis of commercial products, provided that all warranty or liability
claims are assumed by the product vendor.

Developed under the direction of Justin Graver.
Authors include: Justin Graver, Virat Hanvivatpong, and David Wilson.

Send any comments, suggestions, or defects to: [e-mail].
=======================================================================


DISTRIBUTION

This directory contains source code and documentation for T-gen.

Supplemental Files:
 usrguide.ps:  contains a Postscript version of the T-gen user's guide.

 st80comp.st:  contains a T-gen version of the Smalltalk-80
  complier that builds parsetrees using the standard Smalltalk parsetree 
classes.

 tstsuite.st:  contains methods for performs several basic tests
  on the T-gen system.  Refer to TranslatorGenerator class>>runAllTests.

This README file contains the Smalltalk code necessary to build the current
version of T-gen, which runs under ParcPlace's VisualWorks(tm) Release 2.0.
To install T-gen, see INSTALLATION below.  (If you want to use T-gen with
VW Release 1.0, simply remove the file vw2delta.st from the list of files in the
INSTALLATION section below.)


INSTALLATION

To install the complete T-gen system, fill in the appropriate path for the
T-gen source files and then select and evaluate the following expression:

| sourceDir |
sourceDir := '\smalltalk\newtgen\' asFilename.
#(
'Collections-Graphs.st'
'Collections-GraphNodes.st'
'Compilers-Parsers.st'  
'Compilers-Scanners.st'
'T-gen-Support.st'
'T-gen-ParseTrees.st'
'T-gen-GrammarNodes.st'
'T-gen-RegularExpressionNodes.st'
'T-gen-TokenSpecificationNodes.st'
'T-gen-ScanningParsing.st'
'T-gen-ConflictStrategies.st'
'T-gen-Interface.st'
'T-Genmisc.st'
'T-gen-init.st'
)
 do: [:file | (sourceDir construct: file) fileIn]


To install a minimal T-gen system, capable of executing scanners
and parsers generated by T-gen but which does not contain the T-gen
tool interface, select and evaluate the following expression:

| sourceDir |
sourceDir := '../T-gen/' asFilename.
#(
'Collections-Graph_Nodes.st'
'Compilers-Parsers.st' 
'Compilers-Scanners.st'
'T-gen-Parse_Trees.st' 
'T-gen-Scanning_Parsing.st'
'misc-changes.st'
)
 do: [:file | (sourceDir construct: file) fileIn]