		     SCADALisp, Shareware Release
		    Cogent Real-Time Systems Inc.
			  September 20, 1995


1.  Installation
================

To install SCADALisp, do the following:

	$ melt -c scadalisp.tar.F | tar xf -
	$ su
	# sh ./install.sh

Alter the PATH variable in your .profile to include /usr/bin if
it does not already do so.

2.  Running
===========

To run SCADALisp, simply type phlisp for Photon, or qwlisp for QNX
Windows at the prompt.  This should produce a copyright notice and a
lisp> prompt.  You can now simply type to the prompt.

Command line arguments:

-c command	- Perform the command during startup.  More than one
		  -c option may be supplied.  Order is important.

-e		- Do not enter interactive mode.  Exit once all
		  command line arguments have been evaluated.

-f filename	- Execute the named file and turn on the -e flag.

-h		- Print a short help message.

-i filename	- Execute the named initialization file.  Does not
		  affect the -e flag.

-p		- Protect function code from the garbage collector.
		  This assumes that functions will not get redefined
		  during run-time.  In some circumstance this flag may
		  deliver up to 10% extra performance.

-q		- Do not print the copyright notice at startup.

-s stacksize	- Set the LISP stack size.  This may allow you to
		  reduce the data requirement by up to 15 KBytes.

filename	- If a filename appears on the command line without a
		  -f or -i qualifier, then it is treated as if -f were
		  provided, and all subsequent command line arguments
		  are passed to the SCADALisp program in the list
		  variable argv.  For example:
		      $ scadalisp -f myfile -q -s 2000
		  would instruct SCADALisp to run quietly (-q) with a
		  stack of 2000 and to exit after evaluating myfile.
		  On the other hand,
		      $ scadalisp myfile -q -s 2000
		  would instruct SCADALisp to execute the file myfile,
		  passing the list ("myfile" "-q" "-s" "2000") to the LISP
		  program in the variable argv.
