README

This file gives a brief overview of the SQRSH utility.

SQRSH is an SQR SHell.  It is an extensible, command line
oriented utility designed for use by SQR programmers, and 
is written entirely in SQR.

SQRSH is freely distributable as long as the original 
copyright notice is kept and the source code is provided.
For the legal language, see "COPYING.TXT".


INSTALLATION

To use SQRSH:

1) Download the file.

You may want to create a sub-directory in which to place all the 
SQRSH-related files.

   $ mkdir sqrsh
   $ mv sqrsh.zip sqrsh/sqrsh.zip
   $ cd sqrsh

2) Unpack the save set.

   $ unzip sqrsh.zip
or
   $ pkunzip sqrsh.zip

3) Compile the program.

   $ sqr sqrsh usr/psw -rs

4) Run the program.

   $ sqrt sqrsh usr/psw -xb


ADDING MODULES

SQRSH is built with extensibility in mind.  Included with the 
package is a module, GENSQRSH, which allows you to include 
additional SQRSH modules.  It reads a file which contains 
the names of .sqh files to include, which must be the same
as the names of the command used to invoke them within SQRSH.
See some of the existing .sqh files for examples of how to 
add modules.


BUG REPORTS

Please send suggestions, comments, bug reports to:

Ray Ontko
rayo@ontko.com