Home » Archimedes archive » Archimedes World » AW-1994-09-Disc1.adf » Disk1Sep94 » !AWSept94/Goodies/Ray3D/!Help+/Help_On/!Help+

!AWSept94/Goodies/Ray3D/!Help+/Help_On/!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 » Archimedes World » AW-1994-09-Disc1.adf » Disk1Sep94
Filename: !AWSept94/Goodies/Ray3D/!Help+/Help_On/!Help+
Read OK:
File size: 1ED5 bytes
Load address: 0000
Exec address: 0000
File contents
@page:contents@Title page


                           

                           
    @Sprite:Wyvern@                
      _______________________________________________________

   Welcome to !Help+. While using this application you will come across
   3d slab icons such as the ones below. Clicking on an icon takes you
   to more help on that subject.

         @goto:2: Using !Help+         @      @goto:7: The Menu             @
         @goto:search: Searching            @      @goto:4: About the Author     @
         @goto:print: Printing             @      @goto:5: Copyright Notice     @
      
         @goto:prog: Programmers          @

@end@
@page:2@Using Help+

   @colour:11@Using Help+

   Clicking on the icon on the icon bar brings up a window for
   the associated Help+ file. It is in this window that the pages
   will be displayed. Initially it consists of the "root" page.

   On each page there may be 3d buttons with text inside them.
   Clicking on one will take you to another page.

   Clicking on the close icon of the window with ADJUST will bring
   up the page you came from. By repeatedly doing this you may
   trace your way back to the "root" page.

   Sprites may also be displayed within the page, however clicking
   on these will have no effect.

   Clicking on the icon on the icon bar brings up a @goto:7:Menu@ with
   more features.

@end@
@page:3@Creating Help+ files

   @colour:11@Creating !Help+ files

   To create help on another application for use with !Help+, you need
   to know the following.

   *  The help is a textfile , within which are @goto:6:special commands@

   *  The file should be given the filetype &0f8 and saved in the
      "Help_On" directory (located in the !Help+ application directory).

   *  The name you give your file is the name that will appear on the
      !Help+ menu.

   *  The help file is divided into 'pages', using the commands to start
      and end a page.

   *  Any sprites which you will be using need to be merged with the
      existing "Sprites" file using !Paint.

@end@
@page:4@About the Author

   @colour:11@About the Author

   !Help+ was fully designed and coded exclusively for Wyvern Software by:
   
      Robert Taylor
      5 Mayfield Grove
      Skegness
      Lincolnshire
      PE25 3RY

@end@
@page:5@Copyright for !Help+

   @colour:11@Copyright Notice for !Help+
   
   !Help+ is a public domain application but it is copyright, so
   please copy it freely but do follow the conditions below.
   
   *It may be copied freely as long as this is not done for a
    profit or any sort of commercial gain or advantage and the
    complete application is copied as a whole.
   
   *The copyright remains mine at all times. @goto:4:About the Author@
   
   *No part of this application may be included in any other app-
    lication without my permission.
   
   *Any modifications should be commented and a copy sent to me so
    that they can be incorporated in future versions.
   
   *This application is supplied "as is", and I cannot be held
    responsible for loss or damages that arise from the use, mis-use
    or lack of use of this program.

   *This help file MUST be unaltered and included with any other help
    files which are distributed.

@end@
@page:6@Commands

   @colour:11@Special Commands

       @Goto:Page: Page:id             @
       @Goto:end: End                 @
       @Goto:colour: Colour:##           @
       @Goto:sprite: Sprite:name         @
       @Goto:goto: Goto:id:button text @

   For more information I suggest loading an existing Help+ file into a
   text editor such as !Edit.

@end@
@page:page@Page:id

  @colour:11@   @sprite:at@ Page:id@sprite:at@
  
       This marks the start of a page. A page name or identifier should
       be given in place of id.
  
       NB: Every file must have a page "contents", which is what will be
       displayed when the icon bar is clicked on.

@end@
@Page:end@End
  
  @colour:11@   @sprite:at@ End@sprite:at@
  
       This marks the end of the page being defined.

@end@
@page:colour@Colour:##
  
  @colour:11@   @sprite:at@ colour:##@sprite:at@
  
       This command changes the colour of the text, until the next line,
       where it changes back to black.
  
       NB: The (wimp) colour number should be given in place of the ##.
           Numbers less than 10 should be given as 01,02...

@end@
@page:Sprite@Sprite:name
  
  @colour:11@   @sprite:at@ Sprite:name@sprite:at@
  
       This will place the sprite 'name' on the screen, with it's bottom
       left corner located at the start of the command.

@end@
@page:goto@Goto:id:button text

  @colour:11@   @sprite:at@ Goto:id:button text@sprite:at@
  
       This places a button on the screen, with the 'button text' dis-
       played inside. Clicking on this button will send the user to the
       page identified by id.

@end@
@page:7@The !Help+ Menu

   @colour:11@The !Help+ Menu

   To bring up the !Help+ menu, click using the MENU button on the icon
   bar over the !Help+ icon.

   There are five options:

       @goto:info: Info       @
       @goto:Help_on: Help On   �@
       @goto:root: Root       @
       @goto:search: Search     @
       @goto:print: Print page @
       @goto:quit: Quit       @

@end@
@page:info@Info

      @colour:08@Info

      This option leads onto a sub-menu with Information on !Help+ such
      as the version number.

@end@
@page:Help_on@Help On

      @colour:08@Help On

      This option leads onto a sub-menu which lists all the applications
      for which help is available. Selecting one of these applications
      will bring up the relevant help system.

@end@
@page:root@Root

      @colour:08@Open Root

      From time to time you may want to go back to the start page of the
      current help system. Selecting this option will open the "root" page.

@end@
@page:search@Search

      @colour:08@Search

      Selecting this option will open a window where you can enter what
      you wish to search for. Pressing return will start the search, and
      clicking on 'Next" will find the next match.

      Note: Clicking on the icon bar with ADJUST will also open the search
            window.

@end@
@page:quit@Quit

      @colour:08@Quit

      This will quit the !Help+ application.

@end@
@page:print@Printing

   @colour:11@Printing

   Sometimes it is desireable to have a hard copy of some information
   which can be found within a text file.

   Selecting the Print option from the menu will output a copy of the
   current page to your printer.

   NB: Sprites that appear in the Help+ files will not be printed.
       This is to maximise the speed of printing.

@end@
@page:prog@Programmers

   @colour:11@Programmers

   It is easy to create !Help+ files for your own applications, which can
   then be used interactively by sending commands from your own program
   which to the Help+ application

      @goto:3: Creating your own !Help+ files @

      @goto:ih: Implementing interactive help  @

@end@
@page:ih@Interactive help

   @colour:11@Interactive help

   It is possible to send !Help+ a wimp message which will cause it to
   display a specific page. This can be used to support interactive help
   which displays much more detailed information than is possible with
   Acorn's interactive help application.

   To do this a wimp message must be sent as follows:

@colour:08@       DEF PROCsend_help(command$)
@colour:08@         b%!0=256     :b%!4=0
@colour:08@         b%!8=0       :b%!12=0
@colour:08@         b%!16=&9900  :$(b%+20)=command$
@colour:08@         SYS"Wimp_SendMessage",17,b%,0
@colour:08@       ENDPROC

   Where the parameter passed to PROCsend_help is of the form:

@colour:08@       Help_system@sprite:b_at@ Page_name

   eg:  !Help.Contents     or
        !Help.Quit         or
        !Ray3d.Tools       etc.

@end@
00000000  40 70 61 67 65 3a 63 6f  6e 74 65 6e 74 73 40 54  |@page:contents@T|
00000010  69 74 6c 65 20 70 61 67  65 0a 0a 0a 20 20 20 20  |itle page...    |
00000020  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
00000030  20 20 20 20 20 20 20 0a  0a 20 20 20 20 20 20 20  |       ..       |
00000040  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
00000050  20 20 20 20 0a 20 20 20  20 40 53 70 72 69 74 65  |    .    @Sprite|
00000060  3a 57 79 76 65 72 6e 40  20 20 20 20 20 20 20 20  |:Wyvern@        |
00000070  20 20 20 20 20 20 20 20  0a 20 20 20 20 20 20 5f  |        .      _|
00000080  5f 5f 5f 5f 5f 5f 5f 5f  5f 5f 5f 5f 5f 5f 5f 5f  |________________|
*
000000b0  5f 5f 5f 5f 5f 5f 0a 0a  20 20 20 57 65 6c 63 6f  |______..   Welco|
000000c0  6d 65 20 74 6f 20 21 48  65 6c 70 2b 2e 20 57 68  |me to !Help+. Wh|
000000d0  69 6c 65 20 75 73 69 6e  67 20 74 68 69 73 20 61  |ile using this a|
000000e0  70 70 6c 69 63 61 74 69  6f 6e 20 79 6f 75 20 77  |pplication you w|
000000f0  69 6c 6c 20 63 6f 6d 65  20 61 63 72 6f 73 73 0a  |ill come across.|
00000100  20 20 20 33 64 20 73 6c  61 62 20 69 63 6f 6e 73  |   3d slab icons|
00000110  20 73 75 63 68 20 61 73  20 74 68 65 20 6f 6e 65  | such as the one|
00000120  73 20 62 65 6c 6f 77 2e  20 43 6c 69 63 6b 69 6e  |s below. Clickin|
00000130  67 20 6f 6e 20 61 6e 20  69 63 6f 6e 20 74 61 6b  |g on an icon tak|
00000140  65 73 20 79 6f 75 0a 20  20 20 74 6f 20 6d 6f 72  |es you.   to mor|
00000150  65 20 68 65 6c 70 20 6f  6e 20 74 68 61 74 20 73  |e help on that s|
00000160  75 62 6a 65 63 74 2e 0a  0a 20 20 20 20 20 20 20  |ubject...       |
00000170  20 20 40 67 6f 74 6f 3a  32 3a 20 55 73 69 6e 67  |  @goto:2: Using|
00000180  20 21 48 65 6c 70 2b 20  20 20 20 20 20 20 20 20  | !Help+         |
00000190  40 20 20 20 20 20 20 40  67 6f 74 6f 3a 37 3a 20  |@      @goto:7: |
000001a0  54 68 65 20 4d 65 6e 75  20 20 20 20 20 20 20 20  |The Menu        |
000001b0  20 20 20 20 20 40 0a 20  20 20 20 20 20 20 20 20  |     @.         |
000001c0  40 67 6f 74 6f 3a 73 65  61 72 63 68 3a 20 53 65  |@goto:search: Se|
000001d0  61 72 63 68 69 6e 67 20  20 20 20 20 20 20 20 20  |arching         |
000001e0  20 20 20 40 20 20 20 20  20 20 40 67 6f 74 6f 3a  |   @      @goto:|
000001f0  34 3a 20 41 62 6f 75 74  20 74 68 65 20 41 75 74  |4: About the Aut|
00000200  68 6f 72 20 20 20 20 20  40 0a 20 20 20 20 20 20  |hor     @.      |
00000210  20 20 20 40 67 6f 74 6f  3a 70 72 69 6e 74 3a 20  |   @goto:print: |
00000220  50 72 69 6e 74 69 6e 67  20 20 20 20 20 20 20 20  |Printing        |
00000230  20 20 20 20 20 40 20 20  20 20 20 20 40 67 6f 74  |     @      @got|
00000240  6f 3a 35 3a 20 43 6f 70  79 72 69 67 68 74 20 4e  |o:5: Copyright N|
00000250  6f 74 69 63 65 20 20 20  20 20 40 0a 20 20 20 20  |otice     @.    |
00000260  20 20 0a 20 20 20 20 20  20 20 20 20 40 67 6f 74  |  .         @got|
00000270  6f 3a 70 72 6f 67 3a 20  50 72 6f 67 72 61 6d 6d  |o:prog: Programm|
00000280  65 72 73 20 20 20 20 20  20 20 20 20 20 40 0a 0a  |ers          @..|
00000290  40 65 6e 64 40 0a 40 70  61 67 65 3a 32 40 55 73  |@end@.@page:2@Us|
000002a0  69 6e 67 20 48 65 6c 70  2b 0a 0a 20 20 20 40 63  |ing Help+..   @c|
000002b0  6f 6c 6f 75 72 3a 31 31  40 55 73 69 6e 67 20 48  |olour:11@Using H|
000002c0  65 6c 70 2b 0a 0a 20 20  20 43 6c 69 63 6b 69 6e  |elp+..   Clickin|
000002d0  67 20 6f 6e 20 74 68 65  20 69 63 6f 6e 20 6f 6e  |g on the icon on|
000002e0  20 74 68 65 20 69 63 6f  6e 20 62 61 72 20 62 72  | the icon bar br|
000002f0  69 6e 67 73 20 75 70 20  61 20 77 69 6e 64 6f 77  |ings up a window|
00000300  20 66 6f 72 0a 20 20 20  74 68 65 20 61 73 73 6f  | for.   the asso|
00000310  63 69 61 74 65 64 20 48  65 6c 70 2b 20 66 69 6c  |ciated Help+ fil|
00000320  65 2e 20 49 74 20 69 73  20 69 6e 20 74 68 69 73  |e. It is in this|
00000330  20 77 69 6e 64 6f 77 20  74 68 61 74 20 74 68 65  | window that the|
00000340  20 70 61 67 65 73 0a 20  20 20 77 69 6c 6c 20 62  | pages.   will b|
00000350  65 20 64 69 73 70 6c 61  79 65 64 2e 20 49 6e 69  |e displayed. Ini|
00000360  74 69 61 6c 6c 79 20 69  74 20 63 6f 6e 73 69 73  |tially it consis|
00000370  74 73 20 6f 66 20 74 68  65 20 22 72 6f 6f 74 22  |ts of the "root"|
00000380  20 70 61 67 65 2e 0a 0a  20 20 20 4f 6e 20 65 61  | page...   On ea|
00000390  63 68 20 70 61 67 65 20  74 68 65 72 65 20 6d 61  |ch page there ma|
000003a0  79 20 62 65 20 33 64 20  62 75 74 74 6f 6e 73 20  |y be 3d buttons |
000003b0  77 69 74 68 20 74 65 78  74 20 69 6e 73 69 64 65  |with text inside|
000003c0  20 74 68 65 6d 2e 0a 20  20 20 43 6c 69 63 6b 69  | them..   Clicki|
000003d0  6e 67 20 6f 6e 20 6f 6e  65 20 77 69 6c 6c 20 74  |ng on one will t|
000003e0  61 6b 65 20 79 6f 75 20  74 6f 20 61 6e 6f 74 68  |ake you to anoth|
000003f0  65 72 20 70 61 67 65 2e  0a 0a 20 20 20 43 6c 69  |er page...   Cli|
00000400  63 6b 69 6e 67 20 6f 6e  20 74 68 65 20 63 6c 6f  |cking on the clo|
00000410  73 65 20 69 63 6f 6e 20  6f 66 20 74 68 65 20 77  |se icon of the w|
00000420  69 6e 64 6f 77 20 77 69  74 68 20 41 44 4a 55 53  |indow with ADJUS|
00000430  54 20 77 69 6c 6c 20 62  72 69 6e 67 0a 20 20 20  |T will bring.   |
00000440  75 70 20 74 68 65 20 70  61 67 65 20 79 6f 75 20  |up the page you |
00000450  63 61 6d 65 20 66 72 6f  6d 2e 20 42 79 20 72 65  |came from. By re|
00000460  70 65 61 74 65 64 6c 79  20 64 6f 69 6e 67 20 74  |peatedly doing t|
00000470  68 69 73 20 79 6f 75 20  6d 61 79 0a 20 20 20 74  |his you may.   t|
00000480  72 61 63 65 20 79 6f 75  72 20 77 61 79 20 62 61  |race your way ba|
00000490  63 6b 20 74 6f 20 74 68  65 20 22 72 6f 6f 74 22  |ck to the "root"|
000004a0  20 70 61 67 65 2e 0a 0a  20 20 20 53 70 72 69 74  | page...   Sprit|
000004b0  65 73 20 6d 61 79 20 61  6c 73 6f 20 62 65 20 64  |es may also be d|
000004c0  69 73 70 6c 61 79 65 64  20 77 69 74 68 69 6e 20  |isplayed within |
000004d0  74 68 65 20 70 61 67 65  2c 20 68 6f 77 65 76 65  |the page, howeve|
000004e0  72 20 63 6c 69 63 6b 69  6e 67 0a 20 20 20 6f 6e  |r clicking.   on|
000004f0  20 74 68 65 73 65 20 77  69 6c 6c 20 68 61 76 65  | these will have|
00000500  20 6e 6f 20 65 66 66 65  63 74 2e 0a 0a 20 20 20  | no effect...   |
00000510  43 6c 69 63 6b 69 6e 67  20 6f 6e 20 74 68 65 20  |Clicking on the |
00000520  69 63 6f 6e 20 6f 6e 20  74 68 65 20 69 63 6f 6e  |icon on the icon|
00000530  20 62 61 72 20 62 72 69  6e 67 73 20 75 70 20 61  | bar brings up a|
00000540  20 40 67 6f 74 6f 3a 37  3a 4d 65 6e 75 40 20 77  | @goto:7:Menu@ w|
00000550  69 74 68 0a 20 20 20 6d  6f 72 65 20 66 65 61 74  |ith.   more feat|
00000560  75 72 65 73 2e 0a 0a 40  65 6e 64 40 0a 40 70 61  |ures...@end@.@pa|
00000570  67 65 3a 33 40 43 72 65  61 74 69 6e 67 20 48 65  |ge:3@Creating He|
00000580  6c 70 2b 20 66 69 6c 65  73 0a 0a 20 20 20 40 63  |lp+ files..   @c|
00000590  6f 6c 6f 75 72 3a 31 31  40 43 72 65 61 74 69 6e  |olour:11@Creatin|
000005a0  67 20 21 48 65 6c 70 2b  20 66 69 6c 65 73 0a 0a  |g !Help+ files..|
000005b0  20 20 20 54 6f 20 63 72  65 61 74 65 20 68 65 6c  |   To create hel|
000005c0  70 20 6f 6e 20 61 6e 6f  74 68 65 72 20 61 70 70  |p on another app|
000005d0  6c 69 63 61 74 69 6f 6e  20 66 6f 72 20 75 73 65  |lication for use|
000005e0  20 77 69 74 68 20 21 48  65 6c 70 2b 2c 20 79 6f  | with !Help+, yo|
000005f0  75 20 6e 65 65 64 0a 20  20 20 74 6f 20 6b 6e 6f  |u need.   to kno|
00000600  77 20 74 68 65 20 66 6f  6c 6c 6f 77 69 6e 67 2e  |w the following.|
00000610  0a 0a 20 20 20 2a 20 20  54 68 65 20 68 65 6c 70  |..   *  The help|
00000620  20 69 73 20 61 20 74 65  78 74 66 69 6c 65 20 2c  | is a textfile ,|
00000630  20 77 69 74 68 69 6e 20  77 68 69 63 68 20 61 72  | within which ar|
00000640  65 20 40 67 6f 74 6f 3a  36 3a 73 70 65 63 69 61  |e @goto:6:specia|
00000650  6c 20 63 6f 6d 6d 61 6e  64 73 40 0a 0a 20 20 20  |l commands@..   |
00000660  2a 20 20 54 68 65 20 66  69 6c 65 20 73 68 6f 75  |*  The file shou|
00000670  6c 64 20 62 65 20 67 69  76 65 6e 20 74 68 65 20  |ld be given the |
00000680  66 69 6c 65 74 79 70 65  20 26 30 66 38 20 61 6e  |filetype &0f8 an|
00000690  64 20 73 61 76 65 64 20  69 6e 20 74 68 65 0a 20  |d saved in the. |
000006a0  20 20 20 20 20 22 48 65  6c 70 5f 4f 6e 22 20 64  |     "Help_On" d|
000006b0  69 72 65 63 74 6f 72 79  20 28 6c 6f 63 61 74 65  |irectory (locate|
000006c0  64 20 69 6e 20 74 68 65  20 21 48 65 6c 70 2b 20  |d in the !Help+ |
000006d0  61 70 70 6c 69 63 61 74  69 6f 6e 20 64 69 72 65  |application dire|
000006e0  63 74 6f 72 79 29 2e 0a  0a 20 20 20 2a 20 20 54  |ctory)...   *  T|
000006f0  68 65 20 6e 61 6d 65 20  79 6f 75 20 67 69 76 65  |he name you give|
00000700  20 79 6f 75 72 20 66 69  6c 65 20 69 73 20 74 68  | your file is th|
00000710  65 20 6e 61 6d 65 20 74  68 61 74 20 77 69 6c 6c  |e name that will|
00000720  20 61 70 70 65 61 72 20  6f 6e 20 74 68 65 0a 20  | appear on the. |
00000730  20 20 20 20 20 21 48 65  6c 70 2b 20 6d 65 6e 75  |     !Help+ menu|
00000740  2e 0a 0a 20 20 20 2a 20  20 54 68 65 20 68 65 6c  |...   *  The hel|
00000750  70 20 66 69 6c 65 20 69  73 20 64 69 76 69 64 65  |p file is divide|
00000760  64 20 69 6e 74 6f 20 27  70 61 67 65 73 27 2c 20  |d into 'pages', |
00000770  75 73 69 6e 67 20 74 68  65 20 63 6f 6d 6d 61 6e  |using the comman|
00000780  64 73 20 74 6f 20 73 74  61 72 74 0a 20 20 20 20  |ds to start.    |
00000790  20 20 61 6e 64 20 65 6e  64 20 61 20 70 61 67 65  |  and end a page|
000007a0  2e 0a 0a 20 20 20 2a 20  20 41 6e 79 20 73 70 72  |...   *  Any spr|
000007b0  69 74 65 73 20 77 68 69  63 68 20 79 6f 75 20 77  |ites which you w|
000007c0  69 6c 6c 20 62 65 20 75  73 69 6e 67 20 6e 65 65  |ill be using nee|
000007d0  64 20 74 6f 20 62 65 20  6d 65 72 67 65 64 20 77  |d to be merged w|
000007e0  69 74 68 20 74 68 65 0a  20 20 20 20 20 20 65 78  |ith the.      ex|
000007f0  69 73 74 69 6e 67 20 22  53 70 72 69 74 65 73 22  |isting "Sprites"|
00000800  20 66 69 6c 65 20 75 73  69 6e 67 20 21 50 61 69  | file using !Pai|
00000810  6e 74 2e 0a 0a 40 65 6e  64 40 0a 40 70 61 67 65  |nt...@end@.@page|
00000820  3a 34 40 41 62 6f 75 74  20 74 68 65 20 41 75 74  |:4@About the Aut|
00000830  68 6f 72 0a 0a 20 20 20  40 63 6f 6c 6f 75 72 3a  |hor..   @colour:|
00000840  31 31 40 41 62 6f 75 74  20 74 68 65 20 41 75 74  |11@About the Aut|
00000850  68 6f 72 0a 0a 20 20 20  21 48 65 6c 70 2b 20 77  |hor..   !Help+ w|
00000860  61 73 20 66 75 6c 6c 79  20 64 65 73 69 67 6e 65  |as fully designe|
00000870  64 20 61 6e 64 20 63 6f  64 65 64 20 65 78 63 6c  |d and coded excl|
00000880  75 73 69 76 65 6c 79 20  66 6f 72 20 57 79 76 65  |usively for Wyve|
00000890  72 6e 20 53 6f 66 74 77  61 72 65 20 62 79 3a 0a  |rn Software by:.|
000008a0  20 20 20 0a 20 20 20 20  20 20 52 6f 62 65 72 74  |   .      Robert|
000008b0  20 54 61 79 6c 6f 72 0a  20 20 20 20 20 20 35 20  | Taylor.      5 |
000008c0  4d 61 79 66 69 65 6c 64  20 47 72 6f 76 65 0a 20  |Mayfield Grove. |
000008d0  20 20 20 20 20 53 6b 65  67 6e 65 73 73 0a 20 20  |     Skegness.  |
000008e0  20 20 20 20 4c 69 6e 63  6f 6c 6e 73 68 69 72 65  |    Lincolnshire|
000008f0  0a 20 20 20 20 20 20 50  45 32 35 20 33 52 59 0a  |.      PE25 3RY.|
00000900  0a 40 65 6e 64 40 0a 40  70 61 67 65 3a 35 40 43  |.@end@.@page:5@C|
00000910  6f 70 79 72 69 67 68 74  20 66 6f 72 20 21 48 65  |opyright for !He|
00000920  6c 70 2b 0a 0a 20 20 20  40 63 6f 6c 6f 75 72 3a  |lp+..   @colour:|
00000930  31 31 40 43 6f 70 79 72  69 67 68 74 20 4e 6f 74  |11@Copyright Not|
00000940  69 63 65 20 66 6f 72 20  21 48 65 6c 70 2b 0a 20  |ice for !Help+. |
00000950  20 20 0a 20 20 20 21 48  65 6c 70 2b 20 69 73 20  |  .   !Help+ is |
00000960  61 20 70 75 62 6c 69 63  20 64 6f 6d 61 69 6e 20  |a public domain |
00000970  61 70 70 6c 69 63 61 74  69 6f 6e 20 62 75 74 20  |application but |
00000980  69 74 20 69 73 20 63 6f  70 79 72 69 67 68 74 2c  |it is copyright,|
00000990  20 73 6f 0a 20 20 20 70  6c 65 61 73 65 20 63 6f  | so.   please co|
000009a0  70 79 20 69 74 20 66 72  65 65 6c 79 20 62 75 74  |py it freely but|
000009b0  20 64 6f 20 66 6f 6c 6c  6f 77 20 74 68 65 20 63  | do follow the c|
000009c0  6f 6e 64 69 74 69 6f 6e  73 20 62 65 6c 6f 77 2e  |onditions below.|
000009d0  0a 20 20 20 0a 20 20 20  2a 49 74 20 6d 61 79 20  |.   .   *It may |
000009e0  62 65 20 63 6f 70 69 65  64 20 66 72 65 65 6c 79  |be copied freely|
000009f0  20 61 73 20 6c 6f 6e 67  20 61 73 20 74 68 69 73  | as long as this|
00000a00  20 69 73 20 6e 6f 74 20  64 6f 6e 65 20 66 6f 72  | is not done for|
00000a10  20 61 0a 20 20 20 20 70  72 6f 66 69 74 20 6f 72  | a.    profit or|
00000a20  20 61 6e 79 20 73 6f 72  74 20 6f 66 20 63 6f 6d  | any sort of com|
00000a30  6d 65 72 63 69 61 6c 20  67 61 69 6e 20 6f 72 20  |mercial gain or |
00000a40  61 64 76 61 6e 74 61 67  65 20 61 6e 64 20 74 68  |advantage and th|
00000a50  65 0a 20 20 20 20 63 6f  6d 70 6c 65 74 65 20 61  |e.    complete a|
00000a60  70 70 6c 69 63 61 74 69  6f 6e 20 69 73 20 63 6f  |pplication is co|
00000a70  70 69 65 64 20 61 73 20  61 20 77 68 6f 6c 65 2e  |pied as a whole.|
00000a80  0a 20 20 20 0a 20 20 20  2a 54 68 65 20 63 6f 70  |.   .   *The cop|
00000a90  79 72 69 67 68 74 20 72  65 6d 61 69 6e 73 20 6d  |yright remains m|
00000aa0  69 6e 65 20 61 74 20 61  6c 6c 20 74 69 6d 65 73  |ine at all times|
00000ab0  2e 20 40 67 6f 74 6f 3a  34 3a 41 62 6f 75 74 20  |. @goto:4:About |
00000ac0  74 68 65 20 41 75 74 68  6f 72 40 0a 20 20 20 0a  |the Author@.   .|
00000ad0  20 20 20 2a 4e 6f 20 70  61 72 74 20 6f 66 20 74  |   *No part of t|
00000ae0  68 69 73 20 61 70 70 6c  69 63 61 74 69 6f 6e 20  |his application |
00000af0  6d 61 79 20 62 65 20 69  6e 63 6c 75 64 65 64 20  |may be included |
00000b00  69 6e 20 61 6e 79 20 6f  74 68 65 72 20 61 70 70  |in any other app|
00000b10  2d 0a 20 20 20 20 6c 69  63 61 74 69 6f 6e 20 77  |-.    lication w|
00000b20  69 74 68 6f 75 74 20 6d  79 20 70 65 72 6d 69 73  |ithout my permis|
00000b30  73 69 6f 6e 2e 0a 20 20  20 0a 20 20 20 2a 41 6e  |sion..   .   *An|
00000b40  79 20 6d 6f 64 69 66 69  63 61 74 69 6f 6e 73 20  |y modifications |
00000b50  73 68 6f 75 6c 64 20 62  65 20 63 6f 6d 6d 65 6e  |should be commen|
00000b60  74 65 64 20 61 6e 64 20  61 20 63 6f 70 79 20 73  |ted and a copy s|
00000b70  65 6e 74 20 74 6f 20 6d  65 20 73 6f 0a 20 20 20  |ent to me so.   |
00000b80  20 74 68 61 74 20 74 68  65 79 20 63 61 6e 20 62  | that they can b|
00000b90  65 20 69 6e 63 6f 72 70  6f 72 61 74 65 64 20 69  |e incorporated i|
00000ba0  6e 20 66 75 74 75 72 65  20 76 65 72 73 69 6f 6e  |n future version|
00000bb0  73 2e 0a 20 20 20 0a 20  20 20 2a 54 68 69 73 20  |s..   .   *This |
00000bc0  61 70 70 6c 69 63 61 74  69 6f 6e 20 69 73 20 73  |application is s|
00000bd0  75 70 70 6c 69 65 64 20  22 61 73 20 69 73 22 2c  |upplied "as is",|
00000be0  20 61 6e 64 20 49 20 63  61 6e 6e 6f 74 20 62 65  | and I cannot be|
00000bf0  20 68 65 6c 64 0a 20 20  20 20 72 65 73 70 6f 6e  | held.    respon|
00000c00  73 69 62 6c 65 20 66 6f  72 20 6c 6f 73 73 20 6f  |sible for loss o|
00000c10  72 20 64 61 6d 61 67 65  73 20 74 68 61 74 20 61  |r damages that a|
00000c20  72 69 73 65 20 66 72 6f  6d 20 74 68 65 20 75 73  |rise from the us|
00000c30  65 2c 20 6d 69 73 2d 75  73 65 0a 20 20 20 20 6f  |e, mis-use.    o|
00000c40  72 20 6c 61 63 6b 20 6f  66 20 75 73 65 20 6f 66  |r lack of use of|
00000c50  20 74 68 69 73 20 70 72  6f 67 72 61 6d 2e 0a 0a  | this program...|
00000c60  20 20 20 2a 54 68 69 73  20 68 65 6c 70 20 66 69  |   *This help fi|
00000c70  6c 65 20 4d 55 53 54 20  62 65 20 75 6e 61 6c 74  |le MUST be unalt|
00000c80  65 72 65 64 20 61 6e 64  20 69 6e 63 6c 75 64 65  |ered and include|
00000c90  64 20 77 69 74 68 20 61  6e 79 20 6f 74 68 65 72  |d with any other|
00000ca0  20 68 65 6c 70 0a 20 20  20 20 66 69 6c 65 73 20  | help.    files |
00000cb0  77 68 69 63 68 20 61 72  65 20 64 69 73 74 72 69  |which are distri|
00000cc0  62 75 74 65 64 2e 0a 0a  40 65 6e 64 40 0a 40 70  |buted...@end@.@p|
00000cd0  61 67 65 3a 36 40 43 6f  6d 6d 61 6e 64 73 0a 0a  |age:6@Commands..|
00000ce0  20 20 20 40 63 6f 6c 6f  75 72 3a 31 31 40 53 70  |   @colour:11@Sp|
00000cf0  65 63 69 61 6c 20 43 6f  6d 6d 61 6e 64 73 0a 0a  |ecial Commands..|
00000d00  20 20 20 20 20 20 20 40  47 6f 74 6f 3a 50 61 67  |       @Goto:Pag|
00000d10  65 3a 20 50 61 67 65 3a  69 64 20 20 20 20 20 20  |e: Page:id      |
00000d20  20 20 20 20 20 20 20 40  0a 20 20 20 20 20 20 20  |       @.       |
00000d30  40 47 6f 74 6f 3a 65 6e  64 3a 20 45 6e 64 20 20  |@Goto:end: End  |
00000d40  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 40  |               @|
00000d50  0a 20 20 20 20 20 20 20  40 47 6f 74 6f 3a 63 6f  |.       @Goto:co|
00000d60  6c 6f 75 72 3a 20 43 6f  6c 6f 75 72 3a 23 23 20  |lour: Colour:## |
00000d70  20 20 20 20 20 20 20 20  20 20 40 0a 20 20 20 20  |          @.    |
00000d80  20 20 20 40 47 6f 74 6f  3a 73 70 72 69 74 65 3a  |   @Goto:sprite:|
00000d90  20 53 70 72 69 74 65 3a  6e 61 6d 65 20 20 20 20  | Sprite:name    |
00000da0  20 20 20 20 20 40 0a 20  20 20 20 20 20 20 40 47  |     @.       @G|
00000db0  6f 74 6f 3a 67 6f 74 6f  3a 20 47 6f 74 6f 3a 69  |oto:goto: Goto:i|
00000dc0  64 3a 62 75 74 74 6f 6e  20 74 65 78 74 20 40 0a  |d:button text @.|
00000dd0  0a 20 20 20 46 6f 72 20  6d 6f 72 65 20 69 6e 66  |.   For more inf|
00000de0  6f 72 6d 61 74 69 6f 6e  20 49 20 73 75 67 67 65  |ormation I sugge|
00000df0  73 74 20 6c 6f 61 64 69  6e 67 20 61 6e 20 65 78  |st loading an ex|
00000e00  69 73 74 69 6e 67 20 48  65 6c 70 2b 20 66 69 6c  |isting Help+ fil|
00000e10  65 20 69 6e 74 6f 20 61  0a 20 20 20 74 65 78 74  |e into a.   text|
00000e20  20 65 64 69 74 6f 72 20  73 75 63 68 20 61 73 20  | editor such as |
00000e30  21 45 64 69 74 2e 0a 0a  40 65 6e 64 40 0a 40 70  |!Edit...@end@.@p|
00000e40  61 67 65 3a 70 61 67 65  40 50 61 67 65 3a 69 64  |age:page@Page:id|
00000e50  0a 0a 20 20 40 63 6f 6c  6f 75 72 3a 31 31 40 20  |..  @colour:11@ |
00000e60  20 20 40 73 70 72 69 74  65 3a 61 74 40 20 50 61  |  @sprite:at@ Pa|
00000e70  67 65 3a 69 64 40 73 70  72 69 74 65 3a 61 74 40  |ge:id@sprite:at@|
00000e80  0a 20 20 0a 20 20 20 20  20 20 20 54 68 69 73 20  |.  .       This |
00000e90  6d 61 72 6b 73 20 74 68  65 20 73 74 61 72 74 20  |marks the start |
00000ea0  6f 66 20 61 20 70 61 67  65 2e 20 41 20 70 61 67  |of a page. A pag|
00000eb0  65 20 6e 61 6d 65 20 6f  72 20 69 64 65 6e 74 69  |e name or identi|
00000ec0  66 69 65 72 20 73 68 6f  75 6c 64 0a 20 20 20 20  |fier should.    |
00000ed0  20 20 20 62 65 20 67 69  76 65 6e 20 69 6e 20 70  |   be given in p|
00000ee0  6c 61 63 65 20 6f 66 20  69 64 2e 0a 20 20 0a 20  |lace of id..  . |
00000ef0  20 20 20 20 20 20 4e 42  3a 20 45 76 65 72 79 20  |      NB: Every |
00000f00  66 69 6c 65 20 6d 75 73  74 20 68 61 76 65 20 61  |file must have a|
00000f10  20 70 61 67 65 20 22 63  6f 6e 74 65 6e 74 73 22  | page "contents"|
00000f20  2c 20 77 68 69 63 68 20  69 73 20 77 68 61 74 20  |, which is what |
00000f30  77 69 6c 6c 20 62 65 0a  20 20 20 20 20 20 20 64  |will be.       d|
00000f40  69 73 70 6c 61 79 65 64  20 77 68 65 6e 20 74 68  |isplayed when th|
00000f50  65 20 69 63 6f 6e 20 62  61 72 20 69 73 20 63 6c  |e icon bar is cl|
00000f60  69 63 6b 65 64 20 6f 6e  2e 0a 0a 40 65 6e 64 40  |icked on...@end@|
00000f70  0a 40 50 61 67 65 3a 65  6e 64 40 45 6e 64 0a 20  |.@Page:end@End. |
00000f80  20 0a 20 20 40 63 6f 6c  6f 75 72 3a 31 31 40 20  | .  @colour:11@ |
00000f90  20 20 40 73 70 72 69 74  65 3a 61 74 40 20 45 6e  |  @sprite:at@ En|
00000fa0  64 40 73 70 72 69 74 65  3a 61 74 40 0a 20 20 0a  |d@sprite:at@.  .|
00000fb0  20 20 20 20 20 20 20 54  68 69 73 20 6d 61 72 6b  |       This mark|
00000fc0  73 20 74 68 65 20 65 6e  64 20 6f 66 20 74 68 65  |s the end of the|
00000fd0  20 70 61 67 65 20 62 65  69 6e 67 20 64 65 66 69  | page being defi|
00000fe0  6e 65 64 2e 0a 0a 40 65  6e 64 40 0a 40 70 61 67  |ned...@end@.@pag|
00000ff0  65 3a 63 6f 6c 6f 75 72  40 43 6f 6c 6f 75 72 3a  |e:colour@Colour:|
00001000  23 23 0a 20 20 0a 20 20  40 63 6f 6c 6f 75 72 3a  |##.  .  @colour:|
00001010  31 31 40 20 20 20 40 73  70 72 69 74 65 3a 61 74  |11@   @sprite:at|
00001020  40 20 63 6f 6c 6f 75 72  3a 23 23 40 73 70 72 69  |@ colour:##@spri|
00001030  74 65 3a 61 74 40 0a 20  20 0a 20 20 20 20 20 20  |te:at@.  .      |
00001040  20 54 68 69 73 20 63 6f  6d 6d 61 6e 64 20 63 68  | This command ch|
00001050  61 6e 67 65 73 20 74 68  65 20 63 6f 6c 6f 75 72  |anges the colour|
00001060  20 6f 66 20 74 68 65 20  74 65 78 74 2c 20 75 6e  | of the text, un|
00001070  74 69 6c 20 74 68 65 20  6e 65 78 74 20 6c 69 6e  |til the next lin|
00001080  65 2c 0a 20 20 20 20 20  20 20 77 68 65 72 65 20  |e,.       where |
00001090  69 74 20 63 68 61 6e 67  65 73 20 62 61 63 6b 20  |it changes back |
000010a0  74 6f 20 62 6c 61 63 6b  2e 0a 20 20 0a 20 20 20  |to black..  .   |
000010b0  20 20 20 20 4e 42 3a 20  54 68 65 20 28 77 69 6d  |    NB: The (wim|
000010c0  70 29 20 63 6f 6c 6f 75  72 20 6e 75 6d 62 65 72  |p) colour number|
000010d0  20 73 68 6f 75 6c 64 20  62 65 20 67 69 76 65 6e  | should be given|
000010e0  20 69 6e 20 70 6c 61 63  65 20 6f 66 20 74 68 65  | in place of the|
000010f0  20 23 23 2e 0a 20 20 20  20 20 20 20 20 20 20 20  | ##..           |
00001100  4e 75 6d 62 65 72 73 20  6c 65 73 73 20 74 68 61  |Numbers less tha|
00001110  6e 20 31 30 20 73 68 6f  75 6c 64 20 62 65 20 67  |n 10 should be g|
00001120  69 76 65 6e 20 61 73 20  30 31 2c 30 32 2e 2e 2e  |iven as 01,02...|
00001130  0a 0a 40 65 6e 64 40 0a  40 70 61 67 65 3a 53 70  |..@end@.@page:Sp|
00001140  72 69 74 65 40 53 70 72  69 74 65 3a 6e 61 6d 65  |rite@Sprite:name|
00001150  0a 20 20 0a 20 20 40 63  6f 6c 6f 75 72 3a 31 31  |.  .  @colour:11|
00001160  40 20 20 20 40 73 70 72  69 74 65 3a 61 74 40 20  |@   @sprite:at@ |
00001170  53 70 72 69 74 65 3a 6e  61 6d 65 40 73 70 72 69  |Sprite:name@spri|
00001180  74 65 3a 61 74 40 0a 20  20 0a 20 20 20 20 20 20  |te:at@.  .      |
00001190  20 54 68 69 73 20 77 69  6c 6c 20 70 6c 61 63 65  | This will place|
000011a0  20 74 68 65 20 73 70 72  69 74 65 20 27 6e 61 6d  | the sprite 'nam|
000011b0  65 27 20 6f 6e 20 74 68  65 20 73 63 72 65 65 6e  |e' on the screen|
000011c0  2c 20 77 69 74 68 20 69  74 27 73 20 62 6f 74 74  |, with it's bott|
000011d0  6f 6d 0a 20 20 20 20 20  20 20 6c 65 66 74 20 63  |om.       left c|
000011e0  6f 72 6e 65 72 20 6c 6f  63 61 74 65 64 20 61 74  |orner located at|
000011f0  20 74 68 65 20 73 74 61  72 74 20 6f 66 20 74 68  | the start of th|
00001200  65 20 63 6f 6d 6d 61 6e  64 2e 0a 0a 40 65 6e 64  |e command...@end|
00001210  40 0a 40 70 61 67 65 3a  67 6f 74 6f 40 47 6f 74  |@.@page:goto@Got|
00001220  6f 3a 69 64 3a 62 75 74  74 6f 6e 20 74 65 78 74  |o:id:button text|
00001230  0a 0a 20 20 40 63 6f 6c  6f 75 72 3a 31 31 40 20  |..  @colour:11@ |
00001240  20 20 40 73 70 72 69 74  65 3a 61 74 40 20 47 6f  |  @sprite:at@ Go|
00001250  74 6f 3a 69 64 3a 62 75  74 74 6f 6e 20 74 65 78  |to:id:button tex|
00001260  74 40 73 70 72 69 74 65  3a 61 74 40 0a 20 20 0a  |t@sprite:at@.  .|
00001270  20 20 20 20 20 20 20 54  68 69 73 20 70 6c 61 63  |       This plac|
00001280  65 73 20 61 20 62 75 74  74 6f 6e 20 6f 6e 20 74  |es a button on t|
00001290  68 65 20 73 63 72 65 65  6e 2c 20 77 69 74 68 20  |he screen, with |
000012a0  74 68 65 20 27 62 75 74  74 6f 6e 20 74 65 78 74  |the 'button text|
000012b0  27 20 64 69 73 2d 0a 20  20 20 20 20 20 20 70 6c  |' dis-.       pl|
000012c0  61 79 65 64 20 69 6e 73  69 64 65 2e 20 43 6c 69  |ayed inside. Cli|
000012d0  63 6b 69 6e 67 20 6f 6e  20 74 68 69 73 20 62 75  |cking on this bu|
000012e0  74 74 6f 6e 20 77 69 6c  6c 20 73 65 6e 64 20 74  |tton will send t|
000012f0  68 65 20 75 73 65 72 20  74 6f 20 74 68 65 0a 20  |he user to the. |
00001300  20 20 20 20 20 20 70 61  67 65 20 69 64 65 6e 74  |      page ident|
00001310  69 66 69 65 64 20 62 79  20 69 64 2e 0a 0a 40 65  |ified by id...@e|
00001320  6e 64 40 0a 40 70 61 67  65 3a 37 40 54 68 65 20  |nd@.@page:7@The |
00001330  21 48 65 6c 70 2b 20 4d  65 6e 75 0a 0a 20 20 20  |!Help+ Menu..   |
00001340  40 63 6f 6c 6f 75 72 3a  31 31 40 54 68 65 20 21  |@colour:11@The !|
00001350  48 65 6c 70 2b 20 4d 65  6e 75 0a 0a 20 20 20 54  |Help+ Menu..   T|
00001360  6f 20 62 72 69 6e 67 20  75 70 20 74 68 65 20 21  |o bring up the !|
00001370  48 65 6c 70 2b 20 6d 65  6e 75 2c 20 63 6c 69 63  |Help+ menu, clic|
00001380  6b 20 75 73 69 6e 67 20  74 68 65 20 4d 45 4e 55  |k using the MENU|
00001390  20 62 75 74 74 6f 6e 20  6f 6e 20 74 68 65 20 69  | button on the i|
000013a0  63 6f 6e 0a 20 20 20 62  61 72 20 6f 76 65 72 20  |con.   bar over |
000013b0  74 68 65 20 21 48 65 6c  70 2b 20 69 63 6f 6e 2e  |the !Help+ icon.|
000013c0  0a 0a 20 20 20 54 68 65  72 65 20 61 72 65 20 66  |..   There are f|
000013d0  69 76 65 20 6f 70 74 69  6f 6e 73 3a 0a 0a 20 20  |ive options:..  |
000013e0  20 20 20 20 20 40 67 6f  74 6f 3a 69 6e 66 6f 3a  |     @goto:info:|
000013f0  20 49 6e 66 6f 20 20 20  20 20 20 20 40 0a 20 20  | Info       @.  |
00001400  20 20 20 20 20 40 67 6f  74 6f 3a 48 65 6c 70 5f  |     @goto:Help_|
00001410  6f 6e 3a 20 48 65 6c 70  20 4f 6e 20 20 20 89 40  |on: Help On   .@|
00001420  0a 20 20 20 20 20 20 20  40 67 6f 74 6f 3a 72 6f  |.       @goto:ro|
00001430  6f 74 3a 20 52 6f 6f 74  20 20 20 20 20 20 20 40  |ot: Root       @|
00001440  0a 20 20 20 20 20 20 20  40 67 6f 74 6f 3a 73 65  |.       @goto:se|
00001450  61 72 63 68 3a 20 53 65  61 72 63 68 20 20 20 20  |arch: Search    |
00001460  20 40 0a 20 20 20 20 20  20 20 40 67 6f 74 6f 3a  | @.       @goto:|
00001470  70 72 69 6e 74 3a 20 50  72 69 6e 74 20 70 61 67  |print: Print pag|
00001480  65 20 40 0a 20 20 20 20  20 20 20 40 67 6f 74 6f  |e @.       @goto|
00001490  3a 71 75 69 74 3a 20 51  75 69 74 20 20 20 20 20  |:quit: Quit     |
000014a0  20 20 40 0a 0a 40 65 6e  64 40 0a 40 70 61 67 65  |  @..@end@.@page|
000014b0  3a 69 6e 66 6f 40 49 6e  66 6f 0a 0a 20 20 20 20  |:info@Info..    |
000014c0  20 20 40 63 6f 6c 6f 75  72 3a 30 38 40 49 6e 66  |  @colour:08@Inf|
000014d0  6f 0a 0a 20 20 20 20 20  20 54 68 69 73 20 6f 70  |o..      This op|
000014e0  74 69 6f 6e 20 6c 65 61  64 73 20 6f 6e 74 6f 20  |tion leads onto |
000014f0  61 20 73 75 62 2d 6d 65  6e 75 20 77 69 74 68 20  |a sub-menu with |
00001500  49 6e 66 6f 72 6d 61 74  69 6f 6e 20 6f 6e 20 21  |Information on !|
00001510  48 65 6c 70 2b 20 73 75  63 68 0a 20 20 20 20 20  |Help+ such.     |
00001520  20 61 73 20 74 68 65 20  76 65 72 73 69 6f 6e 20  | as the version |
00001530  6e 75 6d 62 65 72 2e 0a  0a 40 65 6e 64 40 0a 40  |number...@end@.@|
00001540  70 61 67 65 3a 48 65 6c  70 5f 6f 6e 40 48 65 6c  |page:Help_on@Hel|
00001550  70 20 4f 6e 0a 0a 20 20  20 20 20 20 40 63 6f 6c  |p On..      @col|
00001560  6f 75 72 3a 30 38 40 48  65 6c 70 20 4f 6e 0a 0a  |our:08@Help On..|
00001570  20 20 20 20 20 20 54 68  69 73 20 6f 70 74 69 6f  |      This optio|
00001580  6e 20 6c 65 61 64 73 20  6f 6e 74 6f 20 61 20 73  |n leads onto a s|
00001590  75 62 2d 6d 65 6e 75 20  77 68 69 63 68 20 6c 69  |ub-menu which li|
000015a0  73 74 73 20 61 6c 6c 20  74 68 65 20 61 70 70 6c  |sts all the appl|
000015b0  69 63 61 74 69 6f 6e 73  0a 20 20 20 20 20 20 66  |ications.      f|
000015c0  6f 72 20 77 68 69 63 68  20 68 65 6c 70 20 69 73  |or which help is|
000015d0  20 61 76 61 69 6c 61 62  6c 65 2e 20 53 65 6c 65  | available. Sele|
000015e0  63 74 69 6e 67 20 6f 6e  65 20 6f 66 20 74 68 65  |cting one of the|
000015f0  73 65 20 61 70 70 6c 69  63 61 74 69 6f 6e 73 0a  |se applications.|
00001600  20 20 20 20 20 20 77 69  6c 6c 20 62 72 69 6e 67  |      will bring|
00001610  20 75 70 20 74 68 65 20  72 65 6c 65 76 61 6e 74  | up the relevant|
00001620  20 68 65 6c 70 20 73 79  73 74 65 6d 2e 0a 0a 40  | help system...@|
00001630  65 6e 64 40 0a 40 70 61  67 65 3a 72 6f 6f 74 40  |end@.@page:root@|
00001640  52 6f 6f 74 0a 0a 20 20  20 20 20 20 40 63 6f 6c  |Root..      @col|
00001650  6f 75 72 3a 30 38 40 4f  70 65 6e 20 52 6f 6f 74  |our:08@Open Root|
00001660  0a 0a 20 20 20 20 20 20  46 72 6f 6d 20 74 69 6d  |..      From tim|
00001670  65 20 74 6f 20 74 69 6d  65 20 79 6f 75 20 6d 61  |e to time you ma|
00001680  79 20 77 61 6e 74 20 74  6f 20 67 6f 20 62 61 63  |y want to go bac|
00001690  6b 20 74 6f 20 74 68 65  20 73 74 61 72 74 20 70  |k to the start p|
000016a0  61 67 65 20 6f 66 20 74  68 65 0a 20 20 20 20 20  |age of the.     |
000016b0  20 63 75 72 72 65 6e 74  20 68 65 6c 70 20 73 79  | current help sy|
000016c0  73 74 65 6d 2e 20 53 65  6c 65 63 74 69 6e 67 20  |stem. Selecting |
000016d0  74 68 69 73 20 6f 70 74  69 6f 6e 20 77 69 6c 6c  |this option will|
000016e0  20 6f 70 65 6e 20 74 68  65 20 22 72 6f 6f 74 22  | open the "root"|
000016f0  20 70 61 67 65 2e 0a 0a  40 65 6e 64 40 0a 40 70  | page...@end@.@p|
00001700  61 67 65 3a 73 65 61 72  63 68 40 53 65 61 72 63  |age:search@Searc|
00001710  68 0a 0a 20 20 20 20 20  20 40 63 6f 6c 6f 75 72  |h..      @colour|
00001720  3a 30 38 40 53 65 61 72  63 68 0a 0a 20 20 20 20  |:08@Search..    |
00001730  20 20 53 65 6c 65 63 74  69 6e 67 20 74 68 69 73  |  Selecting this|
00001740  20 6f 70 74 69 6f 6e 20  77 69 6c 6c 20 6f 70 65  | option will ope|
00001750  6e 20 61 20 77 69 6e 64  6f 77 20 77 68 65 72 65  |n a window where|
00001760  20 79 6f 75 20 63 61 6e  20 65 6e 74 65 72 20 77  | you can enter w|
00001770  68 61 74 0a 20 20 20 20  20 20 79 6f 75 20 77 69  |hat.      you wi|
00001780  73 68 20 74 6f 20 73 65  61 72 63 68 20 66 6f 72  |sh to search for|
00001790  2e 20 50 72 65 73 73 69  6e 67 20 72 65 74 75 72  |. Pressing retur|
000017a0  6e 20 77 69 6c 6c 20 73  74 61 72 74 20 74 68 65  |n will start the|
000017b0  20 73 65 61 72 63 68 2c  20 61 6e 64 0a 20 20 20  | search, and.   |
000017c0  20 20 20 63 6c 69 63 6b  69 6e 67 20 6f 6e 20 27  |   clicking on '|
000017d0  4e 65 78 74 22 20 77 69  6c 6c 20 66 69 6e 64 20  |Next" will find |
000017e0  74 68 65 20 6e 65 78 74  20 6d 61 74 63 68 2e 0a  |the next match..|
000017f0  0a 20 20 20 20 20 20 4e  6f 74 65 3a 20 43 6c 69  |.      Note: Cli|
00001800  63 6b 69 6e 67 20 6f 6e  20 74 68 65 20 69 63 6f  |cking on the ico|
00001810  6e 20 62 61 72 20 77 69  74 68 20 41 44 4a 55 53  |n bar with ADJUS|
00001820  54 20 77 69 6c 6c 20 61  6c 73 6f 20 6f 70 65 6e  |T will also open|
00001830  20 74 68 65 20 73 65 61  72 63 68 0a 20 20 20 20  | the search.    |
00001840  20 20 20 20 20 20 20 20  77 69 6e 64 6f 77 2e 0a  |        window..|
00001850  0a 40 65 6e 64 40 0a 40  70 61 67 65 3a 71 75 69  |.@end@.@page:qui|
00001860  74 40 51 75 69 74 0a 0a  20 20 20 20 20 20 40 63  |t@Quit..      @c|
00001870  6f 6c 6f 75 72 3a 30 38  40 51 75 69 74 0a 0a 20  |olour:08@Quit.. |
00001880  20 20 20 20 20 54 68 69  73 20 77 69 6c 6c 20 71  |     This will q|
00001890  75 69 74 20 74 68 65 20  21 48 65 6c 70 2b 20 61  |uit the !Help+ a|
000018a0  70 70 6c 69 63 61 74 69  6f 6e 2e 0a 0a 40 65 6e  |pplication...@en|
000018b0  64 40 0a 40 70 61 67 65  3a 70 72 69 6e 74 40 50  |d@.@page:print@P|
000018c0  72 69 6e 74 69 6e 67 0a  0a 20 20 20 40 63 6f 6c  |rinting..   @col|
000018d0  6f 75 72 3a 31 31 40 50  72 69 6e 74 69 6e 67 0a  |our:11@Printing.|
000018e0  0a 20 20 20 53 6f 6d 65  74 69 6d 65 73 20 69 74  |.   Sometimes it|
000018f0  20 69 73 20 64 65 73 69  72 65 61 62 6c 65 20 74  | is desireable t|
00001900  6f 20 68 61 76 65 20 61  20 68 61 72 64 20 63 6f  |o have a hard co|
00001910  70 79 20 6f 66 20 73 6f  6d 65 20 69 6e 66 6f 72  |py of some infor|
00001920  6d 61 74 69 6f 6e 0a 20  20 20 77 68 69 63 68 20  |mation.   which |
00001930  63 61 6e 20 62 65 20 66  6f 75 6e 64 20 77 69 74  |can be found wit|
00001940  68 69 6e 20 61 20 74 65  78 74 20 66 69 6c 65 2e  |hin a text file.|
00001950  0a 0a 20 20 20 53 65 6c  65 63 74 69 6e 67 20 74  |..   Selecting t|
00001960  68 65 20 50 72 69 6e 74  20 6f 70 74 69 6f 6e 20  |he Print option |
00001970  66 72 6f 6d 20 74 68 65  20 6d 65 6e 75 20 77 69  |from the menu wi|
00001980  6c 6c 20 6f 75 74 70 75  74 20 61 20 63 6f 70 79  |ll output a copy|
00001990  20 6f 66 20 74 68 65 0a  20 20 20 63 75 72 72 65  | of the.   curre|
000019a0  6e 74 20 70 61 67 65 20  74 6f 20 79 6f 75 72 20  |nt page to your |
000019b0  70 72 69 6e 74 65 72 2e  0a 0a 20 20 20 4e 42 3a  |printer...   NB:|
000019c0  20 53 70 72 69 74 65 73  20 74 68 61 74 20 61 70  | Sprites that ap|
000019d0  70 65 61 72 20 69 6e 20  74 68 65 20 48 65 6c 70  |pear in the Help|
000019e0  2b 20 66 69 6c 65 73 20  77 69 6c 6c 20 6e 6f 74  |+ files will not|
000019f0  20 62 65 20 70 72 69 6e  74 65 64 2e 0a 20 20 20  | be printed..   |
00001a00  20 20 20 20 54 68 69 73  20 69 73 20 74 6f 20 6d  |    This is to m|
00001a10  61 78 69 6d 69 73 65 20  74 68 65 20 73 70 65 65  |aximise the spee|
00001a20  64 20 6f 66 20 70 72 69  6e 74 69 6e 67 2e 0a 0a  |d of printing...|
00001a30  40 65 6e 64 40 0a 40 70  61 67 65 3a 70 72 6f 67  |@end@.@page:prog|
00001a40  40 50 72 6f 67 72 61 6d  6d 65 72 73 0a 0a 20 20  |@Programmers..  |
00001a50  20 40 63 6f 6c 6f 75 72  3a 31 31 40 50 72 6f 67  | @colour:11@Prog|
00001a60  72 61 6d 6d 65 72 73 0a  0a 20 20 20 49 74 20 69  |rammers..   It i|
00001a70  73 20 65 61 73 79 20 74  6f 20 63 72 65 61 74 65  |s easy to create|
00001a80  20 21 48 65 6c 70 2b 20  66 69 6c 65 73 20 66 6f  | !Help+ files fo|
00001a90  72 20 79 6f 75 72 20 6f  77 6e 20 61 70 70 6c 69  |r your own appli|
00001aa0  63 61 74 69 6f 6e 73 2c  20 77 68 69 63 68 20 63  |cations, which c|
00001ab0  61 6e 0a 20 20 20 74 68  65 6e 20 62 65 20 75 73  |an.   then be us|
00001ac0  65 64 20 69 6e 74 65 72  61 63 74 69 76 65 6c 79  |ed interactively|
00001ad0  20 62 79 20 73 65 6e 64  69 6e 67 20 63 6f 6d 6d  | by sending comm|
00001ae0  61 6e 64 73 20 66 72 6f  6d 20 79 6f 75 72 20 6f  |ands from your o|
00001af0  77 6e 20 70 72 6f 67 72  61 6d 0a 20 20 20 77 68  |wn program.   wh|
00001b00  69 63 68 20 74 6f 20 74  68 65 20 48 65 6c 70 2b  |ich to the Help+|
00001b10  20 61 70 70 6c 69 63 61  74 69 6f 6e 0a 0a 20 20  | application..  |
00001b20  20 20 20 20 40 67 6f 74  6f 3a 33 3a 20 43 72 65  |    @goto:3: Cre|
00001b30  61 74 69 6e 67 20 79 6f  75 72 20 6f 77 6e 20 21  |ating your own !|
00001b40  48 65 6c 70 2b 20 66 69  6c 65 73 20 40 0a 0a 20  |Help+ files @.. |
00001b50  20 20 20 20 20 40 67 6f  74 6f 3a 69 68 3a 20 49  |     @goto:ih: I|
00001b60  6d 70 6c 65 6d 65 6e 74  69 6e 67 20 69 6e 74 65  |mplementing inte|
00001b70  72 61 63 74 69 76 65 20  68 65 6c 70 20 20 40 0a  |ractive help  @.|
00001b80  0a 40 65 6e 64 40 0a 40  70 61 67 65 3a 69 68 40  |.@end@.@page:ih@|
00001b90  49 6e 74 65 72 61 63 74  69 76 65 20 68 65 6c 70  |Interactive help|
00001ba0  0a 0a 20 20 20 40 63 6f  6c 6f 75 72 3a 31 31 40  |..   @colour:11@|
00001bb0  49 6e 74 65 72 61 63 74  69 76 65 20 68 65 6c 70  |Interactive help|
00001bc0  0a 0a 20 20 20 49 74 20  69 73 20 70 6f 73 73 69  |..   It is possi|
00001bd0  62 6c 65 20 74 6f 20 73  65 6e 64 20 21 48 65 6c  |ble to send !Hel|
00001be0  70 2b 20 61 20 77 69 6d  70 20 6d 65 73 73 61 67  |p+ a wimp messag|
00001bf0  65 20 77 68 69 63 68 20  77 69 6c 6c 20 63 61 75  |e which will cau|
00001c00  73 65 20 69 74 20 74 6f  0a 20 20 20 64 69 73 70  |se it to.   disp|
00001c10  6c 61 79 20 61 20 73 70  65 63 69 66 69 63 20 70  |lay a specific p|
00001c20  61 67 65 2e 20 54 68 69  73 20 63 61 6e 20 62 65  |age. This can be|
00001c30  20 75 73 65 64 20 74 6f  20 73 75 70 70 6f 72 74  | used to support|
00001c40  20 69 6e 74 65 72 61 63  74 69 76 65 20 68 65 6c  | interactive hel|
00001c50  70 0a 20 20 20 77 68 69  63 68 20 64 69 73 70 6c  |p.   which displ|
00001c60  61 79 73 20 6d 75 63 68  20 6d 6f 72 65 20 64 65  |ays much more de|
00001c70  74 61 69 6c 65 64 20 69  6e 66 6f 72 6d 61 74 69  |tailed informati|
00001c80  6f 6e 20 74 68 61 6e 20  69 73 20 70 6f 73 73 69  |on than is possi|
00001c90  62 6c 65 20 77 69 74 68  0a 20 20 20 41 63 6f 72  |ble with.   Acor|
00001ca0  6e 27 73 20 69 6e 74 65  72 61 63 74 69 76 65 20  |n's interactive |
00001cb0  68 65 6c 70 20 61 70 70  6c 69 63 61 74 69 6f 6e  |help application|
00001cc0  2e 0a 0a 20 20 20 54 6f  20 64 6f 20 74 68 69 73  |...   To do this|
00001cd0  20 61 20 77 69 6d 70 20  6d 65 73 73 61 67 65 20  | a wimp message |
00001ce0  6d 75 73 74 20 62 65 20  73 65 6e 74 20 61 73 20  |must be sent as |
00001cf0  66 6f 6c 6c 6f 77 73 3a  0a 0a 40 63 6f 6c 6f 75  |follows:..@colou|
00001d00  72 3a 30 38 40 20 20 20  20 20 20 20 44 45 46 20  |r:08@       DEF |
00001d10  50 52 4f 43 73 65 6e 64  5f 68 65 6c 70 28 63 6f  |PROCsend_help(co|
00001d20  6d 6d 61 6e 64 24 29 0a  40 63 6f 6c 6f 75 72 3a  |mmand$).@colour:|
00001d30  30 38 40 20 20 20 20 20  20 20 20 20 62 25 21 30  |08@         b%!0|
00001d40  3d 32 35 36 20 20 20 20  20 3a 62 25 21 34 3d 30  |=256     :b%!4=0|
00001d50  0a 40 63 6f 6c 6f 75 72  3a 30 38 40 20 20 20 20  |.@colour:08@    |
00001d60  20 20 20 20 20 62 25 21  38 3d 30 20 20 20 20 20  |     b%!8=0     |
00001d70  20 20 3a 62 25 21 31 32  3d 30 0a 40 63 6f 6c 6f  |  :b%!12=0.@colo|
00001d80  75 72 3a 30 38 40 20 20  20 20 20 20 20 20 20 62  |ur:08@         b|
00001d90  25 21 31 36 3d 26 39 39  30 30 20 20 3a 24 28 62  |%!16=&9900  :$(b|
00001da0  25 2b 32 30 29 3d 63 6f  6d 6d 61 6e 64 24 0a 40  |%+20)=command$.@|
00001db0  63 6f 6c 6f 75 72 3a 30  38 40 20 20 20 20 20 20  |colour:08@      |
00001dc0  20 20 20 53 59 53 22 57  69 6d 70 5f 53 65 6e 64  |   SYS"Wimp_Send|
00001dd0  4d 65 73 73 61 67 65 22  2c 31 37 2c 62 25 2c 30  |Message",17,b%,0|
00001de0  0a 40 63 6f 6c 6f 75 72  3a 30 38 40 20 20 20 20  |.@colour:08@    |
00001df0  20 20 20 45 4e 44 50 52  4f 43 0a 0a 20 20 20 57  |   ENDPROC..   W|
00001e00  68 65 72 65 20 74 68 65  20 70 61 72 61 6d 65 74  |here the paramet|
00001e10  65 72 20 70 61 73 73 65  64 20 74 6f 20 50 52 4f  |er passed to PRO|
00001e20  43 73 65 6e 64 5f 68 65  6c 70 20 69 73 20 6f 66  |Csend_help is of|
00001e30  20 74 68 65 20 66 6f 72  6d 3a 0a 0a 40 63 6f 6c  | the form:..@col|
00001e40  6f 75 72 3a 30 38 40 20  20 20 20 20 20 20 48 65  |our:08@       He|
00001e50  6c 70 5f 73 79 73 74 65  6d 40 73 70 72 69 74 65  |lp_system@sprite|
00001e60  3a 62 5f 61 74 40 20 50  61 67 65 5f 6e 61 6d 65  |:b_at@ Page_name|
00001e70  0a 0a 20 20 20 65 67 3a  20 20 21 48 65 6c 70 2e  |..   eg:  !Help.|
00001e80  43 6f 6e 74 65 6e 74 73  20 20 20 20 20 6f 72 0a  |Contents     or.|
00001e90  20 20 20 20 20 20 20 20  21 48 65 6c 70 2e 51 75  |        !Help.Qu|
00001ea0  69 74 20 20 20 20 20 20  20 20 20 6f 72 0a 20 20  |it         or.  |
00001eb0  20 20 20 20 20 20 21 52  61 79 33 64 2e 54 6f 6f  |      !Ray3d.Too|
00001ec0  6c 73 20 20 20 20 20 20  20 65 74 63 2e 0a 0a 40  |ls       etc...@|
00001ed0  65 6e 64 40 0a                                    |end@.|
00001ed5