home *** CD-ROM | disk | FTP | other *** search
/ Current Shareware 1994 January / SHAR194.ISO / menuing / macmen35.zip / MACMENU.DOC < prev    next >
Text File  |  1993-01-20  |  49KB  |  899 lines

  1.                             THE MACROWARE MENU (tm)
  2.                                  VERSION 3.50
  3.  
  4.                         A MACROWARE SOFTWARE PRODUCTION
  5.  
  6.  
  7.                   BOTH THIS DOCUMENTATION AND THE PROGRAM ARE
  8.              COPYRIGHT (C) 1992 MACROWARE SOFTWARE AND DAVID CARNEY
  9.                               ALL RIGHTS RESERVED
  10.  
  11.  
  12.  
  13.  
  14.                                ==================
  15.                                   INTRODUCTION
  16.                                ==================
  17.  
  18.        This software product is the property of MacroWare Software and
  19.        David Carney. MacroWare Software and David Carney make no
  20.        guarantees that it will work successfully on your system and also
  21.        take no responsibility for any damages caused by this product.
  22.        The purpose of this program is to serve as a means of organizing
  23.        the programs on your hard drive into categories so they are easy
  24.        to access and run. As other inferior past products performing
  25.        almost the same function have called it, a hard drive menu. It
  26.        allows you to organize your programs in a system of submenus. It
  27.        starts with the main menu which has 19 possible entries, next the
  28.        first submenu which has 8 possible entries, and finally a third
  29.        branch off of each of those 8 which has 8 of its own. You can
  30.        configure any item on any level to run as a program or proceed to
  31.        the next level of the structure. All programs and submenus can be
  32.        protected by a password of your choice to ensure security. In
  33.        addition to these options you can also configure the functions
  34.        keys from F1 through F10 to run a program upon being pressed.
  35.        These hotkeys give you truly fast access to ten of your most used
  36.        programs. The menu is organized using the letters of the English
  37.        alphabet, but to those of you who can't read, the menu can also
  38.        be navigated with the arrow keys. For the amount of disk space
  39.        the actual program takes, under 150k, and its price, only $10 to
  40.        register, this is truly an excellent choice for any computer user
  41.        who wishes a small alternative to the other huge, windows style,
  42.        menus that are available on today's market for much higher
  43.        prices. MacroWare Software is proud to release this program into
  44.        the market.
  45.  
  46.  
  47.  
  48.  
  49.                                ==================
  50.                                   REGISTRATION
  51.                                ==================
  52.  
  53.        If you find this program useful, you are asked to register it.
  54.        Registration entitles you to a registered copy of the program
  55.        which does not contain the shareware delay screens and is the
  56.        latest available version of the program, free online support on
  57.        Compuserve through email, my autograph, a current disk copy of
  58.        this manual, and a disk containing other MacroWare programs of
  59.        our choice. Registration is easy and is outlined in the
  60.        MacroWare Software demo included with this program but here's
  61.        how to register:
  62.  
  63.           Send $10, your name, address, type of disk you want, a
  64.           statement saying that you want to register the MacroWare Menu,
  65.           and any comments to:
  66.  
  67.                   MacroWare Software
  68.                   133 Caribou Dr.
  69.                   Boardman, OH 44512
  70.  
  71.  
  72.        We recommend however that you take advantage of the form we have
  73.        included by running the macorder.exe file and printing it out.
  74.        You can then fill out this form and mail it to the above address.
  75.        For easy access to this form you can run the MacroWare Software
  76.        demo by running the macrodem.exe file. Thank you if you take this
  77.        opportunity to donate to MacroWare Software.
  78.  
  79.  
  80.  
  81.  
  82.                                ==================
  83.                                   INSTALLATION
  84.                                ==================
  85.  
  86.        Installation of the MacroWare Menu is simple. Just log to the
  87.        directory containing the MacroWare Menu files, either from the
  88.        distribution disk or the archieve file, and type "install". You
  89.        will soon be asked to enter the drive and the path that you want
  90.        to install the menu on. For the drive, enter the letter of the
  91.        drive you want the menu installed on and press enter. For the
  92.        path you will be prompted to type the path and press enter or
  93.        simply press enter for the default. The default is \MACMENU.
  94.        If you choose a different path, enter it in that form. For
  95.        example if you wanted to install the menu in the subdirectory
  96.        TEST, you would type \TEST for your selection. After you enter
  97.        those two pieces of information you will then be given a menu
  98.        displaying your choices. If you want to change your choice of
  99.        drive press '1'. If you want to change your choice of path press
  100.        '2'. Press '3' to continue with the installation. Next the
  101.        installation will copy the files from the current directory (the
  102.        directory you were in when you executed the install.exe file) to
  103.        the new drive and path that you specified. If the new directory
  104.        is not already present, it will be created. If a previous version
  105.        of the menu is found in this directory you will be asked if you
  106.        wish to install over it or keep your old data files. This is to
  107.        make installing subsequent versions of the menu easy and prevent
  108.        you from having to reenter all your menu data. The only data that
  109.        will not remain the same is your menu logo and your system
  110.        preferences. To run the MacroWare Menu after installing it,
  111.        simply type 'MACRO' at the dos prompt while logged to the
  112.        installation directory. Do not attempt to run the macmenu.exe
  113.        file, as you will not be able to run any programs from the menu
  114.        if you do. After installing the menu you may wish to start your
  115.        system up with the menu. To do this first copy the macromen.bat
  116.        file from the MacroWare Menu installation directory to the root
  117.        directory of your boot drive (usually drive C for hard drive
  118.        systems). Next add the line, macromen, to the end of your
  119.        autoexec.bat file using a text editor of your choice.
  120.  
  121.        *Note* If you experience any problems with the installation you
  122.          may need to add this line to your config.sys file and reboot:
  123.          files = 20
  124.          
  125.  
  126.  
  127.  
  128.  
  129.                          ==============================
  130.                             MACROWARE MENU STRUCTURE
  131.                          ==============================
  132.  
  133.        The MacroWare Menu first contains 19 choices in the main menu.
  134.        This is located on the far left of the screen and each choice is
  135.        distinguished with a letter of the alphabet ranging from A
  136.        through S. Each of these 19 choices contains 8 subchoices which
  137.        are located in a box in the middle of the screen and each of
  138.        these choices is distinguished with a letter ranging from A
  139.        through H and this is called the second submenu. The third
  140.        submenu is located in a box on the far right of the screen and
  141.        its choices are characterized by the letters A through H also.
  142.        Each of the 19 main menu choices contains 8 choices on the second
  143.        submenu and each of the 8 choices on the second submenu in turn
  144.        contains 8 choices of its own on the third submenu. So in essence
  145.        each of the 19 main choices contains 8*8 or 64 choices. There are
  146.        then in turn a total of 19*8*8 choices or 1216 choices in all.
  147.        Here is a simple diagram to describe this menu but for complexity
  148.        reasons only 1 main choice will be shown:
  149.  
  150.                                |             |choice 1
  151.                                |             |choice 2
  152.                                |             |choice 3
  153.                                |             |choice 4
  154.                                |choice 1-----|choice 5
  155.                                |             |choice 6
  156.                                |             |choice 7
  157.                                |             |choice 8
  158.                                |
  159.                                |             |choice 1
  160.                                |             |choice 2
  161.                                |             |choice 3
  162.                                |             |choice 4
  163.                                |choice 2-----|choice 5
  164.                                |             |choice 6
  165.                                |             |choice 7
  166.                                |             |choice 8
  167.                                |
  168.                                |
  169.                                |             |choice 1
  170.                                |             |choice 2
  171.                                |             |choice 3
  172.                                |             |choice 4
  173.                                |choice 3-----|choice 5
  174.                                |             |choice 6
  175.                                |             |choice 7
  176.                                |             |choice 8
  177.                                |
  178.                                |             |choice 1
  179.                                |             |choice 2
  180.                                |             |choice 3
  181.                                |             |choice 4
  182.                                |choice 4-----|choice 5
  183.                                |             |choice 6
  184.                                |             |choice 7
  185.                                |             |choice 8
  186.           main choice----------|
  187.                                |             |choice 1
  188.                                |             |choice 2
  189.                                |             |choice 3
  190.                                |             |choice 4
  191.                                |choice 5-----|choice 5
  192.                                |             |choice 6
  193.                                |             |choice 7
  194.                                |             |choice 8
  195.                                |
  196.                                |             |choice 1
  197.                                |             |choice 2
  198.                                |             |choice 3
  199.                                |             |choice 4
  200.                                |choice 6-----|choice 5
  201.                                |             |choice 6
  202.                                |             |choice 7
  203.                                |             |choice 8
  204.                                |
  205.                                |             |choice 1
  206.                                |             |choice 2
  207.                                |             |choice 3
  208.                                |             |choice 4
  209.                                |choice 7-----|choice 5
  210.                                |             |choice 6
  211.                                |             |choice 7
  212.                                |             |choice 8
  213.                                |
  214.                                |             |choice 1
  215.                                |             |choice 2
  216.                                |             |choice 3
  217.                                |             |choice 4
  218.                                |choice 8-----|choice 5
  219.                                              |choice 6
  220.                                              |choice 7
  221.                                              |choice 8
  222.  
  223.  
  224.  
  225.  
  226.                                   ===========
  227.                                      SETUP
  228.                                   ===========
  229.  
  230.        Once you load the MacroWare Menu your first plan of action may be
  231.        to setup the various options that you have. To do this you can
  232.        press the ALT-S key. It is a highlighted choice at the bottom of
  233.        the screen. Upon pressing ALT-S a windowed menu will pop up
  234.        containing several setup options. They are:
  235.  
  236.               1) Setup Function Keys
  237.  
  238.                         This allows you to define the ten function keys
  239.                         on your keyboard as programs that will run when
  240.                         they are pressed. Setup of these is easy. Simply
  241.                         press '1' from the setup menu and another
  242.                         windowed menu will appear showing the current
  243.                         function key definitions. To choose which key to
  244.                         edit simply press that function key or to return
  245.                         to the original setup menu press escape. When
  246.                         you press a function key another window will
  247.                         open showing the current settings of that
  248.                         function key. You can edit these settings by
  249.                         typing the number next to the line you want to
  250.                         edit. You will then be prompted to enter the new
  251.                         value for that setting. The choices are: 1) title
  252.                         - which is what is displayed on the previous
  253.                         screen, 2) path - which is the filename and path
  254.                         of the program that is to be run when that
  255.                         particular function key is pressed (The filename
  256.                         can also be chosen by pressing the F2 key and
  257.                         selecting the program by using the arrows and
  258.                         enter keys from the directory selection that is
  259.                         available - this is the file pick), 3) password
  260.                         - which is the password which will protect any
  261.                         given function key when it is pressed (if this
  262.                         is blank there will be no password protection on
  263.                         that key), and parameters which is a yes or no
  264.                         value (if yes you will be prompted to enter
  265.                         command line parameters for the program every
  266.                         time you press the function key and if no you
  267.                         will not be prompted for parameters). Note that
  268.                         when typing in a filename, if the filename is
  269.                         not found by the MacroWare Menu it will tell you
  270.                         so but it will also give you the option to keep
  271.                         the filename anyway as we realize that sometimes
  272.                         you might want to include command line
  273.                         parameters in with the filename so they do not
  274.                         have to be retyped every time. The other two
  275.                         options, '5' and '6', are for when you are
  276.                         finished. Press '5' if you want to save your new
  277.                         settings and return to the previous window and
  278.                         press '6' if you just want to return to the
  279.                         previous menu without saving the new values.
  280.  
  281.               2) Setup Password Protection
  282.  
  283.                         This option allows you to setup your system
  284.                         password protection settings. Upon pressing this
  285.                         a window will open showing the current system
  286.                         password and which system options are password
  287.                         protected. Note that in this case the password
  288.                         can in fact be a simple enter if the system
  289.                         password field is blank and that if password
  290.                         protection is set to yes on any of the options
  291.                         you will be prompted for a password even if this
  292.                         field is blank. The password in this case would
  293.                         be simply pressing enter. Anyway you can change
  294.                         the current system password by pressing '1' and
  295.                         typing your new password. Options 2 through 7 on
  296.                         this menu are yes or no fields which denote
  297.                         whether or not each of the system options is
  298.                         password protected or not. A 'YES' means that it
  299.                         is password protected while a 'NO' means that it
  300.                         is not. If any of these are set to yes, when
  301.                         they are chosen from the menu, the user will be
  302.                         prompted to enter the system password. If the
  303.                         user does not get the password correctly, access
  304.                         to that particular option will be denied. Please
  305.                         remember your password if you password protect
  306.                         the setup as once you are out of setup you can
  307.                         not get back in without the password. One option
  308.                         automatically covered by the system password is
  309.                         the ALT-C function discussed later and the user
  310.                         has no way of unpassword protecting this option.
  311.                         Options '8' and '9' allow the user to exit this
  312.                         window and return back to the original setup
  313.                         menu. Pressing '8' will save the options and
  314.                         return while pressing '9' will just return to
  315.                         the previous menu.
  316.  
  317.               3) Setup Screen Saver
  318.  
  319.                         This allows the user to determine whether or not
  320.                         to have the time activated screen saver active.
  321.                         Pressing '1' will ask the user whether or not a
  322.                         time activated screen saver is wanted and
  323.                         pressing '2' will ask the user to enter the
  324.                         amount of time without keystroke before the
  325.                         screen saver is to activate in seconds. A screen
  326.                         saver is something that clears the screen so
  327.                         that monitor burn in will not occur. Remember
  328.                         that when entering the time that it is in
  329.                         seconds, so if you enter 1 thinking in terms of
  330.                         minutes, every second the screen saver will go
  331.                         off making it virtually impossible to use your
  332.                         menu or even get back to the setup to change it
  333.                         and a reinstallation will probably even be
  334.                         necessary. Again as in the previous setup
  335.                         options the last two options allow the user to
  336.                         exit to the previous menu. Pressing '3' will
  337.                         save the new settings and exit while pressing
  338.                         '4' will simply return to the setup menu.
  339.  
  340.               4) Setup Dos Shell
  341.  
  342.                         This option allows the user to determine the
  343.                         program that will be used as a dos shell and any
  344.                         run time parameters to include with that
  345.                         program. Pressing '1' will prompt the user to
  346.                         enter the path and filename of the dos shell
  347.                         that is to be used. Unlike other filename and
  348.                         path options in this program, this one will not
  349.                         accept filenames that it can not find. Remember
  350.                         the extension if in doubt. To start, the menu is
  351.                         configured to run the command.com file in your
  352.                         root directory, however if you do not use dos
  353.                         you will probably have to change this. Pressing
  354.                         '2' will prompt the user to enter any command
  355.                         line parameters necessary for the dos shell.
  356.                         Again the last two options allow the user to
  357.                         exit back to the previous screen. Pressing '3'
  358.                         will save the settings and pressing '4' will
  359.                         simply return to the setup menu.
  360.  
  361.               5) Setup Menu Logo
  362.  
  363.                         This option allows you to customize the
  364.                         MacroWare Menu with your own logo. This 2 line
  365.                         logo is displayed at the top of the main menu
  366.                         screen and also displayed in the screen saver.
  367.                         After choosing this option you will be given a
  368.                         menu containing the current logo. To change line
  369.                         1 of this logo type '1' and then enter your new
  370.                         text. To change line 2 of this logo type '2' and
  371.                         then enter your new text. To save and exit type
  372.                         '3' and to exit without saving your changes
  373.                         press '4'.
  374.  
  375.               6) Setup Preferences
  376.  
  377.                         This option allows you to customize your system
  378.                         preferences. Pressing '1' will allow you choose
  379.                         whether you want a YES/NO prompt when you press
  380.                         the escape key to exit the menu. Pressing '2'
  381.                         will give you the option of having the menu in
  382.                         color or monochrome. For color type 'C' and for
  383.                         monochrome type 'M'. Choosing '3' will turn the
  384.                         menu's sound capabilities on or off. Choose 'Y'
  385.                         if you want sound and 'N' if you don't. A choice
  386.                         of '4' will allow you to choose which video
  387.                         address you wish to use. The first one,
  388.                         $B800:0000, is for CGA, EGA, and VGA systems.
  389.                         The second one, $B000:0000, is for MDA systems.
  390.                         Choosing '5' will allow you to select your time
  391.                         format, either 12 hour with trailing AM or PM or
  392.                         24 hour with format. Choose '1' for 24 Hour or
  393.                         '2' for 12 Hour. To save your settings and
  394.                         return to the setup menu choose '6' and to
  395.                         simply return without saving choose '7'.
  396.  
  397.               7) Return to Menu
  398.  
  399.                         This option is self explanatory. It returns the
  400.                         user to the main MacroWare Menu.
  401.  
  402.  
  403.  
  404.  
  405.                                    ==========
  406.                                       EDIT
  407.                                    ==========
  408.  
  409.        After completing a satisfactory setup the user will probably next
  410.        want to start entering their own programs into the menu. This can
  411.        be achieved by pressing ALT-E from the main menu. This will in
  412.        turn edit the properties of the current menu item (the one that is
  413.        highlighted). Editing allows the user to add titles, comments,
  414.        whether it will be a program or sub menu, the filename and path
  415.        of the program if applicable, and the password you wish to use to
  416.        password protect the program. Upon pressing ALT-E from the main
  417.        menu, a window will pop up containing the current settings of the
  418.        current highlighted menu option and will allow you to edit them.
  419.        You can do this by moving the hightlight bar with the arrow keys
  420.        to the setting that you want to change and pressing enter. Upon
  421.        doing so you will be asked to input the new setting. The choices
  422.        are:
  423.  
  424.                  title:
  425.  
  426.                         This allows the user to edit the title that will
  427.                         be displayed on the menu for this choice. Press
  428.                         enter and then type in the new title you wish to
  429.                         use. Note that you can type as much as you want
  430.                         but that what you type will be truncated to fit
  431.                         into the title field for any particular choice.
  432.                         Upon finishing press enter and the new value
  433.                         will appear as a current setting.
  434.  
  435.                  comment:
  436.  
  437.                         This allows the user to edit the comment that
  438.                         will be shown in the comment box when that
  439.                         particular choice is highlighted. Simply press
  440.                         enter and then type the comment you want. Note
  441.                         again that you can type as much as you want but
  442.                         only the first 30 characters will be saved and
  443.                         the rest will be truncated.
  444.  
  445.                  submenu or program:
  446.  
  447.                         This will allow the user to define whether the
  448.                         choice will be a submenu or whether it will be a
  449.                         program. Press enter and then you will be asked
  450.                         which one you want it to be. Press 'p' for
  451.                         program or 's' for submenu. A description of
  452.                         the difference between submenu and program was
  453.                         contained previously in this manual under
  454.                         'MacroWare Menu Structure'. Also note that on
  455.                         the level three submenu there is no further
  456.                         branch and the only possible value for this is
  457.                         program.
  458.  
  459.                  filename if available:
  460.  
  461.                         This will allow the user to enter the filename
  462.                         and path of the program that is to be run by
  463.                         this choice. This only applies if the above option
  464.                         is set to 'PROGRAM'. Press enter to access this
  465.                         and then type the filename and path of the program
  466.                         and press enter. If the file is not found by
  467.                         MacroWare Menu then it will tell you so but will
  468.                         give you the option of keeping it anyway for the
  469.                         reason that sometimes you may want to keep
  470.                         frequently used command line parameters in the
  471.                         filename so that they do not have to be retyped
  472.                         every time. You may also select the filename by
  473.                         pressing the F2 key which will then cause a
  474.                         directory window to be opened. By using the
  475.                         arrow keys and enter key you can select the
  476.                         filename that you want. You can also change
  477.                         drives by pressing the F1 key and then selecting
  478.                         the new drive by letter. Pressing escape will
  479.                         take you back to the edit window and not change
  480.                         the filename.
  481.  
  482.                  password:
  483.  
  484.                         This option allows the user to determine whether
  485.                         or not a password is desired to protect this
  486.                         choice and what that password will be. Left
  487.                         blank, no password will be assumed and the
  488.                         program will not be protected. However typing a
  489.                         password in this field will cause the menu to
  490.                         prompt the user to enter that password every
  491.                         time that choice is chosen and will deny access
  492.                         if the password is not entered correctly.
  493.  
  494.                  save and exit:
  495.  
  496.                         This option allows the user to exit back to the
  497.                         menu saving the newly entered settings.
  498.  
  499.                  exit without saving:
  500.  
  501.                         This option allows the user to exit back to the
  502.                         menu, discarding all the newly entered settings
  503.                         and keeping the old ones active.
  504.  
  505.  
  506.  
  507.  
  508.                                 ===============
  509.                                    DOS SHELL
  510.                                 ===============
  511.  
  512.        The third system option is shelling to dos. Choosing this option
  513.        will execute the program with the command line parameters that
  514.        you specified for the dos shell in the setup. To access the dos
  515.        shell press ALT-D from the main menu. If there is no password you
  516.        will shell out to dos. A message will be printed on the dos
  517.        screen saying to return to the MacroWare Menu to type 'EXIT'.
  518.        This only applies if you are using IBM dos as your dos shell. To
  519.        return to the menu from other programs you must simply exit that
  520.        program. This is the only area of the MacroWare Menu that
  521.        contains any known bugs. We have not yet pin pointed the reason
  522.        for them, so if you find any please mail in the report of these
  523.        bugs to the address specified in the registration part of this
  524.        documentation or the MacroWare Demo. The dos shell generally
  525.        works well, however to prevent crashing the MacroWare Menu we
  526.        recommend that you do not perform any extensive functions from
  527.        the dos shell such as running dos debug.
  528.  
  529.  
  530.  
  531.  
  532.                                  =============
  533.                                     OPTIONS
  534.                                  =============
  535.  
  536.        This area of the MacroWare Menu provides you with other various
  537.        options. When you select this by pressing ALT-O from the main
  538.        menu, a window will open up and will provide you with a menu of
  539.        options. They include:
  540.  
  541.               1) System Info
  542.  
  543.                         Pressing '1' will produce a window that shows
  544.                         information about your computer and about the
  545.                         functioning of the MacroWare Menu on it. You can
  546.                         also set the system time and date from here. To
  547.                         set the time simply press 't' and then enter any
  548.                         information that you are asked for. To set the
  549.                         date simply press 'd' and then enter anything
  550.                         that you are asked to. To return back to the
  551.                         option menu press escape.
  552.  
  553.               2) Run Screen Saver
  554.  
  555.                         This option allows the user to run the screen
  556.                         saver right from this menu. The screen saver has
  557.                         been described previously in this manual under
  558.                         setup. Remember to exit the screen saver and
  559.                         return to the menu press any key. This option
  560.                         gives the user fast access to the available
  561.                         screen saver so the user does not have to wait
  562.                         the specified amount of time for the time
  563.                         activated screen saver to start.
  564.  
  565.               3) Delete Current Entry
  566.  
  567.                         This option allows you to delete the current or
  568.                         entry of the menu. For example, if this is
  569.                         chosen while an entry on the third sub level is
  570.                         highlighted, then that entry will simply be
  571.                         deleted and all entries after it moved back one
  572.                         to fill in. If this option is chosen while an
  573.                         entry on the second sub level is highlighted,
  574.                         then that entry on the second sub level will be
  575.                         deleted along all of its entries on the third
  576.                         sub level corresponding with it. Again all other
  577.                         entries will be moved back one. If this is
  578.                         performed on the main level, then all of its
  579.                         entries on the second sub level and all the
  580.                         entries on the third sub level branching from
  581.                         those entries will all be deleted and subsequent
  582.                         entries will be pulled back one. For easy access
  583.                         to this option you can use the Delete key. If
  584.                         the options are password protected, then use of
  585.                         the Delete Key will also be password protected
  586.                         by the system password.
  587.  
  588.               4) Insert Blank Entry
  589.  
  590.                         This option allows you to insert a blank entry
  591.                         into the menu right before the currently
  592.                         highlighted entry. Entries will be moved
  593.                         forward correspondingly and the last entry in
  594.                         the current sub level will be lost. Also, all
  595.                         the appropriate sub levels will be updated
  596.                         accordingly to make blank space for the
  597.                         inserted entry. For example if you insert a
  598.                         blank entry into the main level, you are also
  599.                         moving all of the subsequent sub levels down
  600.                         as well to make room for a completely new
  601.                         branch of the menu tree. This is similar to
  602.                         the delete option, except it allows the user
  603.                         add entries rather than remove them. The added
  604.                         entry will be just like any other blank entry;
  605.                         it can be edited, ect. This option can also be
  606.                         accessed by pressing the Insert Key. If the
  607.                         Options menu is password protected, then the
  608.                         insert key will also be protected by the system
  609.                         password.
  610.                         
  611.               5) Exit to Main Menu
  612.  
  613.                         This option returns the user to the main
  614.                         MacroWare Menu.
  615.  
  616.        Please note that many of the options are currently not filled
  617.        with anything. They will be filled in future versions with
  618.        choices such as an option to print the current menu structure to
  619.        the printer, an option to delete branches of the tree easily, and
  620.        many other new and innovative MacroWare Software ideas.
  621.  
  622.  
  623.  
  624.  
  625.                                =================
  626.                                   RUN SPECIAL
  627.                                =================
  628.  
  629.        This option simply allows the user to enter command line
  630.        parameters and then run the currently highlighted program with
  631.        these parameters. To access this option, highlight the program
  632.        you want to run with parameters and the press ALT-R. You will
  633.        then be prompted by any password protection and then by a prompt
  634.        to enter the command line parameters that you want. Type the
  635.        parameters that you want to be passed to the program and then
  636.        press enter. Then the program will be executed with the
  637.        parameters and upon completion you will again return to the
  638.        MacroWare Menu.
  639.  
  640.  
  641.  
  642.  
  643.                               ====================
  644.                                  EXITING TO DOS
  645.                               ====================
  646.  
  647.        This option is completely self explanatory. When selected you
  648.        will quit out of the MacroWare Menu and will be returned to dos
  649.        or whatever other environment you were in before you started the
  650.        menu. This can be accomplished by pressing the escape key. If you
  651.        decided to password protect exit to dos you will first have to
  652.        enter the password before you will be permitted to leave the
  653.        program.
  654.  
  655.  
  656.  
  657.  
  658.                         ===============================
  659.                            MACROWARE MENU NAVIGATION
  660.                         ===============================
  661.  
  662.        Navigation through the MacroWare Menu is simple. In addition to
  663.        the system choices already described, there are also many other
  664.        keys on the keyboard to use. To move the highlight bar around the
  665.        menu you must use the up and down arrow keys. To select a choice
  666.        press enter on that choice or type the letter of the choice. To
  667.        back out of a particular submenu back to the previous submenu use
  668.        the tab key. The home key and end key will place you at the first
  669.        or last choice of the menu that you are in but will not select
  670.        that choice. In the main menu (first sublevel) the page up and
  671.        page down keys can be used the same as the home and end keys
  672.        respectively. However in the other two submenus the page up key
  673.        serves to move the choice in the previous menu up one. So if you
  674.        were in the second submenu of choice B in the main menu and you
  675.        pressed page up you would be taken to choice A in the main menu
  676.        and the current submenu would be updated. Similarly, if you were
  677.        in the third submenu of main choice B and second submenu choice
  678.        C, you would be taken to the third submenu of main choice B and
  679.        second submenu choice B. The current submenu will always be
  680.        updated to match the settings of your current location. The same
  681.        thing holds for page down except that instead of moving towards A
  682.        in the alphabet you would be moving away from A. Pressing page up
  683.        on A however causes the menu to select the last choice and
  684.        pressing page down on the last choice causes the menu to select
  685.        the first choice. While that is somewhat complex, it is easy to
  686.        see once you have your menu put together and you start navigating
  687.        through it. Just remember that you can use the page up and page
  688.        down keys. Next are the left and right arrow keys. The right
  689.        arrow key increases the level you are on by one if you are on the
  690.        main submenu or the second submenu. It simply takes you into the
  691.        submenu of the current choice. While in the third submenu it will
  692.        have no effect. The left arrow key functions the same as the tab
  693.        key as it moves you back one submenu. It has no effect if pressed
  694.        in the main submenu. Again this can be somewhat confusing but it
  695.        is quite evident once you start navigating the menu. Next,
  696.        pressing ALT-C will first prompt you for the system password. If
  697.        you get it you will be asked if you are sure you want to proceed.
  698.        The basic thing that this does is to reset the whole menu to its
  699.        original settings. If you choose to do this, all of your current
  700.        settings will be lost and there is no way to recover them so be
  701.        careful with this option. The final key is ALT-F. When you press
  702.        this a menu will pop up containing your current function key
  703.        definitions. To return to the menu from here, press escape. Here
  704.        is a brief synopsis of each navigational key:
  705.  
  706.  
  707.                 'A' - 'S'      ----- Pressing the letter of the choice
  708.                                      you want will select that choice
  709.                                      and either run the program or
  710.                                      proceed to the next submenu
  711.  
  712.                 ALT S   ----- Runs the setup.
  713.  
  714.                 ALT E   ----- Edits the current selection.
  715.  
  716.                 ALT D   ----- Runs the dos shell.
  717.  
  718.                 ALT O   ----- Produces system options menu.
  719.  
  720.                 ALT R   ----- Runs current program with command
  721.                                      line parameters.
  722.  
  723.                 ALT H   ----- Displays help screen.
  724.  
  725.                 ALT A   ----- Displays info about program.
  726.  
  727.                 Up Key         ----- Moves the highlight selector up
  728.  
  729.                 Down Key       ----- Moves the highlight selector down
  730.  
  731.                 Right Key      ----- On main and second submenu, moves
  732.                                      to the next submenu.
  733.  
  734.                 Left Key       ----- On the third and second submenu,
  735.                                      moves to the previous menu - SEE
  736.                                      ALSO Tab Key.
  737.  
  738.                 Home Key       ----- Moves the current menu selection to
  739.                                      A in all sub menus.
  740.  
  741.                 End Key        ----- Moves the current menu selection to
  742.                                      the last choice in all sub menus.
  743.  
  744.                 Page Up Key    ----- In main menu, moves current
  745.                                      selection to A. In other submenus
  746.                                      it increases the previous menu's
  747.                                      choice by one.
  748.  
  749.                 Page Down Key  ----- In main menu, moves current
  750.                                      selection to S. In other submenus
  751.                                      it decreases the previous menu's
  752.                                      choice by one.
  753.  
  754.                 Tab Key        ----- Moves to the previous submenu. SEE
  755.                                      ALSO Left Key.
  756.  
  757.                 Delete Key     ----- Deletes the current highlighted
  758.                                      entry and any subsequent sub levels
  759.                                      corresponding to it.
  760.  
  761.                 Insert Key     ----- Inserts a blank entry before the
  762.                                      Currently highlighted entry including
  763.                                      the insertion of the appropriate sub
  764.                                      sub levels.
  765.  
  766.                 ALT C          ----- Clears the current menu and resets
  767.                                      original settings. BE CAREFUL.
  768.  
  769.                 ALT F          ----- Displays a small window containing
  770.                                      the current function key
  771.                                      definitions.
  772.  
  773.                 F1 through F10 ----- These keys can be defined to run
  774.                                      programs in the setup. Pressing one
  775.                                      of these will run the program
  776.                                      defined in the setup.
  777.  
  778.                 Escape Key     ----- Exits to dos or original
  779.                                      environment. Also serves as a
  780.                                      backup key for most pop up windows.
  781.                                      Keep in mind however that if you
  782.                                      are changing settings it serves as
  783.                                      the save without exiting option.
  784.  
  785.        Movement through the MacroWare Menu has been made as easy as
  786.        possible and once you get the hang of it is quite effortless.
  787.  
  788.  
  789.  
  790.  
  791.                               ===================
  792.                                  SPECIAL NOTES
  793.                               ===================
  794.  
  795.        One unique thing about this program is that when you choose for
  796.        one of your choices in the main or second submenu to be a program
  797.        you can still access a submenu for that choice by pressing the
  798.        right key or by accessing a previous submenu and using the page up
  799.        and page down keys. Another, already discussed problem, is with
  800.        the dos shell. While it usually works, I have found some
  801.        instances where it will crash the menu and possibly cause me to
  802.        have to reboot the machine. I have not been able to pinpoint this
  803.        so again any detailed bug reports would be greatly appreciated.
  804.        The MacroWare Menu has been tested on many different system
  805.        configurations. It has been tested with QEMM, Hyperdisk
  806.        Utilities, Norton's Cache, EMM386, Microsoft's Smart Drive Disk
  807.        Cache, a clean system, and many others. There are no known bugs
  808.        in this version other than with the dos shell.
  809.  
  810.  
  811.  
  812.  
  813.                         ===============================
  814.                            WHAT'S NEW IN VERSION 2.0
  815.                         ===============================
  816.  
  817.        Version 2.0 includes several new features along with a few minor
  818.        bug fixes. Among the bugs encountered were those dealing with
  819.        password protection and the left, right, page up, and page down
  820.        keys. Some passwords were skipped when submenus or programs were
  821.        accessed with these keys. The dos shell seems to be working much
  822.        more reliably now as a minor change was made in that but it still
  823.        could encounter problems. A bug occurring when the machine is
  824.        rebooted while running a program (lost chains would occur) has
  825.        been fixed. To the registered version, a personalized logo has
  826.        been added that is displayed not only on the main menu screen but
  827.        also on the screen saver. The major addition to the menu is that
  828.        of the system info utility under options. Again this is available
  829.        only in the registered copy. Also added was the Alt F key
  830.        combination which will display your function key definitions
  831.        quickly and easily, and the Alt C key combination which is used
  832.        to clear the existing menu. In the future we hope to completely
  833.        eliminate any potential problems with the dos shell, add a file
  834.        "pick" routine so that you can page through your file directories
  835.        for the correct file names when you are adding programs to your
  836.        menu with the edit option, add an option to allow you delete
  837.        program entries and whole subdirectories from the menu, and we
  838.        also hope to add an option to print your menu structure out on
  839.        your printer.
  840.  
  841.  
  842.  
  843.  
  844.                         ===============================
  845.                            WHAT'S NEW IN VERSION 3.0
  846.                         ===============================
  847.  
  848.        Version 3.0 of the menu contains many new and exciting features
  849.        along with a barrage of bug fixes. More lost chain bugs have been
  850.        eliminated and the problem now seems to be basically completely
  851.        safe in that respect. Another notable bug fix is that dealing
  852.        with the reprinting of the menu entries when in the setup and
  853.        option menus. In previous versions it appeared as though the menu
  854.        became blank when these options were used. Many other minor
  855.        problems have also been solved. The most obvious addition to the
  856.        menu is now the option of being able to delete entries and
  857.        branches of the menu through the "OPTIONS" menu or with "CTRL D".
  858.        The only other major changes can be located in the System Setup.
  859.        A whole new option has been added here called "Setup Preferences"
  860.        which allows the user to specify some system preferences. The
  861.        prompt on exit can be turned on and off here, color or monochrome
  862.        can be specifed, and whether or not the user wants the new sound
  863.        of the menu on or off. Here alone are two completely new
  864.        features, the monochrome option, and the sound that now is
  865.        contained in the menu at various points. Before Version 4.0 is
  866.        released the menu will contain configurable colors, an insert
  867.        blank entry option, and a few other surprises. When Version 4.0
  868.        we will be striving to complete the "pick" routine for files,
  869.        error handling routines to prevent any crashes, and the option to
  870.        print your menu entries on the printer. We look forward to
  871.        continuing to improve upon the menu.
  872.  
  873.  
  874.  
  875.  
  876.  
  877.                                 ================
  878.                                    CONCLUSION
  879.                                 ================
  880.  
  881.        In concluding, I think this menu is truly useful and easy to use.
  882.        I wrote it because I was tired of the same old menus that I was
  883.        used to and it has some truly innovative (as far as I know)
  884.        ideas.  It does not take up much disk space either. For a
  885.        registration cost of only $10 I don't think you will find a better
  886.        menu anywhere. The MacroWare Menu will provide organization and
  887.        quick access to programs for most any computer. In the future
  888.        even more will be added to this menu in new releases. It
  889.        currently is not as fancy as many other menu programs but it does
  890.        perform its task of system organization as well, if not better
  891.        than others.  Thank you for using the MacroWare Menu!
  892.  
  893.  
  894.  
  895.  
  896.                  Written by David Carney of MacroWare Software
  897.                      Copyright (C) 1992 MacroWare Software
  898.                               All Rights Reserved
  899.