---------------------------------------------------------------------------
README for ST-Guide v1.3e (English Release 5)                 12th May 1995
===========================================================================
Important!
Previous versions were not given normal version nmbers but instead titled: 
Release 1, Release 2, Release 3 and Release 4.
From this release normal version numbers have been adopted so this v1.3 
supercedes Release 4 (and is effectively Release 5).

Read ST-GUIDE.CHG for details of the latest changes.

ST-Guide consists of two archives:

STGUIxxE.LZH:    Contains ST-Guide, HCP, HypFind, STool and RefLink
STGUTxxE.LZH:    Contains 1st-Conv, PC-Conv, MAN2STG with C source code 
                 along with HELP_RC, HELPDISK, HypTree and others!

We've included the source code so other programmers can debug or extend 
the converters. Please let me know and send me a copy of any changes you 
make so I can make sure everbody has access to the latest and optimum 
versions at all times.

---------------------------------------------------------------------------
Installation guide
===========================================================================

To minimise the risk of other software affecting the installation of 
ST-Guide perform the installation after a reboot on a 'clean' minimum 
system!

Extracting the archives
-----------------------
Extract the contents of the archives OR copy the contents of the master 
disk onto the root directory of your boot partition/disk.

Either method should preserve the directory structure and ensures ST-GUIDE 
can locate its files. Double check to ensure ST-GUIDE.ACC and ST-GUIDE.INF 
reside in the root directory of the boot partition or disk.

Configuring ST-Guide
--------------------
Using a text editor (eg Everest) load ST-GUIDE.INF and carefully read 
through the options. Each option is described in detail followed by the 
option line itself. Lines preceded with a '#' character are NOT currently 
active.

It's important the path entries are correct otherwise ST-Guide won't be 
able to find its files:

PATHS:   The path where HYP files are located, more than one path can be 
         entered, use the ';' character to seperate paths.
HYPFOLD: The default path used by the file selector and HCP.
HYPTOP:  The default hypertext loaded when ST-GUIDE is called without 
         parameters.
REF:     The path to the ALL.REF file, which may already be listed in the 
         PATHS variable. It's not needed during installation and can be 
         added later.
HCP:     The path to the compiler, HCP.TTP.

ST-GUIDE should not be renamed as some applications which offer on-line 
help may not be able to find it.

Managing your hypertexts
------------------------
Each hypertext consists of a HYP and a REF file. The HYP file contains the 
compiled hypertext and the REF file contains the references defined in the 
hypertext.
Using REFLINK.TTP it's possible to combine the references contained in 
each REF file into a single ALL.REF file.
There are several ways of adding the contents of an individual REF file to 
ALL.REF:
a) Install REFLINK.TTP as an application for '*.REF' files using the 
   desktop. After installation a double click on any REF file on the 
   desktop will call REFLINK.TTP and add the contents of the REF file to 
   an ALL.REF file located using the REF path in ST-GUIDE.INF.
b) Drag a REF file/s onto REFLINK.TTP.
c) Run REFLINK.TTP and manually enter the path to the desired REF file.
 
Catalogue your collection
-------------------------
Using STOOL.TOS it's possible to automatically catalogue all your 
hypertexts thematically. This does however depend on the author of the 
hypertext including the necessary infomation in the hypertext header.

On starting STOOL.TOS each of the paths entered in the ST-GUIDE.INF PATH 
entry is searched for HYP format hypertexts and creates a hypertext 
called CATALOG.HYP. this can be loaded via the 'Open' option from the 
'Extras' menu in ST-GUIDE.ACC or installed as the default hypertext in 
ST-GUIDE.INF.
                             
Finally
-------
Reboot your computer and we wish you every success using ST-Guide.
---------------------------------------------------------------------------
EOF