OC
				   ------
                      The Opl Compressor and Protector
		          (C)opyright 1997 Jon Read
			           ------
                                Version 0.9b
				   
Introduction
------------
OC is a program	to compress the variable and procedure names within an
OPL file.  There are several reasons to do this:

 1) The resulting OPL file, and the OPO/OPA produced after translating it,
    will be smaller and hence require less memory to edit or execute.

 2) If a program passed through OC is reverse translated using revtran,
    it will be much harder to understand and copy the code.

OC is available both as a command line operated DOS program and as an
APP for running on the Psion itself.  Both of these are included in the
distribution archive, OC_09B.ZIP.

DOS version
-----------
To use the DOS version, simpy pass the name of the OPL file you wish to
compress and the name of the output file on the command line.  For example:

OC COSMO.OPL COSMO2.OPL

The program will process the file COSMO.OPL and write the new file
COSMO2.OPL.  The output from the program will look something like this:

	OPL Compressor v0.9b    (C)opyright 1997 Jon Read

	Scanning procedures... 42 procedures found.
	Scanning variables... 131 unique variable names found.
	Ranking procedures and variables... Done.
	Sorting procedures... Done.
	Sorting variables... Done.
	Generating procedure names... Done.
	Generating variable names... Done.
	Converting procedure and variable names... Done.
	Conversion completed sucessfully.

Psion version
-------------
The Psion version installs as an application on the system screen.  Also
provided is an alias of the Program application, for editing and translating
the compressed OPL files that are produced.

To install the Psion version:

 1)  Copy OC.APP and OPC.ALS to any \APP directory.
 2)  Install them on the system screen using Psion-I.

After installation, a list of OPL files to be compressed will appear under
the OC icon.  Selecting one of these and pressing Enter will launch the
OC application, which will compress the selected file.  The compressed
file will be created with the same name as the original, but in a \OPC
directory.

Compressed files in the \OPC directory are displayed under the OPC icon;
edit one of these and translate it to produce the final OPO or OPA.

Notes
-----
 1)  This is beta software, and as such probably has bugs.  I take no
     responsibility for it introducing bugs into your code, either! ;-)
     I've tested and used it myself, and it appears to work OK on any
     valid OPL files - ie. ones that the translator has not problems
     with.  Strange results may occur if you try to compress non-valid
     code; robustness and speed are the major improvements aimed for
     version 1.0.
     
 2)  The Psion version of the program is written using the CLIB library,
     as it is generated from the same code as the DOS version.  It
     therefore requires a reasonable quantity of free memory to run
     (around 36K for a file with 42 procedures and 131 variables, plus
     of course available space for the output file).

Support
-------
The OC homepage is located at:
http://www.ecs.soton.ac.uk/~jnr95r/psion/oc.html

Please email any comments or bug reports to:
jnr95r@ecs.soton.ac.uk

Registration
------------
If the program you are releasing is to be given away as freeware (ie.
you do not charge for the program), then the use of OC is free.  If
the program you release if either commercial or shareware, then a
registration fee of 5 pounds sterling is required.

Please send cheques to:
	Jon Read
	5 Coombe Gardens
	Hughenden Valley
	High Wycombe
	Bucks HP14 4PD
	ENGLAND

Thank you for supporting this program.