

		Schoonschip, Version 91

				Copyright (C) 1991 by Martinus J. G. Veltman.

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.  A reasonable effort
will be made to correct bugs, which may be reported to

   Prof. M.J.G. Veltman
   Physics Department
   University of Michigan
   Ann Arbor, MI 48109

or

   Prof. David N. Williams
   Physics Department
   University of Michigan
   Ann Arbor, MI 48109

   David_N._Williams@um.cc.umich.edu
   DWilliams@UMiPhys.bitnet
   75706.3124@CompuServe.com


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 has been 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 distribution for each machine consists of 2 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 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.

Distributions are provided for the Atari, Amiga, MacII, Sun 3/60, and NeXT
computers, with 680x0 cpu's, except that the Macintosh version will be
delayed for a future release.  The program should run in approximately 650
kilobytes of memory, 500 K 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, MAC, SUN, or NXT.  They include the following files:

	README 		(this file)
	README.FTP	a brief guide to anonymous ftp
	Schip		executable

   Amiga version only:

	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

   Mac version only:

	(yet to be determined)

Installation for CLI-based (command line interface) operation is the same
for all machines:  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:

	README		(this file)
	README.FTP	a brief guide to anonymous ftp

   Documentation:

	Schipmanual.e	(the place to begin)

   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

Among the program files, the essential ones for the beginner are the
manual, Schipman.e, and the examples file, Examples.e, which is 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
					October 10, 1991
