
                     +---------------------------------+
                     |The BASIC HelpReader Library 1.10|
                     +---------+-------------+---------+
                               |by Ben Harris|
                               +-------------+

+----------+
|Setting up|
+----------+

Before you incorporate the library into you program, you should copy
HelpRdrLib into your application's directory and put the following lines in
your HelpDes file:

b
cANO:Appl;HelpTable;`=^
fFFB
phelpreader_make_table
s

Where 'ANO:Appl' is the name of the help text.  Since this is a little hard
to type (involving lots of Alt-key combinations), it would probably be a
good idea to copy it directly from this text file into your HelpDes file.

In the help text itself, insert context-sensitive markers as normal (see the
main HelpGen help text).  The label names will be converted into variable
names, so don't re-use them in your program.

+--------------+
|Initialisation|
+--------------+

In you application's initialisation routines, you should load the HelpReader
library and initialise it as follows:

LIBRARY "<Appl$Dir>.HelpRdrLib"
PROChelpreader_init("<Appl$Dir>","ANO:Appl")

Where '<Appl$Dir>' is your application's directory and 'ANO:Appl' is the
name of the help text.

+----------------+
|Message handling|
+----------------+

In your application's message handling routine, you should use:

PROChelpreader_msg_poll

+--------------------+
|Moving the help text|
+--------------------+

To move the help text, use:

PROChelpreader_move(label%)

Where 'label%' is the label name specified in the help text.

+---------------------+
|Loading the help text|
+---------------------+

To load the help text, or move it to the front, if it is already loaded,
use:

PROChelpreader_load

+-------------------+
|Variable names etc.|
+-------------------+

All of the library's functions, procedures and global variables have names
beginning with 'helpreader_'.  It's unlikely that you will want to use
anything that will clash with these, but if you were thinking of it, don't!

+------------------+
|Conditions of use:|
+------------------+

This library may be freely copied and distributed.

Any modifications should mentioned in this text file along with the name and
address of the person who modified it and a copy of the modified library
sent to me so that I can include the modification in any future versions (if
I like it!).

You may use this library in any program as long as I am fully credited and
I am set a copy.

If I find that anyone has breached these conditions, they will be hanged,
drawn and quartered (or at least given a stern ticking-off).

+----------+
|My Address|
+----------+

If for any reason you would like to contact me (to report bugs, suggest
improvements, give praise, donate money, etc.), please write to me at:

Ben Harris,
9 Brownhill Lane,
Wembury,
Plymouth.
PL9 0JQ

Please note that I am only responsible for this library. The rest of the
HelpReader system is the responsibility of Ben Summers.
