superpascal, for p5c

quick start:
------------

Go to the superpascal directory, type

   ./test.sh

This should create the compiler and interpreter.

For more details see the original readme below.

Notes:

- the shar (shell archive) is already unpacked

- text files have already been converted to pdf

- the following information replaces specific parts of user.pdf & notes.pdf:

user.pdf
--------

  sections 1,2 & 3 of the user guide are for sun workstations
  The scripts in this p5c version assume a gnu environment (ie the bash shell).

  To set an alias as suggested in section 1, type this in the bash shell:

      alias sr=<path/to/superpascal>sr

  Also, this version replaces the sc & sr scripts with a single script, sr, that
  compiles and runs your superpascal program.  It takes the name of your
  program as an argument, eg type this to run hello.sp

      sr hello.sp


notes.pdf
---------

References to the build scripts are for sun workstations.
To build this version of superpascal use the test.sh script as described above.

File io in this version is via the program header, so the non-standard file
statements in aection 5 are unused.
The non-standard clock function comes from the c standard library.



Below is the original readme file forsuperpascal:

-----------------------------------------------------------------

         ANONYMOUS FTP OF THE SUPERPASCAL SOFTWARE

                     PER BRINCH HANSEN

         School of Computer and Information Science
        Syracuse University, Syracuse, NY 13244, USA

                       November 1993

These instructions describe the SuperPascal software, define
the terms and conditions for its use, and  explain  how  you
obtain the software by anonymous FTP.

                        DEFINITIONS

The SuperPascal software (hereafter Software) is educational
software written by Per Brinch Hansen (hereafter  PBH).  The
Software  consists of the Manuals, Programs, and Scripts for
the programming language SuperPascal invented  by  PBH.  The
Software is stored as text in 11 files (hereafter Files).
  The Manuals, written by PBH, are stored as LaTeX text in 3
Files:

     report.tex  "The programming language SuperPascal."

     user.tex    "The SuperPascal user manual."

     notes.tex   "The SuperPascal software notes."

  The  Programs,  written by PBH, are a SuperPascal compiler
and interpreter (hereafter Compiler  and  Interpreter).  The
Programs   are   written   in   Pascal  for  Sun3  and  Sun4
workstations running Unix. The Programs are stored as Pascal
text in 6 Files:

     common.p     The common declarations used by the
                  Compiler and Interpreter.

     scan.p       The Compiler procedure that performs
                  lexical analysis.

     parse.p      The Compiler procedure that performs
                  syntax, scope, and type analysis.

     assemble.p   The Compiler procedure that assembles
                  interpreted code.

     compile.p    The Compiler program.

     interpret.p  The Interpreter program.

  The  Scripts  are  Unix  shell scripts stored as text in 2
Files:

   sun3.user  A shell script for compilation of the
              Programs on a Sun3 workstation under Unix.

   sun4.user  A shell script for compilation of the
              Programs on a Sun4 workstation under Unix.

                    TERMS AND CONDITIONS

THE MANUALS ARE COPYRIGHTED BY PBH. THE PROGRAMS ARE IN  THE
PUBLIC DOMAIN. YOU CAN OBTAIN THE SOFTWARE BY ANONYMOUS FTP.
THE SOFTWARE IS NOT GUARANTEED FOR A PARTICULAR PURPOSE. PBH
SUPPLIES  THE  SOFTWARE  "AS  IS"  WITHOUT ANY WARRANTIES OR
REPRESENTATIONS AND DOES NOT  ACCEPT  ANY  LIABILITIES  WITH
RESPECT  TO THE SOFTWARE. YOU (THE USER) ARE RESPONSIBLE FOR
SELECTING THE SOFTWARE, AND FOR THE USE AND RESULTS OBTAINED
FROM  THE  SOFTWARE. YOUR USE OF THE SOFTWARE INDICATES YOUR
ACCEPTANCE OF THESE TERMS AND CONDITIONS.

                  FILE TRANSFER PROCEDURE

To obtain the Software, click here. Save it in some local
directory.

  Split the archive into Files by typing

                      sh software.shar

  Your local directory should now contain the Files.

                     HOW TO GET STARTED

Transform the LaTeX files into PostScript  files  and  print
the  Manuals.  Read  "The  SuperPascal software notes" which
explain how you  compile  the  Programs  on  Sun3  and  Sun4
workstations.  Compile  the  Programs  into  two  executable
files:

               sc  An executable Compiler.
               sr  An excutable Interpreter.

  Then read "The programming language SuperPascal" and  "The
SuperPascal user manual".

