home *** CD-ROM | disk | FTP | other *** search
/ Falcon 030 Power 2 / F030_POWER2.iso / ST_STE / MAGS / ICTARI03.ARJ / ictari.03 / GFA / MENUMAKE / MENUMAKE.DOC next >
Text File  |  1992-03-07  |  9KB  |  231 lines
  1.  
  2.  
  3.                         ---- MenuMaker v1.0 ----
  4.                              (test release)
  5.  
  6.  
  7. This is the first public release of  a  small utility that I wrote for my
  8. own use to aid the making of  GEM  menus  within GFA Basic a lot quicker,
  9. and for the beginner, a lot easier.  I  have  tried to make it as easy to
  10. use as possible but as  it  was  originally  written for myself you might
  11. find some of the menu options  and  prompts a little confusing. Hopefully
  12. this document should help.
  13.  
  14.                           -- Copyright Stuff --
  15.  
  16. Version 1.0 is totally Public Domain. All I ask is that the program file,
  17. MENUMAKE.PRG, and  this  MENUMAKE.DOC  file  stay  together.  All  future
  18. releases of  MenuMaker  will  be  released  as  Licenceware  and  will be
  19. available  through  any  PD  library   that   is   a  member  of  the  PD
  20. Confederation. ONLY version 1.0 is available from anywhere.
  21.  
  22.  
  23.                  --- How It Works (or Does It Work?) ---
  24.  
  25. When you first try to  save  any  work  you  have  done, the program will
  26. create a folder on the root directory of the drive from which the program
  27. was started, this also  includes  hard  drives,  called MENUMAKE. In this
  28. folder all the files created will be  stored. The idea of this feature is
  29. to keep all the menu files and final source code in one directory instead
  30. of all over the place, this is if  your anything like me anyway. When you
  31. create a menu it can be saved  as  raw  data  so it can be re-loaded at a
  32. later date and added to or changed. When  it is saved as code a GFA Basic
  33. file in ASCII format, should have a .LST extension, is created. This code
  34. can be merged into GFA Basic and run immediately. The only thing you have
  35. to add is the  routines  for  your  program.  There  are certain do's and
  36. dont's but I will explain  these  in  their specific sections later. When
  37. you are creating the menu any entries  can have the routine that they are
  38. to call entered, this is  optional  and  the  final source code will have
  39. Procedure and return commands  for  them  ready  made,  also the function
  40. within GFA Basic that  calls  a  Procedure  when  it  is selected will be
  41. included, again, this is only if  the  procedure to be called was entered
  42. into MenuMaker. If no procedure  was  entered  the  only code created for
  43. that entry is for the actual code  needed to create the display menu, not
  44. the call routines. Examine the source code to see how it works if you are
  45. a beginner. Throughout the creation of your  menu you can always see what
  46. the finished product will look like as  there is a test menu function, so
  47. there is no need to keep saving  the  source  code and having to merge it
  48. into GFA Basic. The code produced has  been  tested on GFA Basic v2.0 and
  49. v3.6 and it worked without  any  problems,  SO  FAR. Whenever any code is
  50. created it will always allow the  maximum  of 6 desktop accessories to be
  51. selected from the first menu list. You  do  not have to enter any details
  52. about these as the program will do it automatically.
  53.  
  54.  
  55. The following sections will try to explain what each menu option does and
  56. how to use it. Each section title will show the menu heading and the menu
  57. entry to be found under it.
  58.  
  59. Info
  60. ----
  61. GFA MenuMaker
  62.  
  63. This is just a small  information  screen. Any desktop accessories loaded
  64. will be displayed below this line.
  65.  
  66.  
  67. File
  68. ----
  69. Load Menu Info
  70.  
  71. Loads a raw menu data file.
  72.  
  73.  
  74. File
  75. ----
  76. Save Menu Info
  77.  
  78. Saves a raw menu data file.
  79.  
  80.  
  81. File
  82. ----
  83. Quit MenuMaker
  84.  
  85. Need I say more? The option to save any work is given before quitting.
  86.  
  87. Options
  88. -------
  89. Clear Present Menu
  90.  
  91. *** USE WITH CAUTION ***  Any menu data held in memory will be deleted so
  92. make sure any work you have done has been saved. This is used to clear an
  93. old menu so a new one can be started.
  94.  
  95. Options
  96. -------
  97. Add New Menu Heading
  98.  
  99. You will be prompted for a menu  heading name. This is the text displayed
  100. above the line all the time. As  you enter them MenuMaker will create the
  101. menu bar in the same order from  the  left.  There can be a maximum of 10
  102. menu headings but you must  be  careful  not  to  go  off  the end of the
  103. screen.
  104.  
  105. Options
  106. -------
  107. Delete A Menu List
  108.  
  109. You can delete a complete dropdown menu by choosing the menu heading. Use
  110. this function with care. Once a  list  has been deleted the existing menu
  111. details that came after it  are  moved  into  its place. Any deleted list
  112. cannot be recovered, unless it was saved on disk.
  113.  
  114. Options
  115. -------
  116. Add To Menu Heading
  117.  
  118. From here you can create the part of  the menu that drops down. First you
  119. are asked to enter which menu heading  you  want  to add to. If it is the
  120. first heading you can only add 1  item because of having to reserve space
  121. for any desktop accessories. This  is  a  feature  of  GEM that cannot be
  122. changed. Any other headings can  have  up  to  20 entries. After you have
  123. entered this you can then enter the  name  of the procedure to be called.
  124. This is optional, but if it  is  entered  the appropriate GFA commands to
  125. call this procedure are created when the  menu is saved as code. Also the
  126. procedure command and return are  done.  All  you  need do then is insert
  127. your own code in between these two lines for example:-
  128.  
  129.         you enter the menu name  as  TEST  and  the procedure as TESTONE.
  130. Menumaker will create the code to check  if TEST was chosen from the menu
  131. and if so will branch off to the line PROCEDURE TESTONE, after which your
  132. code will be run and then the  last  line entered by MenuMaker which will
  133. be RETURN which will go back  to  monitoring  the  menu again. Try it and
  134. see. When you enter a procedure name  you  cannot have any spaces but you
  135. can use the underscore, for example you  cannot have TEST ONE but you can
  136. have TEST_ONE.
  137.  
  138.  
  139. Options
  140. -------
  141. Edit A Menu Entry
  142.  
  143. First you select the menu heading and  then the menu entry. From here you
  144. can change the menu entry and the procedure to call.
  145.  
  146. Options
  147. -------
  148. Delete A Menu Entry
  149.  
  150. As the name suggests you can delete  a  menu entry, First choose the menu
  151. heading and then the menu  entry  to  be  deleted. All other menu entries
  152. below the deleted one will be shifted to fill its space.
  153.  
  154. Options
  155. -------
  156. Test Menu So Far
  157.  
  158. You can see what your finished menu will look like without having to save
  159. it and quit the program. The  screen  colours  will change to the default
  160. desktop colours and  your  menu  bar  will  be  shown,  complete with the
  161. dropdown menus. Move the mouse over  the  menu  headings to see what they
  162. will look like. This is a new feature written in for the v1.0 release. To
  163. return to the 'REAL' menu just click  the right mouse button. Any changes
  164. or deletions you make will  always  be  shown  here so keep checking your
  165. menu.
  166.  
  167.  
  168. Right, I think that's  about  it.  Hopefully  most  things will be simple
  169. enough to follow, but I remember when I first started to program menus in
  170. GFA and it took me hours  to  get  it  the  way I wanted it, this utility
  171. should make life that bit easier. Not only that, IT'S FREE.
  172.  
  173. I am more than welcome to  receive  any letters giving me suggestions and
  174. ideas to make the program  better  and  easier  to  use, or even a letter
  175. letting me know if the program was of any use to you. As I am a member of
  176. the PdC (Public Domain  Confederation)  as  a  Licenceware programmer all
  177. future versions will be available from PdC  PD Libraries. One of which is
  178. Jennix PD which can be contacted at  66  Abbey Rd, Strood, Kent, ME2 3QB.
  179. Alternativly you can send me Two Pounds  and your address and I will send
  180. you the next version, when it's done. Any users who give me ideas which I
  181. use will be mentioned in the program, now is your chance to get your name
  182. seen by hundreds of ST users, well 2 anyway, Me and You!
  183.  
  184. Thanks to the following:-
  185.  
  186. ST Format -
  187.  
  188. It was the GFA Surgery  section  that  made  me  release the program as I
  189. was suprised at the amount of  questions  asked about GEM menus, also for
  190. giving us  ST  users  a  great  magazine,  I  get  mine  every  month, DO
  191. YOU?
  192.  
  193. Nick Klee -
  194.  
  195. A good friend who  runs  Jennix  PD  and  first  suggested that I release
  196. some of the programs  I  have  written,  both  his  catalogue and invoice
  197. programs are by me, and for introducing me to the PdC.
  198.  
  199. GFA Basic -
  200.  
  201. This must be the  Rolls  Royce  of  the  basic  programming languages. In
  202. my 10 years of computing  as  a  hobby  I  have  never  used or admired a
  203. program as much as I do this. If only all things were as good as GFA.
  204.  
  205. YOU! -
  206.  
  207. For taking the  time  to  read  this  document  and  for  possibly trying
  208. out the program.  Please  let  me  know  what  you  think.  Just a letter
  209. of appreciation (no money) will mean a lot.
  210.  
  211. Finally and most importantly -
  212.  
  213. My wife, Geraldine -
  214.  
  215. Thanks for my 2 wonderful sons, Richard & Daniel, and for putting up with
  216. me being on the computer all  night.  I  love you... This mush is killing
  217. me. The truth is as long as  she  gets  her go on Llamatron every now and
  218. again, she's happy.
  219.  
  220.  
  221. The Author ( Thats me ! ) : Mark Matts
  222.                              66 Telford Way
  223.                               Leicester
  224.                                LE5 2LX.
  225.  
  226.            ------------------------*-------------------------
  227.  
  228.  
  229.  
  230.  
  231.