home *** CD-ROM | disk | FTP | other *** search
/ Simtel MSDOS 1992 December / simtel1292_SIMTEL_1292_Walnut_Creek.iso / msdos / menu / menu_ii.arc / MENU-II.DOC next >
Text File  |  1988-02-07  |  10KB  |  289 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.               ╔═══════════════════════════════════════════════╗
  7.               ║       MENU-II.EXE         by Brian Meier      ║
  8.               ╚═══════════════════════════════════════════════╝
  9.  
  10.  
  11.  
  12.  
  13.       Menu-II  is a menu program which easily allows the user to
  14.   customize the colors, display options, and the placement of options
  15.   on the screen.  There are already a large number of menu programs
  16.   available but I feel this is of comparable quality, especially because
  17.   of the supported profile options.  This is the third program is as
  18.   many weeks that I am uploading to Genie.  The other two BLCKBOOK.ARC
  19.   and DSKCHK.ARC have had quite a few accesses but I have only received
  20.   a few responses.  I would really like to hear any comments you have so
  21.   that I can make adjustments in future programs.  The main reason I
  22.   add options to change colors in this program is because I received two
  23.   letters from users of BLCKBOOK with monochrome monitors.  My GEmail
  24.   address is  B.MEIER   or you could send a letter to :
  25.        Brian Meier
  26.        P.O. Box 111146
  27.        Arlington, TX  76007
  28.  
  29. Notice: I am making this software available as Public Domain.  The user
  30.    assumes all risks and liabilities for the use, or inability to use
  31.    this program.  This program may be freely distributed so long as it
  32.    is unaltered and all files are given as a set and a fee of not more
  33.    than $5.00 is charged including media and postage.
  34.  
  35.      All you need to do to run MENU-II is add your program descriptions,
  36. paths, and parameters to the profile.  You may also set colors and other
  37. display options in this file.
  38.  
  39. Profile Format:
  40.     The profile is named MENU.PRO by default but you may specify the
  41. name of another default as parameter.  i.e.   type  MENU SAMPLE.MNU
  42. This allows you to keep multiple profiles for use with different monitors,
  43. etc.  The profile is divided into two sections, the first contains the
  44. display options, the second contains the menu entries.
  45.     Two sample programs have been included, Parser (parses a string of
  46. words into single word strings) and Parmtest (demonstrates how menu-ii
  47. passes parameters to called execs.)  Also included are sample profiles.
  48. MENU.PRO is the default profile and will be used if no others specified.
  49. SAMPLE.PRO is different color profile which may be given as parameter to
  50. MENU-II.  The third is MONOCHRM.PRO for use on monochrome monitors.
  51.  
  52.  
  53.  
  54. Section One: Display Options.
  55. ═════════════════════════════
  56.     All commands in this sections should be entered in Uppercase only.
  57. Invalid options are ignored in most places.  Refer to picture on next
  58. page for a sample menu display.  This is the default display, though the
  59. actual menu on screen is larger than illustration below.  This program
  60. and the two sample programs were written with Turbo Pascal 4.0 by Borland
  61. International.
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72.  
  73.     ╔═══════ 10:14:22 pm ═════════ Saturday February 6, 1988 ══════╗
  74.     ║ ╔══════════════════════════════════════════════════════════╗ ║
  75.     ║ ║ ╔════════════════════Menu Title════════════════════════╗ ║ ║
  76.     ║ ║ ║ ╔══════════════════════════════════════════════════╗ ║ ║ ║
  77.     ║ ║ ║ ║                                                  ║ ║ ║ ║
  78.     ║ ║ ║ ║   F1   Program-1           F2    MS MASM         ║ ║ ║ ║
  79.     ║ ║ ║ ║                                                  ║ ║ ║ ║
  80.     ║ ║ ║ ║   F3   BLCKBOOK            F4    Turbo C         ║ ║ ║ ║
  81.     ║ ║ ║ ║                                                  ║ ║ ║ ║
  82.     ║ ║ ║ ║   F5   DSKCHK              F6    Ada             ║ ║ ║ ║
  83.     ║ ║ ║ ║                                                  ║ ║ ║ ║
  84.     ║ ║ ║ ║   F7   Video Game          F8    Lisp            ║ ║ ║ ║
  85.     ║ ║ ║ ║                                                  ║ ║ ║ ║
  86.     ║ ║ ║ ║   F9   Turbo Pascal        F10   Program-10      ║ ║ ║ ║
  87.     ║ ║ ║ ║                                                  ║ ║ ║ ║
  88.     ║ ║ ║ ╚══════════════════════════════════════════════════╝ ║ ║ ║
  89.     ║ ║ ╚══════════════════════════════════════════════════════╝ ║ ║
  90.     ║ ╚══════════════════════════════════════════════════════════╝ ║
  91.     ╚════ALT-X : Exits══════PGUP: Prev Menu═════PGDN: Next Menu════╝
  92.  
  93.  
  94.  
  95.  
  96.    Bars:
  97. ───────────
  98.      This 4 rings around the menu are referred to as bars.  From outer to
  99. innermost, their names are BAR1 ,BAR2, BAR3, and BAR4.  You can change
  100. the colors of bars, make them flash, or remove them completely.  The
  101. appropriate commands are:
  102.    SET BAR#  ON│OFF
  103.    SET BAR# COLOR COLOR# [BLINK]
  104. for example, the following commands in profile would make BAR1 flash
  105. red, BAR2 is removed, BAR3 is yellow, BAR4 is left for default value.
  106.    SET BAR1 COLOR 12 BLINK
  107.    SET BAR2 OFF
  108.    SET BAR3 COLOR 14
  109.  
  110.  
  111.  
  112.   Date and Time
  113. ──────────────────
  114. The date and time are displayed on the top row by default with the
  115. clock updating every second.  You can change the color of the date or
  116. time, turn the display of date or time off, and even move the them to
  117. a different line.  Valid date and time commands are:
  118.    SET DATE│TIME COLOR COLOR# [BLINK]
  119.    SET DATE│TIME ON LINE#
  120.    SET DATE│TIME OFF
  121. Line# is a number from 1-8 where 1-4 are the top of bars 1-4 and 5-8
  122. are the bottom lines of bars 1-4.
  123. For example, if you wanted to time displayed yellow, on the next to last
  124. line (bottom of bar3) you would enter:
  125.    SET TIME COLOR 14
  126.    SET TIME ON 7
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.  
  137.  
  138.  
  139.   Set background color
  140. ────────────────────────
  141.    Background color of screen may be changed to colors 1-7.  Format is:
  142.    SET BACK COLOR COLOR# [BLINK]
  143.  
  144.  
  145.  
  146.  
  147.   Title and Special Keys
  148. ──────────────────────────
  149.     You may also set options for the title of menu and for the row of
  150. keys at bottom of menu (alt-x, pgup, pgdn).  You may set these on/off,
  151. change colors, or put on new line.  Commands are:
  152.    SET TITLE│KEYS COLOR COLOR# [BLINK]
  153.    SET KEYS│TITLE ON LINE#
  154.    SET TITLE│KEYS OFF
  155. usage of these is same as time and date.  The actual title name is
  156. defined after the menu command defined later.
  157.  
  158.  
  159.  
  160.  
  161.   PFKEYs and NAMES
  162. ────────────────────
  163. The PFKEYs and program NAMES are within the center of menu.  The only
  164. options valid for these is to change colors.  Command format is:
  165.    SET   PFKEY│NAMES  COLOR COLOR# [BLINK]
  166. The actual names are set after the menu command.
  167.  
  168.  
  169.  
  170.  
  171.    Section 2: Menu Entries
  172. ════════════════════════════
  173.    After all options have been entered your profile should have the
  174. command 'MENU'.  You may optionally follow MENU with the TITLE of your
  175. menu.  Note that the title is delimited by spaces so if you want a two
  176. word title, there can be no spaces between words; replace blank with
  177. underscore,dash, period, etc.  Following MENU are your program data, one
  178. program per line.  Whereas spacing was not important in section 1, it is
  179. important in the menu section.  You may enter up to 30 programs with each
  180. entry in profile haveing program description (what appears on menu) in
  181. columns 1-20, the path and actual filename in columns 21-60, and param-
  182. eters in columns 61-80.  i.e.: the program BLCKBOOK.EXE in the directory
  183. c:\tools and having no paramters would be entered as:
  184.  
  185. Black Book         c:\tools\blckbook.exe
  186.  
  187. Note that lowercase can be used for section 2 entries.  Also note that
  188. the path includes the full exec name and drive prefix as well as the path
  189. 30 entries is the maximum number allowed, 10 for each of 3 menus.
  190. If less than 30 entries, the remainder are set to null.  If more than
  191. 30 entries, the extras are ignored.
  192.  
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.  
  203.  
  204.  
  205.   Usage notes
  206. ───────────────
  207.   Section 1: all entries must be upper case
  208.              invalid entries ignored if possible
  209.              last command takes precedence, for example if you
  210.                   set color of bar1 twice, last color is used.
  211.   Section 2: entries may be in mixed case
  212.              extra entries are ignored
  213.              data in wrong fields will result in program not being
  214.                 called and will return to menu.
  215.              unused entries will be null.
  216.              30 entries maximum
  217.   Keys : hitting a PFkey will call appropriate exec.  ALT-X will exit
  218.          menu program.  PGUP and PGDN move to previous or next set of 10
  219.          programs to be displayed on menu.
  220.  
  221.  
  222.  
  223.  
  224.   Default Values
  225. ──────────────────
  226.  
  227.   item             color          flash        location
  228. --------     -----------------   -------      ----------
  229.  BAR1                              no           fixed
  230.  BAR2                              no           fixed
  231.  BAR3                              no           fixed
  232.  BAR4                              no           fixed
  233.  DATE                              no           line 1
  234.  TIME                              no           line 1
  235.  KEYS                              no           line 7
  236.  PFKEY         14 - yellow         no           fixed
  237.  NAMES                             no           fixed
  238.  TITLE                             no           line 3
  239.  BACK           0 - black          no            n/a
  240.  
  241.  
  242.  
  243.           ┌─     ─┐ ┌─     ─┐ ┌─      ─┐ ┌─     ─┐
  244.       SET │ BAR1  │ │ COLOR │ │ COLOR# │ │ BLINK │
  245.           │ BAR2  │ └─     ─┘ └─      ─┘ └─     ─┘
  246.           │ BAR3  │ ┌─   ─┐
  247.           │ BAR4  │ │ OFF │
  248.           │ BACK  │ └─   ─┘
  249.           │ DATE  │ ┌─  ─┐ ┌─     ─┐
  250.           │ TIME  │ │ ON │ │ LINE# │
  251.           │ KEYS  │ └─  ─┘ └─     ─┘
  252.           │ PFKEY │
  253.           │ NAMES │
  254.           │ TITLE │
  255.           └─     ─┘
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.  
  269.  
  270.  
  271.       COLOR#     TEXTCOLOR      BACKGROUND
  272.       ──────   ─────────────   ────────────
  273.          0      black           black
  274.          1      blue            blue
  275.          2      green           green
  276.          3      cyan            cyan
  277.          4      red             red
  278.          5      magenta         magenta
  279.          6      brown           brown
  280.          7      light gray      light gray
  281.          8      dark gray
  282.          9      light blue
  283.         10      light green
  284.         11      light cyan
  285.         12      light red
  286.         13      light magenta
  287.         14      yellow
  288.         15      white
  289.