README revised March 6, 2004.

COPYRIGHT AND DISCLAIMER

Schoonschip, Version 91
Copyright (C) 1991 by Martinus J. G. Veltman.
Distribution of October, 1991.

The copyrights to the Schoonschip program and source code are
owned exclusively by their author, M.J.G. Veltman.  The
executable code, as well as the example and documentation files
listed below, may be freely disseminated and used on a
not-for-profit basis--small charges may be made to cover
distribution costs.  We think it important that the files in
this distribution be kept together in any redistribution.

This software is provided "as is", and includes no guarantee of
support, implied or otherwise.  Neither the author nor his
agents shall be responsible for any problems associated with its
use.

The executable files in this distribution run mostly on obsolete
680x0 machines, so the archive is mainly of historical interest.
The partial exception is the Macintosh version, which still runs
under OS 9.2.2, and under many earlier versions of the Macintosh
operating system, including with Classic under OS X.  The 680x0
code is of course emulated on power pc's.


OVERVIEW

Schoonschip is an algebraic manipulation program, which was
designed for large problems, originally in particle physics, and
which pioneered a number of the concepts now generally used in
algebraic computation.  Its interface is not as slick as some of
the "modern" symbolic manipulation programs, and it does not
have as many built-in procedures as some of them do, requiring
the user to construct more of his own.  But it is written in
machine language and is fast, capable, and efficient in its use
of machine resources.

It was developed always in a context of solving real problems,
over a period of nearly 28 years.  As a result it is
(relatively) bug free, and its algorithms embody a certain
experience.  It has to be emphasized that no program of this
complexity can be truly bug free, and that the problem of
ensuring the correctness of machine solutions to real problems
remains unsolved, and must always be taken seriously by the
user.


DISTRIBUTION SPECIFICS

The general distribution includes a pdf copy of Prof. Veltman's
manual, edited, LaTeX'd, and indexed by dnw.

Except for the Macintosh, the distribution for each machine
consists of two compressed archive files, one of which contains
the binary executable and is machine specific, and the other of
which contains text files with examples and a manual, the same
for all machines.

The Macintosh distribution consists of two dmg files, one for
the Classic executable, and one for the text files, with
Macintosh line ends.

The Amiga distribution includes the executable files IconJ and
AtatJ, version 1.0, 1990 by Rich Franzen, whose free use he has
permitted, and for which we thank him.  The Amiga version also
runs on the Macintosh with the MaxUAE Amiga emulator, under OS 9
and OS 9 Classic.

Distributions are provided for Atari, Amiga,  Sun 3/60, NeXT,
and Macintosh computers, with 680x0 cpu's.  The program should
run in approximately 650 kilobytes of memory, 500K of which is
for a work space and must be contiguous.  There are ways to
change the size of the work space, both down and up.

The machine specific archive files have a 3-character
designation in the file name:  ATA, AMI, SUN, NXT, or Mac.  All
but the Macintosh version include the following files:

        README          1991 version of this file
        Schip           executable

The Amiga version also contains:

        Install.txt     installation instructions for icons, etc.
        Schip.info      icon for executable
        SchipDoc.icon   icon template for documents
        IconJ           executable tool for Schip.info
        AtatJ           executable document icon attachment utility 
        DoIcon          sample document icon attachment script

The Macintosh version contains:

        README.txt      this file
        READMEmac.txt   how to run MacSchip
        MacSchip        executable

Installation for CLI-based (command line interface) operation is
the same for all machines (except that no CLI version is
provided for the Macintosh):  place the executable file in a
directory in your execution path, and make its mode executable,
if necessary.  This is the mode of operation for which the
program is designed.

The text archive file comes in several flavors, corresponding to
common archiving tools and text file conventions on the various
machines.  Their contents are identical, and include the
following text files (the README's are all archaic):

        README          1991 version of this file
        README.1st      instructions for uncompression
        README.FTP      a guide to anonymous ftp

   Documentation:

        Schipmanual.e   (superceded by the pdf version)

   Schoonschip programs:

        Anomaly.e
        Examples.e
        Roblocks.e
        Roparam.e
        Schipman.e
        Spinors.e
        Stand.e
        Standb.e
        Varia.e
        Vectors.e
        WW.e
        WWb.e

The essential program file for beginners is Examples.e, which
contains examples discussed in the manual.  The applications in
the remaining program files are of interest mostly to physics
specialists, but they may provide further insight into methods
of programming with Schoonschip.

                                        David N. Williams
                                        Ann Arbor, Michigan
                                        March 7, 2004