---------------------------------------------------------------------------------
README for pccts 1.33mr16 (Maintenance Release #16) release date 10 December 1998
---------------------------------------------------------------------------------

                          Parr Research Corporation
                                    with
                  Purdue University Electrical Engineering
                                    and
                       University of Minnesota, AHPCRC

                                Terence Parr
                                Russell Quong
                                 Will Cohen
                                 Hank Dietz


A central place for information about PCCTS 1.33 is:

        http://www.mcs.net/~tmoog/pccts.html

The maintenance release is available from:

        http://www.mcs.net/~tmoog/pccts133mr.zip

There is a ready-to-run version for win32 for Microsoft Visual Studio
at the same site.  It is available from:

        http://www.mcs.net/~tmoog/win32.zip

There is a newsgroup dedicated to pccts 1.33 and related topics:

        comp.compilers.tools.pccts

You may also want to register for the antlr-interest mailing list
which is provided gratis by the following service:

        http://www.onesite.com

New users should visit http://www.mcs.net/~tmoog/pccts.html in
order to get the following document:

        "Notes For New Users of PCCTS"

This is a Postscript file of about 40 pages which is extremely 
useful for someone starting out. It is a based on 1.33mr7 so is a
little bit out-of-date.  The section on semantic predicates is
very out of date, but I have not had time to revise it.

When you have a little more experience, be sure to review the
following documents in the distribution kit:

            CHANGES_FROM_133.txt
            KNOWN_PROBLEMS.txt

-------------------------------------------------------------------------
                      INSTALLATION (Unix)
-------------------------------------------------------------------------
0. Download http://www.mcs.net/~tmoog/pccts133mr.zip

1. Unzip the distribution kit to your preferred location.

2. cd to the main pccts directory.

3. make

   This will create:

        antlr.exe
        dlg.exe
        sorcerer.exe
        genmk.exe

4. Add pccts/bin to your path.

5. To get an up-to-date list of program options execute the
   program with no command line options.  To get up-to-date
   documentation read CHANGES_FROM_133.txt and KNOWN_PROBLEMS.txt
   at:

           http://www.mcs.net/~tmoog/pccts.html.

-------------------------------------------------------------------------
                    INSTALLATION (Win32)
-------------------------------------------------------------------------

I've tried to keep the win32 kit to the minimum necessary to get 
up and running.  The complete kit contains additional information
(some historical), source code, and DevStudio projects for 
rebuilding pccts from the source code.

0. Download http://www.mcs.net/~tmoog/win32.zip.

   You may also wish to download:

        http://www.mcs.net/~tmoog/CHANGES_FROM_133.txt
        http://www.mcs.net/~tmoog/KNOWN_PROBLEMS.txt

1. Unzip the distribution kit to your preferred location.

   This will create:

         a pccts directory tree
            pccts/bin/*.exe
            pccts/lib/*.lib
            pccts/h/*
            sorcerer/lib/*
            sorcerer/h/*

         an example directory tree
            example\calcAST\*
            example\simple\*

2. Define the environment variable PCCTS to point to the main
   pccts directory.

3. Try building the simple project: example\simple\simple.dsw.

4. Try building the complex project: example\calcAST\calcAST.dsw.

5. To get an up-to-date list of program options execute the
   program with no command line options.  To get up-to-date
   documentation read CHANGES_FROM_133.txt and KNOWN_PROBLEMS.txt
   at http://www.mcs.net/~tmoog/pccts.html.
