initial commit

tools/st-gui15/readme.now

@@ -0,0 +1,121 @@
+ST-Guide v1.5e                                                February 1997
+===========================================================================
+
+*** ST-Guide can now display 16 colour images! ***
+
+Some new variables have been added. Please refer to the Update History 
+node (in the ST-Guide hypertext) and read through the ST-GUIDE.INF file 
+for more details.
+
+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 separate 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.
+
+
+Registration
+------------
+The registered English Master disk includes the following programs 
+designed for use with ST-Guide:
+
+ST-Guide Lite:
+Cut down distribution which may be included by authors with any programs 
+which use ST-Guide format hypertexts.
+
+HypTree v3 Beta:
+Status: Freeware
+Programmed by: Martin Osieka
+Displays the tree structure of ST-Guide hypertexts
+
+Katalog-Maker:
+Status: Freeware
+Programmed by: Christoph Spengler
+Katalog-Maker makes a simple catalogue of hypertext files. It may be used 
+instead of the ST-Guide bundled STOOL which is more comprehensive but 
+harder to use.
+
+RefCheck v1.3:
+Status: Freeware
+Programmed by: Frank R<>ger
+Checks the consistency of the $REF (ALL.REF) file
+
+Remarker v0.4:
+Status: Shareware
+Programmed by: Christoph Spengler
+Remarker is a utility which allows comments to hypertext pages to be saved 
+in a separate file for each text.
+
+ST-Guide Creator 4:
+Status: Freeware
+Programmed by: Gregor Duchalski
+Includes 5 Tools for ST-Guide:
+TXT2STG   -Generates an ST-Guide STG format text from an ASCII file.
+           Text attributes, title generation and heirarchical chapter 
+           referencing can be automatically added.
+STGALIAS  -Generates alias names for pages.
+APPEND    -Appends one file to another.
+UFP2STG   -Changes the PC UFP format Star Trek data to ST-Guide format.
+TELE2STG  -Converts the Tele Office handbook into STG format. [German]
+---------------------------------------------------------------------------
+EOF