C interface to context sensitive HelpReader help systems
by Ben Summers

Source code included - please do not modfify.


Setup of HelpDes
~~~~~~~~~~~~~~~~
Select context sensitiveness with the 'c' option with a line like

cBDS:HelpGen;h.helpn;#define HELPREADER_~ ^

This will create a header file in the 'h' directory inside the application
directory. Each line will be something like this:

#define HELPREADER_LABELNAME

You can also have prefixs and suffixs if you wish. The filetype does not
need to be specified, HelpGen defaults to Text.


Use in program
~~~~~~~~~~~~~~
To use be able to use HelpReader it must first be initialised:

  helpreader_init("BDS:HelpGen");

The name 'BDS:HelpGen' is the name of the help text you want it to move. See
the main help file for guidelines on the selection of the name.

When you want to move the text just use:

  helpreader_move(HELPREADER_LABELNAME);

The constant 'HELPREADER_LABELNAME' is set in the number file by HelpGen.
You will use a line like this, for example, when a window or menu is opened.
If the help text is not loaded, this function will have no effect.

That's all there is to it really, except if you want to put a 'Help option'
on your iconbar menu. To load the help text, use

  helpreader_load("HelpGen");

The string here is the name of the application. It is used for the system
variable for the directory the help text is in. This example will produce
the system variable '<HelpGen$Dir>'.

If the help text is already loaded, it will be moved to the front of the
window stack. You can also do this with

  helpreader_helptext_to_front();

You will need to #include the helpreader header file in every source file as
well as the number file.


~~~~~~~~~~~

I hope you find this useful. If you use this library, please credit me, and
send me a copy of your application.

