home *** CD-ROM | disk | FTP | other *** search
/ Media Share 9 / MEDIASHARE_09.ISO / bbs / popmax1.zip / DOCUMENT.POP < prev    next >
Text File  |  1993-06-16  |  28KB  |  723 lines

  1.   June 15, 1993
  2.  
  3.   +---------------------------------+
  4.   |          PopMax!                |
  5.   |          v. 1.0                 |
  6.   |      Allan Bowhill, 1993        |
  7.   +---------------------------------+
  8.   +---------------------------------------------------+
  9.   | Allan Bowhill                                     |
  10.   | 7714 196th St #204                                |
  11.   | Edmonds, WA 98026                                 |
  12.   | BBS support (206) 775-4765 - State Express BBS    |
  13.   | Fidonet 1:343/555                                 |
  14.   | Internet: Allan.Bowhill@f555.n343.z1.fidonet.org  |
  15.   +---------------------------------------------------+
  16.  
  17.  
  18.  
  19.  
  20.                              Type C for Contents
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒T0▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  30.  
  31.  
  32.                   This macro is free, but {Commo} isn't....
  33.  
  34.  
  35.                        Register your copy of {Commo}!
  36.           
  37.  
  38.  
  39.               PopMax has an internal mechanism to display your
  40.                  {Commo} registration name and number online.
  41.             
  42.              Each time the menus are initialized, a snapshot of your
  43.           opening screen will be copied to your disk. Your registration
  44.                number and name will be displayed to your users.
  45.  
  46.    If you don't have a valid registration number, it will show to your users.
  47.  
  48.                      - Do not disable this feature! -
  49.  
  50.                   Show your users that you have registered!
  51.                        
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒TC▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  58.  
  59.                              Help     Contents
  60.  
  61.  Section               Topic                      Access Keys      
  62.  -------               -----                      -----------
  63.  
  64.  Introduction         Register {Commo}                    T0         
  65.                       Disclaimer                          TA        
  66.                       Files included                      TB        
  67.                       System requirements                 TD        
  68.                       Program description                 TE        
  69.  Startup              Quick start                         TF        
  70.  Customizing PopMax   Menu structure                      TH        
  71.                       How menus are displayed             TI        
  72.                       Modifying and compiling menus       TJ        
  73.                       Option types                        TK        
  74.                       Constructing menus                  TL        
  75.  Using PopMax         Using arrow-keys                    TN        
  76.  
  77.  
  78.  ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒TA▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  79.  
  80.                                   ∙NOTICE∙
  81.                                    ~~~~~~
  82.  
  83.   NOTICE from the Author:
  84.   ~~~~~~~~~~~~~~~~~~~~~~~
  85.   This is a test release of POPMAX! Menus for Maximus v. 1.0.
  86.   This means it is still under development. I do not guarantee that this
  87.   macro will work for you.
  88.  
  89. RISK
  90.   You use this software at your own risk.
  91.   I will not be held libel for any consequential damages from the use of 
  92.   these macos and data files.
  93.  
  94. FEES
  95.   You may use this macro, as long as you do not remove, modify, or disable 
  96.   the subroutines that display to remote callers your:
  97.  
  98.                     1. {Commo} registration number
  99.                     2. {Commo} registered name
  100.                     3. {Commo} version number
  101.  
  102.   If used in an institututional setting, I ask that you notify me of the 
  103.   company that is using it, and the number of copies in use. There is no 
  104.   charge for use.
  105.   
  106. SUPPORT
  107.    BBS support can be obtained by calling State Express (206) 775-4765.
  108.    I will try to answer any questions that you have.
  109.  
  110. INELLECTUAL PROPERTY
  111.    Allan Bowhill (the author) retains all intellectual property rights
  112.    guaranteed under the U.S. Constitution, and international law. You 
  113.    are not permitted to distribute this macro in anything other than its 
  114.    original form.
  115.  
  116. CREDITS
  117.    {Commo} is a trademark of Fred P. Brucker
  118.    Maximus-CBCS is a product of Scott J. Dudley
  119.  
  120.  
  121.  
  122.  ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒TB▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  123.  
  124.  
  125.                               ∙Files Included∙
  126.  
  127.  
  128.  
  129.  
  130.         There are twelve (12) files enclosed in the POPMAX1.ZIP archive:
  131.  
  132. README.1ST     Basic startup instructions
  133. INSTALL.BAT    Installation batch file
  134. INSTALL.POP    Installation Macro
  135. TAGMENU.POP    Information to be added to Menus.Ctl during installation
  136. DOCUMENT.POP   This document
  137. GUI_HLP.POP    Online help screen for users
  138. OUTLINE.POP    Menu options as you define them
  139. POPDATA.POP    Compiled version of above file
  140. COMPILE.POP    Macro to compile menu options into above data file
  141. POPMAX.POP     Main macro, executed online
  142. POPMENU.MEC    Displayed via Maximus when user selects option
  143. POPMAX.MEC     User information. Creates .DEF file
  144.  
  145.  
  146.  ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒TD▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  147.  
  148.  
  149.                            ∙System Requirements∙
  150.  
  151. In order to run this beta release properly, you will need the following
  152. equipment and files.
  153.  
  154.             1. An IBM AT computer.
  155.  
  156.             2. A hard disk.
  157.  
  158.             3. A *REGISTERED* COPY of Commo v. 5.41 
  159.                An unregistered version will not work!!
  160.  
  161.             4. A working Maximus BBS 2.0 or higher
  162.  
  163. This macro is pre-configured to use the following programs in your MAXIMUS
  164. Home path:
  165.               
  166.                     1.  Silt.Exe
  167.                     2.  Mecca.Exe
  168.                     3.  {Commo} 5.41
  169.  
  170.  
  171.  ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒TE▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  172.  
  173.                             ∙Program Description∙
  174.  
  175. POPMAX! is a set of online ansi pop-down menus for Maximus BBS. It is acts
  176. as a door program that utilises Maximus' comprehensive Mecca token language
  177. to give your BBS interactive ansi menus.
  178.  
  179. Interactive ansi menus differ from regular ansi menus, because they work
  180. on a graphical principle. Your users may select any option based on the
  181. movement of a selector bar at a variety of levels.
  182.  
  183. Popmax works as a 'script' file inside Fred Brucker's efficient {Commo}
  184. terminal program. When someone logs in to your Maximus system, and enters
  185. the Popmax menus, they will be able to use their arrow-keys to select any
  186. option in Maximus, in a familiar and intuitive environment.
  187.  
  188. You, as the sysop, can use the interface locally with the added advantage
  189. of mouse support, and special control and information features. You can
  190. also use the interface (and mouse) while someone is logged-on to your system.
  191.  
  192. Here are a few of the features:
  193.  
  194.      - Configurable and definable pop-down menus - make your own options
  195.      - Optional mouse support for local and online sysop functions
  196.      - Selectable color or black-and-white ansi emulation
  197.      - Accessible help files for users
  198.      - Easy-access online documentation
  199.      - Online sysop screen with security features
  200.      - Online user information bar
  201.      - No 'helper' utilities are used - 100 percent {Commo} reliability
  202.      - Special data file design - fast reads, minimal disk activity
  203.      - Special precautions taken against 'ansi-bleed' at high speeds
  204.      - Optimized escape sequences for fast data transmission
  205.      - Support for locked baud rates, or non-locked rates
  206.  
  207.  
  208. HISTORY
  209. -------
  210.  
  211. Originally, this project of developing a pop-down menu interface for Maximus
  212. started with the H.A.L. series. The H.A.L. macro series enabled users of
  213. a Maximus BBS to use interactive ansi online in the form of little pop-up
  214. boxes with a scrolling menu bar. The last in the series (HALGUI1F.XXX)
  215. was the last bug fix. 
  216.  
  217. The little GUI turned out to be very slow, however, and had a certain
  218. lack of appeal, due to the speed. The menus also weren't -true- pop-down
  219. menus. I had done all my personal testing of these menus with a 2400 
  220. baud modem, and the lack of speed was less apparant. 
  221.  
  222. Most of HAL's slowness was due to slow data file reads, so I set out on a 
  223. project (about 3 or 4 months ago) to redo the menus completely. Since then 
  224. I have been testing and revising the new version. I have also given the 
  225. menus a new name, and there have been many improvements.
  226.  
  227.  
  228.  ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒TF▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  229.  
  230.  
  231.  
  232.                                 ∙Quick-Start∙
  233.  
  234.  
  235. 1. Move a *registered* version of {Commo} 5.4 or above, (with all
  236.    commo data files) into your Maximus home directory.
  237.  
  238. 2. Unzip the POPMAX archive in your Maximus home directory.
  239.  
  240. 3. Type `INSTALL' from the DOS prompt, in the Maximus home directory.
  241.    You will guided through a series of steps to assist you in setup.
  242.  
  243. 4. Compile with Silt.Exe, and logon!
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒TH▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  251.  
  252.  
  253.                                  Menu Structure
  254.                             ∙Explanation and Analogy∙
  255.  
  256.    The outline file is organized much the same way an essay or speech
  257.    outline is -- in a topical hierarchy. Each line in the outline file has
  258.    an associated `level', (from 1 to 8 -- represented by successive dashes)
  259.    as each line in a speech outline has an associated number or letter.
  260.  
  261.    Speech Outline                        Outline.Pop
  262.    ``````````````                        ```````````
  263.    I. Introduction       <- level 1 ->   -menuBar choice a
  264.    II. Subject           <- level 1 ->   -menubar choice b
  265.        A. Topic          <- level 2 ->   --popdown menu choice a (from b)
  266.           1.  subtopic   <- level 3 ->   ---popdown menu subchoice
  267.    III. Subject          <- level 1 ->   -menu bar choice c
  268.           1. Topic       <- level 2 ->   --popdown menu choice a (from c)
  269.           2. Topic       <- level 2 ->   --popdown menu choice b (from c)
  270.        /                                                            \
  271.       +-----+                                                        \
  272.             |                                                         \
  273.        ------------------------------------------------------------    \
  274.        a level-one item: Roman numerals (I,II,III,IV,V,IV...)           \
  275.        a level-two item: Uppercase English letters (A,B,C,D,E...)        \
  276.        a level-three item: Arabic numerals (1,2,3,4,5...)                 \
  277.        a level-four item: Lower case English letters (a,b,c,d,e...)        \
  278.        a level-five item: Arabic numerals (1,2,3,4,5...)                    \
  279.        ------------------------------------------------------------          |
  280.                                                                              |
  281.                    -------------------------------------                     |
  282.                    level one    -  (one dash)                                |
  283.                    level two    --  (two dashes)                             |
  284.                    level three  ---  (three dashes)      --------------------+
  285.                    level four   ----  (four dashes)
  286.                    level five   -----  (five dashes)
  287.                    level six    ------  (six dashes)
  288.                    level seven  -------  (seven dashes)
  289.                    level eight  --------  (eight dashes)
  290.                    --------------------------------------
  291.  
  292.  
  293.  ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒TI▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  294.  
  295.  
  296.                             ∙How menus are displayed∙
  297.  
  298.  ┌───────────────────┐     ┌─────────────┐     ┌───────────────────────┐
  299.  │  Maximus BBS      ├──»──┤ Popmax Menu ├──»──┤ Popmax.Bbs displayed  ├──»─┐
  300.  └───────────────────┘     │ is entered  │     │ as custom MenuFile    │    │
  301.      ┌────────»────────────┤             │     └───────────────────────┘    │  
  302.      │                     └─────────────┘                                  │  
  303.      └───■─────────────«─────────────■──────────────«────────────■──────────┘  
  304.  ┌───────┴────────┐            ┌─────┴─────┐         ┌───────────┴────────────┐
  305.  │ Mecca compiles │            │  {Commo}  │         │ Popmenu.mec displayed  │
  306.  │ Choice.Mec     │····        └─────┬─────┘         └───────────┬────────────┘
  307.  └───────┬────────┘   :       ┌──────┴───────┐         ┌─────────┴──────────┐
  308.    ┌─────┴───────┐    :       │ Popmax Macro │·········│ Popmax.Def written │  
  309.    │ Choice.Bbs  │    :       └──────┬───────┘         └────────────────────┘  
  310.    │  displayed  │    :      ┌───────┴─────────┐     
  311.    └─────┬───────┘    :      │ Option selected │        ╔═════════════════════╗
  312.  ┌───────┴────────┐   :      │ from Ansi GUI   │        ║       Popmax!       ║
  313.  │ Mecca command  │   :      └───────┬─────────┘        ║  Process Flowchart  ║
  314.  │ excuted online │   :  ┌───────────┴──────────────┐   ╠═════════════════════╣
  315.  └────────────────┘   ···│ Associated Mecca token   │   ║  ■  sub-process     ║
  316.                          │ written to Choice.Mec    │   ║ ··· input file link ║
  317.                          └───────────┬──────────────┘   ║ ─── execution path  ║
  318.                               ┌──────┴───────┐          ║ « » program flow    ║
  319.                               │ Exit {Commo} │          ╚═════════════════════╝
  320.                               └──────────────┘
  321.  
  322.  
  323.    Each line in the outline file represents an option in one of the menus
  324.    in PopMax. All options that are in level one (1) will be placed in the
  325.    menu bar at the top of the screen. All other options will be end up
  326.    in pop-down panels, or pop-down subpanels. The borders of the panels
  327.    are specially deigned to accentate the differences between panels.
  328.  
  329.      [ This command was selected ]
  330.              |
  331.              |                       <top of screen>
  332. Main Menu  Message Menu  File Menu  Change settings  Exit GUI menus  Goodbye
  333.  
  334.            ▌▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▐▀▀▐
  335.            ▌ Areas            ▐a ▐
  336.            ▌ Upload a Message ▐  ▐<----- pop down panel
  337.            ▌ Post a message   ▐<-------- pop down subpanel
  338.            ▌ Kill a message   ▐  ▐
  339.            ▌ Edit a message   ▐  ▐
  340.            ▌▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▐  ▐
  341.            ▌ Goodbye             ▐
  342.            ▌▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▐
  343.  
  344. information bars are always at bottom of screen
  345.  |
  346. Escape key exits : Keep mouse still : Use buttons only : Double-click if stuck
  347.  
  348.  
  349.  ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒TJ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  350.  
  351.  
  352.                          ∙Modifying and compiling Menus∙
  353.  
  354.    PopMax's menus are fully customizable and configurable. You can add
  355.    your own menu options, or modify and delete ones that have been included
  356.    in the original archive.
  357.  
  358.    PopMax is capable of displaying 23 options on any menu or submenu, and 8
  359.    levels of submenus can be created. This means almost 200 options can be 
  360.    encorporated into the outline file.
  361.  
  362.    Customizing PopMax menu items is a two-step process:
  363.  
  364.        1. Modify the outline file (POPDATA.POP) to add, delete or
  365.           edit options.  You can edit the outline file via your 
  366.           favorite text editor, or by selecting `Edit outline file'
  367.           from the sysop menu.
  368.  
  369.        2. Compile this file by selecting `Compile new outline file'
  370.           from the sysop menu. 
  371.  
  372.  
  373.  ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒TK▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  374. Page 10
  375.                                   ∙Option Types∙
  376.  
  377.         Each option in the outline file is placed on a single line.
  378.         There are two types of options in the outline file.
  379.  
  380.         1. Submenu-calling option:  calls a submenu
  381.         2. Command-executing option:  executes a Commo/Mecca command
  382.  
  383.       * When you create a submenu-calling option, you must also create an
  384.         associated menu.
  385.  
  386.  A submenu-calling option has:
  387.           1. No associated command
  388.           2. Precedes the first option of the menu it calls
  389.           3. Precedes a menu level that is one greater in value
  390.  
  391.  A command-executing option has:
  392.           1. An associated command
  393.           2. Will never precede a menu level greater than itself
  394.  
  395.  
  396.  ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒TL▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  397.  
  398.  
  399.                               ∙Constructing Menus∙
  400.  
  401.    In the PopMax outline file, each individual pop-down menu and submenu
  402.    must have an assigned menu level. When a submenu-calling option is selected
  403.    items of the next level are `gathered' to form a new menu on the screen.
  404.  
  405.    In the speech outline, sub-topics can be summarized by `gathering'
  406.    items of a particular level. For example, if a summary is needed of
  407.    The Four Misconceptions of Social Responsibility, one would first locate
  408.    the topic header:
  409.  
  410.        A. Subject 1             <- level 2
  411.  
  412.    Then `gather' the item headers under that topic:
  413.  
  414.           1. Topic 1      <- level 3
  415.           2. Topic 2      <- level 3
  416.           3. Topic 3      <- level 3
  417.           4. Topic 4      <- level 3
  418.  
  419.  
  420.    Regarding the menus, the same rule applies. If an item is selected,
  421.    the the item headers under that option are gathered to form a new submenu.
  422.  
  423.    Selected Item: Post (message)
  424.    Associated text in outline file: -Post`'
  425.    Option-Type: Submenu-calling
  426.    Yeilds screen output:
  427.  
  428.                                      <top of screen>
  429. Main Menu  Message Menu  File Menu  Change settings  Exit GUI menus  Goodbye
  430.  
  431.            ▌▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▐▀▀▐
  432.            ▌ Areas            ▐a ▐
  433.            ▌ Upload a Message ▐  ▐<----- pop down panel
  434.            ▌ Post a message   ▐<-------- pop down subpanel
  435.            ▌ Kill a message   ▐  ▐
  436.            ▌ Edit a message   ▐  ▐
  437.            ▌▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▐  ▐
  438.            ▌ Goodbye             ▐
  439.            ▌▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▐
  440.  
  441.  
  442. Items that were gathered:
  443. -------------------------
  444.  
  445. --Post`'                                                      <- level 2
  446. ---Areas`[message][menu_cmd Area_Change]Message'              <- level 3
  447. ---Upload a Message`[message][menu_cmd Msg_Upload]message'    <- level 3 
  448. ---Post a message`[message][menu_cmd Enter_Message]message'   <- level 3 
  449. ---Kill a message`[message][menu_cmd Msg_Kill]message'        <- level 3 
  450. ---Edit a message`[mesage][menu_cmd Msg_Change]message'       <- level 3 
  451. <gethering terminates here>
  452.  
  453.  
  454.                              ∙Constructing Options∙
  455.  
  456.    To construct individual options in OUTLINE.POP, three fields must be
  457.    included, and entered in a prescribed format. Unlike a speech outline,
  458.    there is no room for error in organization or syntax. If information
  459.    is absent or misplaced, results may be unpredictable while using.
  460.  
  461.    After constructing new options, select `compile' from the sysop menu, 
  462.    to activate them.
  463.  
  464.    The three fields each line requires are:
  465.  
  466.            Menu_Level        Item_Descriptor         ^([Mecca Token]^)
  467.  
  468.                1                    2                        3
  469.  
  470.  
  471.              -----------====[ Field #1 - Menu_Level ]====----------
  472.  
  473.    These are represented by dashes only -- at least one, no more than eight.
  474.    The number of concurrent dashes designate the menu level for that option.
  475.  
  476.     Valid types:
  477.                    level one    -  (one dash)
  478.                    level two    --  (two dashes)
  479.                    level three  ---  (three dashes)
  480.                    level four   ----  (four dashes)
  481.                    level five   -----  (five dashes)
  482.                    level six    ------  (six dashes)
  483.                    level seven  -------  (seven dashes)
  484.                    level eight  --------  (eight dashes)
  485.  
  486.  
  487.  
  488.            ---------====[ Field #2 - Item_Decriptor]====-----------
  489.  
  490.    Item_Descriptor is the text that will appear in any menu as a selectable
  491.    description of that option.
  492.  
  493.        For Example:
  494.                               Quote
  495.                               Message Menu
  496.                               Change Area
  497.                               
  498.  
  499.  
  500.         ------------====[ Field #3 - ^(Mecca Token^)]====-----------
  501.  
  502.    This field contains the associated Mecca token to display when the
  503.    option is selected from the menus. Three things must be satisfied
  504.    in order for this field to work.
  505.  
  506.    1. If the item that calls a submenu, this field should be left
  507.       blank, without ^(^) or [] 
  508.  
  509.    -  If it is a command-executing option, Item_Action must be a valid
  510.       self-contained Mecca command (or series of commands), executable
  511.       by display. It is important to remember that you are in the POPMAX
  512.       menu, and all Mecca tokens should be designed with this in mind.
  513.  
  514.       In other words, if you wish to design a mecca token to perform a 
  515.       command from the Change menu, write it like this :
  516.  
  517.                     [Menu_Cmd (menu option)]Change
  518.         
  519.       This way, Maximus will know which menu you are referring to.
  520.  
  521.       Additional steps must be taken if you wish to refer to menu options
  522.       from the Message or File menus. For some reason, Maximus does not
  523.       recognize all plain references (as above) to calls of options in 
  524.       Message or File areas, so it is important to `fool' Maximus' internal
  525.       pointers into thinking it's in the Message or File area before calling
  526.       a menu option.
  527.  
  528.       Example:
  529.  
  530.                    [Menu_Cmd Area_Change]Message   <-- won't work
  531.  
  532.           [message][Menu_Cmd Area_Change]Message   <-- will work
  533.  
  534.       So, use the Menheader mecca tokens ([message], [file]) before calls
  535.       to these menus.
  536.  
  537.  
  538.       Such as:
  539.                       [Quote] - displays a quote
  540.                       [ckoff] - turns control-c checking off
  541.                       [Menu_Cmd Statistics]Main  - Displays Stats   
  542.  
  543.    2. The whole command must be enclosed with Commo's substitute for curly
  544.       braces: ^( and ^)
  545.  
  546.                       ^(   open curly braces
  547.                       ^)   closed curly braces
  548.  
  549.       If a submenu is called, these and the mecca tokens are unnecessary.
  550.  
  551.    3. Lastly, the entire text of the 3rd field (including the curly-brace
  552.       substitutes) must be enclosed with small quotes: ` and '
  553.  
  554.                       ` open small-quote      
  555.                       ' closed small-quote
  556.  
  557.       If the option is a call to a submenu, there isn't anything inside 
  558.       these quotes. The third field simply appears as a: `'
  559.  
  560.       Valid texts for this field would be:
  561.  
  562.                 `'                              <----- calls a submenu
  563.                 `^([Menu_Cmd chg_video]Change^)'
  564.                 `^([message][menu_cmd area_change]Message^)'
  565.                 `^([Quote])'
  566.  
  567.    Finally, when a line is composed in OUTLINE.POP, the three fields
  568.    must be merged together to form a continuous line, and placed flush
  569.    up against the left margin.
  570.  
  571.    For example:
  572.  
  573. +------>
  574. |       Change Video Mode`^([Menu_Cmd chg_video]Change^)'
  575. |       Change Message Area`^([message][menu_cmd area_change]Message^)'
  576. |       See Quote`^([Quote])'
  577. |        
  578. +----->
  579.    \
  580.     left margin
  581.    
  582.  Additional Notes:
  583.  
  584.  *  The outline file must contain one blank line after the last option.
  585.  
  586.  *  Each line in the outline file may contain short comments to the right
  587.     of the 3rd field. They will be ignored during the compiling stage.
  588.  
  589.  *  Within limits, multiple Mecca tokens may be included in one option.
  590.     However, they must appear back-to-back, and the composite third field
  591.     must be enclosed with one pair of small quotes. Also, they must occupy
  592.     one line only. Multiple commands will execute in the sequence in which
  593.     they appear in the third field.
  594.  
  595.  ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒TN▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  596.  
  597.                            ∙Using the Arrow-Keys∙
  598.  
  599.     You can use the arrow-keys to select options from the menu bar or the
  600.     pop-down menus, by hitting the appropriate arrow-key (next to the
  601.     numeric keypad on your computer)
  602.  
  603.      Pop-down: moves selector up   UPA     Menu bar, Offline: clears screen
  604.                                     |      Online, 1st press: redraws menu bar
  605.                                     |              2nd press: clears screen
  606.                                     |
  607.                     LFA<------------+------------>RTA
  608.      Menu bar: moves selector left  |
  609.      Pop-down: moves back 1 menu    |       menu bar: moves selector to right
  610.                                     |       pop-down: selects option
  611.                                     |
  612.                                     v
  613.                                    DNA   Menu bar: selects option
  614.                                          pop-down: moves selector down
  615.  
  616.  
  617.  ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒TO▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  618.  
  619.                           SYSOP LOGINS
  620.  
  621. If you login locally, you will see a blue menu bar at the top of the screen.
  622. Most menus will be represented by an option on this bar.
  623.  
  624. You can move around the menus with your arrow-keys (located next to the 
  625. shift-key on 101-style keyboards), or use the three mouse buttons to move.
  626.  
  627. UP-ARROW will redraw the menu bar.
  628. DOWN-ARROW will select the option hilighted in red and yellow.
  629. RIGHT-ARROW will move the selctor bar right
  630. LEFT-ARROW will move the selector bar left
  631.  
  632. If you select an option, (DOWN-ARROW) a pop-down panel will display
  633. containing the menu options for that menu. At this point:
  634.  
  635. UP-ARROW will move the selector bar up an option
  636. DOWN-ARROW will move the selector bar down an option
  637. RIGHT-ARROW will select an option
  638. LEFT-ARROW will revert to the last menu, (or the menu bar)
  639.  
  640.  
  641. SYSOP SCREEN
  642. ````````````
  643. Either locally, or while online, there is a sysop menu you will be able to
  644. access, by pressing the F1 or escape and F1 while someone,is online.
  645.  
  646. It contains eight commands:
  647.  
  648. X eXit to max menus
  649. S Sysop menu control (disables user)
  650. U User menu control (disables sysop)
  651. H Hangup
  652. N Compile new outline file
  653. E Edit outline file
  654. D Read POPMAX Docs
  655. Q Halt Macro
  656. ----------------------
  657. X - Exit to max Menus
  658. ----------------------
  659.  
  660. This will return you to the regular Maximus menus.
  661.  
  662. -------------------------------------
  663. S - Sysop menu control (disable user)
  664. -------------------------------------
  665.  
  666. This will remove the ability of the user to ontrol the menus while online.
  667. You may select options for the user after this is pressed.
  668.  
  669.  
  670. -----------------------------------
  671. U User menu control (disbles sysop)
  672. -----------------------------------
  673.  
  674. This will allow you to return control back to the user while online.
  675. Pressing this key in local mode prints a lot of junk to the screen.
  676.  
  677.  
  678. --------
  679. H Hangup
  680. --------
  681.  
  682. This will hangup on the user.
  683.  
  684.  
  685. --------------------------
  686. N Compile new outline file
  687. --------------------------
  688.  
  689. This will compile a new outline file into a data file.
  690. The outline file contains the menu options, and is fully configurable.
  691.  
  692.  
  693. -------------------
  694. E Edit outline file
  695. -------------------
  696.  
  697. This will allow you to edit the outline file that contains the options 
  698. for the various menus.
  699.  
  700. -----------------------
  701. D Read POPMAX Documents
  702. -----------------------
  703.  
  704. This will bring up this doscument online.
  705.  
  706. ------------
  707. Q Halt Macro
  708. ------------
  709.  
  710. In case of an emergency, you may halt macro this way.
  711.  
  712.  
  713. ----------
  714. ESCAPE KEY
  715. ----------
  716.  
  717. The escape key will restore the normal macro operation, and is used 
  718. used to get out of the sysop menu.
  719.  
  720.  
  721.  ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒END▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  722.  
  723.