home *** CD-ROM | disk | FTP | other *** search
/ DP Tool Club 15 / CD_ASCQ_15_070894.iso / vrac / mm_300w.zip / MM.DOC < prev    next >
Text File  |  1993-10-02  |  66KB  |  1,287 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.                                    Menu Master (Tm)
  25.  
  26.                                      Version 3.00
  27.  
  28.  
  29.                                The Ultimate Menu Editor
  30.                                   For Remote Access
  31.  
  32.                           Copyright 1993 by Pegasus Software
  33.  
  34.                                   Fido : 1:2613/477
  35.  
  36.  
  37.                              Documentation Copyright 1993
  38.                                           by
  39.                                    Pegasus Software
  40.                                  Benjamin Schollnick
  41.                                          and
  42.                                     Rick Luquette
  43.  
  44.  
  45.  
  46.  
  47.  
  48.                                   Table of Contents
  49.  
  50.        Introduction  . . . . . . . . . . . . . . . . . . . . . . . . . . .   4
  51.  
  52.        The Real Basics . . . . . . . . . . . . . . . . . . . . . . . . . .   4
  53.  
  54.        Setting Up Menus  . . . . . . . . . . . . . . . . . . . . . . . . .   4
  55.             ANSIMode . . . . . . . . . . . . . . . . . . . . . . . . . . .   5
  56.             AutoMode . . . . . . . . . . . . . . . . . . . . . . . . . . .   5
  57.             Default_Prompt . . . . . . . . . . . . . . . . . . . . . . . .   5
  58.             Default_Sec  . . . . . . . . . . . . . . . . . . . . . . . . .   5
  59.             FlagA, FlagB, FlagC, and FlagD . . . . . . . . . . . . . . . .   5
  60.             HotKey_Edit  . . . . . . . . . . . . . . . . . . . . . . . . .   5
  61.             Linenumber . . . . . . . . . . . . . . . . . . . . . . . . . .   5
  62.             MultiPath  . . . . . . . . . . . . . . . . . . . . . . . . . .   5
  63.             Path1, Path2, and Path3  . . . . . . . . . . . . . . . . . . .   5
  64.             SecurityLevel  . . . . . . . . . . . . . . . . . . . . . . . .   5
  65.             ShowData . . . . . . . . . . . . . . . . . . . . . . . . . . .   5
  66.             Status_Line  . . . . . . . . . . . . . . . . . . . . . . . . .   5
  67.             Swap1  . . . . . . . . . . . . . . . . . . . . . . . . . . . .   5
  68.             Swap2  . . . . . . . . . . . . . . . . . . . . . . . . . . . .   6
  69.             SwapToEms  . . . . . . . . . . . . . . . . . . . . . . . . . .   6
  70.             TopMenu  . . . . . . . . . . . . . . . . . . . . . . . . . . .   6
  71.             WordWrap . . . . . . . . . . . . . . . . . . . . . . . . . . .   6
  72.  
  73.        Status Line . . . . . . . . . . . . . . . . . . . . . . . . . . . .   6
  74.  
  75.        Menus and Speed Keys  . . . . . . . . . . . . . . . . . . . . . . .   7
  76.             Add [Alt-A]  . . . . . . . . . . . . . . . . . . . . . . . . .   8
  77.             Copy [Alt-C] . . . . . . . . . . . . . . . . . . . . . . . . .  12
  78.             Copy Menu [Ctrl-C] . . . . . . . . . . . . . . . . . . . . . .  12
  79.             Delete [Alt-D] . . . . . . . . . . . . . . . . . . . . . . . .  13
  80.             Delete Menu [Ctrl-D] . . . . . . . . . . . . . . . . . . . . .  13
  81.             Edit [Alt-E] . . . . . . . . . . . . . . . . . . . . . . . . .  13
  82.             Global Change [Alt-G]  . . . . . . . . . . . . . . . . . . . .  13
  83.             HighLight [Alt-H]  . . . . . . . . . . . . . . . . . . . . . .  14
  84.             Insert [Alt-I] . . . . . . . . . . . . . . . . . . . . . . . .  15
  85.             List [Alt-L] . . . . . . . . . . . . . . . . . . . . . . . . .  15
  86.             New Menu [Ctrl-N]  . . . . . . . . . . . . . . . . . . . . . .  15
  87.             OS Shell [Ctrl-O]  . . . . . . . . . . . . . . . . . . . . . .  16
  88.             Prompt [Alt-P] . . . . . . . . . . . . . . . . . . . . . . . .  17
  89.             Rename Menu [Ctrl-R] . . . . . . . . . . . . . . . . . . . . .  17
  90.             Save Menu [Ctrl-S] . . . . . . . . . . . . . . . . . . . . . .  17
  91.             Settings [Alt-S] . . . . . . . . . . . . . . . . . . . . . . .  17
  92.             Write To Menu [Ctrl-W] . . . . . . . . . . . . . . . . . . . .  18
  93.  
  94.        Command Line Options  . . . . . . . . . . . . . . . . . . . . . . .  19
  95.  
  96.        Enhanced Menu Displays  . . . . . . . . . . . . . . . . . . . . . .  19
  97.  
  98.        Extended Path Switching . . . . . . . . . . . . . . . . . . . . . .  20
  99.  
  100.        Editing the Help File . . . . . . . . . . . . . . . . . . . . . . .  21
  101.  
  102.  
  103.  
  104.  
  105.  
  106.        Grouping  . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  22
  107.  
  108.        Speed Keys  . . . . . . . . . . . . . . . . . . . . . . . . . . . .  22
  109.  
  110.        Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  24
  111.  
  112.  
  113.  
  114.  
  115.  
  116.                                      Introduction
  117.  
  118.             Welcome  to  Menu Master,  the  Ultimate  Menu Editor  for  Remote
  119.        Access.  If you've used prior versions of  Menu Master then you want to
  120.        get  ready for possible culture  shock. Many things  have changed since
  121.        v1.20, but just as many have stayed the same.
  122.  
  123.             Menu Master is well named. It's  a Menu construction utility --  a
  124.        fully  functional and ready to  run Menu tool kit.  It gives you a user
  125.        friendly environment to  work in  while you  work on  your menus.  Menu
  126.        Master is a quantum leap forward  when compared to the Menu Editor that
  127.        comes  with Remote  Access, with  it's very  simplistic and  frequently
  128.        awkward controls.
  129.  
  130.             One  of Remote Access's most attractive features is its configura-
  131.        bility, thanks to the ability  to customize the Menus. Your users  will
  132.        spend most of  their time using your menus. A  good design will impress
  133.        them, while a poor one will confuse or bemuse them.
  134.  
  135.             Menu Master won't design the menus  for you. but it certainly will
  136.        make it easier  for you to discover the "one" style  of menus which you
  137.        will  like. The Remote Access  Menu Editor is  often awkward, sometimes
  138.        difficult to use, and  doesn't have a fully developed  simulation mode.
  139.        Menu Master  will simulate menus and let you see exactly what the users
  140.        will see when they are logged in.
  141.  
  142.  
  143.                                    The Real Basics
  144.  
  145.             Menu Master should run on any IBM compatible computer system. It's
  146.        been tested on  various 80x86  based computers including  8088 and  386
  147.        based systems. In fact, most of the development has been done on a 8088
  148.        based  machine so  performance should  be more  then adequate  on those
  149.        machines.
  150.  
  151.             No  special changes should  be necessary on  your system, although
  152.        you should have SHARE installed. Menu Master will automatically  detect
  153.        the RA environmental settings and use them to locate your configuration
  154.        files.
  155.  
  156.  
  157.                                    Setting Up Menus
  158.  
  159.             Menu  Master  can take  its  setup  information from  an  optional
  160.        configuration file called MM.CFG. This file sets the defaults that will
  161.        determine how Menu Master displays menus on startup. Since it is a text
  162.        file, you  can create it  with any standard  text editor. (A  sample is
  163.        included in the  release archive.) If you choose not  to create MM.CFG,
  164.        Menu Master will use its internal defaults which  can be changed within
  165.        the program.
  166.  
  167.             MM.CFG  consists of  keywords followed  by the  value you  wish to
  168.        assign  to that  option. It's  important to  remember that  MM.CFG only
  169.        controls the Simulation mode  settings when you first run  Menu Master;
  170.  
  171.  
  172.  
  173.  
  174.  
  175.        it has no  effect on the menus your users will  see. Any of the options
  176.        in MM.CFG  except the paths for  the MultiPath function  can be changed
  177.        from  within the program for the current  session only. Keywords may be
  178.        placed  in any order and are not case  sensitive, so they may be in all
  179.        upper case,  all lower case,  or any combination.  If a keyword  or the
  180.        entire configuration file is  missing, the default will be  used (shown
  181.        in brackets in the list below). Any line which begins  with a semicolon
  182.        or a carriage return will be  considered a comment; anything else  that
  183.        is not a valid keyword will cause an error message.
  184.  
  185.  
  186.             Here is a list of available keywords:
  187.  
  188.             ANSIMode [On]:  Determines the status of ANSI mode in your simula-
  189.                  tion.
  190.  
  191.             AutoMode  [Off]:   Determines  whether [Ctrl-A]  commands will  be
  192.                  activated by the simulation.
  193.  
  194.             Default_Prompt [Command:]: Sets the default prompt for new menus
  195.  
  196.             Default_Sec [5]: Sets the default security level to be used in the
  197.                  Insert and Add commands.
  198.  
  199.             FlagA, FlagB, FlagC, and FlagD [--------]: Controls simulated flag
  200.                  settings.
  201.  
  202.             HotKey_Edit [Off]: Determines the setting of the AutoEdit function
  203.                  at startup.
  204.  
  205.             Linenumber [On]:  Determines whether Line Numbers  will be visible
  206.                  on your simulation screen.
  207.  
  208.             MultiPath [Off]: Determines whether Menu Master will allow Extend-
  209.                  ed Path Switching.
  210.  
  211.             Path1,  Path2, and  Path3 [No Defaults]:  Sets paths  for Extended
  212.                  Path Switching.
  213.  
  214.             SecurityLevel [5]:  Determines the  Security Level you  will simu-
  215.                  late.
  216.  
  217.             ShowData [Off]: Determines whether  command type explanations will
  218.                  be shown.
  219.  
  220.             Status_Line  [On]:  Determines whether  the  status  line will  be
  221.                  displayed  at the bottom of your screen. When turned off, the
  222.                  menu  will look  exactly like  it will  be displayed  to your
  223.                  users. If a Type 40 ANSI/ASCII menu screen is displayed, then
  224.                  ANSI_Mode must also be turned ON.
  225.  
  226.             Swap1  [No default]: Specifies the  command to be  run by pressing
  227.                  [Alt-F1].  This function might be used to run an ANSI drawing
  228.                  program to edit ANSI menu screens.
  229.  
  230.  
  231.  
  232.  
  233.  
  234.             Swap2  [No default]: Specifies the  command to be  run by pressing
  235.                  [Alt-F2]. This function might be used to run a text editor to
  236.                  edit ASCII menu screens.
  237.  
  238.             SwapToEms [On] : Enables swapping to EMS when shelling to DOS with
  239.                  Ctrl-O.
  240.  
  241.             TopMenu [TOP.MNU]:  Identifies the  first menu  to be  loaded when
  242.                  starting Menu Master.
  243.  
  244.             WordWrap [Off]: Determines whether WordWrap will be ON or OFF.
  245.  
  246.  
  247.             To  use Menu Master, simply change to your Remote Access directory
  248.        and type  MM. After the opening  screens, you'll be placed  in the main
  249.        editing screen and shown TOP.MNU (or the menu identified by the TopMenu
  250.        keyword in  MM.CFG), and the status line  will appear across the bottom
  251.        of the screen if the Status_Line keyword in MM.CFG is set to ON.
  252.  
  253.  
  254.                                      Status Line
  255.  
  256.             If activated, the status line will show the following options in a
  257.        two line display that is too wide for the printed page (the settings of
  258.        the options will be determined by MM.CFG):
  259.  
  260.                                         Line 1
  261.  
  262.             F1:ANSI ON
  263.             F2:Data Mode OFF
  264.             F3:Numbers ON
  265.             F4:Ctrl-A Mode OFF
  266.             F5:Hot Edit ON
  267.  
  268.                                         Line 2
  269.  
  270.             TOP.MNU
  271.             S:32000 A:XXXXXXXX B:XXXXXXXX C:XXXXXXXX D:XXXXXXXX
  272.  
  273.             On  the first line, the status of  options is shown by the word On
  274.        or Off, as set in MM.CFG or by the defaults. Also, if your video system
  275.        supports  it, options  that  are on  are in  bright  white text,  while
  276.        options that are off are not highlighted. You can toggle the options to
  277.        the opposite state by pressing the indicated function key.
  278.  
  279.             F1   Toggles ANSI or ASCII mode. Shows how your screen will appear
  280.                  to users with and without ANSI capability.
  281.  
  282.             F2   Toggles Data  mode, which  gives you brief  information about
  283.                  each  menu option instead of  the display text.  Data mode is
  284.                  very useful if you are making menus featuring text file menus
  285.                  activated automatically by [Ctrl-A].
  286.  
  287.  
  288.  
  289.  
  290.  
  291.             F3   Toggles line numbers, which help you to pick the correct line
  292.                  to edit.
  293.  
  294.             F4   Toggles  Ctrl-A  mode. In  Ctrl-A  mode,  the simulator  will
  295.                  display a text file used  as the display for the menu.  Also,
  296.                  it will automatically  load Type 1,  Type 2, or Type  4 menus
  297.                  with a Ctrl-A  if this option  is ON. If you  need to Edit  a
  298.                  menu in which  you're using a Ctrl-A to call up another menu,
  299.                  turn this  option OFF and you will stop at the first menu and
  300.                  be allowed to edit the options in it.
  301.  
  302.             F5   Toggles Hotkey Editing. If ON, you'll automatically move into
  303.                  command edit mode when you press an activation key.
  304.  
  305.             F6   Allows  you to change the  security and flags  that are being
  306.                  simulated, and other configuration items.
  307.  
  308.             The second line shows the menu you are now editing and the securi-
  309.        ty  level and flag settings you are  simulating. [F6] allows you to see
  310.        how the menu  will appear to users at various  security levels and flag
  311.        settings, and  also to change some of the options in MM.CFG. Changes to
  312.        the MM.CFG settings are in effect for the current session only; to make
  313.        permanent changes, edit MM.CFG with any text editor.
  314.  
  315.             When Hotkey Edit is turned off, moving around from menu to menu is
  316.        as easy from  within Menu Master as  it is on  the BBS itself. You  can
  317.        move from one menu  to another by pressing the same key that would call
  318.        up the secondary menu on  your BBS. Some menu  types, such as Type  7's
  319.        and Type 15's,  will not activate but instead will  display a data line
  320.        telling you  the key's  function. If Hotkey  Edit is turned  on, you'll
  321.        automatically move into  command edit mode  by pressing the  activation
  322.        key.
  323.  
  324.  
  325.                                  Menus and Speed Keys
  326.  
  327.             You can  bring up the  menus within  Menu Master in  several ways.
  328.        Pressing [ESC] will give you the Main Menu. You can reach the File menu
  329.        by choosing  File from the Main  Menu, or by pressing  [Alt-F] from the
  330.        simulation screen. To  the left of  each menu option  is an Alt-Key  or
  331.        Ctrl-Key  combination (Speed  Keys)  that will  activate that  function
  332.        without  bringing down the  menu. Also, once  a menu is  shown, you can
  333.        press the first letter  of an option to activate it,  or move the high-
  334.        light to that line and press [Enter]. If you're using a  mouse, a click
  335.        on the  mouse key  will pull  down the Main  Menu, and  a click  on the
  336.        proper line will activate that option.
  337.  
  338.             When the main menu is activated, the following will be displayed:
  339.  
  340.                           ╒══════════MenuMaster═══════════╕
  341.                           │ File  Settings  Edit  Utility │
  342.                           ╘═══════════════════════════════╛
  343.  
  344.  
  345.  
  346.  
  347.  
  348.             The file menu presents the following display:
  349.  
  350.                            ╒══════════MenuMaster═══════════╕
  351.                            │ File  Settings  Edit  Utility │
  352.                            ╘═╒═════════════════════════╕═══╛
  353.                              │ New Menu     │ <Cntl-N> │
  354.                              │ Save         │ <Cntl-S> │
  355.                              │ Save As      │ <Cntl-W> │
  356.                              │ Rename Menu  │ <Cntl-R> │
  357.                              │ Copy Menu    │ <Cntl-C> │
  358.                              │ Delete Menu  │ <Cntl-D> │
  359.                              │ Quit         │ <Alt-X>  │
  360.                              ╘═════════════════════════╛
  361.  
  362.             On either menu, a highlight bar marks the current option. The file
  363.        menu can be called by  pressing [Alt-F] from the simulation screen,  by
  364.        pressing F from the Main Menu, by  moving the highlight bar to the File
  365.        line,  or by  bringing up the  Main Menu  and then using  your mouse to
  366.        click on the File line.
  367.  
  368.             The four  methods of choosing  an option are  functionally equiva-
  369.        lent.  At the beginning, you'll probably  call up menus and choose your
  370.        options, but soon you'll be using the Speed Keys like a pro!
  371.  
  372.             Here is a detailed explanation of each option in the Main and File
  373.        Menus. They are listed alphabetically.
  374.  
  375.             Add [Alt-A]: Allows you to add a command to  the end of your menu.
  376.        If you want  to add a command in the middle  of the menu, use Insert or
  377.        Copy and then Edit. Pressing [Alt-A] brings up the Add/Edit screen:
  378.  
  379.  
  380.  
  381.  
  382.  
  383.        ┌────────────────────────────────────────────────────────────────────┐
  384.        │                           Editing Entry #: 13                      │
  385.        │        1         2         3         4         5         6         │
  386.        │12345678901234567890123456789012345678901234567890123456789012345678│
  387.        │····································································│
  388.        │                                                                    │
  389.        │Optional Data:                                                      │
  390.        │····································································│
  391.        │                                                                    │
  392.        │Menu Type....>0··                                                   │
  393.        │Security.....>0···╓──────────────────────Keys In Use───────────────╖│
  394.        │Key..........>?   ║?0?H012CGP?                                     ║│
  395.        │ForeGround...>7·  ╙────────────────────────────────────────────────╜│
  396.        │BackGround...>0·                                                    │
  397.        │A Flags......>--------╔════════════════════Shift-FKeys═════════════╗│
  398.        │B Flags......>--------║ This information reproduced below because  ║│
  399.        │C Flags......>--------║ of space limitations on the printed page   ║│
  400.        │D Flags......>--------╚════════════════════════════════════════════╝│
  401.        │                   [F4] Extended Security Options                   │
  402.        │                  [F10] To Finish And Save Changes                  │
  403.        │                [ESC] To Abort Changes To This Entry                │
  404.        │[HOME]-Beginning of Line, [END]-End of Line, [INS]-Toggle Ins Mode  │
  405.        │            [F2]-Center Display Line, [F1]-Menu Type Help           │
  406.        └─────String To Appear On Menu, ^String^ Makes String Highlighted────┘
  407.        TEST.MNU     S:32000 A:XXXXXXXX B:XXXXXXXX C:XXXXXXXX D:XXXXXXXX
  408.  
  409.        ╒════════════════════════════════════════════════════╕
  410.        │ F1-┌ F2-┐ F3-└ F4-┘ F5-─ F6-│ F7-├ F8-┤ F9-┴ F10┬  │
  411.        │        (Use PgUp & PgDn To Change Char Set)        │
  412.        ╘════════════════════════════════════════════════════╛
  413.  
  414.             Adding menu options  is as easy as filling in  the blanks. The top
  415.        line is  the display line. Anything  you type here will  display on the
  416.        menu. If you leave it blank, the menu will show a blank line. Normally,
  417.        each  text line  is  followed  by  a  carriage  return,  but  adding  a
  418.        semi-colon  (;) at  the end  of the  line will  eliminate  the carriage
  419.        return. A  line containing only a  semi-colon will not affect  the menu
  420.        display at all.
  421.  
  422.             The numbers above the  line are to aid you in placing items on the
  423.        screen.  Be sure to  note the editing  keys shown at the  bottom of the
  424.        screen.  [F2] will  center  your data,  [F3]  allows selection  of  the
  425.        graphics  character set palette, [Home]  moves you to  the beginning of
  426.        the  line, [End]  to the  end of  the line,  and [Ins]  toggles between
  427.        Insert and Overtype mode. Including an up-carat (^) on the line toggles
  428.        between regular and highlight mode. In the following line:
  429.  
  430.                          This is a ^display line^ in the menu
  431.  
  432.        the words "display  line" would be  highlighted. The words "This  is a"
  433.        and  "in the  menu" would  both take on  the foreground  and background
  434.        colors specified on the Add/Edit screen.
  435.  
  436.  
  437.  
  438.  
  439.  
  440.             Be careful when using  the highlight (^) character in  text lines.
  441.        It will  appear to take  a character position  on the edit  screen, but
  442.        will  not  use a  space in  the actual  menu  display. Also,  using the
  443.        highlight (^) character  can produce some  interesting effects. If  you
  444.        have  your foreground set  to white and  your background  to blue, this
  445.        line will  have a blue  background beginning  all the way  at the  left
  446.        margin, and ending immediately after the last character:
  447.  
  448.                           This is a display line in the menu
  449.  
  450.        On the other hand, this line  will show the blue background only behind
  451.        the letters:
  452.  
  453.               ^                      ^This is a display line in the menu
  454.  
  455.        If you want the blue background to cover the entire line, use the first
  456.        example but pad it with spaces all the way to the end of the line.
  457.  
  458.             Other special  purpose keys in Add/Edit  Mode include [Ctrl-Enter]
  459.        and [F10], either of which  will save your work and then  return you to
  460.        Simulation Mode (if  you're in Edit  Mode), or  give you another  blank
  461.        command screen  (if you're in  Add Mode), and  [Esc], which  aborts the
  462.        changes on the  current command  screen and returns  you to  Simulation
  463.        Mode. [F1] also  has a  special function, described  under "Menu  type"
  464.        below.
  465.  
  466.             Pressing [PgUp] or [PgDn] flips through 100 special characters you
  467.        can include on the text lines  of your menus, or you can choose  from a
  468.        list  by pressing  [F3]. Use  the shifted function  key to  include the
  469.        graphics  character  in your  menu's  text  line. Remember  that  users
  470.        without IBM compatible equipment or that  do not have a suitable graph-
  471.        ics card might  not be able to display characters that are above 126 or
  472.        below 28  on the table  of ASCII  characters. Characters  below 28  and
  473.        character 127  are control  characters that control  various communica-
  474.        tions  functions, or  in  some cases  trigger  the display  of  special
  475.        information by the BBS.
  476.  
  477.  
  478.                  @    Displays the current file area
  479.                  `    Displays the current message area
  480.  
  481.        Menu type  defines which one of the available options will be called by
  482.        this command. A complete,  detailed list of Menu Types are  detailed in
  483.        the Remote Access instructions, but by pressing [F1] you  will be shown
  484.        a complete list of all available menu types.
  485.  
  486.             Security and A-D Flags  determine which users will have  access to
  487.        this command. A user must  have a security level at or above the speci-
  488.        fied limit AND  the specified flags  to use this  command. As a  sysop,
  489.        system  security should be your  most important concern,  so a thorough
  490.        understanding  of security levels  and flags is  necessary. By default,
  491.        Menu Master  places you in Insert mode, but this  can be a problem when
  492.        changing flags.  Since a  maximum of  eight flags  are allowed  on each
  493.        line,  and all eight are already set to [-], you won't be able to "add"
  494.  
  495.  
  496.  
  497.  
  498.  
  499.        an [X] character to toggle a flag on. Delete the [-] character or press
  500.        the [Insert] key to change to Typeover mode, and you'll be able to make
  501.        the changes.
  502.  
  503.             Key  is the character  your callers  will use  to select  the menu
  504.        option.  Alphabetical characters  will automatically  convert  to upper
  505.        case if necessary. Your users can use upper or lower case.
  506.  
  507.             Remember that many computers  that are not IBM compatible  may not
  508.        be able to generate all of the characters on the IBM-style keyboard, so
  509.        characters such as the brace ({}), the bracket ([]), the tilde (~), the
  510.        vertical line (|), and the backslash (\) should be avoided on  commands
  511.        you intend  for public access. Often characters such as these make good
  512.        choices for restricted access  commands, such as menus or  special read
  513.        commands for  your co-sysops as  many users  will not even  be able  to
  514.        generate them.
  515.  
  516.             Keys in  Use shows you which  keys already have a  function in the
  517.        current menu.  Once you  understand what you're  doing you can  use the
  518.        same  command more  than once  and let  it have  different effects  for
  519.        different users. For example,  you might want to install  two different
  520.        time banking programs.  The first  might allow users  to borrow  online
  521.        time. You probably won't want to let new users do that. The second door
  522.        might not  have that function, but will still allow users to save their
  523.        own time for later use. You can use the [B] command for both choices as
  524.        long as you follow three simple rules:
  525.  
  526.             1.   The most restrictive command must come first. Users who  meet
  527.                  the  security level  and  flag restrictions  will select  the
  528.                  first command and never get to the second.
  529.  
  530.             2.   The less restrictive command must come after the first.
  531.  
  532.             3.   Only include a text line on the least restrictive command.
  533.  
  534.             Simple enough? If you  set the first command at security level 10,
  535.        and  the second  command at security  level 5,  a user  with a security
  536.        level  of 10  will activate  the  first command,  while a  user with  a
  537.        security level  of 5 will activate  the second. If you  place the lower
  538.        security  level first,  the user  with the  higher security  level will
  539.        trigger the first command and never make it to the second.
  540.  
  541.             Foreground  and  Background set  the  colors that  users  who have
  542.        access to  the command will  see when the  text line displays  on their
  543.        screen. This applies only to  users who have chosen to use  ANSI graph-
  544.        ics. Colors  can add interest and  excitement to your  system, but they
  545.        can  also make  it  unreadable, especially  if  you use  certain  color
  546.        combinations such as dark gray on  black. Any combination that does not
  547.        produce  a high contrast  will be useless on  a monochrome system. Some
  548.        colors produce  underlined text in  monochrome, while others  blink! If
  549.        you don't have access to a monochrome system yourself, your best bet is
  550.        to ask a user you trust to let  you know if there are any areas on your
  551.        menus  that are useless to her/him. You'll  need to print out a list of
  552.  
  553.  
  554.  
  555.  
  556.  
  557.        your commands first  since your user won't be  able to report invisible
  558.        commands!
  559.  
  560.             Here is a list of available colors:
  561.  
  562.                  Black . . . . 0               Dark Gray . . . .  8
  563.                  Blue  . . . . 1               Light Blue  . . .  9
  564.                  Green . . . . 2               Light Green . . . 10
  565.                  Cyan  . . . . 3               Light Cyan  . . . 11
  566.                  Red . . . . . 4               Light Red . . . . 12
  567.                  Magenta . . . 5               Light Magenta . . 13
  568.                  Brown . . . . 6               Yellow  . . . . . 14
  569.                  Light Gray  . 7               White . . . . . . 15
  570.  
  571.             Only colors 1-7 can be used for background colors. If 8 is entered
  572.        for the background color, the command will blink; if 9  is entered, the
  573.        command will blink in reverse colors.
  574.  
  575.             Copy [Alt-C]: Allows you to copy  or move commands from one  place
  576.        on your menu to another. Pressing [Alt-C] gives the following display:
  577.  
  578.                       ╓───────────────────────────────────────╖
  579.                       ║ Copy Range Start Entry:1·             ║
  580.                       ║ Copy Range Ending Entry:1·            ║
  581.                       ║ Copy Range Before What Entry:1·       ║
  582.                       ║ Delete Source Entries?Y               ║
  583.                       ╙───────────────────────────────────────╜
  584.  
  585.             If you enter 1 as your start entry, 5 as your ending entry, and 10
  586.        as your destination  entry, and  answer No to  Delete Source  Entries?,
  587.        menu  items 1-5 will become items 10-14,  and previous #10 will move to
  588.        #15. If you answered Yes to Delete Source Entries?, then previous items
  589.        6-9 will  become 1-3; previous items  1-5 will become 4-9,  and item 10
  590.        will remain in place,  as will any other items  that follow. To add  an
  591.        item to the end of  the menu, enter a destination entry one higher than
  592.        the last line on  your menu. So if your  menu has 10 lines,  entering a
  593.        destination before line 11 would copy the entry to the end of the menu.
  594.  
  595.             Copy  Menu [Ctrl-C]: This command  allows you to  replace one menu
  596.        with another or create  a new menu as  a duplicate of a previous  menu.
  597.        You'll be shown the standard file display box (see page 65). Select the
  598.        file  you want to copy  (or type in the name  including the .MNU exten-
  599.        sion,  or another extension if appropriate), and you'll be prompted for
  600.        the destination name:
  601.  
  602.               ╓────────────────────────────────────────────────────────╖
  603.               ║Destination Menu Name: (.MNU Extension Assumed) ········║
  604.               ╙────────────────────────────────────────────────────────╜
  605.  
  606.             While  it is  necessary to type  in the  extension for  the source
  607.        file,  it is not necessary  to enter the  extension for the destination
  608.        menu name. This allows you to copy backup menus or  create "core" menus
  609.        for later use in  creating new menus. A core menu contains the shell of
  610.  
  611.  
  612.  
  613.  
  614.  
  615.        commands you will use on every menu. As an example,  suppose you wanted
  616.        every menu to have this basic structure:
  617.  
  618.             Menu Master v3.00
  619.             Menu Title Here
  620.  
  621.             (Individual menu commands go here)
  622.  
  623.             <G>oodbye Menu                     <Q>uick Bye
  624.             <-> Return to Previous Menu        <T>ime Remaining Online
  625.             <S>earch Userlog                   <R>eturn to Top Menu
  626.  
  627.             Time remaining: 9999 minutes Enter your command:
  628.  
  629.             You could create a special menu named CORE.MNU and duplicate it to
  630.        create  all your other menus. This will save you lots of time in creat-
  631.        ing  new menus.  For additional  protection, you  might want  to rename
  632.        CORE.MNU to  CORE.COR or CORE.!!! or some other name so Menu Master and
  633.        Remote Access will ignore it except when using the copy function.
  634.  
  635.             Delete  [Alt-D]: Allows you to  delete a command.  Use this option
  636.                  with caution as there are no second chances.
  637.  
  638.             Delete  Menu [Ctrl-D]:  Allows you  to  delete unwanted  menus and
  639.                  their  backup files. Choosing this  option brings up the File
  640.                  Display Box. As always, you can choose the menu to be deleted
  641.                  from the  display,  or type  in  the filename  and  extension
  642.                  yourself. Use this option with caution as there is no second-
  643.                  ary prompt to ask you if you're sure. Once you delete a file,
  644.                  it's gone forever! (Not really ... if you know how to recover
  645.                  deleted files through DOS, you can  retrieve it as long as it
  646.                  hasn't been overwritten.) 
  647.  
  648.             Edit  [Alt-E]: Allows you to  edit an existing  command. You'll be
  649.                  shown the following display:
  650.  
  651.                                 ╔═══════════════════╗
  652.                                 ║Edit Which Entry?1·║
  653.                                 ╚═══════════════════╝
  654.  
  655.                  Enter the line number you want to edit. You'll go to the Edit
  656.                  screen so you can update the menu. Remember to press [F10] to
  657.                  save your work. See the section on  Adding menu options for a
  658.                  complete discussion of Add/Edit  Mode. Remember that it's not
  659.                  necessary to press [Alt-E] if AutoEdit is turned on.
  660.  
  661.             Global  Change [Alt-G]: Allows you  to make changes  to several or
  662.                  even  all  of your  menus at  one  time. Pressing  [Alt-G] or
  663.                  choosing Global from the menu will present these choices:
  664.  
  665.  
  666.  
  667.  
  668.  
  669.                  ╒Choose What to Change╕
  670.                  │Visible Text         │
  671.                  │Optional Data        │
  672.                  │Menu Type            │ ********* NOTE **********
  673.                  │Security Level       │ * The Flags can be      *
  674.                  │HotKey               │ * accessed by scrolling *
  675.                  │ForeGround           │ * Down farther          *
  676.                  │BackGround           │ *************************
  677.                  │Hi-ForeGround        │
  678.                  │Hi-BackGround        │
  679.                  │Prompt-ForeGround    │
  680.                  │Prompt-BackGround    │
  681.                  ╘═════════════════════╛
  682.  
  683.                  This function  is similar to the  Global Search/Replace func-
  684.                  tion of  many word  processors. If  you choose Display  Text,
  685.                  you'll be shown this display:
  686.  
  687.             NOTE: On String Searches, Only An Exact Match Will Be Replaced.
  688.  
  689.           ╓Enter The Display String To Search For:────────────────────────╖
  690.           ║·······························································║
  691.           ╙───────────────────────────────────────────────────────────────╜
  692.  
  693.           ╓Enter The Replacement Display String:──────────────────────────╖
  694.           ║·······························································║
  695.           ╙───────────────────────────────────────────────────────────────╜
  696.  
  697.                  After  entering the  search string,  you'll be shown  the re-
  698.                  placement string  menu. Menu  Master will search  through the
  699.                  text lines on all of your menus and replace them according to
  700.                  your instructions. If you  have the following line on  all of
  701.                  your menus:
  702.  
  703.                            <^G^>oodbye -- Logof the system
  704.  
  705.                  you can  use this  feature  to correct  your spelling  error!
  706.                  Enter the incorrect line  under "Enter The Display String  To
  707.                  Search For," and the corrected line under "Enter The Replace-
  708.                  ment Display String." Only exact matches will be replaced, so
  709.                  if you  leave out a  character (including  the highlight  (^)
  710.                  character), the replacement will not be made.
  711.  
  712.                  The  next screen  will  be file  display  box, by  using  the
  713.                  [Space] bar,  mark  those menus  you want  to have  searched.
  714.                  Other menus will be ignored. Menu Master will search  through
  715.                  the marked menus, making replacements as warranted.
  716.  
  717.                  All other options are almost the  same, varying only slightly
  718.                  in  the display. For example, if you choose HotKey, you'll be
  719.                  asked for the menu hotkey rather than the display text.
  720.  
  721.             HighLight [Alt-H]: Allows you  to change foreground and background
  722.                  colors of highlight text.
  723.  
  724.  
  725.  
  726.  
  727.  
  728.             Insert [Alt-I]: Inserts a command into a menu. You'll be shown the
  729.                  following display:
  730.  
  731.                             ╓───────────────────────────╖
  732.                             ║Insert Before What Entry?1·║
  733.                             ╙───────────────────────────╜
  734.  
  735.                  Enter  the line number you  want the new  command to precede,
  736.                  and you'll be brought to a blank Edit screen so you can enter
  737.                  the new command.
  738.  
  739.             List [Alt-L]: Lists the commands that make up the menu. First, you
  740.                  must decide whether you want to print the list:
  741.  
  742.                                  ╓──────────────────╖
  743.                                  ║List To Printer? N║
  744.                                  ╙──────────────────╜
  745.  
  746.                  If you say [No], the list will display on your screen. If you
  747.                  say  [Yes], the list will be printed on the printer. Pressing
  748.                  [Esc] will  abort the  printout. Either  way, it  will follow
  749.                  this format:
  750.  
  751.                  1  Str:<^P^>ost Messages in Current Area         ;
  752.                  Menu Type:27  Sec:0     Key:P    Foreground:4   BackGround: 7
  753.                  DATA:
  754.                  FLAGS> A:-------- B:-------- C:-------- D:--------
  755.  
  756.                  2  Str:<^R^>ead Messages in Current Area         ;
  757.                  Menu Type:23  Sec:0     Key:R    Foreground:4   BackGround: 7
  758.                  DATA:
  759.                  FLAGS> A:-------- B:-------- C:-------- D:--------
  760.  
  761.                  3  Str:<^D^>etail Scan of Current Area           ;
  762.                  Menu Type:24  Sec:0     Key:D    Foreground:4   BackGround: 7
  763.                  DATA:
  764.                  FLAGS> A:-------- B:-------- C:-------- D:--------
  765.  
  766.                  4  Str:<^B^>asic Scan of Current Area            ;
  767.                  Menu Type:25  Sec:0     Key:B    Foreground:4   BackGround: 7
  768.                  DATA:
  769.                  FLAGS> A:-------- B:-------- C:-------- D:--------
  770.  
  771.                  This condensed  format may  seem confusing  at first,  but it
  772.                  presents  all of the information shown on the edit screen for
  773.                  each command. In  this case, nearly  all commands have  their
  774.                  security  levels set  to 0  and flags  are all  reset because
  775.                  access is  determined in the individual  message bases rather
  776.                  than at the menu level.
  777.  
  778.             New Menu  [Ctrl-N]: Calls up  a new  menu for you  to simulate  or
  779.                  edit. You'll be  shown a  list of all  available menu  files,
  780.                  from which you  can select the one you want,  or you can type
  781.                  out the name. The menu list will resemble this one:
  782.  
  783.  
  784.  
  785.  
  786.  
  787.           ╒═════════════════════ D:\RA\MENUS\*.MNU ════════════════════════╕
  788.           │                                                                │
  789.           │ [C:]           LOBBY.MNU      OLGAMES2.MNU   REPORTS.MNU       │
  790.           │ [E:]           MCITY.MNU      OLGAMES3.MNU   S-VERM.MNU        │
  791.           │ [F:]           MCSGAME.MNU    OLGAMES4.MNU   SYSOP.MNU         │
  792.           │ ..\            MCSMENU.MNU    OLGAMES5.MNU   TERM.MNU          │
  793.           │ COMBINED.MNU   MESSAGES.MNU   OLGAMES6.MNU   TOP.MNU           │
  794.           │ DL-QBBS.MNU    MULTINOD.MNU   OLGAMES7.MNU   TOP_1.MNU         │
  795.           │ DOORS.MNU      NET_MAIL.MNU   PEGASUS.MNU    TOP_2.MNU         │
  796.           │ FILES.MNU      OLGAMES.MNU    QMX.MNU                          │
  797.           │ LIBRARY.MNU    OLGAMES1.MNU                                    │
  798.           │                                                                │
  799.           ╘Select File or Type <FileName>═══<Space> to Change Display Mode═╛
  800.  
  801.             Pressing the space bar will give a more detailed display
  802.  
  803.           ╒═════════════════════ D:\RA\MENU\*.MNU ════════════════════════╕
  804.           │ [C:]                           OLGAMES1.MNU   3/18/93  8:12p  │
  805.           │ [E:]                           OLGAMES2.MNU   4/20/93  7:00a  │
  806.           │ [F:]                           OLGAMES3.MNU   3/18/93  8:12p  │
  807.           │ ..\            9/ 8/92  9:08a  OLGAMES4.MNU   4/ 6/93  8:17a  │
  808.           │ COMBINED.MNU   3/18/93  8:11p  OLGAMES5.MNU   3/18/93  8:12p  │
  809.           │ DL-QBBS.MNU    5/ 2/93  9:20a  OLGAMES6.MNU   3/18/93  8:12p  │
  810.           │ DOORS.MNU      3/18/93 10:04p  OLGAMES7.MNU   3/18/93  8:11p  │
  811.           │ FILES.MNU      4/ 1/93  9:14a  PEGASUS.MNU    3/18/93  8:12p  │
  812.           │ LIBRARY.MNU    3/18/93  8:11p  QMX.MNU        3/18/93  8:12p  │
  813.           │ LOBBY.MNU      6/16/93  5:30p                                 │
  814.           ╘Select File or Type <FileName>═══<Space> to Change Display Mode╛
  815.  
  816.                  Use the up and down arrow keys  to scroll the list if its too
  817.                  long to fit on the screen at one time.
  818.  
  819.                  Select the  menu you want  to simulate or edit  by moving the
  820.                  highlight over the  desired menu,  or click on  it with  your
  821.                  mouse, or  type in the  menu name. If  you enter a  name that
  822.                  doesn't exist, you'll be  asked if you want to create it from
  823.                  scratch, which is usually not a good idea.
  824.  
  825.             OS Shell [Ctrl-O]: Allows you to drop into DOS. Handy for renaming
  826.                  files to an  extension other  than *.MNU.  This function  re-
  827.                  quires about 307 KB of available memory, so if you're using a
  828.                  multitasker or have shelled from Remote Access and don't have
  829.                  that much memory available, it won't work.
  830.  
  831.                  After  dropping to DOS, you'll see a display like the follow-
  832.                  ing:
  833.  
  834.                 Menu Master v3.00 Shell Active.  Type EXIT to Return.
  835.  
  836.                          Microsoft(R) MS-DOS(R) Version 5.00
  837.                         (C)Copyright Microsoft Corp 1981-1991.
  838.  
  839.                                [MenuMaster v3.00 Shell]
  840.             D:\RA>
  841.  
  842.  
  843.  
  844.  
  845.  
  846.                  Menu Master will swap out of memory, but you still might  not
  847.                  have enough memory left  to do heavy duty work.  Your display
  848.                  will  show information on the  version of DOS  loaded on your
  849.                  system.  To return to Menu  Master, type EXIT  and press [En-
  850.                  ter].
  851.  
  852.             Prompt  [Alt-P]: The Prompt is the line  at the bottom of the menu
  853.                  that you use  to tell  callers to enter  their command.  This
  854.                  function allows you to change the prompt's text and colors.
  855.  
  856.             Rename Menu [Ctrl-R]: First you're asked for the new name:
  857.  
  858.                 ╓───────────────────────────────────────────────────╖
  859.                 ║Rename What Menu? (.MNU Extension Assumed) ········║
  860.                 ╙───────────────────────────────────────────────────╜
  861.  
  862.                  If you press  [Enter], you'll  see a file  display box,  that
  863.                  will allow you to select the menu that you want to rename.
  864.  
  865.                  After selecting the menu  to be renamed, you're prompted  for
  866.                  the new name:
  867.  
  868.                 ╓───────────────────────────────────────────────────╖
  869.                 ║Rename What Menu? (.MNU Extension Assumed) ········║
  870.                 ╙───────────────────────────────────────────────────╜
  871.                   ╓─────────────────────────────────────────────────╖
  872.                   ║Enter New Name: (.MNU Extension Assumed) ········║
  873.                   ╙─────────────────────────────────────────────────╜
  874.  
  875.                  Enter  the new name without the .MNU extension, which will be
  876.                  added automatically.
  877.  
  878.                  Pressing [Esc]  aborts any  option in Menu  Master until  the
  879.                  menu  is actually saved. As  an extra precaution, Menu Master
  880.                  stores the previous  version of your menu  with the extension
  881.                  .BAK. Once you're sure the  menu is the way you want  it, you
  882.                  can delete the .BAK file.
  883.  
  884.             Save Menu [Ctrl-S]: Saves the menu you're working on.
  885.  
  886.             Settings [Alt-S]: Brings up the main menu with Settings highlight-
  887.                  ed. Pressing [Enter] brings down the Settings menu:
  888.  
  889.  
  890.  
  891.  
  892.  
  893.                           ╒══════════MenuMaster═══════════╕
  894.                           │ File  Settings  Edit  Utility │
  895.                           ╘═══════╒═══════════════════════════════╕
  896.                                   │ Ansi Mode            │ F1     │
  897.                                   │ Data Mode            │ F2     │
  898.                                   │ Line Numbers         │ F3     │
  899.                                   │ Autoexec Mode        │ F4     │
  900.                                   │ Hot Key Editing      │ F5     │
  901.                                   │ Change Configuration │ F6     │
  902.                                   │ Redraw Menu          │ F7     │
  903.                                   │ MultiPath Control    │ F8     │
  904.                                   │ Change Language      │ F9     │
  905.                                   │ Edit Help File       │ <None> │
  906.                                   ╘═══════════════════════════════╛
  907.  
  908.                  As before, you  may either  choose an option  from the  menu,
  909.                  click on  it with your mouse,  or use the Speed  Key (in this
  910.                  case,  the function key). Speed keys work even if the menu is
  911.                  not showing, so they really do speed things up.
  912.  
  913.                  Pressing [F6] will allow you to change the simulated security
  914.                  level and flag settings, and the system configuration:
  915.  
  916.                ╒════════════Menu Master Global Settings══════════════╕
  917.                │            General Configuration Settings           │
  918.                │                                                     │
  919.                │ Emulated Security Level? 64000                      │
  920.                │ Emulated Flag A: XXXXXXXX                           │
  921.                │ Emulated Flag B: XXXXXXXX                           │
  922.                │ Emulated Flag C: XXXXXXXX                           │
  923.                │ Emulated Flag D: XXXXXXXX                           │
  924.                │                                                     │
  925.                │                  Other Settings                     │
  926.                │                                                     │
  927.                │ Menu Data is Shown? N       Ansi Mode is On? Y      │
  928.                │ Autodisplay is On? N        Line Numbers is On? Y   │
  929.                │ MultiPath is On? N          Word Wrap is Active? N  │
  930.                │ Swapping to EMS Memory? Y   Status Line is Shown? Y │
  931.                │ Edit by Hotkeys? Y                                  │
  932.                ╘═════════════════════════════════════════════════════╛
  933.  
  934.                  The  information on the top half of the screen duplicates the
  935.                  settings on the status line, while the bottom half allows you
  936.                  to edit settings in MM.CFG (see page 53).
  937.  
  938.             Write To  Menu [Ctrl-W]: After you have loaded a menu into Simula-
  939.                  tion/Edit mode, this option will allow you to save it under a
  940.                  different  name. You can add  any extension you  like. If you
  941.                  don't  put an extension, Menu  Master will add  .MNU for you.
  942.                  There  are  no safety  precautions, so  it's  easy to  make a
  943.                  mistake  and overwrite the wrong menu. It's safer to copy the
  944.                  menu  to the new file first, and  then edit it under it's new
  945.                  name.
  946.  
  947.  
  948.  
  949.  
  950.  
  951.                                  Command Line Options
  952.  
  953.             There are two command line options available for use with MM.EXE:
  954.  
  955.             -D:  This is  the "Directory"  Command, it  causes Menu  Master to
  956.                  begin by displaying the Ctrl-N directory listing.
  957.  
  958.             -Q:  The "Quick" Command, it allows registered users to bypass the
  959.                  opening screen.
  960.  
  961.             These options may also be set with an environmental variable:
  962.  
  963.                                    SET MM=DIR QUICK
  964.  
  965.        using either one or both options, if you're a registered user.
  966.  
  967.  
  968.                                 Enhanced Menu Displays
  969.  
  970.             Once  you  have your  BBS running  successfully,  you may  want to
  971.        become more creative  and design  customized menus to  display to  your
  972.        users. This is  most often  done with automatically  executing Type  40
  973.        menu commands, although Type 5 and Type 45 could also be used.
  974.  
  975.             All three of these commands display a *.A?? file to  the user, who
  976.        actually  sees a  file with  the extension  of ANS  if he/she  has ANSI
  977.        graphics enabled, and a file with the extension of ASC if ANSI graphics
  978.        are disabled. The advantage of the  Type 40 command over Type 5  is the
  979.        availability of Hot Keys. When menus use hot keys, commands take effect
  980.        immediately without  forcing the user to wait for the entire menu to be
  981.        displayed. This is especially appreciated by long distance callers when
  982.        the sysop chooses  to use elaborate  animated menus,  which can take  a
  983.        relatively long time to draw. If a Type 40 command is used, the display
  984.        will be interrupted if the caller enters any valid menu command.
  985.  
  986.             In  contrast, a Type  5 display may  also be used,  but the caller
  987.        will  be forced to view the entire  menu before making a selection. The
  988.        Type 45 command, which forces the caller to press [Enter] at the end of
  989.        the  display, is not  very useful for  menu displays. The  rest of this
  990.        section will assume that you will use Type 40 displays.
  991.  
  992.             In order to create customized displays, you will need to either be
  993.        extremely  familiar with ANSI color and positioning commands, or use an
  994.        ANSI editor  such as TheDraw. You can  be as creative as  you like, but
  995.        remember that animation and color changes will slow your menu displays,
  996.        especially for users calling at slower baud rates.
  997.  
  998.             The technique for using enhanced  menu displays with Remote Access
  999.        is a simple one. As  the first command on  your menu, create a Type  40
  1000.        command using [Ctrl-A] as the activation key, and with the menu name on
  1001.        the  optional data line. This will automatically display the named file
  1002.        each time the menu is accessed. Create ANSI and ASCII  versions of your
  1003.        menu and  store them in your  Text Files directory. You  must have both
  1004.  
  1005.  
  1006.  
  1007.  
  1008.  
  1009.        ANSI and ASCII versions, or callers who have ANSI displays toggled  off
  1010.        will not see any display at all!
  1011.  
  1012.             Now  that you  have  created your  menu,  you must  eliminate  the
  1013.        built-in  menu displays. Edit  each command and delete  any text in the
  1014.        display line. Insert a semi-colon [;] as the only character, indicating
  1015.        that  you don't even want a carriage  return. Don't forget to edit your
  1016.        Prompt to eliminate text displays.
  1017.  
  1018.             When creating your ANSI  menus, keep in mind that commands  on the
  1019.        menu will  be displayed to everyone  even if they don't  have access to
  1020.        the command. Using the technique described, you can have more than  one
  1021.        command using  the same activation key, or commands which do not appear
  1022.        on the menu at all. You can even create  more than one menu display and
  1023.        control which users  see which menu with flags and  security levels, or
  1024.        use the language function  to control displays. Be careful  because the
  1025.        more elaborate  your security gets, the more  likely it is that someone
  1026.        will "fall through the cracks" and end up seeing no display at all!
  1027.  
  1028.             Enhanced menu displays involve a lot more maintenance than regular
  1029.        menu displays. Each time you modify your menu, you must use Menu Master
  1030.        to edit the *.MNU file, your ANSI editor to edit the *.ANS file,  and a
  1031.        text editor (or your ANSI editor) to edit the *.ASC file. Forgetting to
  1032.        edit any  of these  will prevent  your users from  taking advantage  of
  1033.        changes  to your  system, since  they won't  know about  them. Enhanced
  1034.        displays can  create an atmosphere for  your system through the  use of
  1035.        "theme" menu displays, or provide additional assistance  for your users
  1036.        through the use of highlights, blinking text, etc.
  1037.  
  1038.  
  1039.                                Extended Path Switching
  1040.  
  1041.             MM.CFG  includes this function for sysops who run Remote Access in
  1042.        a  multinode or network environment.  Extended Path Switching, which is
  1043.        activated with the MultiPath keyword, allows you to edit menus residing
  1044.        in multiple directories identified with the Path keywords.
  1045.  
  1046.             The  menu path listed in  RACONFIG.EXE in your  main Remote Access
  1047.        directory  or  in the  directory  in which  you  started MM.EXE  is the
  1048.        standard directory in which  Menu Master looks for your  menu files. If
  1049.        MultiPath is set to On,  up to three other paths can also be used. Each
  1050.        path must be  identified in MM.CFG with the keywords  Path1, Path2, and
  1051.        Path3. Use the [F8] key to choose alternate directories.
  1052.  
  1053.             MultiPath can be  toggled from within Menu Master,  but it must be
  1054.        set  up in MM.CFG for Extended Path  Switching to be available, and all
  1055.        paths not listed in  RACONFIG.EXE must be identified with  Pathn state-
  1056.        ments.
  1057.  
  1058.             MultiPath  functions  like  the  directory setting  in  many  word
  1059.        processors. If  you change  paths and  then  save your  menu, you  will
  1060.        either save the menu to the wrong directory, or perhaps even replace an
  1061.        existing menu that you did not  want to change. Menu Master will obedi-
  1062.        ently follow your  instructions even  if it causes  the replacement  of
  1063.  
  1064.  
  1065.  
  1066.  
  1067.  
  1068.        valuable data, so  if you activate Extended Path  Switching, be sure to
  1069.        use it with caution!
  1070.  
  1071.  
  1072.                                 Editing the Help File
  1073.  
  1074.             Pressing  [F1] while adding or  editing menu commands  brings up a
  1075.        help screen  of available menu  types. First, you  are given a  list of
  1076.        menu types grouped according to function, and then a sequential list.
  1077.  
  1078.             Menu  Master allows you to edit  the menu types, choose the groups
  1079.        to which it belongs, and specify default settings.
  1080.  
  1081.             Choosing Edit Help File  from the Settings menu will give you this
  1082.        display:
  1083.  
  1084.         ╒════════════════════════════Entry # : 0════════════════════════════╕
  1085.         │                                                                   │
  1086.         │              Shown from Help Display                              │
  1087.         │                                                                   │
  1088.         │If Chosen, Import Data into Menu? N                                │
  1089.         │Help Description: Text Line (Not Considered a Command)·            │
  1090.         │Help Options    : None·································            │
  1091.         │Which Groups....: --------                                         │
  1092.         │                                                                   │
  1093.         │              What will be Imported if Chosen                      │
  1094.         │                                                                   │
  1095.         │Display.......: ···················································│
  1096.         │Optional Data : ···················································│
  1097.         │                                                                   │
  1098.         │Security Level: 0····                                              │
  1099.         │ForeGround....: 0                                                  │
  1100.         │BackGround....: 0                                                  │
  1101.         │A Flag........: --------                                           │
  1102.         │B Flag........: --------                                           │
  1103.         │C Flag........: --------                                           │
  1104.         │D Flag........: --------                                           │
  1105.         ╘═══════════════════════════════════════════════════════════════════╛
  1106.  
  1107.             Use the [PgUp]  and [PgDn] keys  to move from  one menu option  to
  1108.        another, and the [Tab] or arrow keys to move around the edit screen.
  1109.  
  1110.             Here are the available options:
  1111.  
  1112.             If  Chosen, Import Data  into Menu? If  set to Yes,  data from the
  1113.        bottom of the  screen will be  set as a  default if  this menu type  is
  1114.        chosen.
  1115.  
  1116.             Help  Description: The information that will appear on the left of
  1117.                  the help line, next to the menu type number.
  1118.  
  1119.             Help Options: The information that will appear on the right of the
  1120.                  help line.
  1121.  
  1122.  
  1123.  
  1124.  
  1125.  
  1126.             Which Groups: Specifies grouping  of menu types for the  help dis-
  1127.                  play.  Each command can belong to more than one group; simply
  1128.                  set the flag for the group(s) you wish to use.
  1129.  
  1130.             Display: The default display line if this menu type is added.
  1131.  
  1132.             Optional  Data: The  default optional  data if  this menu  type is
  1133.                  added.
  1134.  
  1135.             Security  Level: The default security  level if this  menu type is
  1136.                  added.
  1137.  
  1138.             ForeGround:  The  default foreground  color if  this menu  type is
  1139.                  added.
  1140.  
  1141.             BackGround:  The default  background color  if this  menu  type is
  1142.                  added.
  1143.  
  1144.             A/B/C/D  Flag:  The default  flag settings  if  this menu  type is
  1145.                  added.
  1146.  
  1147.  
  1148.                                        Grouping
  1149.  
  1150.             Remote  Access uses a concept called Grouping, which allows you to
  1151.        customize the display of file and  message areas while running the BBS,
  1152.        and menu  types within Menu Master. The Grouping concept is the same in
  1153.        all cases.
  1154.  
  1155.             Grouping of menu types serves a slightly different function, since
  1156.        it allows  you to group menu  types according to function.  There is no
  1157.        benefit to  your users at  all; in fact,  since the menu  type grouping
  1158.        applies  only to MenuMaster's help function, your users won't even know
  1159.        it exists. Within  Menu Master,  you can group  message commands,  file
  1160.        commands, user status commands,  etc. The menu types are  shown grouped
  1161.        when you press  [F10]; a  list in numerical  order follows the  grouped
  1162.        list.
  1163.  
  1164.             To accomplish grouping,  Remote Access uses binary  math, which is
  1165.        the  "ones and zeros" that make up  the nuts and bolts of computers. In
  1166.        binary ("base 2"), the decimal number 1 is represented as "00000001", 2
  1167.        is "00000010", three is "00000011", etc. A group of eight binary digits
  1168.        ("bits") is called a "byte"; 1024 bytes are a "kilobyte" (Kbyte, KB, or
  1169.        just K);  and a thousand kilobytes  are a megabyte (Mbyte,  or MB). One
  1170.        megabyte is not a million bytes, but actually 1024*1000=1,024,000. That
  1171.        also explains why  640K is not  640,000 but actually  1024*640=655,360.
  1172.        And that concludes the math lesson.....
  1173.  
  1174.  
  1175.                                       Speed Keys
  1176.  
  1177.             The following Speed Keys are active in Simulation Mode:
  1178.  
  1179.             Alt-A     Add a command
  1180.  
  1181.  
  1182.  
  1183.  
  1184.  
  1185.             Alt-C     Copy/Move commands
  1186.             Alt-D     Delete a command
  1187.             Alt-E     Edit a command
  1188.             Alt-F     Access File Menu
  1189.             Alt-G     Make Global changes
  1190.             Alt-H     Change Highlight colors
  1191.             Alt-I     Insert a command
  1192.             Alt-S     Change Settings (Flags &  Security Level) being simulat-
  1193.        ed.
  1194.             Alt-L     List menu commands
  1195.             Alt-P     Edit Prompt string and colors
  1196.             Alt-X     Exit Menu Master
  1197.             Ctrl-C    Copy a menu
  1198.             Ctrl-D    Delete a menu
  1199.             Ctrl-N    Edit a different menu
  1200.             Ctrl-O    DOS Shell
  1201.             Ctrl-R    Rename a menu
  1202.             Ctrl-S    Save the current menu
  1203.             Ctrl-W    Write (save) to a new name
  1204.  
  1205.  
  1206.             The following speed keys are active in Edit mode:
  1207.  
  1208.             F1        Finish and Save Changes
  1209.             F2        Center Display Line
  1210.             F3        Select from graphics palette
  1211.             F10       Menu Type Help
  1212.             END       Move to End of Line
  1213.             ESC       Abort Changes To This Entry
  1214.             HOME      Move to Beginning of Line
  1215.             INS       Toggle Insert Mode
  1216.  
  1217.  
  1218.  
  1219.  
  1220.  
  1221.                                         Index
  1222.  
  1223.        *.ANS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  20
  1224.        *.ASC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  20
  1225.        *.MNU . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  16, 20
  1226.        Add [Alt-A] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
  1227.        ANSI  . . . . . . . . . . . . . . . . . . . . . . . . . 5, 6, 11, 18-20
  1228.        ANSI Graphics . . . . . . . . . . . . . . . . . . . . . . . . .  11, 19
  1229.        BBS . . . . . . . . . . . . . . . . . . . . . . . . . . . 7, 10, 19, 22
  1230.        Caution . . . . . . . . . . . . . . . . . . . . . . . . . . . .  13, 20
  1231.        Colors  . . . . . . . . . . . . . . . . . . . 9, 11, 12, 14, 17, 22, 23
  1232.             Background colors  . . . . . . . . . . . . . . . . . . . 9, 12, 14
  1233.             Monochrome . . . . . . . . . . . . . . . . . . . . . . . . . .  11
  1234.        Configuration Files . . . . . . . . . . . . . . . . . . . . . . . . . 4
  1235.        Copyright . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1, 16
  1236.        Ctrl-A  . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  6, 7
  1237.        Default . . . . . . . . . . . . . . . . . . . . . . . . . 5, 10, 21, 22
  1238.        Directories . . . . . . . . . . . . . . . . . . . . . . . . . . . .  20
  1239.        Display Files
  1240.             ASCII  . . . . . . . . . . . . . . . . . . . . .  5, 6, 10, 19, 20
  1241.        Door  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  11
  1242.        Doors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  16
  1243.        DOS Paths
  1244.             Menu Path  . . . . . . . . . . . . . . . . . . . . . . . . . .  20
  1245.        DOS Shell . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  23
  1246.             EXIT . . . . . . . . . . . . . . . . . . . . . . . . .  16, 17, 23
  1247.        Editor  . . . . . . . . . . . . . . . . . . . . . .  1, 4, 6, 7, 19, 20
  1248.        EMS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6, 18
  1249.        Environmental variable  . . . . . . . . . . . . . . . . . . . . . .  19
  1250.        File area . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  10
  1251.        Grouping  . . . . . . . . . . . . . . . . . . . . . . . . . . .  21, 22
  1252.        Hot keys  . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  19
  1253.        Insert [Alt-I]  . . . . . . . . . . . . . . . . . . . . . . . . . .  15
  1254.        Line Number . . . . . . . . . . . . . . . . . . . . . . . . . .  13, 15
  1255.        Memory  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16-18
  1256.        Menu Files  . . . . . . . . . . . . . . . . . . . . . . . . . .  15, 20
  1257.             TOP.MNU  . . . . . . . . . . . . . . . . . . . . . . . . . . 6, 16
  1258.        Menu Path . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  20
  1259.        Message area  . . . . . . . . . . . . . . . . . . . . . . . . . . .  10
  1260.        Multinode . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  20
  1261.        Other Options . . . . . . . . . . . . . . . . . . . . . . . . . . .  14
  1262.             ANSI Graphics  . . . . . . . . . . . . . . . . . . . . . .  11, 19
  1263.        Pegasus Software  . . . . . . . . . . . . . . . . . . . . . . . . . . 1
  1264.        Security  . . . . . . . . . . . . . . . . 5, 7, 9-11, 14, 15, 18, 20-22
  1265.             Restrictions . . . . . . . . . . . . . . . . . . . . . . . . .  11
  1266.        Security Level  . . . . . . . . . . . . .  5, 7, 10, 11, 14, 18, 21, 22
  1267.        SHARE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
  1268.        Special Characters  . . . . . . . . . . . . . . . . . . . . . . . .  10
  1269.             ^  . . . . . . . . . . . . . . . . . . . . . . . . . . . 9, 10, 14
  1270.             >  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9, 13
  1271.             |  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  11
  1272.             ~  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  11
  1273.        Status  . . . . . . . . . . . . . . . . . . . . . . . . .  5, 6, 18, 22
  1274.        Structure . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  12
  1275.  
  1276.  
  1277.  
  1278.  
  1279.  
  1280.        System security . . . . . . . . . . . . . . . . . . . . . . . . . .  10
  1281.             Flags  . . . . . . . . . . . . . . . . .  7, 9, 10, 14, 15, 20, 22
  1282.             Security Levels  . . . . . . . . . . . . . . . . . . 7, 10, 15, 20
  1283.        TopMenu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
  1284.        Types of access
  1285.             Read . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  11
  1286.             Sysop  . . . . . . . . . . . . . . . . . . . . . . . .  10, 16, 19
  1287.             Write  . . . . . . . . . . . . . . . . . . . . . . . . . .  18, 23