SWiM version 1.0 by Steve Jennen	jennen%tigger.decnet@msus1.bitnet
Student Programmer, 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
terminal 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,i.e. the same ones used by
DecWindows(TWDRIVER.EXE and PYDRIVER.EXE).  

        $ RUN SYS$SYSTEM:SYSGEN
        LOAD TWDRIVER.EXE
        LOAD PYDRIVER.EXE
        CONNECT TWA0 /NOADAPTER /DRIVER=TWDRIVER
        CONNECT PYA0 /NOADAPTER /DRIVER=PYDRIVER

Then, compile and link SWiM as follows:

	$ cc/noopt swim
	$ link/notrace swim,swim.opt/opt

Or use the command procedure:

	$ @build

Then, create the help library for SWiM:

	$ library/create/help swim swim

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

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.

[librarian's note: I have found that the SWIM program needs to be
installed or run with privileges or it crashes as currently built.
I install it with /priv=(share,phy_io) to allow it to reset characteristics
of the pseudo terminals it uses. It is, once installed, a VERY nice
package. I recompiled and linked from source at my machine when the
supplied .exe failed. - Glenn Everhart ]