home *** CD-ROM | disk | FTP | other *** search
/ DP Tool Club 17 / CD_ASCQ_17_101194.iso / vrac / ezmenu15.zip / MENU.DOC < prev    next >
Text File  |  1994-04-05  |  11KB  |  266 lines
  1.  
  2. EASYMENU v1.0 (c) GDSOFT 1993
  3.  
  4. WHAT IT IS AND AIN'T
  5. --------------------
  6.  
  7. EASYMENU  is compatible  with any  IBM PC  286 or  Better using  an EGA/VGA
  8. monitor. Sorry, it  WILL NOT WORK on 8088  machines or monochrome monitors.
  9. It is small (about 40K), FAST, slick, and easy to use. When programs or DOS
  10. commands are executed,  it takes up ONLY 384 bytes  of memory, and DOES NOT
  11. use batch files unless you want.
  12.  
  13. It's GREAT  for laptop machines  or in applications  where you need  a menu
  14. "right NOW" without a  lot of fuss and bother. There is  ONLY one 48K 'EXE'
  15. file and the  MENU.DAT file required. There is NO  LIMIT (except memory and
  16. disk space) to the number of menus and sub-menus that can be created.
  17.  
  18. GETTING STARTED
  19. ---------------
  20.  
  21. EASYMENU was  written to provide a  simple to use, and  yet exciting way of
  22. executing programs. Also, I wanted EASYMENU to be able to do lot's of other
  23. stuff than just run programs. The FIRST  order of business is to review the
  24. sample menu data  files included. ESPECIALLY look at  SAMPMENU.DAT which is
  25. heavily comment.
  26.  
  27. Where to put the EASYMENU Files :
  28. ---------------------------------
  29.  
  30. Generally all of  the EASYMENU files should be kept  in the ROOT directory.
  31. This  insures that  EASYMENU will  run the  fastest. If  you create another
  32. directory  for the  EASYMENU programs,  make sure  that your PATH statement
  33. includes this directory.
  34.  
  35. On Floppy  based systems, The file  EASYMENU.EXE and MENU.DAT are  all that
  36. are required to run EASYMENU.
  37.  
  38. EASYMENU can  be executed directly from  the DOS command line  if you wish.
  39. However, I recommend that you use the  file RUN.BAT to load EASYMENU . Take
  40. a look  at the  sample RUN.BAT  included with  the distribution  files. You
  41. could name this file anything such as 'GO.BAT'.
  42.  
  43. This makes executing EASYMENU as easy as typing 'GO' or 'RUN' at the command
  44. line. Also,  it gives you the  opportunity to include a  path statement and
  45. whatever else you want done before and after EASYMENU.
  46.  
  47. EASYMENU Data Files
  48. -------------------
  49.  
  50. EASYMENU uses a  simple ASCII data file which can  be created with any text
  51. editor to allow easy creation of  your menus. See the SAMPMENU.DAT file for
  52. an example. Each menu that you create can  have up to 30 items. If your new
  53. to  DOS, you  access F11-20  by pressing  SHIFT and  F1-10 ,  and F21-30 by
  54. pressing CTRL and F1-10 .
  55.  
  56. Menus can load  other menus, and there is virtually  no limit to the number
  57. of levels that you can go. The  only requirement is that your file MENU.DAT
  58. must be the first  level menu data file. From there, the  the limit is your
  59. computer memory.
  60.  
  61. Here are some sample menu data file lines.
  62.  
  63.         Load TURBO PASCAL 5.0  %D:\TURBO      @TURBO.EXE
  64.         Load Lotus 123         %D:\LOTUS      @123.EXE
  65.         Display Directory      %D:\           @DIR/W @PAUSE
  66.  
  67.  
  68. Notice that  each menu selection  must be entirely  on one line.  The first
  69. part of the  line is what EASYMENU will  display on the menu. Of  course, a
  70. function key  from 1-30 will  be added in  front. The %  sign indicates the
  71. start of  the path where  you program  is  located. After that,  the @ sign
  72. indicates the name of the program  to be executed. Multiple programs or DOS
  73. commands may be executed by separating them with the @ sign.
  74.  
  75. Load Sub-Menus :
  76. ----------------
  77.  
  78. Here is a sample menu data file line to load a sub-menu.
  79.  
  80.         Load File Utility Menu %C:\ @$UTILMENU.DAT
  81.         Load Communications Menu %C:\ @#UTILMENU.DAT
  82.  
  83. Notice the inclusion  of the '$' Dollar-sign character  after the '@' sign.
  84. This indicates to EASYMENU that this  is a REGULAR SUB-MENU file. This type
  85. of sub-menu  will have the  same format as  your main menu,  and can itself
  86. call yet another sub-menu. There is NO limit except memory. The second type
  87. of sub-menu  is indicated by  the '#' pound  sign. This type  of menu is  a
  88. "point-shoot" type menu, and MAY NOT be used to call another sub-menu. Your
  89. taste will decide which you use. I often use BOTH !
  90.  
  91. EASYMENU Memory Usage
  92. ---------------------
  93.  
  94. By default,  EASYMENU "Swaps" itself to  EMS,XMS or DISK when  a program or
  95. DOS command is executed. It leaves behind  ONLY 384 bytes of memory when it
  96. does this, making it the SMALLEST footprint of any menu system available.
  97.  
  98. Sometimes  you may  want to   have EASYMENU  COMPLETELY remove  itself from
  99. memory prior to loading a program.  This is commonly know as CHAINING. Here
  100. is how to do it.
  101.  
  102.         Load Lotus 123  %C:\LOTUS      @!123.EXE
  103.  
  104. Notice  the exclamation  '!' character.  This tells  EASYMENU to COMPLETELY
  105. remove itself from  memory prior to loading "123". You  might want to use a
  106. batch file  and have EASYMENU  load that, which  would then load  "123" and
  107. when finished,  would re-load EASYMENU  , otherwise, you  will get the  DOS
  108. command line when the program is finished.
  109.  
  110. In other cases, you may want EASYMENU  to use to old "batch" file approach.
  111. This should be unnecessary with EASYMENU,  but nevertheless, here is how to
  112. do it.  EASYMENU will create  a batch file  named $RUN.BAT with  all of the
  113. right commands to be executed.
  114.  
  115.         Load Lotus 123  %C:\LOTUS      @^123.EXE
  116.  
  117. Notice the Carat '^' character. This tells EASYMENU to create a batch files
  118. ($RUN.BAT) and  execute it. NO MEMORY  is used in this  case as EASYMENU is
  119. COMPLETELY  removed  from  memory,  the  commandline  is "STUFFED", and the
  120. $RUN.BAT file is executed. It will re-load EASYMENU.
  121.  
  122. The Method that  you choose will depend upon the  memory requirement of the
  123. program that you  are going to run. Usually, DOS  commands will NOT require
  124. that EASYMENU  be removed at  all. Experiment to  find the best  method for
  125. each program that you are using.
  126.  
  127. The  EASYMENU  "ASK" function :
  128. -------------------------------
  129.  
  130. There are times when  you want the menu to ask you  for a drive designation
  131. or or something BEFORE a program  or DOS command is executed. For instance,
  132. you might have a line in a menu data file that looks like this :
  133.  
  134.         List Directory  %C:\         @DIR/W@PAUSE
  135.  
  136. With this  line, EASYMENU will  list the directory  on drive 'C',  and then
  137. pause for a key press. Change the line to look like this :
  138.  
  139.        List Directory  %C:\          @DIR/W "ASK What Directory" @PAUSE
  140.  
  141. Now, before the  'DIR/W' command is issued, EASYMENU  will present you with
  142. an input box  and you will have an opportunity  to indicate which directory
  143. you want listed.
  144.  
  145. Notice that  the "ASK" command  must follow the  command to be  issued, and
  146. that it MUST be included in (") quotes. That's all there is to it.
  147.  
  148.  
  149. The EASYMENU Title :
  150. --------------------
  151.  
  152. The last  line of the data  file will be used  as the menu title  it should
  153. look something like this :
  154.  
  155.                            GDSOFT - Main Menu  %@
  156.  
  157. Notice the %@ combination indicating the this is the end of the data.
  158.  
  159. Also, read the section on 3 EASYMENU Passwords
  160.  
  161. MENU PASSWORDS
  162. --------------
  163.  
  164. The password system implemented here is  SIMPLE and NOT FOOLPROOF . It does
  165. however  provide  for  the  necessary  protection  against the execution of
  166. programs  by someone  other than  the person  who is  supposed to use them.
  167. Individual  programs  can  be  password  protected,  and  their is a MASTER
  168. PASSWORD designed to prevent quitting  the menu, shelling to DOS, executing
  169. DOS commands, and the execution of several of the utility programs.
  170.  
  171. HOW ITS DONE
  172. ------------
  173.  
  174. EASYMENU uses a  simple ASCII data file which can  be created with any text
  175. editor to  allow easy creation of  your menus. Before trying  to understand
  176. the password  scheme, you'll want to  set up your own  menu data file. Read
  177. the section  on 2 Customizing  MENU.DAT for more  information on how  to do
  178. this, and take a look at the file SAMPMENU.DAT , especially the stuff about
  179. PASSWORDS .
  180.  
  181.  
  182. Here are some sample menu data file lines modified with passwords :
  183.  
  184.         Load TURBO PASCAL 5.0  %D:\TURBO      @[password]TURBO.EXE
  185.         Load Lotus 123         %D:\LOTUS      @[password]123.EXE
  186.         Display Directory      %D:\           @DIR/W @PAUSE
  187.  
  188.  
  189. You will notice the password precedes  the program name, and is enclosed in
  190. brackets []. Any  keyboard characters can be included  in the password, and
  191. at the attempted execution of the program, the user will be given three (3)
  192. chances to enter the password correctly.
  193.  
  194. The EASYMENU Master Password :
  195. ------------------------------
  196.  
  197. The last line of  the data file used as the menu  title, should be modified
  198. to look as follows :
  199.  
  200.  
  201.                          GDSOFT - Main Menu  % @[PASSWORD]
  202.  
  203. Once this  is done, ALL attempts  to quit the EASYMENU  program WILL require
  204. this password.
  205.  
  206. Please  NOTE that  once this  MASTER PASSWORD  is set,  ALL subsequent menu
  207. levels will  use this SAME password,  even if their title  lines attempt to
  208. change it. In other  words, this password is set at the  ROOT level, and is
  209. used from there on.
  210.  
  211.                              !!! A WARNING !!!
  212.  
  213. PLEASE DO  NOT USE PKLITE,  DIET or ANY  EXE COMPRESSOR ON  GDSOFT FILES. I
  214. HAVE ALREADY COMPRESSED THEM TO THE LIMIT, and YOU WILL EXPERIENCE PROBLEMS
  215. IF YOU COMPRESS THEM AGAIN.
  216.  
  217. Well, that's  pretty much it. I  think that you will  find EASYMENU easy to
  218. use, FAST, and once you get used to using it, indispensable !!
  219.  
  220. You may use EASYMENU on ONE machine for 21 days without registration. After
  221. that, you  CAN register it for  $15.00 and doing so  will get you a  LOT of
  222. BONUS programs and other goodies WELL WORTH THE $15.00.
  223.  
  224. For a  $40.00 registration fee,  I will send  my super dooper  menu package
  225. $MENU as  well. This system  is the BIG  BROTHER to EASYMENU,  and contains
  226. built-in features that you will LOVE. Here are just a few :
  227.  
  228.                 FILE MANAGER with archive Manager
  229.                 CALENDAR (appointment system)
  230.                 TYPEWRITER emulation
  231.                 COMPLETE Desktop
  232.                 TWO Editors
  233.                 PHONE Dialer
  234.                 COMPLETE Communications package
  235.                 ... and MUCH, MUCH, MORE ...
  236.  
  237.  
  238. In addition,  you'll get the GDSOFT  BONUS disk. Believe me  there are many
  239. goodies  on this  BONUS disk.  including FILEMANAGER  PLUS, an exciting NEW
  240. program which does  ALL that you could EVER want  a file manager program to
  241. do, including everything that EASYMENU does  and MUCH MORE !!! ALL this for
  242. ONLY $40.00 !!! WOW !!!
  243.  
  244. (These program CAN  NOT be obtained any other  way !! This is the  only way
  245. you can get it !!).
  246.  
  247. Send your request to :
  248.  
  249.         G.D. DAVIS
  250.         57280 Osage Drive
  251.         Goshen, Indiana 46526
  252.  
  253.         Please Include the proper registration fee.
  254.  
  255.         Make sure  that you include  your return address  and required disk
  256.         size (3 1/2 or 5 1/4)
  257.  
  258.  
  259. If you have any comments or questions,  I would REALLY love to receive your
  260. comments  or  suggestions.  I  can  be  reached  by  leaving  mail on GENIE
  261. (G.D.DAVIS) or CompuServe (72067,2726), or write to me at the above address
  262. or  better  yet,  call  GDSOFT  BBS  (219)  875-8133,  5pm-5am  (EST),  HST
  263. 14400,8,N,1.
  264.  
  265. Thank you for choosing EASYMENU.
  266.