The files in this directory are not needed to run ARexxGuide, but might be
helpful to some users. These files are included:

  ARexxGuide                       ARexxGuide.info
  ARexxGuide.rexx                  ARx_Guide.xref
  ARx_Help.TTX

ARexxGuide.rexx ARexxGuide & ARexxGuide.info
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
I use these files to start the guide. They were especially helpful during
development, before full paths were added to the link points. The .rexx
file is the only file that really does anything. The file named
'ARexxGuide' is empty. It's only purpose is to hold a place for the icon
file, making it possible to move the icon normally.

The icon is set up to call the ARexxGuide.rexx file. It can be placed in
any directory and will successfully launch the guide as long as long as
ARexxGuide.rexx is located in the REXX: directory.

This script uses the .xref file which is explained below.

The script uses the library 'rexxarplib.library' to help the user set up
the system. Although it can handle a system that doesn't have 'rexxarplib',
it isn't pretty. Once the system is set up, though, rexxarplib is no longer
needed for this file.

Those who wish to show ARexxGuide on a public screen could use the library's
public screen support to automatically open it on a public screen.


ARx_Guide.xref
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
When the 'Find Document' menu item is chosen in the AmigaGuide 'Navigation'
menu, the application searches the current database for the specified name.
It will also search any cross-reference file that has been added. This file
tells AmigaGuide where to find many of the nodes in the guide and makes the
Navigation feature more useful.

The .xref file is automatically added by the ARexxGuide.rexx file described
above. It is also used by the TurboText help-key macro.

ARx_Help.ttx
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
This file can turn the Help key in TurboText into a powerful on-line help
facility. It will call ARexxGuide with context-sensitive help while you're
writing an ARexx script.

To use the macro, add something like the following line to the KEYBOARD:
section of the TTX_Startup.dfn file:

  HELP               ExecARexxMacro "ARx_Help" SYNC
  SHIFT-HELP         ExecARexxMacro "ARx_Help" ASYNC
  CTRL-HELP			   OpenDoc NAME TurboText:Support/TTX_Help.txt

You might prefer to use CTRL-HELP for the ARexx help key. The 'SYNC' and
'ASYNC' options will, in the first case, load the appropriate file any
window that was opened by the application. 'ASYNC' will always open a new
window.

The library 'rexxarplib.library' is required for this macro. It should be
in you libs: directory.

This file is still a work-in-progress. I'd be happy to include help-key
facilities for other programs in future editions of the guide. Send
anything you'd like included to one of the addresses below.

					Robin Evans							26 Sep 1993

						R.EVANS6   on GEnie

						from Internet:
							robin@halcyon.com
							r.evans6@genie.geis.com