home *** CD-ROM | disk | FTP | other *** search
/ RBBS in a Box Volume 1 #2 / RBBS_vol1_no2.iso / add2 / vmenu.zip / VMENU.DOC < prev    next >
Text File  |  1989-01-24  |  32KB  |  712 lines
  1.                      PC-Valet Super Menu Documentation
  2.  
  3.  
  4.      VMENU (PC-Valet  Super Menu)  is a  totally user definable menu system
  5. that will  allow a  user to  select and  execute any  program by pressing a
  6. single key.   What  happens after you press a key will be determined by how
  7. that particular  key is  defined.   It may execute any DOS command, a batch
  8. file, any  application program, or may take you to a different menu or even
  9. load an  entirely different  set of  menus.  For the security minded, VMENU
  10. also allows  passwords to  be defined  to change  to any of the menus or to
  11. execute any of the functions in the menu.
  12.  
  13.      FEATURES:
  14.      
  15.      o    Small memory utilization (under 17k-78k of RAM depending on menu
  16.             definitions, 25k average)
  17.      o    Fast (written in assembly language)
  18.      o    10 menus resident at a time
  19.      o    Unlimited total number of menus
  20.      o    Totally user definable
  21.      o    MONO/CGA/EGA/VGA compatible
  22.      o    Support for older "snowy" monitiors
  23.      o    Uses Microsoft compatible mouse if desired
  24.      o    Doesn't require a hard drive
  25.      o    3 different screen formats
  26.      o    User defined titles and keys
  27.      o    User defined key help lines
  28.      o    User defined colors on a color monitor
  29.      o    Built-in menu editor
  30.      o    Built-in screen blanker
  31.      o    On-screen clock (with 24 hour clock option)
  32.      o    Password protection capability
  33.      o    Run-time responses and 10 internal variables
  34.      o    Tested on Novell and 3+Open networks
  35.  
  36.      VMENU can  be configured  to utilize  the function  keys or the number
  37. keys.   It can display a menu resembling the function keys and allow a user
  38. to select  the desired function by simply pressing a function key.  When in
  39. the function  key mode,  VMENU also  allows a  user to  select the  desired
  40. function by pointing to the selection and pressing the left mouse button of
  41. a Microsoft  compatible mouse.  In the alternate mode, VMENU will provide a
  42. more standard  menu that  users select the desired function by pressing one
  43. of the number keys.
  44.  
  45.      VMENU can  provide up  to ten  menus in memory at a time and gives you
  46. the ability  to execute  up to ten commands per function key within each of
  47. these menus.  VMENU also  has the ability to load additional menus (in sets
  48. of 10) thereby increasing the maximum number of menus to the amount of free
  49. space on your disks.
  50.  
  51.      VMENU's appearance  may also  be customized  to suit  your own tastes.
  52. The colors of the different parts of the screen may be changed and even the
  53. style of the displayed keys.
  54.  
  55.      VMENU was  designed to  be used  with the  Zenith Z-248  AT compatible
  56. computers that  have an  Enhanced Graphics  Adapter (EGA card) with 256k of
  57. memory.   However, VMENU  will  also  run  on  many  other  IBM  compatible
  58. computers including  monochrome  computers  and  computers  with  a  "snow"
  59. problem such  as the  AT&T 6300.   VMENU  takes  up  approximately  23k  of
  60. computer memory while running.
  61.  
  62.      To use  this product, two files are required, VMENU.EXE and VMENU.DEF.
  63. VMENU.DEF is the menu definition file and must be located in the root level
  64. directory of  the disk  you start  VMENU from.   VMENU.EXE  may be  in  any
  65. directory, but  it is  recommended that it be located in the \DOS directory
  66. (or whatever directory your normal DOS system files are in).  The last line
  67. of your  AUTOEXEC.BAT file  should  be  modified  to  read  \DOS\VMENU  (or
  68. \BIN\VMENU depending on its location).
  69.  
  70.      The default  file that  VMENU uses  when it starts up, is a file named
  71. VMENU.DEF at the root level of the current drive.  However, you can cause a
  72. different file  to be used when VMENU starts up by entering the name of the
  73. file on  the command  line.   If you  specify a filename, it is recommended
  74. that you specify a full path such as:  VMENU C:\MYDIR\MYMENU.DEF
  75.  
  76.      It is  possible to have several menu definition files for VMENU.  Keys
  77. may be  defined to load the desired menu.  As example you could have a menu
  78. file for  each of  the users  of your  system.   A master menu (\VMENU.DEF)
  79. could come  up when  the system  is started  that would display each of the
  80. persons names  that use  your system.   By pressing a key with that persons
  81. name on  it, a  menu system  of their  very own  could be loaded, including
  82. their own color definitions.
  83.  
  84.      With the use of the {LOAD} command, there is no limit on the number of
  85. menus that  your system  has.  Any menu would also have the ability to call
  86. any other  menu.   No addition  memory is taken up when a different menu is
  87. loaded, as each new menu will load over the top of the previous menu.
  88.  
  89.      It is totally up to the menu designer whether or not to define an exit
  90. key.  The provided menu (VMENU.DEF) has defined F10 in menu 0 as the normal
  91. exit to  MS-DOS key.  If no key is defined as an exit, there will be no way
  92. to exit the menus without rebooting the computer.
  93.  
  94.  
  95. INSTALLATION
  96.  
  97. FIRST TIME INSTALLATION ON A HARD DRIVE:
  98.  
  99.      1.   Start your  computer from the hard drive.  If you computer starts
  100.      up any  kind of  application automatically,  exit to  the DOS  prompt.
  101.      (Probably C> or C:\>)
  102.      2.   Place distribution diskette in the A drive.
  103.      3.   ENTER: COPY A:\VMENU.EXE C:\VMENU.EXE
  104.      Note: You  can put  VMENU.EXE in  any directory  that is pointed to by
  105.      your PATH command.
  106.      4.   ENTER: COPY A:\VMENU.DEF C:\VMENU.DEF
  107.      5.   If desired,  edit C:\AUTOEXEC.BAT  and add the statement VMENU as
  108.      the last line.
  109.      6.   Start VMENU  by entering  VMENU at  the DOS  prompt.  You can now
  110.      customize the  menus as desired using commands described later in this
  111.      documentation.  CTRL-F6 invokes the menu maintainance mode.
  112.      
  113. UPDATING OLD VMENU ON A HARD DRIVE:
  114.      (As always this version of VMENU can read an older version of VMENU's
  115.      menu definition file.  However an earlier version of VMENU cannot read
  116.      this version's file.)
  117.      
  118.      1.   Start your computer from the hard drive.  Exit to the DOS prompt.
  119.      2.   Place distribution diskette in the A drive.
  120.      3.   Locate the directory that you have VMENU.EXE in.  (Enter: DIR
  121.      \DOS or DIR \BIN or DIR \UTILITY , etc until you find it or use the
  122.      locate option of AUTO-DIR.)
  123.      4.   Enter: COPY A:\VMENU.EXE C:\utility\VMENU.EXE  (substitute
  124.      utility with directory name where you found VMENU.EXE).
  125.      5.   Start up VMENU by entering VMENU at the DOS prompt.  You should
  126.      now go into menu maintainance mode and set the options (using F9 for
  127.      the options menu).  Make sure you remember to save the menu after you
  128.      set the options.
  129.      
  130. FIRST TIME ON A FLOPPY DRIVE:
  131.  
  132.      1.   Copy VMENU.EXE and VMENU.DEF from the distribution diskette to
  133.      floppy diskette(s) used to start your computer.
  134.      2.   Edit the \AUTOEXEC.BAT file on the boot diskette and add the
  135.      statement VMENU at the end of the file.
  136.      
  137. UPDATING A FLOPPY DRIVE:
  138.  
  139.      1.   Copy VMENU.EXE from the distribution diskette over any other
  140.      copies of VMENU.EXE that you may have.
  141.      
  142.      
  143. GENERAL USAGE
  144.  
  145. FUNCTION KEY MODE:  To execute  an option  from the  menu, simply press the
  146. function key  corresponding to the desired function or click on it with the
  147. left mouse  button.  Provided that the menu designer entered help for keys,
  148. you may display the purpose of a key by holding the SHIFT key down when you
  149. press the  desired function key.  This may also be accomplished by clicking
  150. on the key with the right button of the mouse.
  151.  
  152. NUMBER KEY MODE:    To execute  an option  from the  menu, simply press the
  153. number key  corresponding to  the desired function.  Provided that the menu
  154. designer entered help for the keys, you may display the purpose of a key by
  155. holding the SHIFT key down when you press the desired number key.
  156.  
  157.      VMENU supports  ten separate  menus in  memory at a time, with any key
  158. having the  ability to call any menu.  Pressing ESC while any other submenu
  159. is displayed will take you back to the initial menu (menu 0).
  160.  
  161.      To reset  a menu  to the  system default  colors press  CTRL-F7.  This
  162. color change will not become permanent unless you use the F7 function under
  163. Menu Modification.   System  status and  memory usage  may be  displayed by
  164. pressing CTRL-F1.
  165.  
  166. USING A  MOUSE WITH  VMENU: VMENU  will let  you use a Microsoft compatible
  167. mouse.  You must set the mouse option on (see Menu Modification) and have a
  168. Microsoft compatible  mouse driver  installed.  Pressing the left button is
  169. the same as pressing the function key.  The right mouse button would be the
  170. same as  holding the  shift key down and pressing the function key.  If you
  171. have a three button mouse, the center button is the same as holding the ALT
  172. key down and pressing the function key.
  173.  
  174.  
  175. MENU MODIFICATION
  176.  
  177. NOTE: If  a modification  password has been set, you will have to enter the
  178. password to be able to perform menu modification.
  179.  
  180.      A menu  definition file  is limited  to 63000 characters.  No check is
  181. performed at input time to verify the size, however, VMENU will not let you
  182. expand  the   file  in   excess  of  62500  characters.    This  gives  you
  183. approximately 6250 characters for each of the ten menus.  If you should run
  184. short on  memory (VMENU  will notify you) it is recommended that you reduce
  185. the length  of help  messages first and also to consider breaking the menus
  186. up into  separate files.  If you make extensive modifications to the menus,
  187. it is recommended that you save the menu, exit, and reenter occasionally to
  188. clean up the menus stored in memory.
  189.  
  190.      Menus may  be modified  by pressing  CTRL-F6  and  entering  the  menu
  191. modification mode.   After pressing CTRL-F6, the system will provide a menu
  192. similar to the following:
  193.  
  194.                +----------------------+
  195.                | F1 = Chg Key Defs    |
  196.                | F2 = Chg Colors      |
  197.                | F3 = Chg Menu Title  |
  198.                | F4 = Chg Menu Layout |
  199.                | F5 = Install Mod Pwd |
  200.                | F7 = Save Changes    |
  201.                | F8 = Reload Menu     |
  202.                | F9 = Option Menu     |
  203.                | ALT F1-F10 Chg Menu  |
  204.                |      ESC = Exit      |
  205.                +----------------------+
  206.  
  207. To change key definitions:
  208.  
  209.      Press CTRL-F6 and then press F1.  The system will then wait for you to
  210.      press the key you wish to modify.
  211.      
  212.      1.   Press the key you wish to modify.
  213.      
  214.      2.   You will  be shown the current definition of the key you pressed.
  215.           At this  time you  can move  the highlighted area with the UP and
  216.           DOWN arrow  keys.  To actually modify the line, just start typing
  217.           or press the RIGHT arrow key. (see USING LINE EDITOR)
  218.      
  219.      3.   A key's  definition may  be deleted  entirely by enter EOK as the
  220.           first three letters of line 1.
  221.      
  222. NOTE:     You will notice the use of a special word in the menu definition.
  223.           Every key must have an EOK (End Of Key) marker as the last entry.
  224.           The system  will provide  the EOK  for you and you do not need to
  225.           type it on any line (except on the first line to delete the key).
  226.      
  227. To change the colors of the screen:
  228.  
  229.      Press CTRL-F6  and then  press F2.  You will  be presented with a menu
  230.      showing function  keys to press to change colors in different areas of
  231.      the screen.  Pressing F9  will reset the colors to the VMENU standard.
  232.      (Note, some colors are not significant in the alternate menu layout.)
  233.  
  234.                +---------------------------------+
  235.                |          CHANGE COLORS          |
  236.                | F1 = Background F2 = Key back   |
  237.                | F3 = Key text   F4 = Key border |
  238.                | F5 = Title text F6 = Title back |
  239.                | F7 = Help text  F8 = Help back  |
  240.                | F9 = Shadow clr F10= Reset clrs |
  241.                |            ESC = Exit           |
  242.                +---------------------------------+
  243.  
  244. To change a title on a displayed screen:
  245.  
  246.      Press CTRL-F6  and then press F3. The system will ask you to enter the
  247.      title. The  title will  automatically be  made to fit in the title box
  248.      and can be up to 127 characters.
  249.  
  250. To change the appearance of the keys:
  251.  
  252.      Press CTRL-F6  and then  press F4.  This will toggle the appearance of
  253.      the menus between the number key format and two different function key
  254.      formats.
  255.      
  256. To install/remove a modification password:
  257.  
  258.      Press CTRL-F6  and then  press F5.  If no  password is  set,  you  are
  259.      prompted to  enter a  password. The password may be any combination of
  260.      keys on the keyboard. The BACKSPACE key is considered a valid key. You
  261.      will have  to reenter the password once again to verify it. If the two
  262.      do not  match, you  will have  to start over. If a password is already
  263.      installed, press F5 will remove password checking.
  264.      MAKE SURE  YOU RECORD THE PASSWORD SOMEWHERE. IF YOU FORGET IT YOU ARE
  265.      OUT OF  LUCK. There  is no  easy way  to  unprotect  a  menu  that  is
  266.      protected by a password. If you do lose the password, you will have to
  267.      redefine all the keys.
  268.  
  269. To make changes permanent:
  270.  
  271.      Press CTRL-F6 and then press F7.  You will be prompted for the name of
  272.      the file  to save  to.  If you press ENTER without entering a name, it
  273.      will be  saved to the displayed name. You may save the changed menu to
  274.      a different  name which  will allows you to have different definitions
  275.      of menus  for different  users of the same system.  If a file creation
  276.      error occurs  at this  point, type a different name for the menu to be
  277.      saved to.   This  will occur  if the directory is full or if DOS views
  278.      the file as Read Only.
  279.  
  280. To reload the current menu:
  281.  
  282.      Press CTRL-F6  and then press F8.  If you wish to void any changes you
  283.      made to  the menu, you can use this option to reload the original menu
  284.      or the last saved menu.
  285.      
  286. To change VMENU options:
  287.  
  288.      Press CTRL-F6  and then  press F9.  This will allow you to enable (ON)
  289.      or disable  (OFF) certain  options within  VMENU.   In this version of
  290.      VMENU you can enable/disable:
  291.      (F1) screen blanking (after 7 minutes of inactivity),
  292.      (F2) the mouse,
  293.      (F3) the ability to change menus with ALT F1-F10,
  294.      (F4) snow control (should only be ON if you see snow when set OFF),
  295.      (F5) the on-screen clock,
  296.      (F6) change the clock between standard and military (24 hour) time.
  297.  
  298. LINE DEFINITIONS
  299.  
  300.   The lines  in the  key definition  screen have  defined purposes.   These
  301.   purposes are described here.
  302.   
  303.   1-2  These are  the two  lines displayed  on the  face of the keys.  Each
  304.        line is  limited to  13 characters.  If you  desire to leave the top
  305.        (first) line  blank, you  must enter spaces on the line.  The second
  306.        line may be left blank by skipping it.
  307.   
  308.   3    This is the help line that will be displayed if you were to hold the
  309.        shift key  down when  you press  a key.   This line may be up to 160
  310.        characters long.
  311.   
  312.   4-14 These lines  contain the  commands necessary  to perform the desired
  313.        action.   Some knowledge  of DOS may be necessary here.  These lines
  314.        sort of act as a batch file.  Any valid DOS command may be placed on
  315.        these lines.  (Batch commands such as labels, IF statements and GOTO
  316.        do not  work here.)     Lines may  be up  to 80 characters long.  In
  317.        addition to  normal DOS  commands these  lines may  contain  certain
  318.        internal commands; {PAUSE}, {EXIT}, {MENU}, {LOAD}, or {RSP}.
  319.   
  320.   As as  sample  entry,  the  following  is  defined  for  MicroSoft  Word.
  321.   Information in  brackets is  shown to clarify statements, and must not be
  322.   entered.
  323.   
  324.   1 MicroSoft                         [title line 1]
  325.   2 Word                              [title line 2]
  326.   3 Invoke Word Processor                [help line]
  327.   4 CD \WORD            [change to proper directory]
  328.   5 WORD.COM                         [start program]
  329.   6 CD \                  [change to root after end]
  330.   7 EOK                 [system supplied End-Of-Key]
  331.  
  332. INTERNAL COMMANDS
  333.  
  334.      Several internal commands are supported by VMENU.  These commands will
  335. allow you  to jump  to another  menu within  the menus  in memory,  load  a
  336. different menu  definition file,  wait for  the user to press the space bar
  337. (and optionally  display a  prompt message),  provide an exit from the menu
  338. system to DOS, and to allow the user to enter arguments at run time.
  339.  
  340.      Several commands  that are  normally considered to be DOS commands are
  341. also supported  as internal  commands  in  VMENU  to  provide  support  for
  342. diskette users.   These  are CD, PAUSE and A:,B:,C:,etc..  Other normal DOS
  343. commands require  that COMMAND.COM be located on the disk in the drive used
  344. to boot  the computer.   Any commands that modify the Environment area will
  345. not work  properly.  These include the PATH and SET commands.  If these are
  346. needed, it is suggested that they be entered before VMENU starts up or in a
  347. batch file  called by  VMENU.   VMENU will reset the Environment area after
  348. each command.
  349.  
  350. NOTE:     Items in brackets [] are optional.  The braces {} are a required
  351.      part of the command and serve to inform VMENU that the command is
  352.      internal.  (Braces {} must be entered as shown.  Brackets [] must not
  353.      be entered.)
  354.      
  355. NOTE:     ECHO and PAUSE without braces will be passed to COMMAND.COM for
  356.      execution.  Drive changes (letter immediately followed by a colon and
  357.      a space or end of line) and the the CD and CHDIR commands are handled
  358.      internal to VMENU.
  359.      
  360. {CLS}
  361.   Clears the screen.
  362.   
  363. {ECHO}[message]
  364.   Displays the message as shown.  The message can contain control character
  365.   by preceding  the letter  of the control character with a circumflex (^).
  366.   As an  example, if  you have  ANSI.SYS loaded  and you wished to move the
  367.   cursor to  the middle  of the  screen and  display a  message, you  could
  368.   enter:
  369.   
  370.   {ECHO}^[[12;20H Somewhere close to the middle.
  371.   
  372. {ECHOON}
  373.   Turns on  the echoing of executing commands.  (Internal commands will not
  374.   echo.)
  375.   
  376. {NOECHO}
  377.   Turns the display of executing commands off. This statement will not echo
  378.   either.  (Default)
  379.   
  380. {MENU}[number]
  381.   This internal  command provides  the mechanism  for  a  key  to  cause  a
  382.   different menu  to be  displayed from  memory. The number must be a digit
  383.   from 0  to 9  indicating a menu to go to.  {MENU}0 is the first menu that
  384.   is displayed  when VMENU  is started.  (No space should be placed between
  385.   the brace  and the  number. If  the syntax  is invalid or a number is not
  386.   specified, the menu will default to 0.)
  387.   
  388.   EXAMPLES:
  389.   
  390.   {MENU}5           Display menu number 5
  391.   
  392.   {MENU}            Display menu number 0 (first menu)
  393.   
  394.   {MENU}0           Display menu number 0 (first menu)
  395.   
  396.   
  397. {LOAD}[menu_file_name]
  398.   This internal  command is  used to  load a different menu definition file
  399.   into memory.   The  menu previously in memory will be written over.  If a
  400.   menu_file_name is not specified, the start up menu will be reloaded.  The
  401.   displayed menu  will then  be menu  0 of  the designated  file.   (It  is
  402.   recommended that  a full  pathname be  specified to  the new menu file as
  403.   shown in the first and last examples.)
  404.   
  405.   EXAMPLES:
  406.   
  407.   CD \JONES
  408.   {LOAD}\jones\VMENU.def
  409.   
  410.   {LOAD}
  411.   
  412.   CD \GAMES
  413.   {LOAD}\games\gamemenu.def
  414.   
  415.   
  416. {EXIT}[message]
  417.   At least  one key  somewhere in  your menu  system should  have this as a
  418.   definition.     The  optional  message  will  be  displayed  after  VMENU
  419.   terminates.
  420.   
  421.   EXAMPLE:
  422.   
  423.   CD \
  424.   {EXIT}
  425.   
  426.   {EXIT} Please enter STARS at this time.
  427.   
  428. {PAUSE}[message]
  429.   {PAUSE} will  display a  message "SPACE to continue  ESC to abort" in the
  430.   lower right  corner of the screen and wait for the space bar or ESC to be
  431.   pressed.   If message  is specified, the message is displayed in a box in
  432.   the middle  of the  screen.   If ESC  is pressed, the last displayed menu
  433.   will be re-displayed immediately.
  434.   
  435.   EXAMPLES:
  436.   
  437.   {PAUSE} Place blank diskette in drive A.
  438.   COPY *.DOC A:
  439.   
  440.   CHKDSK {RSP}"Check disk in what drive? (A,B,C) ":
  441.   {PAUSE}
  442.   
  443. {RSP}["prompt_message"]
  444.   This internal  command is  designed to be placed on a DOS command line to
  445.   allow the  user to  enter an argument at run time.  The prompt_message is
  446.   optional, however, if it is used the quote marks are required.
  447.   
  448.   EXAMPLES:
  449.   
  450.   WORD {RSP}"Enter name of document to edit: "
  451.   DIR {RSP}"Directory of which drive? (A,B,C) ": /P
  452.   COPY {RSP}"Source file: " {RSP}"Destination file: "
  453.   WIN CARDFILE {RSP}"What cardfile do you want? "
  454.   &1={RSP}"Enter drive: "
  455.   
  456. {PASSWORD}password
  457.   This internal  command allows  you to  password  protect  a  single  menu
  458.   option. As  many options  as you wish can be protected with this and each
  459.   can have  a separate password.  Once the file is saved this is changed to
  460.   {PWD} and  the password is encrypted.  To change a password, reenter this
  461.   line as  {PASSWORD} and  the new  password.   The password  is limited to
  462.   eight characters.  This command must precede any commands that need to be
  463.   protected.
  464.   
  465.   EXAMPLES:
  466.   
  467.   1> Communication
  468.   2> Menu
  469.   3> This key is used to change to communication menu
  470.   4> {PASSWORD}special
  471.   5> {MENU}4
  472.   6> EOK
  473.   
  474.   1> Quattro
  475.   2>
  476.   3> Starts Borland Quattro
  477.   4> cd \quattro
  478.   5> {PASSWORD}wonder
  479.   6> {KEYIN}Q123^M
  480.   7> {EXIT}
  481.   8> EOK
  482.   
  483. {KEYIN}keys....
  484.   IMPORTANT!:  This command  may or  may not work correctly in on different
  485.   computers and  with different releases of the operating system!  Some TSR
  486.   programs also keep this function from working correctly.
  487.   
  488.   This command  allows you  to pre-load  the  keyboard  buffer  before  the
  489.   execution of  a command.   You  can pre-load  up to  15 standard  keys or
  490.   control keys  (sorry no  function or  cursor keys).  As an example if you
  491.   wish to  cause TURBO.COM (3.1) to include the message file, automatically
  492.   log the  B drive  and display  the directory,  the command definition may
  493.   look like the following:
  494.   
  495.   CLS
  496.   {PAUSE} Insert Turbo Data disk in drive B:
  497.   {KEYIN}YLB^M D^M
  498.   TURBO.COM
  499.   EOK
  500.   
  501.   If you  wished to  automatically execute  another command  (such as AUTO)
  502.   after exiting from VMENU you may use:
  503.   
  504.   {KEYIN}AUTO^M
  505.   {EXIT}
  506.   
  507.   NOTE: To  include control  keys, use  the circumflex  (^) followed  by  a
  508.   standard key.   The  key is  "anded" with 0x1F to come up with the key to
  509.   send.   I.e.: to  send ESC  use ^[, enter key use ^M.   ^A=0x01, ^B=0x02,
  510.   ^C=0x03, ... ^M=0x0D, ... ^[=0x1B.
  511.   
  512.   Any more than 15 keys are discarded.  You could fool the system with more
  513.   than one  {KEYIN} statement, but the earlier keys will be overwritten and
  514.   the results  are unpredictable.   Also if someone where typing keys while
  515.   the {KEYIN} statement is being processed, the results are unpredictable.
  516.   
  517.   
  518. USER DEFINABLE VARIABLES &0-&9
  519.   
  520.   VMENU allows  user definable  variables.   The use  of these variables is
  521.   somewhat limited  as this version does not yet have the ability to branch
  522.   based on  values of  these parameters.   Once  a variable  is set it will
  523.   remain set  until another statement sets the same variable or until VMENU
  524.   terminates.
  525.   
  526.   To set a user parameter, enter &n=value (where n is a digit from 0 to 9).
  527.   No space may precede or follow the equal (=) sign.  All characters (up to
  528.   69) following  the equal  sign are  the resulting  value of the variable.
  529.   Variable assignment  ends at  end-of-line or  at another  ampersand  (&).
  530.   Thus the statement
  531.      &1=TEST  &2=VALUE OF THIS
  532.   results in &1 equaling "TEST" and &2 equaling "VALUE OF THIS".  Note that
  533.   trailing spaces are always suppressed.
  534.   
  535.   Using the  {RSP}"prompt" statement  with &n= allows the user to enter the
  536.   resulting value.  Thus the statement
  537.      &1={RSP}"Enter your name: "
  538.   will allow the user to enter their name and the result will remain in &1.
  539.   During execution, if I entered
  540.      John Junod
  541.   in response to the message "RESPOND> Enter your name: " this would result
  542.   in &1 equaling "John Junod".
  543.   
  544.   The variables are substituted before a line is checked for anything else.
  545.   If &1="A:*.*" and &2="B:" then the statement
  546.      COPY &1 &2
  547.   would result in "COPY A:*.* B:".  If &1="\WINDOWS" then the statement
  548.      &2={RSP}"Enter source file: &1\"
  549.   would result in '&2={RSP}"Enter source file: \WINDOWS\"'.
  550.   
  551.   EXAMPLE:
  552.   
  553.   Copy File(s)
  554.   (using &1,2,3)
  555.   This key will display a directory, accept a filename and copy a file for
  556.   you.
  557.   CLS
  558.   &1={RSP}"What directory do you wish to look at? "
  559.   DIR &1 /W
  560.   {ECHO}To respond to next question, complete the filename.
  561.   &2={RSP}"What file do you wish to copy? &1"
  562.   &3={RSP}"What is the destination for &1&2? "
  563.   COPY &1&2 &3
  564.   EOK
  565.   
  566.   
  567.   The processing order using these variables is:
  568.   1. Expand any &n not followed by an equal sign.
  569.   2. Search for an &n=
  570.      If found, check for/expand {RSP}"prompt"
  571.      Set &n  to text  now following  equal sign  until another & or end-of-
  572.      line.
  573.      From current location in line, continue step 2 until end-of-line.
  574.   3. Search from start of line for internal commands
  575.      If found, process internal command
  576.      else process as external command and check for/expand {RSP}"prompt".
  577.      
  578.      
  579. NOTE: If  you desire  functions other  than the above, it is suggested that
  580. you simply cause a batch file to be executed from VMENU.
  581.  
  582.  
  583. USING THE LINE EDITOR
  584.  
  585.      The line  editor used  when modifying  key definitions  is internal to
  586. VMENU and is invoked when the key definition is displayed by pressing a key
  587. other than  the up and down arrows, F1, F2, F3, F4 or the return key.  This
  588. editor has redefined the following keys:
  589.  
  590.   HOME           Go to start of line.
  591.   END            Go to end of line.
  592.   BACKSPACE      Move cursor one position to left and erase.
  593.   LEFT ARROW     Move cursor one position to left.
  594.   RIGHT ARROW    Move cursor one position to right.
  595.   UP ARROW       Go to previous line.
  596.   DOWN ARROW     Go to next line (same as ENTER).
  597.   INSERT         Insert a space at the cursor.
  598.   DELETE         Delete character under cursor and move remaining text left
  599.                  one character.
  600.   ENTER          Accept changes made on this line and move down one line.
  601.   ESC            Abort changes made on this line.
  602.   F1             Accept changes and allow modification of a different key.
  603.   F2             Accept changes and return to Menu Modification menu.
  604.   F3             Insert blank line at current line.
  605.   F4             Delete this line and move all lines up.
  606.  
  607.      Note: A  keys definition  cannot  be  totally  deleted  by  repeatedly
  608. pressing this F4 on the first line.  To delete a keys definition, enter EOK
  609. as the first three letters of the first line.
  610.      
  611.  
  612. CREATING A NEW MENU DEFINITION FILE
  613.  
  614.      The preferred  way to  create a  new menu  definition file  is to make
  615. modifications to  an existing  file and  then save that file to a new name.
  616. However, the  need may arise to create a menu definition file from scratch.
  617. A  new   menu  definition  file  may  be  created  by  entering  "VMENU  /C
  618. new_menu_name" without  the quote marks at the DOS prompt.  When a new menu
  619. file is created in this manner, it will only have an exit key defined.
  620.  
  621.  
  622.        *****************************************************************
  623.                   CLARIFICATION OF THE COPYRIGHT AND LICENSE
  624.        *****************************************************************
  625.  
  626. PC Valet Super Menu (VMENU) is shareware and is not a public domain program.
  627. Individuals  are  granted a free license to use VMENU for up to 30 days for 
  628. evaluation  purposes.  To continue using  VMENU  after that time,  you must
  629. register VMENU in one of the following manners.
  630.  
  631. Registrations that are available.
  632.   
  633.   1>   FOR INDIVIDUALS: TO USE WHAT YOU HAVE:
  634.   For $15, as an individual,  you  register the copy that you currently 
  635.   have.  You are then granted a license to use VMENU on any computer as long
  636.   as only one copy of VMENU is ever in use at any one time.
  637.   
  638.   2>   FOR ANYONE: A DISK WITH THE LATEST VERSION, A HARD COPY OF THE 
  639.   DOCUMENTATION AND FREE TECHNICAL ASSISTANCE:
  640.   For $25, you  will  receive the latest  version of VMENU (or the next
  641.   available  version  if  you  have  the  latest)  and  a hard  copy  of the
  642.   documentation.  You will also be notified of updates to  VMENU  (these are
  643.   free when you send a blank disk upon notification). You are then granted a
  644.   license to use the latest version of VMENU on any computer as long as only
  645.   one copy of VMENU is ever in use at any one time.
  646.   
  647.   3>   FOR ORGANIZATIONS AND BUSINESSES:
  648.   Site licenses  and  multi-copy  licenses  are available  at super low
  649.   costs.  A site license covers all computers that are owned by your company
  650.   and as a FREE bonus,  the computers of all your current employees.  Please
  651.   contact  Center Post  for more  information on site licenses.  Include the
  652.   number of company owned computers  that the license will apply to.  Please
  653.   include your phone number. 
  654.  
  655.   ALL registrations and inquiries should be sent to The CenterPost Group.
  656.  
  657.       BY MAIL:                     BY PHONE:                BY FAX:
  658.       Suite 111-189                301-836-5048             301-836-8815
  659.       15 Churchvile Road
  660.       Belair, Maryland 21014
  661.  
  662.   Payment accepted by cash, check, money order, MasterCard or Visa.
  663.         
  664. DISTRIBUTION
  665.  
  666. This package may be freely distributed provided that no  files are modified
  667. in any manner.  The following files MUST be distributed with VMENU in their
  668. original unmodified version:
  669.  
  670.    BWMENU.DEF          (Rename this VMENU.DEF for monochrome systems.)
  671.    MMAP.COM
  672.    VMENU.DEF
  673.    VMENU.DOC
  674.    VMENU.EXE
  675.    VMENU.GAM
  676.    VM_READ.ME
  677.  
  678. The  manner  of  distribution of this package  does  not  relieve the final 
  679. recepient of the package from the obligation  to register this product with
  680. CenterPost Group or John Junod.   Also the recepient of the package MUST be
  681. made aware of the fact that this  is  not  a public domain program and that
  682. they are required to register VMENU to be able to continue to use it.
  683.  
  684. VMENU.EXE must  not be modified in any manner.  You are not allowed to edit
  685. the messages that appear in VMENU.EXE with any kind of editor.
  686.   
  687. WARRANTY
  688.  
  689. With respect  to the physical disk, the author warrents the same to be free
  690. of defects  in materials  and workmanship  for a period of 30 days from the
  691. date of  purchase.  In the event of notification within the warrenty period
  692. of defects  in  material  or  workmanship,  the  author  will  replace  the
  693. defective diskette.   The  remedy for  breach of  this  warranty  shall  be
  694. limited to replacement and shall not encompass any other damages, including
  695. but not  limited to loss of profit, and special, incidental, consequential,
  696. or other similar claims.
  697.  
  698. The author  specifically  disclaims  all  other  warranties,  expressed  or
  699. implied, including but not limited to implied warranties of merchantability
  700. and fitness  for a  particular purpose  with  respect  to  defects  in  the
  701. diskette and documentation.  In no event shall the author or the CenterPost
  702. Group  be  liable  for any loss of profit  or  any other commercial damage,
  703. including but not limited to  special,  incidental,  consequential or other
  704. damages.
  705.  
  706. The author retains all rights to this package and the right to make updates
  707. to this  package without  notification to  the purchaser.   This package is
  708. sold and distributed "as is" except as noted in a specific license.
  709.  
  710. VMENU copyright 1987,1988,1989 by John A Junod.  All rights reserved.
  711. 3005c Greene Place, West Point, NY 10996
  712.