CONTENTS of this directory:

   *.c            The program.  (Written in ANSI-C)

   words.*        Word list files.

   gp10.dict      The file containing the dictionary definitions.

   paper.dict     The abridged dictionary described in the paper.

   examples.batch A set of sentences from the paper illustrating the system.

   bad.batch      A set of sentences illustrating some of the limitations
                  of our system.

   Makefile       The makefile for creating the program "parse"

CREATING the system:

   To use the program, get all of these files, run the unix "make"
   facility with the unix command:

       make

   This creates a binary file called "parse".  To run the program issue
   the unix command:

       parse gp10.dict

   This starts the program.  Help is available there with "!help".

USING the program:

   There is a batch mode that allows the program to read a file full of
   sentences and process each of them.  This is started with, for
   example:

       parse gp10.dict -batch < examples.batch

   In a batch file, each line is one sentence, and everything after a "%"
   is ignored.  Each sentence may be marked with one of four symbols (at
   the start of the sentence).  Here is the notation.

   If you mark a sentence with:

     # -- it must die in the linking phase
     + -- it must pass linking and die in post-processing
     * -- it must die either in linking or postprocessing
     : -- it must be accepted with non-zero disjunct cost
       -- (no mark) it must be accepted (but with any cost)

   The command "!verbosity=1" causes the program to show the stages it's
   going through.  (If the compile flag "FOR_RELEASE" is undefined, then
   verbosity=1 mode also prints out the time required for each phase.)
   "!verbosity=2" gives more internal information.

   The command "!screen_width=120" causes the display to make use of
   a screen that is 120 characters wide.  Of course the width can be
   set to any value you like.

TECH report:

   For a detailed discussion of the capabilities, advantages,
   disadvantages, features, non-features, etc. of our system please see
   our tech report: CMU-CS-91-196.  This is available for anonymous
   ftp at the host spade.pc.cs.cmu.edu, in the file
   /usr/sleator/public/tech-report.ps.  It's 91 pages long.  A shorter
   (14 page) version is in /usr/sleator/public/short-paper.ps.

COMMERCIAL use:

   We feel that our system (or a derivative of it) could be useful in a
   number of commercial applications.  We would be pleased to negotiate
   an agreement with those wanting to use our system in this way.
   Without an explicit agreement with the authors (listed below) such use
   is forbidden.

ADDRESSES

   If you have any questions, or find any bugs, please feel free to send
   a note to:

         Daniel Sleator  <sleator@cs.cmu.edu>
         School of Computer Science
         Carnegie Mellon University
         5000 Forbes Ave.
         Pittsburgh, PA 15213
         412-268-7563

         Davy Temperley  <dt3@cunixa.cc.columbia.edu>
         609 W 189th Street #5A
         New York, NY 10040
