home *** CD-ROM | disk | FTP | other *** search
/ ARM Club 3 / TheARMClub_PDCD3.iso / hensa / misc / b014_1 / !Multi / !Help next >
Text File  |  1993-05-21  |  4KB  |  123 lines
  1. Help file for !Multi Version 1.02
  2. ----------------------------------
  3. by Richard Stagg
  4.  
  5. I wrote !Multi after getting fed up with executing *-commands from the
  6. CLI unnecessarily. It is a fully definable menu-driven system, with extra
  7. options available. This user-definability means that you can tailor it for
  8. use with your own computer, and with your most commonly used *-commands.
  9.  
  10. To use it, simply load it up with a double-click. I have it starting
  11. automatically (courtesy of !Menon). When you want to execute a command,
  12. just click 'menu' on the !Multi icon, and your defined menu will be
  13. available. Just click on the choice that you want.
  14.  
  15. There are two extra items on the menu: 'Info' at the top, which is much
  16. the same as the Info option on all other applications. There is also a
  17. 'Quit' option (in case you want !Multi to go away.)
  18.  
  19. Also, clicking 'Adjust' on the iconbar 'Multi' icon, reloads the command
  20. file. This means that if you are designing your menu, you do not need to
  21. repeatedly close down and reload Multi in order to test it.
  22.  
  23. Defining your menu
  24. -------------------
  25.  
  26. The menu is loaded from a file called 'Commands' inside the !Multi
  27. directory. It is a simple text file, and can be changed in Edit to
  28. modify the menu. The 'Commands' file contains a simple script language
  29. which defines your menu. The file structure is quite simple:
  30.  
  31.         Lines beginning with a semicolon (;) are treated as comments
  32.         and ignored.
  33.  
  34.         Menu lines will appear on the menu in the same order as they
  35.         do in the file. A menu line consists of four comma-separated
  36.         parameters which are:
  37.                 1) The words to appear on the menu
  38.                 2) The option letter (see later)
  39.                 3) The first *-command
  40.                 4) The second *-command (optional)
  41.  
  42.         The file must end with an '<End>'.
  43.  
  44. Option letters
  45. ---------------
  46.  
  47. These tell !Multi what you want your item to do. Currently supported codes
  48. are:
  49.                 X - execute Command 1 when item is clicked
  50.                 O - Item leads to a submenu with 'On' and 'Off' on it.
  51.                     Item 1 is executed when 'On' is clicked and item
  52.                     2 for 'Off'. This can be used, for example, to
  53.                     control the speaker:
  54.                        'Speaker,O,Speaker On,Speaker Off'
  55.                 C - Item leads to a 'Confirm' submenu. Command 1 is
  56.                     executed when 'Confirm' is clicked. For example:
  57.                        'Format,C,Format 0 E Y'
  58.  
  59.  
  60. An example command file:
  61. ------------------------
  62.  
  63. ; Multi Commands Utility
  64. ;------------------------
  65. ;
  66. ; By Richard Stagg
  67. ;
  68. ;
  69. ; !Multi file for my Arc, V.0.01, 10/4/93
  70.  
  71. Cache,O,Cache on,Cache off
  72. Fonts List,X,FontCat
  73. Speaker,O,Speaker on,Speaker off
  74. Reset,C,CtrlBrk
  75. <End>
  76.  
  77. This gives four menu options. The first item allows me to turn my Arm3 cache on
  78. and off. The second just lists the installed fonts. The third is a speaker
  79. control (as mentioned earlier). The fourth, when confirmed, runs a file called
  80. 'CtrlBrk' in my library directory, which resets the computer.
  81.  
  82.  
  83. The little extras
  84. ------------------
  85.  
  86. By clicking on the author's name icon in the Info window, you can get
  87. an author's profile. Look out for the greetings window (also off 'Info').
  88.  
  89.  
  90. If you find any bugs, have any suggestions for improvement, or wish to
  91. get in touch with me for any other reason, then I can be reached by the
  92. following methods:
  93.  
  94. Janet:     stagg_c06@uk.ac.tvu.s
  95.  
  96. BBS email: Arcade #257
  97.            TWOC #639
  98.            The Power House: 'Ricky'
  99.  
  100. Phone:     (0734) 462328
  101.  
  102. Snailmail: 16 Rectory Road
  103.            Caversham
  104.            Reading
  105.            Berkshire
  106.            RG4 7SH
  107.  
  108.  
  109. --------------------------------------
  110. MULTI - Application History
  111. --------------------------------------
  112.  
  113. 0.01 (11/4/93):  Multi first designed and written. Supported script file only,
  114.                  with switches X, O and C.
  115. 1.01 (24/4/93):  Added The PowerHouse's phone number to the comments!
  116.                  Support for indirected menu items (over 11 chars added).
  117.                  'Width' line added to script files.
  118.                  Zero polling removed to increase efficiency.
  119. 1.02 (21/5/93):  Adjust on iconbar icon reloads the command file. Useful to
  120.                  modify the menu without reloading Multi.
  121.                  'Width' line removed in favour of calculated width. Menu
  122.                  width is now dependent on the longest item.
  123.