Home » Archimedes archive » Micro User » MU 1991-05.adf » PDStuff » Utilities/!HelpGen/Help

Utilities/!HelpGen/Help

This website contains an archive of files for the Acorn Electron, BBC Micro, Acorn Archimedes, Commodore 16 and Commodore 64 computers, which Dominic Ford has rescued from his private collection of floppy disks and cassettes.

Some of these files were originally commercial releases in the 1980s and 1990s, but they are now widely available online. I assume that copyright over them is no longer being asserted. If you own the copyright and would like files to be removed, please contact me.

Tape/disk: Home » Archimedes archive » Micro User » MU 1991-05.adf » PDStuff
Filename: Utilities/!HelpGen/Help
Read OK:
File size: 1D10 bytes
Load address: 0000
Exec address: 0000
File contents
4<����H@�HelpGen version 1.01 (HelpReader help system generator)by Ben Summers*************************** How to use HelpReader **************************** Click MENU on this window to bring up the subject menu, and chose a       ** subject to move to it. In the text you may find buttons (  ), and if you  ** click one, the window will move to that reference.                        **************************************************   More on HelpReader ******                         HelpReader system generator                         ~~~~~~~~~~~~~~~~~~~~~~~~~~~HelpReader is a stand-alone application for reading application help fileswhich does not need any application such as Edit to have been loaded first.It also has the advantage that as it is written in ARM code so that it willnot use up much disc space. The application HelpGen will generate suchHelpReader systems and is not needed when the help file is read.Overview~~~~~~~~To generate a help system for an application you just drag the applicationto the HelpGen icon. The relevent files will be created to produce thestand-alone help system. After the help system has been created, a reportwindow will open. Click 'Test' to try out your help system.Two files are needed to create the help system, the text and the definitionof the subject menu. In the application directory, the file 'HelpDes'contains the filenames of these files which are inside the applicationdirectory. The format of the HelpDes file is:  Name of the file containing the text (the text file)  Name of the file containing the menu definition (the menu file)  OptionsIn the current version of HelpGen, the only option you can use is 'n'. Ifthis option is set no menu will be put on the screen when the help system isrun.If there is no HelpDes file in the application directory, one can be madeautomatically.   More information. The only files which are needed for the generated help system to work are'!Help', 'Help' and 'HelpReader' (they must be inside the applicationdirectory). The HelpDes file and the source files can be removed for therelease version once HelpGen has generated the help system.The text file~~~~~~~~~~~~~The text file is the text to be displayed in the window. Each line shouldhave a newline at the end of it (the result of 'Format text' in Edit). Ifthis is not done, HelpReader will not be able to display the text correctly.To tell HelpGen where to move the window to when a menu item is chosen or abutton clicked, you must set labels in the text. These are lines which beginwith '@#' followed by a label name. They are removed from the text when thehelp system is generated. The label must consist of alphanumeric charactersand there must be no spaces anywhere on the label line. For example, a labelline might read:  @#label  Please note that this example is indented. This is to stop HelpGen thinking  this line is a label, and deleting it from the text when this help system  was generated. When you set a label, there must not be an indent.To set a button in the text, you insert '@%label#' in the text, where'label' is the name of the label you want the text to move to when you clickon the button.Look at the files in the subdirectory 'Text' inside the HelpGen applicationdirectory for some examples or press    to see what they are.The menu file~~~~~~~~~~~~~The first line of the menu file is the title of the help window, typicallythe name and version number of the application.The rest of the file is the definition of the menu. Each line is one menuitem. The format of each line is:  Menu_item,labelWhen this item is chosen from the menu, the window will move so that thelabel will appear near the top.See the example menu in the subdirectory 'Text' inside the HelpGenapplication directory.Automatic HelpDes file creation~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~If HelpGen cannot find a HelpDes file in the application directory, it willask you if you want to attempt to create one. If the answer if yes, HelpGenwill look for a text file called either '!Help' or 'ReadMe'. If it can'tfind either, it will stop unsuccessfully.After the generator has found some suitable text, the following actions areperformed to produce a HelpDes file. They are:  Create a directory inside the application directory called 'MakeHelp'  Rename the text to be the file 'MakeHelp.Text'  Create an empty menu file with the title of the HelpReader window as the    name of the help system  Create a HelpDes file specifiying these two files with the option    'no menu on start up'When all this has been done, a help system will be made using these files.Examples~~~~~~~~The subdirectory 'Text' inside the HelpGen application directory containssome examples. They are listed below. (Hold down shift and double click onthe application icon to get inside the application directory.)  Filename  Description of contents  --------  -----------------------  Menu      An example menu  Message   The text of the message I would like you to include in every              help system you make with HelpReader  HowToUse  A short message you might like to include at the top of              your help system to tell the user how to use HelpReader  HelpDes   An example HelpDes file  !DemoApp  An example application set up with source text filesThe Author~~~~~~~~~~HelpReader and HelpGen were written by Ben Summers. If you would like tosuggest improvements, report bugs (what - in my programs?) or send a tokenof your appreciation (a disc of PD etc), please write to me at the addressbelow. Please enclose an SAE if you want a reply.  Ben Summers  39A Cromer Road  Hellesdon  Norwich  NR6 6LXLegal note~~~~~~~~~~You may use HelpReader in any application you write, PD or commercial, aslong as you send me a copy of the release version with any documentationwhich goes with it. You must also include the following text in your helpfile, and the menu item 'HelpReader' which should be set up to jump tothis text:*****************************************************************************  HelpReader version 1.03  by Ben Summers  This HelpReader application is public domain. You may use it in your own  programs, PD or commercial as long as you send me a copy of it, and any  documention which goes with it.  To make help systems using HelpReader, you will need a copy of the  HelpReader file generator. Send me a disc and an SAE with a letter asking  for a copy if you haven't got one.  My address is:    Ben Summers, 39A Cromer Road, Hellesdon, Norwich NR6 6LX*****************************************************************************If this text is not included in your help text, it will be added to the endof your help file, and if the menu item is not included, it will be added tothe menu, so you do not have to worry about adding it yourself.If you do not want to have it at the end of the file, but wish to insert itsomewhere else, the text for the message is in the 'Text' subdirectory ofthe application directory.temHelpGen version 1.01 (HelpReader help system generator)OverviewThe text fileThe menu fileHelpDes generationLegal noteThe authorHelpReaderExamplespd-GW�z�j�Wj�@����`���"���B ������� ���R ���r@���
00000000  34 00 00 00 3c 1c 00 00  04 1c 00 00 a0 1c 00 00  |4...<...........|
00000010  d0 1c 00 00 c0 1c 00 00  cd 1b 00 00 08 00 00 00  |................|
00000020  04 00 00 00 48 00 00 00  14 01 00 00 01 00 00 00  |....H...........|
00000030  1a 40 00 c7 48 65 6c 70  47 65 6e 20 76 65 72 73  |.@..HelpGen vers|
00000040  69 6f 6e 20 31 2e 30 31  20 28 48 65 6c 70 52 65  |ion 1.01 (HelpRe|
00000050  61 64 65 72 20 68 65 6c  70 20 73 79 73 74 65 6d  |ader help system|
00000060  20 67 65 6e 65 72 61 74  6f 72 29 00 62 79 20 42  | generator).by B|
00000070  65 6e 20 53 75 6d 6d 65  72 73 00 00 2a 2a 2a 2a  |en Summers..****|
00000080  2a 2a 2a 2a 2a 2a 2a 2a  2a 2a 2a 2a 2a 2a 2a 2a  |****************|
00000090  2a 2a 2a 2a 2a 2a 2a 20  48 6f 77 20 74 6f 20 75  |******* How to u|
000000a0  73 65 20 48 65 6c 70 52  65 61 64 65 72 20 2a 2a  |se HelpReader **|
000000b0  2a 2a 2a 2a 2a 2a 2a 2a  2a 2a 2a 2a 2a 2a 2a 2a  |****************|
000000c0  2a 2a 2a 2a 2a 2a 2a 2a  2a 00 2a 20 43 6c 69 63  |*********.* Clic|
000000d0  6b 20 4d 45 4e 55 20 6f  6e 20 74 68 69 73 20 77  |k MENU on this w|
000000e0  69 6e 64 6f 77 20 74 6f  20 62 72 69 6e 67 20 75  |indow to bring u|
000000f0  70 20 74 68 65 20 73 75  62 6a 65 63 74 20 6d 65  |p the subject me|
00000100  6e 75 2c 20 61 6e 64 20  63 68 6f 73 65 20 61 20  |nu, and chose a |
00000110  20 20 20 20 20 20 2a 00  2a 20 73 75 62 6a 65 63  |      *.* subjec|
00000120  74 20 74 6f 20 6d 6f 76  65 20 74 6f 20 69 74 2e  |t to move to it.|
00000130  20 49 6e 20 74 68 65 20  74 65 78 74 20 79 6f 75  | In the text you|
00000140  20 6d 61 79 20 66 69 6e  64 20 62 75 74 74 6f 6e  | may find button|
00000150  73 20 28 20 20 29 2c 20  61 6e 64 20 69 66 20 79  |s (  ), and if y|
00000160  6f 75 20 20 2a 00 2a 20  63 6c 69 63 6b 20 6f 6e  |ou  *.* click on|
00000170  65 2c 20 74 68 65 20 77  69 6e 64 6f 77 20 77 69  |e, the window wi|
00000180  6c 6c 20 6d 6f 76 65 20  74 6f 20 74 68 61 74 20  |ll move to that |
00000190  72 65 66 65 72 65 6e 63  65 2e 20 20 20 20 20 20  |reference.      |
000001a0  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
000001b0  20 20 2a 00 2a 2a 2a 2a  2a 2a 2a 2a 2a 2a 2a 2a  |  *.************|
000001c0  2a 2a 2a 2a 2a 2a 2a 2a  2a 2a 2a 2a 2a 2a 2a 2a  |****************|
*
000001e0  2a 2a 2a 2a 2a 20 20 20  4d 6f 72 65 20 6f 6e 20  |*****   More on |
000001f0  48 65 6c 70 52 65 61 64  65 72 20 2a 2a 2a 2a 2a  |HelpReader *****|
00000200  2a 00 00 00 20 20 20 20  20 20 20 20 20 20 20 20  |*...            |
00000210  20 20 20 20 20 20 20 20  20 20 20 20 20 48 65 6c  |             Hel|
00000220  70 52 65 61 64 65 72 20  73 79 73 74 65 6d 20 67  |pReader system g|
00000230  65 6e 65 72 61 74 6f 72  00 20 20 20 20 20 20 20  |enerator.       |
00000240  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
00000250  20 20 7e 7e 7e 7e 7e 7e  7e 7e 7e 7e 7e 7e 7e 7e  |  ~~~~~~~~~~~~~~|
00000260  7e 7e 7e 7e 7e 7e 7e 7e  7e 7e 7e 7e 7e 00 48 65  |~~~~~~~~~~~~~.He|
00000270  6c 70 52 65 61 64 65 72  20 69 73 20 61 20 73 74  |lpReader is a st|
00000280  61 6e 64 2d 61 6c 6f 6e  65 20 61 70 70 6c 69 63  |and-alone applic|
00000290  61 74 69 6f 6e 20 66 6f  72 20 72 65 61 64 69 6e  |ation for readin|
000002a0  67 20 61 70 70 6c 69 63  61 74 69 6f 6e 20 68 65  |g application he|
000002b0  6c 70 20 66 69 6c 65 73  00 77 68 69 63 68 20 64  |lp files.which d|
000002c0  6f 65 73 20 6e 6f 74 20  6e 65 65 64 20 61 6e 79  |oes not need any|
000002d0  20 61 70 70 6c 69 63 61  74 69 6f 6e 20 73 75 63  | application suc|
000002e0  68 20 61 73 20 45 64 69  74 20 74 6f 20 68 61 76  |h as Edit to hav|
000002f0  65 20 62 65 65 6e 20 6c  6f 61 64 65 64 20 66 69  |e been loaded fi|
00000300  72 73 74 2e 00 49 74 20  61 6c 73 6f 20 68 61 73  |rst..It also has|
00000310  20 74 68 65 20 61 64 76  61 6e 74 61 67 65 20 74  | the advantage t|
00000320  68 61 74 20 61 73 20 69  74 20 69 73 20 77 72 69  |hat as it is wri|
00000330  74 74 65 6e 20 69 6e 20  41 52 4d 20 63 6f 64 65  |tten in ARM code|
00000340  20 73 6f 20 74 68 61 74  20 69 74 20 77 69 6c 6c  | so that it will|
00000350  00 6e 6f 74 20 75 73 65  20 75 70 20 6d 75 63 68  |.not use up much|
00000360  20 64 69 73 63 20 73 70  61 63 65 2e 20 54 68 65  | disc space. The|
00000370  20 61 70 70 6c 69 63 61  74 69 6f 6e 20 48 65 6c  | application Hel|
00000380  70 47 65 6e 20 77 69 6c  6c 20 67 65 6e 65 72 61  |pGen will genera|
00000390  74 65 20 73 75 63 68 00  48 65 6c 70 52 65 61 64  |te such.HelpRead|
000003a0  65 72 20 73 79 73 74 65  6d 73 20 61 6e 64 20 69  |er systems and i|
000003b0  73 20 6e 6f 74 20 6e 65  65 64 65 64 20 77 68 65  |s not needed whe|
000003c0  6e 20 74 68 65 20 68 65  6c 70 20 66 69 6c 65 20  |n the help file |
000003d0  69 73 20 72 65 61 64 2e  00 00 4f 76 65 72 76 69  |is read...Overvi|
000003e0  65 77 00 7e 7e 7e 7e 7e  7e 7e 7e 00 54 6f 20 67  |ew.~~~~~~~~.To g|
000003f0  65 6e 65 72 61 74 65 20  61 20 68 65 6c 70 20 73  |enerate a help s|
00000400  79 73 74 65 6d 20 66 6f  72 20 61 6e 20 61 70 70  |ystem for an app|
00000410  6c 69 63 61 74 69 6f 6e  20 79 6f 75 20 6a 75 73  |lication you jus|
00000420  74 20 64 72 61 67 20 74  68 65 20 61 70 70 6c 69  |t drag the appli|
00000430  63 61 74 69 6f 6e 00 74  6f 20 74 68 65 20 48 65  |cation.to the He|
00000440  6c 70 47 65 6e 20 69 63  6f 6e 2e 20 54 68 65 20  |lpGen icon. The |
00000450  72 65 6c 65 76 65 6e 74  20 66 69 6c 65 73 20 77  |relevent files w|
00000460  69 6c 6c 20 62 65 20 63  72 65 61 74 65 64 20 74  |ill be created t|
00000470  6f 20 70 72 6f 64 75 63  65 20 74 68 65 00 73 74  |o produce the.st|
00000480  61 6e 64 2d 61 6c 6f 6e  65 20 68 65 6c 70 20 73  |and-alone help s|
00000490  79 73 74 65 6d 2e 20 41  66 74 65 72 20 74 68 65  |ystem. After the|
000004a0  20 68 65 6c 70 20 73 79  73 74 65 6d 20 68 61 73  | help system has|
000004b0  20 62 65 65 6e 20 63 72  65 61 74 65 64 2c 20 61  | been created, a|
000004c0  20 72 65 70 6f 72 74 00  77 69 6e 64 6f 77 20 77  | report.window w|
000004d0  69 6c 6c 20 6f 70 65 6e  2e 20 43 6c 69 63 6b 20  |ill open. Click |
000004e0  27 54 65 73 74 27 20 74  6f 20 74 72 79 20 6f 75  |'Test' to try ou|
000004f0  74 20 79 6f 75 72 20 68  65 6c 70 20 73 79 73 74  |t your help syst|
00000500  65 6d 2e 00 00 54 77 6f  20 66 69 6c 65 73 20 61  |em...Two files a|
00000510  72 65 20 6e 65 65 64 65  64 20 74 6f 20 63 72 65  |re needed to cre|
00000520  61 74 65 20 74 68 65 20  68 65 6c 70 20 73 79 73  |ate the help sys|
00000530  74 65 6d 2c 20 74 68 65  20 74 65 78 74 20 61 6e  |tem, the text an|
00000540  64 20 74 68 65 20 64 65  66 69 6e 69 74 69 6f 6e  |d the definition|
00000550  00 6f 66 20 74 68 65 20  73 75 62 6a 65 63 74 20  |.of the subject |
00000560  6d 65 6e 75 2e 20 49 6e  20 74 68 65 20 61 70 70  |menu. In the app|
00000570  6c 69 63 61 74 69 6f 6e  20 64 69 72 65 63 74 6f  |lication directo|
00000580  72 79 2c 20 74 68 65 20  66 69 6c 65 20 27 48 65  |ry, the file 'He|
00000590  6c 70 44 65 73 27 00 63  6f 6e 74 61 69 6e 73 20  |lpDes'.contains |
000005a0  74 68 65 20 66 69 6c 65  6e 61 6d 65 73 20 6f 66  |the filenames of|
000005b0  20 74 68 65 73 65 20 66  69 6c 65 73 20 77 68 69  | these files whi|
000005c0  63 68 20 61 72 65 20 69  6e 73 69 64 65 20 74 68  |ch are inside th|
000005d0  65 20 61 70 70 6c 69 63  61 74 69 6f 6e 00 64 69  |e application.di|
000005e0  72 65 63 74 6f 72 79 2e  20 54 68 65 20 66 6f 72  |rectory. The for|
000005f0  6d 61 74 20 6f 66 20 74  68 65 20 48 65 6c 70 44  |mat of the HelpD|
00000600  65 73 20 66 69 6c 65 20  69 73 3a 00 00 20 20 4e  |es file is:..  N|
00000610  61 6d 65 20 6f 66 20 74  68 65 20 66 69 6c 65 20  |ame of the file |
00000620  63 6f 6e 74 61 69 6e 69  6e 67 20 74 68 65 20 74  |containing the t|
00000630  65 78 74 20 28 74 68 65  20 74 65 78 74 20 66 69  |ext (the text fi|
00000640  6c 65 29 00 20 20 4e 61  6d 65 20 6f 66 20 74 68  |le).  Name of th|
00000650  65 20 66 69 6c 65 20 63  6f 6e 74 61 69 6e 69 6e  |e file containin|
00000660  67 20 74 68 65 20 6d 65  6e 75 20 64 65 66 69 6e  |g the menu defin|
00000670  69 74 69 6f 6e 20 28 74  68 65 20 6d 65 6e 75 20  |ition (the menu |
00000680  66 69 6c 65 29 00 20 20  4f 70 74 69 6f 6e 73 00  |file).  Options.|
00000690  00 49 6e 20 74 68 65 20  63 75 72 72 65 6e 74 20  |.In the current |
000006a0  76 65 72 73 69 6f 6e 20  6f 66 20 48 65 6c 70 47  |version of HelpG|
000006b0  65 6e 2c 20 74 68 65 20  6f 6e 6c 79 20 6f 70 74  |en, the only opt|
000006c0  69 6f 6e 20 79 6f 75 20  63 61 6e 20 75 73 65 20  |ion you can use |
000006d0  69 73 20 27 6e 27 2e 20  49 66 00 74 68 69 73 20  |is 'n'. If.this |
000006e0  6f 70 74 69 6f 6e 20 69  73 20 73 65 74 20 6e 6f  |option is set no|
000006f0  20 6d 65 6e 75 20 77 69  6c 6c 20 62 65 20 70 75  | menu will be pu|
00000700  74 20 6f 6e 20 74 68 65  20 73 63 72 65 65 6e 20  |t on the screen |
00000710  77 68 65 6e 20 74 68 65  20 68 65 6c 70 20 73 79  |when the help sy|
00000720  73 74 65 6d 20 69 73 00  72 75 6e 2e 00 00 49 66  |stem is.run...If|
00000730  20 74 68 65 72 65 20 69  73 20 6e 6f 20 48 65 6c  | there is no Hel|
00000740  70 44 65 73 20 66 69 6c  65 20 69 6e 20 74 68 65  |pDes file in the|
00000750  20 61 70 70 6c 69 63 61  74 69 6f 6e 20 64 69 72  | application dir|
00000760  65 63 74 6f 72 79 2c 20  6f 6e 65 20 63 61 6e 20  |ectory, one can |
00000770  62 65 20 6d 61 64 65 00  61 75 74 6f 6d 61 74 69  |be made.automati|
00000780  63 61 6c 6c 79 2e 20 20  20 4d 6f 72 65 20 69 6e  |cally.   More in|
00000790  66 6f 72 6d 61 74 69 6f  6e 2e 20 00 00 54 68 65  |formation. ..The|
000007a0  20 6f 6e 6c 79 20 66 69  6c 65 73 20 77 68 69 63  | only files whic|
000007b0  68 20 61 72 65 20 6e 65  65 64 65 64 20 66 6f 72  |h are needed for|
000007c0  20 74 68 65 20 67 65 6e  65 72 61 74 65 64 20 68  | the generated h|
000007d0  65 6c 70 20 73 79 73 74  65 6d 20 74 6f 20 77 6f  |elp system to wo|
000007e0  72 6b 20 61 72 65 00 27  21 48 65 6c 70 27 2c 20  |rk are.'!Help', |
000007f0  27 48 65 6c 70 27 20 61  6e 64 20 27 48 65 6c 70  |'Help' and 'Help|
00000800  52 65 61 64 65 72 27 20  28 74 68 65 79 20 6d 75  |Reader' (they mu|
00000810  73 74 20 62 65 20 69 6e  73 69 64 65 20 74 68 65  |st be inside the|
00000820  20 61 70 70 6c 69 63 61  74 69 6f 6e 00 64 69 72  | application.dir|
00000830  65 63 74 6f 72 79 29 2e  20 54 68 65 20 48 65 6c  |ectory). The Hel|
00000840  70 44 65 73 20 66 69 6c  65 20 61 6e 64 20 74 68  |pDes file and th|
00000850  65 20 73 6f 75 72 63 65  20 66 69 6c 65 73 20 63  |e source files c|
00000860  61 6e 20 62 65 20 72 65  6d 6f 76 65 64 20 66 6f  |an be removed fo|
00000870  72 20 74 68 65 00 72 65  6c 65 61 73 65 20 76 65  |r the.release ve|
00000880  72 73 69 6f 6e 20 6f 6e  63 65 20 48 65 6c 70 47  |rsion once HelpG|
00000890  65 6e 20 68 61 73 20 67  65 6e 65 72 61 74 65 64  |en has generated|
000008a0  20 74 68 65 20 68 65 6c  70 20 73 79 73 74 65 6d  | the help system|
000008b0  2e 00 00 54 68 65 20 74  65 78 74 20 66 69 6c 65  |...The text file|
000008c0  00 7e 7e 7e 7e 7e 7e 7e  7e 7e 7e 7e 7e 7e 00 54  |.~~~~~~~~~~~~~.T|
000008d0  68 65 20 74 65 78 74 20  66 69 6c 65 20 69 73 20  |he text file is |
000008e0  74 68 65 20 74 65 78 74  20 74 6f 20 62 65 20 64  |the text to be d|
000008f0  69 73 70 6c 61 79 65 64  20 69 6e 20 74 68 65 20  |isplayed in the |
00000900  77 69 6e 64 6f 77 2e 20  45 61 63 68 20 6c 69 6e  |window. Each lin|
00000910  65 20 73 68 6f 75 6c 64  00 68 61 76 65 20 61 20  |e should.have a |
00000920  6e 65 77 6c 69 6e 65 20  61 74 20 74 68 65 20 65  |newline at the e|
00000930  6e 64 20 6f 66 20 69 74  20 28 74 68 65 20 72 65  |nd of it (the re|
00000940  73 75 6c 74 20 6f 66 20  27 46 6f 72 6d 61 74 20  |sult of 'Format |
00000950  74 65 78 74 27 20 69 6e  20 45 64 69 74 29 2e 20  |text' in Edit). |
00000960  49 66 00 74 68 69 73 20  69 73 20 6e 6f 74 20 64  |If.this is not d|
00000970  6f 6e 65 2c 20 48 65 6c  70 52 65 61 64 65 72 20  |one, HelpReader |
00000980  77 69 6c 6c 20 6e 6f 74  20 62 65 20 61 62 6c 65  |will not be able|
00000990  20 74 6f 20 64 69 73 70  6c 61 79 20 74 68 65 20  | to display the |
000009a0  74 65 78 74 20 63 6f 72  72 65 63 74 6c 79 2e 00  |text correctly..|
000009b0  00 54 6f 20 74 65 6c 6c  20 48 65 6c 70 47 65 6e  |.To tell HelpGen|
000009c0  20 77 68 65 72 65 20 74  6f 20 6d 6f 76 65 20 74  | where to move t|
000009d0  68 65 20 77 69 6e 64 6f  77 20 74 6f 20 77 68 65  |he window to whe|
000009e0  6e 20 61 20 6d 65 6e 75  20 69 74 65 6d 20 69 73  |n a menu item is|
000009f0  20 63 68 6f 73 65 6e 20  6f 72 20 61 00 62 75 74  | chosen or a.but|
00000a00  74 6f 6e 20 63 6c 69 63  6b 65 64 2c 20 79 6f 75  |ton clicked, you|
00000a10  20 6d 75 73 74 20 73 65  74 20 6c 61 62 65 6c 73  | must set labels|
00000a20  20 69 6e 20 74 68 65 20  74 65 78 74 2e 20 54 68  | in the text. Th|
00000a30  65 73 65 20 61 72 65 20  6c 69 6e 65 73 20 77 68  |ese are lines wh|
00000a40  69 63 68 20 62 65 67 69  6e 00 77 69 74 68 20 27  |ich begin.with '|
00000a50  40 23 27 20 66 6f 6c 6c  6f 77 65 64 20 62 79 20  |@#' followed by |
00000a60  61 20 6c 61 62 65 6c 20  6e 61 6d 65 2e 20 54 68  |a label name. Th|
00000a70  65 79 20 61 72 65 20 72  65 6d 6f 76 65 64 20 66  |ey are removed f|
00000a80  72 6f 6d 20 74 68 65 20  74 65 78 74 20 77 68 65  |rom the text whe|
00000a90  6e 20 74 68 65 00 68 65  6c 70 20 73 79 73 74 65  |n the.help syste|
00000aa0  6d 20 69 73 20 67 65 6e  65 72 61 74 65 64 2e 20  |m is generated. |
00000ab0  54 68 65 20 6c 61 62 65  6c 20 6d 75 73 74 20 63  |The label must c|
00000ac0  6f 6e 73 69 73 74 20 6f  66 20 61 6c 70 68 61 6e  |onsist of alphan|
00000ad0  75 6d 65 72 69 63 20 63  68 61 72 61 63 74 65 72  |umeric character|
00000ae0  73 00 61 6e 64 20 74 68  65 72 65 20 6d 75 73 74  |s.and there must|
00000af0  20 62 65 20 6e 6f 20 73  70 61 63 65 73 20 61 6e  | be no spaces an|
00000b00  79 77 68 65 72 65 20 6f  6e 20 74 68 65 20 6c 61  |ywhere on the la|
00000b10  62 65 6c 20 6c 69 6e 65  2e 20 46 6f 72 20 65 78  |bel line. For ex|
00000b20  61 6d 70 6c 65 2c 20 61  20 6c 61 62 65 6c 00 6c  |ample, a label.l|
00000b30  69 6e 65 20 6d 69 67 68  74 20 72 65 61 64 3a 00  |ine might read:.|
00000b40  00 20 20 40 23 6c 61 62  65 6c 00 00 20 20 50 6c  |.  @#label..  Pl|
00000b50  65 61 73 65 20 6e 6f 74  65 20 74 68 61 74 20 74  |ease note that t|
00000b60  68 69 73 20 65 78 61 6d  70 6c 65 20 69 73 20 69  |his example is i|
00000b70  6e 64 65 6e 74 65 64 2e  20 54 68 69 73 20 69 73  |ndented. This is|
00000b80  20 74 6f 20 73 74 6f 70  20 48 65 6c 70 47 65 6e  | to stop HelpGen|
00000b90  20 74 68 69 6e 6b 69 6e  67 00 20 20 74 68 69 73  | thinking.  this|
00000ba0  20 6c 69 6e 65 20 69 73  20 61 20 6c 61 62 65 6c  | line is a label|
00000bb0  2c 20 61 6e 64 20 64 65  6c 65 74 69 6e 67 20 69  |, and deleting i|
00000bc0  74 20 66 72 6f 6d 20 74  68 65 20 74 65 78 74 20  |t from the text |
00000bd0  77 68 65 6e 20 74 68 69  73 20 68 65 6c 70 20 73  |when this help s|
00000be0  79 73 74 65 6d 00 20 20  77 61 73 20 67 65 6e 65  |ystem.  was gene|
00000bf0  72 61 74 65 64 2e 20 57  68 65 6e 20 79 6f 75 20  |rated. When you |
00000c00  73 65 74 20 61 20 6c 61  62 65 6c 2c 20 74 68 65  |set a label, the|
00000c10  72 65 20 6d 75 73 74 20  6e 6f 74 20 62 65 20 61  |re must not be a|
00000c20  6e 20 69 6e 64 65 6e 74  2e 00 00 54 6f 20 73 65  |n indent...To se|
00000c30  74 20 61 20 62 75 74 74  6f 6e 20 69 6e 20 74 68  |t a button in th|
00000c40  65 20 74 65 78 74 2c 20  79 6f 75 20 69 6e 73 65  |e text, you inse|
00000c50  72 74 20 27 40 25 6c 61  62 65 6c 23 27 20 69 6e  |rt '@%label#' in|
00000c60  20 74 68 65 20 74 65 78  74 2c 20 77 68 65 72 65  | the text, where|
00000c70  00 27 6c 61 62 65 6c 27  20 69 73 20 74 68 65 20  |.'label' is the |
00000c80  6e 61 6d 65 20 6f 66 20  74 68 65 20 6c 61 62 65  |name of the labe|
00000c90  6c 20 79 6f 75 20 77 61  6e 74 20 74 68 65 20 74  |l you want the t|
00000ca0  65 78 74 20 74 6f 20 6d  6f 76 65 20 74 6f 20 77  |ext to move to w|
00000cb0  68 65 6e 20 79 6f 75 20  63 6c 69 63 6b 00 6f 6e  |hen you click.on|
00000cc0  20 74 68 65 20 62 75 74  74 6f 6e 2e 00 00 4c 6f  | the button...Lo|
00000cd0  6f 6b 20 61 74 20 74 68  65 20 66 69 6c 65 73 20  |ok at the files |
00000ce0  69 6e 20 74 68 65 20 73  75 62 64 69 72 65 63 74  |in the subdirect|
00000cf0  6f 72 79 20 27 54 65 78  74 27 20 69 6e 73 69 64  |ory 'Text' insid|
00000d00  65 20 74 68 65 20 48 65  6c 70 47 65 6e 20 61 70  |e the HelpGen ap|
00000d10  70 6c 69 63 61 74 69 6f  6e 00 64 69 72 65 63 74  |plication.direct|
00000d20  6f 72 79 20 66 6f 72 20  73 6f 6d 65 20 65 78 61  |ory for some exa|
00000d30  6d 70 6c 65 73 20 6f 72  20 70 72 65 73 73 20 20  |mples or press  |
00000d40  20 20 74 6f 20 73 65 65  20 77 68 61 74 20 74 68  |  to see what th|
00000d50  65 79 20 61 72 65 2e 00  00 54 68 65 20 6d 65 6e  |ey are...The men|
00000d60  75 20 66 69 6c 65 00 7e  7e 7e 7e 7e 7e 7e 7e 7e  |u file.~~~~~~~~~|
00000d70  7e 7e 7e 7e 00 54 68 65  20 66 69 72 73 74 20 6c  |~~~~.The first l|
00000d80  69 6e 65 20 6f 66 20 74  68 65 20 6d 65 6e 75 20  |ine of the menu |
00000d90  66 69 6c 65 20 69 73 20  74 68 65 20 74 69 74 6c  |file is the titl|
00000da0  65 20 6f 66 20 74 68 65  20 68 65 6c 70 20 77 69  |e of the help wi|
00000db0  6e 64 6f 77 2c 20 74 79  70 69 63 61 6c 6c 79 00  |ndow, typically.|
00000dc0  74 68 65 20 6e 61 6d 65  20 61 6e 64 20 76 65 72  |the name and ver|
00000dd0  73 69 6f 6e 20 6e 75 6d  62 65 72 20 6f 66 20 74  |sion number of t|
00000de0  68 65 20 61 70 70 6c 69  63 61 74 69 6f 6e 2e 00  |he application..|
00000df0  00 54 68 65 20 72 65 73  74 20 6f 66 20 74 68 65  |.The rest of the|
00000e00  20 66 69 6c 65 20 69 73  20 74 68 65 20 64 65 66  | file is the def|
00000e10  69 6e 69 74 69 6f 6e 20  6f 66 20 74 68 65 20 6d  |inition of the m|
00000e20  65 6e 75 2e 20 45 61 63  68 20 6c 69 6e 65 20 69  |enu. Each line i|
00000e30  73 20 6f 6e 65 20 6d 65  6e 75 00 69 74 65 6d 2e  |s one menu.item.|
00000e40  20 54 68 65 20 66 6f 72  6d 61 74 20 6f 66 20 65  | The format of e|
00000e50  61 63 68 20 6c 69 6e 65  20 69 73 3a 00 00 20 20  |ach line is:..  |
00000e60  4d 65 6e 75 5f 69 74 65  6d 2c 6c 61 62 65 6c 00  |Menu_item,label.|
00000e70  00 57 68 65 6e 20 74 68  69 73 20 69 74 65 6d 20  |.When this item |
00000e80  69 73 20 63 68 6f 73 65  6e 20 66 72 6f 6d 20 74  |is chosen from t|
00000e90  68 65 20 6d 65 6e 75 2c  20 74 68 65 20 77 69 6e  |he menu, the win|
00000ea0  64 6f 77 20 77 69 6c 6c  20 6d 6f 76 65 20 73 6f  |dow will move so|
00000eb0  20 74 68 61 74 20 74 68  65 00 6c 61 62 65 6c 20  | that the.label |
00000ec0  77 69 6c 6c 20 61 70 70  65 61 72 20 6e 65 61 72  |will appear near|
00000ed0  20 74 68 65 20 74 6f 70  2e 00 00 53 65 65 20 74  | the top...See t|
00000ee0  68 65 20 65 78 61 6d 70  6c 65 20 6d 65 6e 75 20  |he example menu |
00000ef0  69 6e 20 74 68 65 20 73  75 62 64 69 72 65 63 74  |in the subdirect|
00000f00  6f 72 79 20 27 54 65 78  74 27 20 69 6e 73 69 64  |ory 'Text' insid|
00000f10  65 20 74 68 65 20 48 65  6c 70 47 65 6e 00 61 70  |e the HelpGen.ap|
00000f20  70 6c 69 63 61 74 69 6f  6e 20 64 69 72 65 63 74  |plication direct|
00000f30  6f 72 79 2e 00 00 41 75  74 6f 6d 61 74 69 63 20  |ory...Automatic |
00000f40  48 65 6c 70 44 65 73 20  66 69 6c 65 20 63 72 65  |HelpDes file cre|
00000f50  61 74 69 6f 6e 00 7e 7e  7e 7e 7e 7e 7e 7e 7e 7e  |ation.~~~~~~~~~~|
00000f60  7e 7e 7e 7e 7e 7e 7e 7e  7e 7e 7e 7e 7e 7e 7e 7e  |~~~~~~~~~~~~~~~~|
00000f70  7e 7e 7e 7e 7e 00 49 66  20 48 65 6c 70 47 65 6e  |~~~~~.If HelpGen|
00000f80  20 63 61 6e 6e 6f 74 20  66 69 6e 64 20 61 20 48  | cannot find a H|
00000f90  65 6c 70 44 65 73 20 66  69 6c 65 20 69 6e 20 74  |elpDes file in t|
00000fa0  68 65 20 61 70 70 6c 69  63 61 74 69 6f 6e 20 64  |he application d|
00000fb0  69 72 65 63 74 6f 72 79  2c 20 69 74 20 77 69 6c  |irectory, it wil|
00000fc0  6c 00 61 73 6b 20 79 6f  75 20 69 66 20 79 6f 75  |l.ask you if you|
00000fd0  20 77 61 6e 74 20 74 6f  20 61 74 74 65 6d 70 74  | want to attempt|
00000fe0  20 74 6f 20 63 72 65 61  74 65 20 6f 6e 65 2e 20  | to create one. |
00000ff0  49 66 20 74 68 65 20 61  6e 73 77 65 72 20 69 66  |If the answer if|
00001000  20 79 65 73 2c 20 48 65  6c 70 47 65 6e 00 77 69  | yes, HelpGen.wi|
00001010  6c 6c 20 6c 6f 6f 6b 20  66 6f 72 20 61 20 74 65  |ll look for a te|
00001020  78 74 20 66 69 6c 65 20  63 61 6c 6c 65 64 20 65  |xt file called e|
00001030  69 74 68 65 72 20 27 21  48 65 6c 70 27 20 6f 72  |ither '!Help' or|
00001040  20 27 52 65 61 64 4d 65  27 2e 20 49 66 20 69 74  | 'ReadMe'. If it|
00001050  20 63 61 6e 27 74 00 66  69 6e 64 20 65 69 74 68  | can't.find eith|
00001060  65 72 2c 20 69 74 20 77  69 6c 6c 20 73 74 6f 70  |er, it will stop|
00001070  20 75 6e 73 75 63 63 65  73 73 66 75 6c 6c 79 2e  | unsuccessfully.|
00001080  00 00 41 66 74 65 72 20  74 68 65 20 67 65 6e 65  |..After the gene|
00001090  72 61 74 6f 72 20 68 61  73 20 66 6f 75 6e 64 20  |rator has found |
000010a0  73 6f 6d 65 20 73 75 69  74 61 62 6c 65 20 74 65  |some suitable te|
000010b0  78 74 2c 20 74 68 65 20  66 6f 6c 6c 6f 77 69 6e  |xt, the followin|
000010c0  67 20 61 63 74 69 6f 6e  73 20 61 72 65 00 70 65  |g actions are.pe|
000010d0  72 66 6f 72 6d 65 64 20  74 6f 20 70 72 6f 64 75  |rformed to produ|
000010e0  63 65 20 61 20 48 65 6c  70 44 65 73 20 66 69 6c  |ce a HelpDes fil|
000010f0  65 2e 20 54 68 65 79 20  61 72 65 3a 00 00 20 20  |e. They are:..  |
00001100  43 72 65 61 74 65 20 61  20 64 69 72 65 63 74 6f  |Create a directo|
00001110  72 79 20 69 6e 73 69 64  65 20 74 68 65 20 61 70  |ry inside the ap|
00001120  70 6c 69 63 61 74 69 6f  6e 20 64 69 72 65 63 74  |plication direct|
00001130  6f 72 79 20 63 61 6c 6c  65 64 20 27 4d 61 6b 65  |ory called 'Make|
00001140  48 65 6c 70 27 00 20 20  52 65 6e 61 6d 65 20 74  |Help'.  Rename t|
00001150  68 65 20 74 65 78 74 20  74 6f 20 62 65 20 74 68  |he text to be th|
00001160  65 20 66 69 6c 65 20 27  4d 61 6b 65 48 65 6c 70  |e file 'MakeHelp|
00001170  2e 54 65 78 74 27 00 20  20 43 72 65 61 74 65 20  |.Text'.  Create |
00001180  61 6e 20 65 6d 70 74 79  20 6d 65 6e 75 20 66 69  |an empty menu fi|
00001190  6c 65 20 77 69 74 68 20  74 68 65 20 74 69 74 6c  |le with the titl|
000011a0  65 20 6f 66 20 74 68 65  20 48 65 6c 70 52 65 61  |e of the HelpRea|
000011b0  64 65 72 20 77 69 6e 64  6f 77 20 61 73 20 74 68  |der window as th|
000011c0  65 00 20 20 20 20 6e 61  6d 65 20 6f 66 20 74 68  |e.    name of th|
000011d0  65 20 68 65 6c 70 20 73  79 73 74 65 6d 00 20 20  |e help system.  |
000011e0  43 72 65 61 74 65 20 61  20 48 65 6c 70 44 65 73  |Create a HelpDes|
000011f0  20 66 69 6c 65 20 73 70  65 63 69 66 69 79 69 6e  | file specifiyin|
00001200  67 20 74 68 65 73 65 20  74 77 6f 20 66 69 6c 65  |g these two file|
00001210  73 20 77 69 74 68 20 74  68 65 20 6f 70 74 69 6f  |s with the optio|
00001220  6e 00 20 20 20 20 27 6e  6f 20 6d 65 6e 75 20 6f  |n.    'no menu o|
00001230  6e 20 73 74 61 72 74 20  75 70 27 00 00 57 68 65  |n start up'..Whe|
00001240  6e 20 61 6c 6c 20 74 68  69 73 20 68 61 73 20 62  |n all this has b|
00001250  65 65 6e 20 64 6f 6e 65  2c 20 61 20 68 65 6c 70  |een done, a help|
00001260  20 73 79 73 74 65 6d 20  77 69 6c 6c 20 62 65 20  | system will be |
00001270  6d 61 64 65 20 75 73 69  6e 67 20 74 68 65 73 65  |made using these|
00001280  20 66 69 6c 65 73 2e 00  00 45 78 61 6d 70 6c 65  | files...Example|
00001290  73 00 7e 7e 7e 7e 7e 7e  7e 7e 00 54 68 65 20 73  |s.~~~~~~~~.The s|
000012a0  75 62 64 69 72 65 63 74  6f 72 79 20 27 54 65 78  |ubdirectory 'Tex|
000012b0  74 27 20 69 6e 73 69 64  65 20 74 68 65 20 48 65  |t' inside the He|
000012c0  6c 70 47 65 6e 20 61 70  70 6c 69 63 61 74 69 6f  |lpGen applicatio|
000012d0  6e 20 64 69 72 65 63 74  6f 72 79 20 63 6f 6e 74  |n directory cont|
000012e0  61 69 6e 73 00 73 6f 6d  65 20 65 78 61 6d 70 6c  |ains.some exampl|
000012f0  65 73 2e 20 54 68 65 79  20 61 72 65 20 6c 69 73  |es. They are lis|
00001300  74 65 64 20 62 65 6c 6f  77 2e 20 28 48 6f 6c 64  |ted below. (Hold|
00001310  20 64 6f 77 6e 20 73 68  69 66 74 20 61 6e 64 20  | down shift and |
00001320  64 6f 75 62 6c 65 20 63  6c 69 63 6b 20 6f 6e 00  |double click on.|
00001330  74 68 65 20 61 70 70 6c  69 63 61 74 69 6f 6e 20  |the application |
00001340  69 63 6f 6e 20 74 6f 20  67 65 74 20 69 6e 73 69  |icon to get insi|
00001350  64 65 20 74 68 65 20 61  70 70 6c 69 63 61 74 69  |de the applicati|
00001360  6f 6e 20 64 69 72 65 63  74 6f 72 79 2e 29 00 00  |on directory.)..|
00001370  20 20 46 69 6c 65 6e 61  6d 65 20 20 44 65 73 63  |  Filename  Desc|
00001380  72 69 70 74 69 6f 6e 20  6f 66 20 63 6f 6e 74 65  |ription of conte|
00001390  6e 74 73 00 20 20 2d 2d  2d 2d 2d 2d 2d 2d 20 20  |nts.  --------  |
000013a0  2d 2d 2d 2d 2d 2d 2d 2d  2d 2d 2d 2d 2d 2d 2d 2d  |----------------|
000013b0  2d 2d 2d 2d 2d 2d 2d 00  20 20 4d 65 6e 75 20 20  |-------.  Menu  |
000013c0  20 20 20 20 41 6e 20 65  78 61 6d 70 6c 65 20 6d  |    An example m|
000013d0  65 6e 75 00 20 20 4d 65  73 73 61 67 65 20 20 20  |enu.  Message   |
000013e0  54 68 65 20 74 65 78 74  20 6f 66 20 74 68 65 20  |The text of the |
000013f0  6d 65 73 73 61 67 65 20  49 20 77 6f 75 6c 64 20  |message I would |
00001400  6c 69 6b 65 20 79 6f 75  20 74 6f 20 69 6e 63 6c  |like you to incl|
00001410  75 64 65 20 69 6e 20 65  76 65 72 79 00 20 20 20  |ude in every.   |
00001420  20 20 20 20 20 20 20 20  20 20 20 68 65 6c 70 20  |           help |
00001430  73 79 73 74 65 6d 20 79  6f 75 20 6d 61 6b 65 20  |system you make |
00001440  77 69 74 68 20 48 65 6c  70 52 65 61 64 65 72 00  |with HelpReader.|
00001450  20 20 48 6f 77 54 6f 55  73 65 20 20 41 20 73 68  |  HowToUse  A sh|
00001460  6f 72 74 20 6d 65 73 73  61 67 65 20 79 6f 75 20  |ort message you |
00001470  6d 69 67 68 74 20 6c 69  6b 65 20 74 6f 20 69 6e  |might like to in|
00001480  63 6c 75 64 65 20 61 74  20 74 68 65 20 74 6f 70  |clude at the top|
00001490  20 6f 66 00 20 20 20 20  20 20 20 20 20 20 20 20  | of.            |
000014a0  20 20 79 6f 75 72 20 68  65 6c 70 20 73 79 73 74  |  your help syst|
000014b0  65 6d 20 74 6f 20 74 65  6c 6c 20 74 68 65 20 75  |em to tell the u|
000014c0  73 65 72 20 68 6f 77 20  74 6f 20 75 73 65 20 48  |ser how to use H|
000014d0  65 6c 70 52 65 61 64 65  72 00 20 20 48 65 6c 70  |elpReader.  Help|
000014e0  44 65 73 20 20 20 41 6e  20 65 78 61 6d 70 6c 65  |Des   An example|
000014f0  20 48 65 6c 70 44 65 73  20 66 69 6c 65 00 20 20  | HelpDes file.  |
00001500  21 44 65 6d 6f 41 70 70  20 20 41 6e 20 65 78 61  |!DemoApp  An exa|
00001510  6d 70 6c 65 20 61 70 70  6c 69 63 61 74 69 6f 6e  |mple application|
00001520  20 73 65 74 20 75 70 20  77 69 74 68 20 73 6f 75  | set up with sou|
00001530  72 63 65 20 74 65 78 74  20 66 69 6c 65 73 00 00  |rce text files..|
00001540  54 68 65 20 41 75 74 68  6f 72 00 7e 7e 7e 7e 7e  |The Author.~~~~~|
00001550  7e 7e 7e 7e 7e 00 48 65  6c 70 52 65 61 64 65 72  |~~~~~.HelpReader|
00001560  20 61 6e 64 20 48 65 6c  70 47 65 6e 20 77 65 72  | and HelpGen wer|
00001570  65 20 77 72 69 74 74 65  6e 20 62 79 20 42 65 6e  |e written by Ben|
00001580  20 53 75 6d 6d 65 72 73  2e 20 49 66 20 79 6f 75  | Summers. If you|
00001590  20 77 6f 75 6c 64 20 6c  69 6b 65 20 74 6f 00 73  | would like to.s|
000015a0  75 67 67 65 73 74 20 69  6d 70 72 6f 76 65 6d 65  |uggest improveme|
000015b0  6e 74 73 2c 20 72 65 70  6f 72 74 20 62 75 67 73  |nts, report bugs|
000015c0  20 28 77 68 61 74 20 2d  20 69 6e 20 6d 79 20 70  | (what - in my p|
000015d0  72 6f 67 72 61 6d 73 3f  29 20 6f 72 20 73 65 6e  |rograms?) or sen|
000015e0  64 20 61 20 74 6f 6b 65  6e 00 6f 66 20 79 6f 75  |d a token.of you|
000015f0  72 20 61 70 70 72 65 63  69 61 74 69 6f 6e 20 28  |r appreciation (|
00001600  61 20 64 69 73 63 20 6f  66 20 50 44 20 65 74 63  |a disc of PD etc|
00001610  29 2c 20 70 6c 65 61 73  65 20 77 72 69 74 65 20  |), please write |
00001620  74 6f 20 6d 65 20 61 74  20 74 68 65 20 61 64 64  |to me at the add|
00001630  72 65 73 73 00 62 65 6c  6f 77 2e 20 50 6c 65 61  |ress.below. Plea|
00001640  73 65 20 65 6e 63 6c 6f  73 65 20 61 6e 20 53 41  |se enclose an SA|
00001650  45 20 69 66 20 79 6f 75  20 77 61 6e 74 20 61 20  |E if you want a |
00001660  72 65 70 6c 79 2e 00 00  20 20 42 65 6e 20 53 75  |reply...  Ben Su|
00001670  6d 6d 65 72 73 00 20 20  33 39 41 20 43 72 6f 6d  |mmers.  39A Crom|
00001680  65 72 20 52 6f 61 64 00  20 20 48 65 6c 6c 65 73  |er Road.  Helles|
00001690  64 6f 6e 00 20 20 4e 6f  72 77 69 63 68 00 20 20  |don.  Norwich.  |
000016a0  4e 52 36 20 36 4c 58 00  00 4c 65 67 61 6c 20 6e  |NR6 6LX..Legal n|
000016b0  6f 74 65 00 7e 7e 7e 7e  7e 7e 7e 7e 7e 7e 00 59  |ote.~~~~~~~~~~.Y|
000016c0  6f 75 20 6d 61 79 20 75  73 65 20 48 65 6c 70 52  |ou may use HelpR|
000016d0  65 61 64 65 72 20 69 6e  20 61 6e 79 20 61 70 70  |eader in any app|
000016e0  6c 69 63 61 74 69 6f 6e  20 79 6f 75 20 77 72 69  |lication you wri|
000016f0  74 65 2c 20 50 44 20 6f  72 20 63 6f 6d 6d 65 72  |te, PD or commer|
00001700  63 69 61 6c 2c 20 61 73  00 6c 6f 6e 67 20 61 73  |cial, as.long as|
00001710  20 79 6f 75 20 73 65 6e  64 20 6d 65 20 61 20 63  | you send me a c|
00001720  6f 70 79 20 6f 66 20 74  68 65 20 72 65 6c 65 61  |opy of the relea|
00001730  73 65 20 76 65 72 73 69  6f 6e 20 77 69 74 68 20  |se version with |
00001740  61 6e 79 20 64 6f 63 75  6d 65 6e 74 61 74 69 6f  |any documentatio|
00001750  6e 00 77 68 69 63 68 20  67 6f 65 73 20 77 69 74  |n.which goes wit|
00001760  68 20 69 74 2e 20 59 6f  75 20 6d 75 73 74 20 61  |h it. You must a|
00001770  6c 73 6f 20 69 6e 63 6c  75 64 65 20 74 68 65 20  |lso include the |
00001780  66 6f 6c 6c 6f 77 69 6e  67 20 74 65 78 74 20 69  |following text i|
00001790  6e 20 79 6f 75 72 20 68  65 6c 70 00 66 69 6c 65  |n your help.file|
000017a0  2c 20 61 6e 64 20 74 68  65 20 6d 65 6e 75 20 69  |, and the menu i|
000017b0  74 65 6d 20 27 48 65 6c  70 52 65 61 64 65 72 27  |tem 'HelpReader'|
000017c0  20 77 68 69 63 68 20 73  68 6f 75 6c 64 20 62 65  | which should be|
000017d0  20 73 65 74 20 75 70 20  74 6f 20 6a 75 6d 70 20  | set up to jump |
000017e0  74 6f 00 74 68 69 73 20  74 65 78 74 3a 00 00 2a  |to.this text:..*|
000017f0  2a 2a 2a 2a 2a 2a 2a 2a  2a 2a 2a 2a 2a 2a 2a 2a  |****************|
*
00001830  2a 2a 2a 2a 2a 2a 2a 2a  2a 2a 2a 2a 00 20 20 48  |************.  H|
00001840  65 6c 70 52 65 61 64 65  72 20 76 65 72 73 69 6f  |elpReader versio|
00001850  6e 20 31 2e 30 33 00 20  20 62 79 20 42 65 6e 20  |n 1.03.  by Ben |
00001860  53 75 6d 6d 65 72 73 00  00 20 20 54 68 69 73 20  |Summers..  This |
00001870  48 65 6c 70 52 65 61 64  65 72 20 61 70 70 6c 69  |HelpReader appli|
00001880  63 61 74 69 6f 6e 20 69  73 20 70 75 62 6c 69 63  |cation is public|
00001890  20 64 6f 6d 61 69 6e 2e  20 59 6f 75 20 6d 61 79  | domain. You may|
000018a0  20 75 73 65 20 69 74 20  69 6e 20 79 6f 75 72 20  | use it in your |
000018b0  6f 77 6e 00 20 20 70 72  6f 67 72 61 6d 73 2c 20  |own.  programs, |
000018c0  50 44 20 6f 72 20 63 6f  6d 6d 65 72 63 69 61 6c  |PD or commercial|
000018d0  20 61 73 20 6c 6f 6e 67  20 61 73 20 79 6f 75 20  | as long as you |
000018e0  73 65 6e 64 20 6d 65 20  61 20 63 6f 70 79 20 6f  |send me a copy o|
000018f0  66 20 69 74 2c 20 61 6e  64 20 61 6e 79 00 20 20  |f it, and any.  |
00001900  64 6f 63 75 6d 65 6e 74  69 6f 6e 20 77 68 69 63  |documention whic|
00001910  68 20 67 6f 65 73 20 77  69 74 68 20 69 74 2e 00  |h goes with it..|
00001920  00 20 20 54 6f 20 6d 61  6b 65 20 68 65 6c 70 20  |.  To make help |
00001930  73 79 73 74 65 6d 73 20  75 73 69 6e 67 20 48 65  |systems using He|
00001940  6c 70 52 65 61 64 65 72  2c 20 79 6f 75 20 77 69  |lpReader, you wi|
00001950  6c 6c 20 6e 65 65 64 20  61 20 63 6f 70 79 20 6f  |ll need a copy o|
00001960  66 20 74 68 65 00 20 20  48 65 6c 70 52 65 61 64  |f the.  HelpRead|
00001970  65 72 20 66 69 6c 65 20  67 65 6e 65 72 61 74 6f  |er file generato|
00001980  72 2e 20 53 65 6e 64 20  6d 65 20 61 20 64 69 73  |r. Send me a dis|
00001990  63 20 61 6e 64 20 61 6e  20 53 41 45 20 77 69 74  |c and an SAE wit|
000019a0  68 20 61 20 6c 65 74 74  65 72 20 61 73 6b 69 6e  |h a letter askin|
000019b0  67 00 20 20 66 6f 72 20  61 20 63 6f 70 79 20 69  |g.  for a copy i|
000019c0  66 20 79 6f 75 20 68 61  76 65 6e 27 74 20 67 6f  |f you haven't go|
000019d0  74 20 6f 6e 65 2e 00 00  20 20 4d 79 20 61 64 64  |t one...  My add|
000019e0  72 65 73 73 20 69 73 3a  00 20 20 20 20 42 65 6e  |ress is:.    Ben|
000019f0  20 53 75 6d 6d 65 72 73  2c 20 33 39 41 20 43 72  | Summers, 39A Cr|
00001a00  6f 6d 65 72 20 52 6f 61  64 2c 20 48 65 6c 6c 65  |omer Road, Helle|
00001a10  73 64 6f 6e 2c 20 4e 6f  72 77 69 63 68 20 4e 52  |sdon, Norwich NR|
00001a20  36 20 36 4c 58 00 00 2a  2a 2a 2a 2a 2a 2a 2a 2a  |6 6LX..*********|
00001a30  2a 2a 2a 2a 2a 2a 2a 2a  2a 2a 2a 2a 2a 2a 2a 2a  |****************|
*
00001a70  2a 2a 2a 2a 00 00 49 66  20 74 68 69 73 20 74 65  |****..If this te|
00001a80  78 74 20 69 73 20 6e 6f  74 20 69 6e 63 6c 75 64  |xt is not includ|
00001a90  65 64 20 69 6e 20 79 6f  75 72 20 68 65 6c 70 20  |ed in your help |
00001aa0  74 65 78 74 2c 20 69 74  20 77 69 6c 6c 20 62 65  |text, it will be|
00001ab0  20 61 64 64 65 64 20 74  6f 20 74 68 65 20 65 6e  | added to the en|
00001ac0  64 00 6f 66 20 79 6f 75  72 20 68 65 6c 70 20 66  |d.of your help f|
00001ad0  69 6c 65 2c 20 61 6e 64  20 69 66 20 74 68 65 20  |ile, and if the |
00001ae0  6d 65 6e 75 20 69 74 65  6d 20 69 73 20 6e 6f 74  |menu item is not|
00001af0  20 69 6e 63 6c 75 64 65  64 2c 20 69 74 20 77 69  | included, it wi|
00001b00  6c 6c 20 62 65 20 61 64  64 65 64 20 74 6f 00 74  |ll be added to.t|
00001b10  68 65 20 6d 65 6e 75 2c  20 73 6f 20 79 6f 75 20  |he menu, so you |
00001b20  64 6f 20 6e 6f 74 20 68  61 76 65 20 74 6f 20 77  |do not have to w|
00001b30  6f 72 72 79 20 61 62 6f  75 74 20 61 64 64 69 6e  |orry about addin|
00001b40  67 20 69 74 20 79 6f 75  72 73 65 6c 66 2e 00 00  |g it yourself...|
00001b50  49 66 20 79 6f 75 20 64  6f 20 6e 6f 74 20 77 61  |If you do not wa|
00001b60  6e 74 20 74 6f 20 68 61  76 65 20 69 74 20 61 74  |nt to have it at|
00001b70  20 74 68 65 20 65 6e 64  20 6f 66 20 74 68 65 20  | the end of the |
00001b80  66 69 6c 65 2c 20 62 75  74 20 77 69 73 68 20 74  |file, but wish t|
00001b90  6f 20 69 6e 73 65 72 74  20 69 74 00 73 6f 6d 65  |o insert it.some|
00001ba0  77 68 65 72 65 20 65 6c  73 65 2c 20 74 68 65 20  |where else, the |
00001bb0  74 65 78 74 20 66 6f 72  20 74 68 65 20 6d 65 73  |text for the mes|
00001bc0  73 61 67 65 20 69 73 20  69 6e 20 74 68 65 20 27  |sage is in the '|
00001bd0  54 65 78 74 27 20 73 75  62 64 69 72 65 63 74 6f  |Text' subdirecto|
00001be0  72 79 20 6f 66 00 74 68  65 20 61 70 70 6c 69 63  |ry of.the applic|
00001bf0  61 74 69 6f 6e 20 64 69  72 65 63 74 6f 72 79 2e  |ation directory.|
00001c00  00 74 65 6d 48 65 6c 70  47 65 6e 20 76 65 72 73  |.temHelpGen vers|
00001c10  69 6f 6e 20 31 2e 30 31  20 28 48 65 6c 70 52 65  |ion 1.01 (HelpRe|
00001c20  61 64 65 72 20 68 65 6c  70 20 73 79 73 74 65 6d  |ader help system|
00001c30  20 67 65 6e 65 72 61 74  6f 72 29 00 4f 76 65 72  | generator).Over|
00001c40  76 69 65 77 00 54 68 65  20 74 65 78 74 20 66 69  |view.The text fi|
00001c50  6c 65 00 54 68 65 20 6d  65 6e 75 20 66 69 6c 65  |le.The menu file|
00001c60  00 48 65 6c 70 44 65 73  20 67 65 6e 65 72 61 74  |.HelpDes generat|
00001c70  69 6f 6e 00 4c 65 67 61  6c 20 6e 6f 74 65 00 54  |ion.Legal note.T|
00001c80  68 65 20 61 75 74 68 6f  72 00 48 65 6c 70 52 65  |he author.HelpRe|
00001c90  61 64 65 72 00 45 78 61  6d 70 6c 65 73 00 70 64  |ader.Examples.pd|
00001ca0  11 00 00 00 2d 00 00 00  47 00 00 00 57 00 00 00  |....-...G...W...|
00001cb0  87 00 00 00 7a 00 00 00  8f 00 00 00 6a 00 00 00  |....z.......j...|
00001cc0  02 00 00 00 8f 00 00 00  57 00 00 00 6a 00 00 00  |........W...j...|
00001cd0  b2 03 00 00 40 ff ff ff  d2 03 00 00 60 ff ff ff  |....@.......`...|
00001ce0  22 03 00 00 00 ff ff ff  42 03 00 00 20 ff ff ff  |".......B... ...|
00001cf0  f2 00 00 00 00 fb ff ff  12 01 00 00 20 fb ff ff  |............ ...|
00001d00  52 02 00 00 20 f7 ff ff  72 02 00 00 40 f7 ff ff  |R... ...r...@...|
00001d10