SWiM version 2.0 by Steve Jennen       jennen@tigger.stcloud.msus.edu
Student Programmer, Academic Computer Services
St. Cloud State University, St. Cloud, MN 56301
=========================================================================

Welcome to SWiM, the multi-session windowing terminal application for
VAX/VMS.  SWiM let's you open windows on your terminal screen, each window
becoming a terminal in itself.  In the windows then, you can log into your
same account (the one running SWiM) or into a different account.  Each
window is an almost full featured VT100 terminal, running most popular
applications available for the VAX.

SWiM allows dynamic sizing of the windows, movement of windows to anywhere
on or off the screen, CUT and PASTE between windows and a back-scroll
feature to look at information that has just scrolled off your screen. 
Once you have the number of windows you're comfortable with and you've
placed them in your favorite location, SWiM allows you to save that
information in a script file.  Next time you run SWiM, you can specify the
loading of the script file and your setup will be properly reproduced. 
SWiM is fun, useful and addicting and I hope you enjoy it.

To set up SWiM on your system, first install the pseudo-terminal drivers
according to the documentation for them.  (Note: The pseudo-terminal drivers are
now part of DECwindows, so if you've installed that you're ready to go.  If not,
then you may have already installed them for some other utility, just do a SHOW
DEV and look for two devices called PYA0 and TWA0.  If they are there, then
you're set.)  Then, compile and link SWiM as follows:

	$ cc/opt=(disj,inline) swim
	$ link/notrace swim,swim.opt/opt

The VAX C compiler can be resource intensive during a compilation with
optimizations turned on, so if you get a "Compiler Abort" message, use an
account with sufficient quotas to compile SWiM or simply compile using
"cc/noopt".

Then, create the help library for SWiM:

	$ library/create/help swim swim

Or use the command procedure to compile, link and create the help library:

	$ @build

SWiM uses a logical SWIM_LOCATION to point to the location of the help
library.  This logical must be defined before running SWiM.

SWiM needs to be INSTALLED with privs and you can do this by:

$ INSTALL
INSTALL> CREATE SWIM_LOCATION:SWIM  /OPEN /HEADER /SHARE /PRIV=SHARE
INSTALL> EXIT
$

The important option there is the PRIV=SHARE.  SWiM needs this priv to modify
the pseudo-terminal device characteristics that may be owned by a process other
than the process activating the SWiM image.

Setup SWIM as a foreign command:

	SWIM == "$swim_location:swim"

It'll accept one parameter, that being the script-file-name:

	$ swim [script-file-spec]

The script-file has a default extension of ".SWM", which will be added
automatically by SWiM during the creation of the script file.

For information on differences between version 2.0 and 1.0, please read the
first few pages of the source file SWiM.C.