Contents of the READ.ME file
HyperShell Release 4.0 - April 1991
HyperShell is a general purpose hypertext control system. Standard
hypertext features provided include a text frame based presentation
style with highlighted references permitting navigation to other
frames in the same or another file, to popup notes which can have
further references, and allowing backtracking through visited
frames, and marking of frames and references for later perusal. The
program also supports graphic screen displays with nested selection
zones, using the common BLOAD format screen files for monochrome
images and Microsoft Paintbrush (.PCX) files for colour and some
monochrome images. CGA,EGA,VGA and Hercules graphics adaptors are
Special features offered include popup menus, paged displays of
menus or text files, DOS management facilities, scripting language
with programming capability, variables, macros, formfill input
fields and numerous features such as program invocation permitting
the use of HyperShell for menuing systems, help systems, computer
aided instruction, simple databases, DOS directory managers and
numerous other applications. Alternative hypertext structures are
also supported, permitting adhoc creation of supporting text. The
hypertext files and supporting files can be compressed and can be
directly accessed in compressed form.
HyperShell has been designed to be fast, small, and powerful,
supporting files larger than available memory whilst occupying a
fixed amount of memory itself (128k currently) so that it can be
used for controlling other applications. It is designed to run on
the widest range of equipment, and the components do not need any
more than a minimal 256k twin floppy mono system (or just a single
floppy system for the reader component to be used), although they
will benefit from the use of colour, a mouse, and a hard disk. The
system is very configurable, including colour schemes, key
mappings, all text strings, control menu and presentation 'look and
feel'. The supporting files are of textual content, permitting easy
production and maintenance.
The system provided as shareware is the full 4.0 release
incorporating the runtime control program, introduction,
demonstration, and reference hyperdocuments, and the full
development system, including a set of cooperating authoring tools
and full documentation on disk. The tools include an integrated
development environment for producing and maintaining hyperfiles,
as well as for use as a freetext database system, an extensive
syntax and consistency checking program, a hyperfile printout
utility, compression and expansion utilities and TSR screen capture
and graphic preparation facilities. Also provided is a popup
context sensitive hypertext system which utilises a subset of
HyperShell syntax, and is ideal for help systems and similar uses.
Documentation includes a full authoring guide and a quick reference
guide. Also there is a hypertext reference guide and a popup quick
************************ IMPORTANT ****************************
* MAKE A COPY OF THE DISTRIBUTION DISKS & WORK USING THE COPY *
The disks contain a number of archives, each of which can be
extracted to a floppy disk, or to the hard disk.
HYPMAIN.LZH Main programs and demonstrations
HYPDEVEL.LZH Development tools etc.
HYPOP.LZH HyperShell popup subset
HYPDOC.LZH Documentation files (shareware version only)
The dearchiving program is on disk2 (and disk3), and is called
LHARC.EXE (NB. This is the original LHARC, and not the latest version,
so if you have the new version called LHA, remember to add the 'old'
command line switch).
This is not on disk1, so this has to be copied to a place where
it may be run, such as the disk you are expanding the archive to,
before you can dearchive the archives on Disk1.
To Floppy disk
To extract onto a floppy disk, place a freshly formatted floppy
disk in drive B, make drive B the default by typing 'B:' and then
type the following:-
A:lharc x A:filename
where 'filename' is the name of the archive without the LZH
For disk 1 to floppy
Place disk 2 in drive A: and a fresh disk in drive B:, type
COPY A:LHARC.EXE B:
Place disk 1 in drive A:, make B: the default drive, and type
LHARC x A:HYPMAIN
Create a directory to contain all the files:-
C: MKDIR HYPSHELL
Change to the directory
C: CD HYPSHELL
Now type the following:-
A:lharc x A:filename
Where filename is one of the archive names with a .LZH extension.
You can extract each archive onto a separate floppy, or all into
the same directory on a hard disk.
FOR DISK 1, COPY LHARC.EXE FROM DISK 2 TO HARD DISK FIRST.
RUNNING THE DEMONSTRATIONS
Before you run the demonstrations, you must check that the COMSPEC
environment variable points to a location where the COMMAND.COM
program is held, and the PATH environment variable must be set up
to include the drive/directory containing the programs, for the
HOME hyperfile and the DOS EXIT to work, but are not essential to
try out HS against a hyperfile directly.
Using the files extracted
from the HYPMAIN archive, adjust contrast on your monitor to show
colours or intensity levels correctly, and type :-
This will present a menu of options. To start with, select the
Introduction option to display the HyperShell introductory
hyperfile to get you started on how to use HyperShell. Hyperfiles
with an extension of .HYP can be run using the command
Some of the examples require extra space to save changes or edits.
If you are using a floppy system,
copy the files to a fresh floppy before use.
If you have a Microsoft compatible mouse, the system will use the
mouse driver directly, otherwise a 'mouse emulation' mode will be
used whereby the cursor keys are used to position the selection
cursor, but this will not allow you to use a mouse pointer with
IMPORTANT: Some software, such as the GEM desktop environment, may
leave certain mouse drivers in an antisocial state, such that any
program attempting to use the mouse interface will hang the
computer, requiring a hard reset. If this happens when running
HyperShell, try rebooting before running the program, and if this
fails, try using the -m command line flag, or not installing the
HyperShell is a trademark of Text Technology.
The HyperShell system, including supporting utilities, is a
shareware product. This means the following:-
HyperShell Copyright (c) 1988,1989,1990,1991 Text Technology
All Rights Reserved
HyperShell is NOT FREE. It is a commercial product for which you
must pay if you are to use it, and is subject to the copyright
You are encouraged to make copies of the HyperShell shareware
distribution, without any alterations to the files in it, and give
these to others for evaluation. This READ.ME file must not be
altered and must accompany all copies. The system may be offered
for download via Bulletin Boards, and may be offered for
distribution by shareware distributors, provided unduly high rates
are not charged for such distribution.
You are permitted to make unlimited use of the HyperShell reader
program (HS.EXE) with any hyperfiles supplied to you, without
further registration, provided you do not alter the content of
these files. A contribution would be welcome to the author if you
feel you are gaining benefit from the system.
You are permitted to evaluate the system for producing your own
hyperfiles for a period not exceeding three (3) calendar months. If
you produce your own hyperfiles for your own use beyond that
period, you are required to pay for a HyperShell personal licence.
A personal licence allows one person to use HyperShell for
producing hyperfiles for his own use and for distribution with the
reader program (HS.EXE or HL.EXE) WITHOUT CHARGE to others, with
the exception that where this is done in a commercial environment a
developers licence is payable (see below). Also the personal
licence allows the sale of your own material, with the reader
program (HS.EXE or HL.EXE), AS SHAREWARE over bulletin boards or
via shareware distribution channels, PROVIDED it is made clear to
the purchaser that the material must not be altered, and a copy of
the material as distributed is sent to Text Technology on the
understanding that unaltered copies may be sent to interested
parties or further distributed.
If you produce hyperfiles for use by others, where a charge is made
for the material or for your services in the production of that
material, you are required to pay for a developers licence. This
applies whether the material forms part of a package, or is the
whole package. The developers licence entitles one person to
produce hyperfiles for any number of 'end' users to read using the
HS.EXE or HL.EXE reader program. Note that a licence is required
for EACH person developing such material. Site licence terms are
available on request. Corporate licence rates are available if
more than one person is to produce hyperfiles. In certain cases,
subject to specific agreement with Text Technology, applications
built using the Integrated Environment features may be distributed
under the developers licence at no additional charge. Text
Technology reserves the right to apply a runtime royalty rate in
other cases, which is subject to negotiation on a per case basis.
Under the personal or developers licence terms, you may provide a
copy of the HyperShell reader component (HS.EXE or HL.EXE) and the
printer component (HP.EXE) with any material that you distribute to
others. You must also provide an acknowledgement, visible on
screen or in printed documentation, indicating that HyperShell has
been used and giving the name and address of Text Technology.
If you feel that your use of the system is only occasional, and is
not sufficient to merit full registration, a 'lite' licence is
available. This will not entitle you to the latest update or
documentation, or give you permission to distribute to others, but
will entitle you to use the system as distributed through shareware
for your own purposes. You will also be notified of updates, and
given the chance to upgrade at a later date for the difference in
If HyperShell is to be used by others within an academic or other
non profit making establishment, and no charge is to be levied for
the use of the system, a reduced rate is applicable, which is
avilable on application. Also special academic licences are
available for teaching or classwork purposes. If such use is to be
made in a commercial establishment, the full developers licence is
The HyPop program is provided as part of the HyperShell system, but
may be separately licenced if you just require a simple popup
hypertext system. The development licence for this is required if
you want ot distribute the system with your own software.
If you decide not to register after the evaluation period you must
destroy all copies of any hyperfiles which you have used in that
time. YOU MUST NOT GIVE COPIES OF ANY HYPERFILES YOU PRODUCE TO
ANYONE, WITHOUT FIRST OBTAINING A SUITABLE LICENCE.
THIS SOFTWARE IS PROVIDED 'AS IS' AND TEXT TECHNOLOGY DISCLAIMS ALL
WARRANTIES RELATING TO THESE SOFTWARE PRODUCTS, WHETHER EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO ANY IMPLIED WARRANTIES OF
MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE, AND ALL SUCH
WARRANTIES ARE EXPRESSLY AND SPECIFICALLY DISCLAIMED. NEITHER TEXT
TECHNOLOGY NOR ITS AGENTS SHALL BE LIABLE FOR ANY INDIRECT,
CONSEQUENTIAL, OR INCIDENTAL DAMAGES ARISING OUT OF THE USE OR
INABILITY TO USE SUCH SOFTWARE EVEN IF TEXT TECHNOLOGY HAS BEEN
ADVISED OF THE POSSIBILITY OF SUCH DAMAGES OR CLAIMS. IN NO EVENT
SHALL TEXT TECHNOLOGY'S LIABILITY FOR ANY DAMAGES EVER EXCEED THE
PRICE PAID FOR THE LICENCE TO USE THE SOFTWARE, REGARDLESS OF THE
FORM OF CLAIM. THE PERSON USING THE SOFTWARE BEARS ALL RISK AS TO
THE QUALITY AND PERFORMANCE OF THE SOFTWARE.
Text Technology is a full member of the Association of Shareware
Authors - U.K.
The ASA-UK has been set up with similar goals in mind to the
Association of Shareware Professionals (ASP), but with an emphasis
on raising the standard of shareware produced by U.K. authors. With
this in mind, a number of exacting qualifications must be met by
the software and documentation before an author is accepted for
membership. Some of the most respected names in shareware are
members of ASA-UK, and if you are a shareware author you should
consider applying for membership at the address below.
If you are unable to resolve a shareware related problem with Text
Technology, you may refer the problem to the Ombudsman at the
Association of Shareware Authors - U.K. P.O.Box 26, Bracknell,
Berkshire, RG12 4WA, ENGLAND.
The following scale of charges are applicable to version 4.0 only,
and supersedes all previous scales with immediate effect. The
quoted prices are subject to change without further notice.
HyPop/HCX only - single user licence - 10 pounds
HyPop/HCX only - Developers licence - 30 pounds
HyperShell Lite licence - 20 pounds
HyperShell Personal licence - 50 pounds
HyperShell Developers licence - 100 pounds (no runtime per-copy
HSRES program, registered through Text Technology - 10 pounds
Also available are some supplementary disks. These are Public
Domain or Shareware programs which can be used with HyperShell, or
by themselves. These can be obtained from Text Technology for 3
pounds each (plus postage of 1 pound for 1 or more disks if outside
U.K. and not sent with HyperShell)
Disk 1 - General utilities, mainly text file processing (Mostly
public domain or freeware).
Disk 2 - MicroEmacs multi-window text editor plus MicroSpell spell
checker, which integrates with MicroEmacs (Freeware).
Disk 3 - Folding (outlining) text editor, supports 43/50 line mode,
and can be configured to produce hyperfiles (Freeware). Plus a
further text processing program.
Disk 4 - Graphics Preparation (Shareware).
(Send for full details of these)
Upgrades of HyperShell licences are chargeable at difference
between price paid and current price of required licence.
Special educational rates available on application.
Personal and Developers registration for the full system includes
the latest copy of version 4 together with printed documentation
and low cost updates to this version. It also includes postal and
off-peak telephone support for problems of use and for bug reports,
until the next major version release.
If you wish to receive the shareware version for distribution to
friends, please indicate this when you register.
Registration is a one off charge, and entitles you to use
HyperShell under the terms of your licence for as long as you like.
Additional support, for instance in the design and production of
hyperfiles, is chargeable on a time and materials basis at mutually
Custom modifications will be charged on a sliding scale from
nothing for a generally useful feature up to full time and
expenses for a special purpose modification.
The above figures apply to registration in the British Isles in
pounds sterling. Sorry we can't handle credit cards, so
cheques/postal orders only please (or hard cash if you prefer).
Outside the British Isles there is an additional postage charge of
5 pounds. Payment in a currency other than pounds sterling should
also have the equivalent of 6 pounds added to cover currency
conversion costs. Some European customers can send a bank giro or a
Eurocheque in pounds, in which case no extra is payable. Please
note that EXTRA IMPORT DUTY MAY BE PAYABLE BY YOU ON RECEIPT.
However, registration and documentation may be provided by a local
distributor at better rates, so check first.
There are no guarantees with the supplied product, other than for
the replacement of defective media. Registration means acceptance
of the product and any money paid will not be refundable, unless
you have registered without seeing the product, in which case you
may return the complete package in a saleable condition within 30
days for a refund of your licence fee.
Bug reports and suggestions for improvements are welcomed from all
users, including unregistered users evaluating the product.
Important, previously unreported, bugs will be rewarded with cash
or credit against registrations or other services.
All bug reports and problems from registered users will be
responded to. All problems should be posted to the provided
address of Text Technology or the agent you have registered with.
Full details of problems should be included, along with any related
hyperfile if this would be of assistance in solving a problem. Bug
reports should indicate the full circumstances of the bug,
including the machine type, monitor type, the version of
HyperShell, the memory size, the version of MSDOS (or DRDOS),
details of resident programs, and any other relevant information.
The following address should be used for registration and support
in the United Kingdom, Europe, certain parts of Birkenhead, and
parts of the world not covered by the agents listed below:-
66 Kennedy Avenue
Enquiries: 0625 431357 after 6 P.M. GMT/BST or Weekends.
Cheques should be made payable to N.G.Taylor.
In Denmark, please contact the following agent:-
In Australasia and Malaysia, please contact the following agent for
details of local registration.
Hyperware Research Laboratory
School of Information Systems
Curtin University of Technology
GPO Box U1987
Enquiries: (09) 351 2000
Fax: (09) 351 2255
When ordering, please state which version you have. Also it would
be useful if you could give an indication of what type of
application you are using HyperShell for. Also please state
whether you want the system on 5.25" 360k or 3.5" 720k disks.
(Arrangements for ordering via agents will differ - please refer to
agent for details).
If you evaluate HyperShell and find it unsuitable for your
requirements, please consider sending a copy of any evaluation
report you produce.
I hope you will enjoy HyperShell as much as I have enjoyed
producing it. Please don't hesitate to send suggestions for
improvements, bug reports etc. Good luck.