home *** CD-ROM | disk | FTP | other *** search
/ AMOS PD CD / amospdcd.iso / 251-275 / apd254 / menumaster.doc < prev    next >
Text File  |  1987-03-30  |  5KB  |  150 lines
  1.         MenuMaster V1.0 (C) Dave Matthewson Sept. 1990
  2.         ==============================================
  3. DISCLAIMER
  4. ==========
  5. Every care has been taken to produce a useful and reliable program which
  6. has been tested as far as possible with no bugs that I know of.
  7. However I cannot guarantee the suitability of this program or be held
  8. legally responsible for any loss or damage incurred by its use.
  9.  
  10. THE PROGRAM
  11. ===========
  12. MenuMaster is intended to be a friendly front end to a collection of programs
  13. assembled on a single disk. It allows the user to select and start a program
  14. (or programs if multitasking) without needing to access the CLI at all.
  15. Any program or command that can be started from the CLI can be included in
  16. the menu, which has a total of 32 selection options.
  17. There are several freeware/public domain programs similar to MenuMaster,
  18. but this one is, as far as I know unique, in that it has its own built-in
  19. editor.
  20.  I was prompted to write this program because after making program additions
  21. or similar alterations to my own utility disks, I then had to use a separate
  22. menumaker program or text editor to generate the new menu. Now, with the
  23. built-in editor provided by MenuMaster, changes are quick and simple.
  24.  
  25. INSTALLATION
  26. ============
  27. To use MenuMaster on your own disks you must copy the file 'MenuMaster' and 
  28. 'MenuMaster.Doc' into the root directory of your boot disk and edit the file
  29. s/startup-sequence so that the first command is 'MenuMaster'.
  30. Also check that the 'Run' command is in the 'c' directory. If not, then copy
  31. it there from your Workbench disk.
  32.  
  33. When you first boot from the disk, MenuMaster will look for a file in the
  34. root directory called 'MenuMaster.data'. If it's not there an alert will
  35. appear informing you that it can't read the data file. After clearing this
  36. alert you will be presented with a menu screen which, except for gadgets, is
  37. completely blank. Using the edit facility will then automatically create this
  38. data file for you.
  39. Note.
  40. The file 'MenuMaster.data' can also be copied to your disk, in which case
  41. the 'Can't read' alert will not appear. However, the data it contains applies
  42. to the disk it came from and will have to be edited to suit.
  43. Use whichever method you find best.
  44.  
  45.  
  46. USE OF MENU GADGETS
  47. ===================
  48.  
  49. BACK/FRONT
  50. ==========
  51. Normal depth arranging gadgets are in the top right corner.
  52.  
  53. MODE
  54. ====
  55. The gadget in the top left corner determines which of the three methods of
  56. execution will be employed on your selected program.
  57. The default is always 'Execute'.
  58.  
  59. 1)Execute
  60. ---------
  61. In this mode the menu window will close and your selected program will be
  62. started. On exiting your program the menu window will re-open ready for the
  63. next selection to be made.
  64.  
  65. 2)Run (MultiTasking)
  66. -------------------
  67. In this mode the menu window will close and your selected program will be
  68. started. The menu window will then immediately re-open allowing further
  69. selections to be made.
  70.  
  71. 3)Launch
  72. --------
  73. In this mode the menu window will close and your selected program will be
  74. started. MenuMaster will then close down completely, leaving only your
  75. selected program running.Any other commands in the startup-sequence will
  76. be executed now also.
  77.  
  78. SELECTION
  79. =========
  80. These are the 32 program selection gadgets. Dependent on the type of program
  81. or command being started, an optional input requester for command arguments
  82. or parameter passing can be made to appear. (Max. 127 characters)  
  83.  
  84. MENU-BAR
  85. ========
  86. Holding down the right mouse button brings up the Options menu which gives
  87. three choices.
  88.  
  89. 1)Shrink. This causes Menumaster to close down to a small title bar at the
  90. top right of the screen. This bar contains Drag,Depth and Close gadgets.
  91. Clicking the right mouse button when this bar is active causes MenuMaster
  92. to re-open its main window again.
  93.  
  94. 2)Edit.  Enter edit mode.
  95.  
  96. 3)Quit.  Exits MenuMaster. Any further commands in the startup-sequence will
  97. now be executed.
  98.  
  99.  
  100. USE OF EDIT MODE GADGETS
  101. ========================
  102.  
  103. UP/DOWN GADGETS
  104. ==============
  105. Scrolls through the 32 selection options plus the menu title.
  106.  
  107. TITLE/ITEM TEXT  GADGET
  108. =======================
  109. Enter title or menu item text here.(Max. 35 characters)
  110.  
  111. COMMAND TEXT GADGET
  112. ===================
  113. Enter command or program name just as you would at the CLI. It is best to
  114. specify the path if possible. Arguments or parameters to be passed to the
  115. command can also be included here if they are always going to be constant.
  116. (Max. 127 characters).If not see below for active input option.
  117.  
  118. COMMAND ARGUMENTS GADGET
  119. ========================
  120. This gadget selects whether or not a requester for input will appear after
  121. selecting an item from the menu.
  122.  
  123. PROMPT TEXT GADGET
  124. ==================
  125. This will always be 'ghosted' unless the user toggles the command arguments
  126. gadget to 'Y'es. A prompt can now be entered which will appear with the
  127. input requester mentioned above.(Max. 71 characters)
  128.  
  129. SAVE GADGET
  130. ===========
  131. Saves your menu data to the root directory as 'MenuMaster.data' then displays
  132. the new items, centre justified, on the menu screen.
  133.  
  134. CANCEL GADGET
  135. =============
  136. All current edits are discarded and last saved items are re-displayed.
  137.  
  138.  
  139. That's about it then, I hope this program is useful to you, send any bug 
  140. reports, suggestions, FreeWare, money etc. to,
  141.  
  142.                 Dave Matthewson.
  143.                 5, Sea View Villas,
  144.                 Mayfield Grange,
  145.                 Cramlington,
  146.                 Northumberland,
  147.                 ENGLAND
  148.                 NE239AD
  149.  
  150.