home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1994 #1 / monster.zip / monster / UTILS2 / MMAN200.ZIP / MENU_MAN.DOC < prev    next >
Text File  |  1994-01-01  |  63KB  |  1,613 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.  
  25.  
  26.                 Welcome to MENU_MAN, a utility routine to display
  27.                   custom user selection menus from batch files!
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.                  ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  41.  
  42.                               U S E R   M A N U A L
  43.  
  44.                                    Version 2.0
  45.  
  46.                  ▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄
  47.  
  48.                        Copyright 1990-1994 by MicroMetric.
  49.                               All rights reserved.
  50.  
  51.                       Document last edited: January 1, 1994
  52.  
  53. MENU_MAN is distributed as SHAREWARE and, as such, may be copied and shared on a
  54. private  non-commercial basis with others  in its unmodified  form. Liability is
  55. limited to  replacing the software for  registered users. There  is no liability
  56. for any damage or loss caused by this software, directly or indirectly. 
  57.                ┌────────────────────────────────────────────────┐ 
  58.                │             ┌───────┐                          │█
  59.                │        ┌────┴──┐    │                (R)       │█
  60.                │      ──│       │O   │───────────────────       │█
  61.                │        │  ┌────┴╨─┐ │  Association of          │█
  62.                │        │  │       │─┘  Shareware               │█
  63.                │        └──│   O   │    Professionals           │█
  64.                │      ─────│   ║   │─────────────────────       │█
  65.                │           └───╨───┘    MEMBER                  │█
  66.                └────────────────────────────────────────────────┘█
  67.                 ██████████████████████████████████████████████████
  68.  
  69. If you have problems with this program, or want to send comments, manual correc-
  70. tions, or enhancement suggestions, you may call or mail them to:
  71.  
  72.           MicroMetric
  73.           98 Dade Avenue
  74.           Sarasota, FLorida  34232-1609  USA
  75.  
  76.           Technical Support   (813) 377-2515
  77.           FAX   . . . . . . . (813) 377-2091
  78.           Support BBS   . . . (813) 371-2490
  79.  
  80. The MicroMetric Software Support BBS provides availability and technical support
  81. for  the MicroMetric ■■■■_MAN series  of shareware programs.  First time callers
  82. have  access to  the board  and can leave  messages or  download replies/current
  83. shareware  releases. Registered  users may  also download  the latest  Beta test
  84. software releases, when available.
  85.  
  86. Additionally,  you can  send  routed E-Mail  via the  RIME(tm) network  to David
  87. Groome at the ->ACTION node in the ASP, Laser, Batch, Common, or Shareware  con-
  88. ferences. I also check CompuServe (71631,744), but only on an infrequent basis.
  89.  
  90.  
  91.  
  92. PKZIP, PKUNZIP and PKSFX are trademarks of PKWARE, Inc.
  93. MS-DOS is a registered trademark of the Microsoft Corporation. 
  94. IBM PC, XT, AT and PC-DOS are registered trademarks of the IBM Corporation.
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104. ii
  105.  
  106.  
  107.                                                                TABLE OF CONTENTS
  108.  
  109.  
  110. INTRODUCTION  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .    1
  111.    Major Features . . . . . . . . . . . . . . . . . . . . . . . . . . . . .    1
  112.    System Requirements  . . . . . . . . . . . . . . . . . . . . . . . . . .    1
  113.    Manual Format  . . . . . . . . . . . . . . . . . . . . . . . . . . . . .    1
  114.       Page layout . . . . . . . . . . . . . . . . . . . . . . . . . . . . .    2
  115.       Brackets and parentheses  . . . . . . . . . . . . . . . . . . . . . .    2
  116.       Computer key conventions  . . . . . . . . . . . . . . . . . . . . . .    2
  117.       Action steps  . . . . . . . . . . . . . . . . . . . . . . . . . . . .    2
  118.       ■■■■_MAN programs . . . . . . . . . . . . . . . . . . . . . . . . . .    2
  119.       Shareware distributed documentation manual  . . . . . . . . . . . . .    2
  120.    Shareware  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .    2
  121.  
  122. INSTALLING THE SYSTEM . . . . . . . . . . . . . . . . . . . . . . . . . . .    5
  123.    From a Diskette Vendor . . . . . . . . . . . . . . . . . . . . . . . . .    5
  124.    From a BBS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .    5
  125.    Registered Version . . . . . . . . . . . . . . . . . . . . . . . . . . .    5
  126.  
  127. RUNNING MENU_MAN  . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   11
  128.    Menu Identifier  . . . . . . . . . . . . . . . . . . . . . . . . . . . .   11
  129.    Batch-file-name  . . . . . . . . . . . . . . . . . . . . . . . . . . . .   11
  130.    Options  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   12
  131.    Title-line . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   12
  132.    Selection-X-line . . . . . . . . . . . . . . . . . . . . . . . . . . . .   12
  133.  
  134. MENU_MAN OPTIONS  . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   13
  135.    [B] - Sound  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   13
  136.    [C] - Menu Colors  . . . . . . . . . . . . . . . . . . . . . . . . . . .   13
  137.    [EA] - Erase After . . . . . . . . . . . . . . . . . . . . . . . . . . .   14
  138.    [EB] - Erase Before  . . . . . . . . . . . . . . . . . . . . . . . . . .   15
  139.    [L] - Menu Highlight Location  . . . . . . . . . . . . . . . . . . . . .   15
  140.    [M] - Display Text Only  . . . . . . . . . . . . . . . . . . . . . . . .   15
  141.    [P] - Menu Position  . . . . . . . . . . . . . . . . . . . . . . . . . .   16
  142.    [S] - Shadow Border  . . . . . . . . . . . . . . . . . . . . . . . . . .   16
  143.    [T] - Display Time . . . . . . . . . . . . . . . . . . . . . . . . . . .   16
  144.    [W] - Exploding Window Time  . . . . . . . . . . . . . . . . . . . . . .   17
  145.    [X] - Check Box Style Menu . . . . . . . . . . . . . . . . . . . . . . .   17
  146.  
  147. MENU_MAN OPERATION  . . . . . . . . . . . . . . . . . . . . . . . . . . . .   19
  148.    User Selection Menu Input  . . . . . . . . . . . . . . . . . . . . . . .   19
  149.    User Check Box Menu Input  . . . . . . . . . . . . . . . . . . . . . . .   19
  150.    User Menu Positioning  . . . . . . . . . . . . . . . . . . . . . . . . .   19
  151.    ERRORLEVEL Testing . . . . . . . . . . . . . . . . . . . . . . . . . . .   19
  152.    Environment Variable Testing . . . . . . . . . . . . . . . . . . . . . .   19
  153.    Sample MENU_MAN Batch File . . . . . . . . . . . . . . . . . . . . . . .   19
  154.    EXAMPLE  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   20
  155.    Shareware message  . . . . . . . . . . . . . . . . . . . . . . . . . . .   20
  156.  
  157. MENU_MAN FILES  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   21
  158.  
  159. INDEX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   23
  160.  
  161.  
  162.                                                                              iii
  163.  
  164.            TABLE OF CONTENTS                          MENU_MAN Version 2.0
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.  
  203.  
  204.  
  205.  
  206.  
  207.  
  208.  
  209.  
  210.  
  211.  
  212.  
  213.  
  214.  
  215.  
  216.  
  217.  
  218.  
  219.  
  220. iv
  221.  
  222.  
  223.                                                                     INTRODUCTION
  224.  
  225. MENU_MAN  allows the  display of user  selection or  check box  style menus from
  226. within batch files.  These menus are controlled by command  line options and can
  227. contain a title and up to twenty-three selection option lines that are generated
  228. from REM  lines in the batch  file which follows  the call to  MENU_MAN. Options
  229. include embedded environment variables, user response time limit, menu position-
  230. ing, erasing screen before/after  menu display, and menu  sound, color and  type
  231. customization.
  232.  
  233. Major Features  
  234.  
  235. *  Over 200 different menus per batch file.
  236. *  Simple format: MENU_MAN # filename options
  237.       REM TITLE
  238.       REM USER SELECTION 1
  239.       REM USER SELECTION 2
  240.       REM ...
  241. *  Menus may be either SELECTION or CHECK BOX type.
  242. *  User defined window selection menus embedded in batch files.
  243. *  Automatic color display on systems so equipped.
  244. *  User control over most window menu parameters on a per menu basis.
  245. *  Display selection menus or informational messages.
  246. *  MENU_MAN  sets the  ERRORLEVEL environment variable  for easy  user selection
  247.    testing in the batch file.
  248. *  Environment variables may be embedded in the menu text.
  249. *  User selections  are imbedded in  the batch file, not  separated into another
  250.    file.
  251. *  Menu may be displayed  for a limited time to aid in uses such as AUTOEXEC for
  252.    unattended operation.
  253. *  A sound may be made  when the window is displayed. The pitch  and duration of
  254.    the sound is adjustable.
  255. *  The menu  colors are adjustable. Sixteen single  option menu colors, or indi-
  256.    vidual menus may be customized.
  257. *  The screen may be erased before the menu is displayed or the menu can overlay
  258.    the current screen display.
  259. *  The menu may be erased after user selection or left.
  260. *  The position of the  menu - Up, center, down and left, center, right - may be
  261.    specified.
  262. *  The menu may be  moved on the screen by  the user -  CTRL  +   ARROWKEY  will
  263.    move the menu one character position in the specified direction.
  264. *  Registered users may suppress the shareware reminder message display.
  265.  
  266. System Requirements  
  267.  
  268. MENU_MAN will run  on an IBM PC, XT, AT or  true compatibles. It has been tested
  269. with  PC-DOS/MS-DOS operating systems, version 3.0 through version 6.0. The pro-
  270. gram will determine what type of display monitor is available  and adjust itself
  271. accordingly. 
  272.  
  273. Manual Format  
  274.  
  275. This manual is divided  into several introductory chapters followed  by chapters
  276. for  operating MENU_MAN. The  format of these chapters  and the information pre-
  277.  
  278.                                                                                1
  279.  
  280.            INTRODUCTION                               MENU_MAN Version 2.0
  281.  
  282. sented therein has been standardized using the following conventions.
  283.  
  284. Page layout - Each page  has a header detailing the chapter and the program ver-
  285. sion covered. A footer displays the manual page number.
  286.  
  287. Brackets and  parentheses - Brackets, [...],  are used in the  manual to specify
  288. what  should be entered in response to the current prompt. If a character string
  289. is  to be entered, the type of character  is noted, such as ALPHA, NUMERIC, ANY,
  290. etc. Parentheses, (..), are used for comments.
  291.  
  292. Computer key conventions  - Keys specified  in the manual text  that are not  in
  293. entry brackets are  shown as reversed, such as  ESCAPE .  All key references are
  294. in capital letters for clarity.
  295.  
  296. Action steps  - Some procedures  may require selection  from a menu  of options,
  297. inputting data or following a sequence of steps. Most manual sections will first
  298. give an overview  of the function or task  under discussion and then  detail the
  299. various action operating procedures. In order  to make this manual easier to use
  300. a symbol, -> , marks the beginning of each of these action operating procedures.
  301.  
  302. ■■■■_MAN programs -  The general group  of shareware programs by  MicroMetric is
  303. referred to by the name ■■■■_MAN. It may also be used in reference to a specific
  304. program in that group.
  305.  
  306. Shareware distributed documentation manual -  The documentation file included on
  307. the shareware distribution diskette contains the same information as the printed
  308. and  bound manual, supplied  as part of  registration, with two  exceptions, the
  309. result of  the word processor, formatting,  and printer used. The  first is that
  310. all of  the control display characters  (ASCII 1-31) and the  reverse print key-
  311. board codes are NOT  shown properly. Finally, bolding, underlining,  and special
  312. symbols are NOT present.
  313.  
  314. Shareware  
  315.  
  316. MENU_MAN is being distributed  as SHAREWARE. The SHAREWARE concept  allows users
  317. to examine a program on a trial basis at no (or  minimal) charge before purchas-
  318. ing it. In addition,  by decreasing marketing costs, professional  quality soft-
  319. ware may be distributed  for a fraction of the  cost of a comparable  commercial
  320. product.  Regardless of whether you register the program, please help distribute
  321. MENU_MAN by sharing unmodified copies of it and its files with others.
  322.  
  323. You are hereby granted  the right to use the MENU_MAN program  for a thirty (30)
  324. day evaluation  period. If  you find MENU_MAN  of value  and continue to  use it
  325. after  this evaluation  period, YOU  MUST REGISTER YOUR  PROGRAM USE.  This will
  326. provide you with:
  327.  
  328.    *  A 7" x 8 1/2" printed and bound manual.
  329.    *  MENU_MAN phone or mail support for one year.
  330.    *  Notification of the next MENU_MAN release.
  331.    *  Ability to suppress the  shareware registration reminder message displayed
  332.       at the end of the program.
  333.    *  An installation/update/registration brand program.
  334.    *  Sincere thanks for your support of the SHAREWARE concept.
  335.  
  336. 2
  337.  
  338.            MENU_MAN Version 2.0                               INTRODUCTION
  339.  
  340. A Single System Program Registration  entitles the user to unlimited use  of the
  341. MENU_MAN program on a single computer. 
  342.  
  343. A Site  License Program Registration entitles  the user to unlimited  use of the
  344. MENU_MAN program on  all computers,  including networks, at  a single  corporate
  345. location.
  346.  
  347. Program Registration, Single System . . .   $20.
  348.      Includes latest version diskette and manual
  349. Program Registration, Site License  . . .  $100.
  350.      Includes latest version diskette and manual
  351. Latest Version Diskette only  . . . . . . .  $5.
  352. Shipping - USA/Canada/Mexico  . . . . . . .  $5.
  353. Shipping - Outside of USA/Canada/Mexico .   $10.
  354. COD orders, add $5.
  355. Florida residents, add 7% sales tax
  356.  
  357. You should specify diskette size and  density desired. If none is specified, 3½"
  358. DSHD will normally be supplied.
  359.  
  360. ADDRESS:  MicroMetric
  361.           98 Dade Avenue
  362.           Sarasota, FLorida 34232-1609 USA
  363.  
  364. PHONE:    Technical Support   (813) 377-2515
  365.           FAX . . . . . . .   (813) 377-2091
  366.           Support BBS . . .   (813) 371-2490
  367.           Order Line  . . .   (800) 929-0184
  368.  
  369. For ease in program registration, a registration order form is included with the
  370. distribution files.
  371.  
  372. This program is produced by a member of the Association of Shareware Profession-
  373. als (ASP). ASP wants to make sure that the shareware principal works for you. If
  374. you  are unable  to resolve a  shareware-related problem  with an  ASP member by
  375. contacting the member directly, ASP may  be able to help. The ASP Ombudsman  can
  376. help you resolve a dispute  or problem with an ASP member, but  does not provide
  377. technical support for members'  products. Please write  to the ASP Ombudsman  at
  378. 545 Grover Road, Muskegon, MI 49442-9427, send a CompuServe message via easyplex
  379. to ASP Ombudsman 70007,3536, or by FAX to the ASP FAX number: (616) 788-2765. In
  380. communications with the Ombudsman  please include a telephone number  and/or FAX
  381. if available.
  382.  
  383.  
  384.  
  385.  
  386.  
  387.  
  388.  
  389.  
  390.  
  391.  
  392.  
  393.  
  394.                                                                                3
  395.  
  396.            INTRODUCTION                               MENU_MAN Version 2.0
  397.  
  398.  
  399.  
  400.  
  401.  
  402.  
  403.  
  404.  
  405.  
  406.  
  407.  
  408.  
  409.  
  410.  
  411.  
  412.  
  413.  
  414.  
  415.  
  416.  
  417.  
  418.  
  419.  
  420.  
  421.  
  422.  
  423.  
  424.  
  425.  
  426.  
  427.  
  428.  
  429.  
  430.  
  431.  
  432.  
  433.  
  434.  
  435.  
  436.  
  437.  
  438.  
  439.  
  440.  
  441.  
  442.  
  443.  
  444.  
  445.  
  446.  
  447.  
  448.  
  449.  
  450.  
  451.  
  452. 4
  453.  
  454.  
  455.                                                            INSTALLING THE SYSTEM
  456.  
  457. From a Diskette Vendor  
  458.  
  459. If  the MENU_MAN program  has been obtained  from a diskette  vendor, you should
  460. follow  any of their instruction on unpacking/installing the programs (if indeed
  461. they have separate instructions.) The  program, and its files, is  normally sup-
  462. plied as a self extracting file whose name is "MMANvvv.EXE" (vvv is the version,
  463. such as "MMAN100").
  464.  
  465. This file  should first be copied to a directory  on your hard disk. This direc-
  466. tory may be a new  one, such as one  named "MENU", and created specifically  for
  467. MENU_MAN, or a  current one, such as  "UTILITY", that has  other programs/files.
  468. For information on creating a separate directory, see your DOS manual.
  469.  
  470.  NOTE    FOR BEST OPERATION, ALL  REQUIRED MENU_MAN FILES *SHOULD* BE  PLACED ON
  471.          PATH REFERENCED SUBDIRECTORIES!
  472.  
  473. Once the file is copied  to the desired hard  disk directory, at the DOS  prompt
  474. change to  this  drive directory,  and then  type  the EXE  file  name (such  as
  475. "MMAN100") and press  ENTER . This will unpack all of the MENU_MAN files.
  476.  
  477. From a BBS  
  478.  
  479. If the MENU_MAN file  was downloaded from a  Bulletin Board, it should  first be
  480. copied to a directory as  defined above, and then unpacked, using  whatever pro-
  481. gram is specified by the  Bulletin Board. It is normally distributed with a name
  482. of "MMANvvv.ZIP" (vvv is the version) or "MMAN10.ZIP".
  483.  
  484. Registered Version  
  485.  
  486. Registered users should use the program "INSTALL", that  is supplied upon regis-
  487. tration. This program will create a registration file which will,  in turn, sup-
  488. press  the shareware registration reminders. If the system is already installed,
  489. and only "BRANDING" the system with the registration information is desired, you
  490. can  run the program "MENU_MAN", and when  exiting, select the "BRAND" option by
  491. pressing  F4 .
  492.  
  493. -> To install MENU_MAN on your hard disk, or to upgrade to a new release, follow
  494.    the steps detailed below:
  495.  
  496. 1. Place the MENU_MAN distribution diskette in your floppy diskette drive.
  497.  
  498. 2. At the DOS prompt, change to the drive in which the distribution  diskette is
  499.    located. For example, if the diskette was placed in drive A, type  A   :  and
  500.    press  ENTER .
  501.  
  502. 3. Type  I   N   S   T   A   L    L  and press  ENTER . The installation program
  503.    will then be loaded, and its display should be as shown below.
  504.  
  505.  
  506.  
  507.  
  508.  
  509.  
  510.                                                                                5
  511.  
  512. INSTALLING THE SYSTEM                                       MENU_MAN Version 2.0
  513.  
  514.  ╒═╡ INSTallation MANagement Program ╞══════════╡ Started at═>12-31-99 08:00 ╞═╕
  515.  │░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│
  516.  │░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│
  517.  │░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│
  518.  │░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│
  519.  │░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│
  520.  │░     ░░▄    ░░▄   ░░▄░░░░░░░░▄░░░░░░░░▄         ░░▄   ░░▄   ░░▄   ░░▄   ░░▄░│
  521.  │░  Ç  ░░█    ░░░▄  ░░█░░█▀▀▀▀▀▀ ▀▀░░█▀▀▀         ░░░▄ ░░░█  ░░░░▄  ░░░▄  ░░█░│
  522.  │░ ┌┼┐ ░░█    ░░█░░▄░░█░░░░░░░░▄   ░░█            ░░░█ ░░░█ ░░█▀░░▄ ░░█░░▄░░█░│
  523.  │░ ┌┴┐ ░░█    ░░█ ▀░░░█ ▀▀▀▀▀░░█   ░░█            ░░█░░▄░░█ ░░░░░░█ ░░█ ▀░░░█░│
  524.  │░═┴═┴═░░█    ░░█   ░░█░░░░░░░░█   ░░█    ░░░░░░▄ ░░█░░█░░█░░█▀▀▀░░▄░░█   ░░█░│
  525.  │░      ▀▀     ▀▀    ▀▀ ▀▀▀▀▀▀▀▀    ▀▀     ▀▀▀▀▀▀  ▀▀ ▀▀ ▀▀ ▀▀    ▀▀ ▀▀    ▀▀░│
  526.  ╘╡ INST_MAN  Version 4.20 Copyright 1990-94 MicroMetric, All Rights Reserved ╞╛
  527.    F1>Help│ESC>Exit│<┘/[char]>Select│  HomeEnd│                               
  528.  
  529.     NOTE    Context sensitive help is  available from this  point on in the  in-
  530.             stallation program on, by pressing the  F1  key.
  531.  
  532. 4. If a color video card is detected, the following prompt will be displayed.
  533.                     ┌──────────────────────────────────────┐
  534.                     │ ╔═╡ Color Monitor Card Detected ╞═╗  │
  535.                     │ ║ Use the color display           ║█ │
  536.                     │ ║ Force a monochrome display      ║█ │
  537.                     │ ╚═════════════════════════════════╝█ │
  538.                     │  ███████████████████████████████████ │
  539.                     └──────────────────────────────────────┘
  540.    -> If your system has a color monitor, press  U .
  541.    -> If your system has a monochrome or LCD display, press  F .
  542.  
  543. 5. A selection list of all path referenced directories is next displayed.
  544.  
  545.     NOTE    Although MENU_MAN will  run from a  non-path directory, placing  its
  546.             files on any path-referenced  directory(s) allows the directory from
  547.             which files  are to be printed  to be set as  the current directory,
  548.             before executing the program.
  549.                  ┌────────────────────────────────────────────┐
  550.                  │ ┌─┤ Select the INSTALLATION DIRECTORY ├─┐  │
  551.                  │ │ C:\BAT                                │█ │
  552.                  │ │ C:\DOS-500                            │█ │
  553.                  │ │ C:\UTILITY                            │█ │
  554.                  │ │ C:\ZIP                                │█ │
  555.                  │ │ C:\                                   │█ │
  556.                  │ │ User Defined Drive-Directory Path     │█ │
  557.                  │ └───────────────────────────────────────┘█ │
  558.                  │  █████████████████████████████████████████ │
  559.                  └────────────────────────────────────────────┘
  560.    -> To cancel the installation program at this point, press  ESCAPE .
  561.    -> To  select one  of  the path  referenced directories  on which  to install
  562.       MENU_MAN, move the highlight bar to it and press  ENTER .
  563.    -> To specify a non-path  referenced directory on which to  install MENU_MAN,
  564.       press  U  and then press  ENTER . A data entry window for the installation
  565.       path will  then be displayed, as shown below (with an example path already
  566.       entered). Enter the desired drive  and directory path on which to  install
  567.  
  568. 6
  569.  
  570. MENU_MAN Version 2.0                                       INSTALLING THE SYSTEM
  571.  
  572.       MENU_MAN, using the control keys described on the bottom help line.
  573.  
  574.        NOTE    INSTALL can  only create directories  one level deeper  than that
  575.                which currently exists. If the  directory C:\ABC exists, the  di-
  576.                rectory  C:\ABC\XYZ may  be created; if  C:\ABC does  not already
  577.                exist, an error will occur. 
  578.    ┌────────────────────────────────────────────────────────────────────────┐
  579.    │ ┌─┤ Enter Path ├────────────────────────────────────────────────────┐  │
  580.    │ │ C:\MENU                                                           │█ │
  581.    │ └───────────────────────────────────────────────────────────────────┘█ │
  582.    │  █████████████████████████████████████████████████████████████████████ │
  583.    └────────────────────────────────────────────────────────────────────────┘
  584.       -> To cancel defining the path, press  ESCAPE . The program will return to
  585.          directory selection.
  586.       -> To accept the path as entered  and edited, press  ENTER . If the speci-
  587.          fied directory does not currently exist, the following message  will be
  588.          displayed.
  589.      ┌────────────────────────────────────────────────────────────────────┐
  590.      │ ┌─┤ MESSAGE ├───────────────────────────────────────────────────┐  │
  591.      │ │ The drive-directory path as entered DOES NOT currently exist. │█ │
  592.      │ │ This directory WILL NOW BE created.                           │█ │
  593.      │ └───────────────────────────────────────────────────────────────┘█ │
  594.      │  █████████████████████████████████████████████████████████████████ │
  595.      └────────────────────────────────────────────────────────────────────┘
  596.          -> To cancel creation of this directory, press  ESCAPE .
  597.          -> To create  it, press  ENTER .  If the specified drive  is invalid or
  598.             the  requested installation  directory's parent  does not  exist, an
  599.             error message will be displayed. 
  600.          ┌─────────────────────────────────────────────────────────────┐
  601.          │ ┌─┤ MESSAGE ├────────────────────────────────────────────┐  │
  602.          │ │ The drive-directory path as entered CANNOT BE CREATED. │█ │
  603.          │ │ Please edit and CORRECT this path.                     │█ │
  604.          │ └────────────────────────────────────────────────────────┘█ │
  605.          │  ██████████████████████████████████████████████████████████ │
  606.          └─────────────────────────────────────────────────────────────┘
  607.             Press any key, and then re-edit the installation path.
  608.  
  609. 6. A TYPE OF INSTALLATION  selection menu will  next be displayed. INSTALL  will
  610.    process either ■■■■_MAN SYSTEMS or their SUPPLEMENTAL FILES.
  611.  
  612.    SYSTEMS consist of the files necessary for basic program operation. 
  613.  
  614.    SUPPLEMENTAL FILES contain additional  information needed to accomplish added
  615.    support or increased functionality. 
  616.                         ┌───────────────────────────────┐
  617.                         │ ╔═╡ TYPE OF INSTALLATION ╞═╗  │
  618.                         │ ║ Systems - Programs       ║█ │
  619.                         │ ║ supplemental Files       ║█ │
  620.                         │ ║ eXit Installation        ║█ │
  621.                         │ ╚══════════════════════════╝█ │
  622.                         │  ████████████████████████████ │
  623.                         └───────────────────────────────┘
  624.    -> To install one or more SYSTEMS  at this time, press  S . A menu  of avail-
  625.  
  626.                                                                                7
  627.  
  628. INSTALLING THE SYSTEM                                       MENU_MAN Version 2.0
  629.  
  630.       able SYSTEMS  will then  be displayed. For  further installation  instruc-
  631.       tions, go to the next step. 
  632.  
  633.        NOTE    THIS APPLICATION CURRENTLY DOES NOT HAVE SUPPLEMENTAL FILES.
  634.  
  635.    -> To exit the INSTALL program at this time, press  X .
  636.  
  637. 7. If more  than one system is  available for installation, a  SYSTEM TO INSTALL
  638.    selection menu will be displayed, as shown below.
  639.  ┌─────────────────────────────────────────────────────────────────────────────┐
  640.  │ ╔═╡ TAG ╞╡ Select the SYSTEM(S) TO INSTALL ╞═════════════════════════════╗  │
  641.  │ ║         DMAN100   SINGLE SCREEN data/graphical summary all disk drives ║█ │
  642.  │ ║         EMAN100   Environment data summary, environ. space remaining   ║█ │
  643.  │ ║         FMAN100   Menu driven DOS file manager, directory tree         ║█ │
  644.  │ ║         LMAN100   Print text files on a laser printer, 36 print styles ║█ │
  645.  │ ║         MMAN100   Display custom user selection menus from batch files ║█ │
  646.  │ ║         PMAN100   Determines if a file is on a PATH directory          ║█ │
  647.  │ ║         VMAN100   Display and edit files in both ASCII and Hex         ║█ │
  648.  │ ║ ------ eXIT SELECTION AND INSTALL ALL TAGGED (√) ------                ║█ │
  649.  │ ╚════════════════════════════════════════════════════════════════════════╝█ │
  650.  │  ██████████████████████████████████████████████████████████████████████████ │
  651.  └─────────────────────────────────────────────────────────────────────────────┘
  652.    -> To terminate the installation program at this point, press  ESCAPE .
  653.    -> To toggle the INSTALL TAG for a given SYSTEM, press its highlighted letter
  654.       or move the highlight bar to  in with the arrow keys and press   ENTER . A
  655.       [√] character to the left of the SYSTEM name denotes that this SYSTEM will
  656.       be installed.
  657.    -> To  conclude the  SYSTEM selection  process,  press  X .  The INSTALLATION
  658.       FUNCTION menu for each selected system will then be displayed.
  659.  
  660. 8. A list of all of  the selected SYSTEMS files is next displayed, along with an
  661.    INSTALLATION FUNCTION menu.  The normal  sequence of operations  is to  first
  662.    "Install" the SYSTEM program and files, and then "Brand" the SYSTEM with your
  663.    name and serial number.
  664.          ┌─────────────────────────────────────────────────────────────┐
  665.          │ ╒═╡ Select the INSTALLATION FUNCTION ╞═══════════════════╕  │
  666.          │ │ Install system     Brand system       eXit             │█ │
  667.          │ ╘════════════════════════════════════════════════════════╛█ │
  668.          │  ██████████████████████████████████████████████████████████ │
  669.          └─────────────────────────────────────────────────────────────┘
  670.  
  671. ┌──────────────────────────────────────────────────────────────────────────────┐
  672. │╒═╡ File Name   Status  Hard Disk Path/File Description    XXXX100  FILES ╞═╕ │
  673. ││ System═>XXXX_MAN      This system does ..................                 │█│
  674. ││ XXXX_MAN.EXE  PROCESS Main program for this application                   │█│
  675. ││ YYYY.YYY      PROCESS Other files...                                      │█│
  676. │╘═╡ INSTALLATION PATH═>C:\MENU ╞════════════════════════════════════════════╛█│
  677. │ █████████████████████████████████████████████████████████████████████████████│
  678. └──────────────────────────────────────────────────────────────────────────────┘
  679.  
  680.    -> To install the  SYSTEM on the hard disk, insure that  the highlight bar is
  681.       on the  "INSTALL SYSTEM" FUNCTION and  press  ENTER . Each of  the file(s)
  682.       will be copied to the selected installation drive-directory. 
  683.  
  684. 8
  685.  
  686. MENU_MAN Version 2.0                                       INSTALLING THE SYSTEM
  687.  
  688.        NOTE    A happy face  symbol after any of the SYSTEM's file names denotes
  689.                that this file is  already on the hard disk.  During installation
  690.                it will be replaced, on the directory where it currently resides,
  691.                not the INSTALLATION DRIVE-DIRECTORY PATH.
  692.  
  693.       If any of the files to be installed is already present, a ACTION menu will
  694.       be displayed during its installation.
  695.             ┌───────────────────────────────────────────────────────┐
  696.             │ ┌─┤ Highlighted file(s) already present. ACTION? ├─┐  │
  697.             │ │ Erase current file(s) and update                 │█ │
  698.             │ │ erase and update this and All later file(s)      │█ │
  699.             │ │ Leave current file(s) 'as is'                    │█ │
  700.             │ │ leave current and Skip the remaining file(s)     │█ │
  701.             │ └──────────────────────────────────────────────────┘█ │
  702.             │  ████████████████████████████████████████████████████ │
  703.             └───────────────────────────────────────────────────────┘
  704.       -> To process the current file, select the proper ACTION to take by press-
  705.          ing its highlighted letter or moving the highlight bar to it and press-
  706.          ing  ENTER .
  707.  
  708.       When all files have been copied to  the hard disk, a copy complete message
  709.       is displayed.
  710.         ┌───────────────────────────────────────────────────────────────┐
  711.         │ ┌─┤ MESSAGE ├──────────────────────────────────────────────┐  │
  712.         │ │ FILE COPY COMPLETED.                                     │█ │
  713.         │ │ All of the required MENU_MAN files are on the hard disk. │█ │
  714.         │ │ ═══> MENU_MAN IS READY TO RUN. <═══                      │█ │
  715.         │ └──────────────────────────────────────────────────────────┘█ │
  716.         │  ████████████████████████████████████████████████████████████ │
  717.         └───────────────────────────────────────────────────────────────┘
  718.       -> To cancel the installation at this point, press  ESCAPE .
  719.       -> To continue with the  installation, press any other key.  The highlight
  720.          bar will then be on the "BRAND SYSTEM" FUNCTION.
  721.  
  722. 9. To brand the system with your name and serial number, move  the highlight bar
  723.    to  the "BRAND SYSTEM" FUNCTION and press  ENTER . A REGISTRATION INFORMATION
  724.    data entry window will be displayed, as shown below, with sample data already
  725.    entered. 
  726.  
  727.     NOTE    This step is REQUIRED  for MENU_MAN to be  registered. Also, if  you
  728.             move  the MENU_MAN files to another drive-directory you will need to
  729.             "BRAND" the system again.
  730.  
  731.       Enter  your company  and/or your  name, and  then the  system registration
  732.       number. Your registration number is located on the back of the front cover
  733.       of this manual.
  734.  
  735.  
  736.  
  737.  
  738.  
  739.  
  740.  
  741.  
  742.                                                                                9
  743.  
  744. INSTALLING THE SYSTEM                                       MENU_MAN Version 2.0
  745.  
  746.                   ┌──────────────────────────────────────────┐
  747.                   │ ┌─┤ REGISTRATION INFORMATION ├────────┐  │
  748.                   │ │ Name ABC COMPANY, George Jones      │█ │
  749.                   │ │ Registration number 12345678        │█ │
  750.                   │ └─────────────────────────────────────┘█ │
  751.                   │  ███████████████████████████████████████ │
  752.                   └──────────────────────────────────────────┘
  753.       -> To accept either the name or  registration number after entry and edit-
  754.          ing,  press  ENTER . A message will be displayed after the registration
  755.          number is entered. It's contents are dependent on whether the registra-
  756.          tion number is valid. Both messages are shown below.
  757.                 ┌───────────────────────────────────────────────┐
  758.                 │ ┌─┤ MESSAGE ├──────────────────────────────┐  │
  759.                 │ │ MENU_MAN serial number entered is VALID. │█ │
  760.                 │ └──────────────────────────────────────────┘█ │
  761.                 │  ████████████████████████████████████████████ │
  762.                 └───────────────────────────────────────────────┘
  763.  
  764.                ┌─────────────────────────────────────────────────┐
  765.                │ ┌─┤ MESSAGE ├────────────────────────────────┐  │
  766.                │ │ MENU_MAN serial number entered is INVALID! │█ │
  767.                │ │ Please try again.                          │█ │
  768.                │ └────────────────────────────────────────────┘█ │
  769.                │  ██████████████████████████████████████████████ │
  770.                └─────────────────────────────────────────────────┘
  771.          -> To continue with  the installation  program, press any  key. If  the
  772.             registration number was valid, the "EXIT" option is  highlighted. If
  773.             it was invalid, select the "BRAND SYSTEM" option again.
  774.  
  775. 10.   To exit from this SYSTEMS installation function, move the highlight bar to
  776.       the  "EXIT" FUNCTION and  press  ENTER . If  the SYSTEM  has been properly
  777.       branded, it is ready for use, and the program will either install the next
  778.       selected SYSTEM, Step 8, or return  to the TYPE OF INSTALLATION MENU, Step
  779.       6. If the system  has not been branded, an error  message is displayed, as
  780.       shown below.
  781.        ┌─────────────────────────────────────────────────────────────────┐
  782.        │ ┌─┤ MESSAGE ├────────────────────────────────────────────────┐  │
  783.        │ │ This system has not been 'BRANDED'.                        │█ │
  784.        │ │ In order to be registered, it must first be 'BRANDED'!     │█ │
  785.        │ │ To exit without BRANDING, press ESCAPE.                    │█ │
  786.        │ │ To continue with the INSTALL program, press any other key. │█ │
  787.        │ └────────────────────────────────────────────────────────────┘█ │
  788.        │  ██████████████████████████████████████████████████████████████ │
  789.        └─────────────────────────────────────────────────────────────────┘
  790.  
  791.  
  792.  
  793.  
  794.  
  795.  
  796.  
  797.  
  798.  
  799.  
  800. 10
  801.  
  802.  
  803.                                                                RUNNING MENU_MAN 
  804.  
  805. The syntax to execute the MENU_MAN utility program from a batch file is: 
  806.  
  807.    ...
  808.    MENU_MAN menu_identifier batch-file-name [option a] [option b] [...]
  809.    REM title-line
  810.    REM selection-1-line
  811.    REM selection-2-line
  812.    ...
  813.    (BATCH FILE LINE THAT DOES NOT START "REM...")
  814.    ...
  815.  
  816.  NOTE    The  double colon character  combination, "::", may  be substituted for
  817.          "REM" in any title or selection option statement.
  818.  
  819. The program name and  all command line parameters must be  separated by at least
  820. one space. If no parameters are present, a MENU_MAN syntax summary will  be dis-
  821. played. 
  822.  
  823. There are also two  special cases of the command line parameters,  for CHECK BOX
  824. style menus, that do not require or expect REM statements to follow. They are:
  825.  
  826.          MENU_MAN !, will   clear   ALL  environment   variables  of   the  form
  827.                      "[char][number(1-23)].
  828.  
  829.          MENU_MAN ![menu_identifier],  will clear the  environment variables  of
  830.                         the form "[menu_identifier][number(1-23)].    
  831.  
  832. For more information on their use, see the section "[X] - Check Box Style Menu".
  833.  
  834. Menu Identifier  
  835.  
  836. menu_identifier is  a unique  character used  to  identify the  location in  the
  837. batchfile-name batch file  from where this call was made. MENU_MAN searches this
  838. batch file for  a line with  its name (MENU_MAN)  and this menu_identifier.  The
  839. title and  the user selection options  are then taken from  following REM state-
  840. ments. 
  841.           
  842. Batch-file-name  
  843.  
  844. batch-file-name is  the name of the  batch file which this statement  is in. The
  845. easiest was to specify this parameter is to use the batch file variable "%0", to
  846. which DOS assigns the batch file name. MENU_MAN adds the extension .BAT if it is
  847. not present, and will first search the current drive/directory for this name. If
  848. it is  not found,  MENU_MAN will  then search each  drive/directory in  the PATH
  849. statement in  turn. If  no match  is found, an  error message  is displayed  and
  850. MENU_MAN returns control to the batch file that called it. 
  851.  
  852.  
  853.  
  854.  
  855.  
  856.  
  857.  
  858.                                                                               11
  859.  
  860.            RUNNING MENU_MAN                           MENU_MAN Version 2.0
  861.  
  862. If your batch file changes the current drive/directory to one that is not in the
  863. PATH  before   it  executes  MENU_MAN   ,  you   must  specify  the   full  path
  864. drive/directory along with the batch-file-name on the command line. 
  865.  
  866.  NOTE    If the batch file  uses the SHIFT command, the variable %0 will no lon-
  867.          ger contain  the batch file path-name.  In situations such  as this, an
  868.          environment  variable to be  set to %0  and the beginning  of the batch
  869.          file.
  870.  
  871. Options  
  872.  
  873. options may be specified after the  first two required parameters and may appear
  874. in any order. The individual options are covered in the next section.
  875.  
  876. Title-line  
  877.  
  878. Following the  MENU_MAN command line should  be a batch file  REM statement. The
  879. contents of this statement will be used as the title of the displayed menu. 
  880.  
  881.  NOTE    The double colon  character combination, "::",  may be substituted  for
  882.          "REM" in any title or selection option statement.
  883.  
  884. Selection-X-line  
  885.    
  886. Following the REM  title statement should be a set of  batch file REM statements
  887. that are the desired selection options for this menu. Each REM will be displayed
  888. on  a separate menu line  in the order  that they appear in  the batch file. The
  889. first numeric  or capitalized alpha character  that has not  been highlighted on
  890. previous menu lines will be highlighted on this menu line and may be pressed for
  891. user selection.  Up to twenty-three menu  lines may be specified.  MENU_MAN will
  892. scan for REM menu  lines until the maximum number is reached or a non REM state-
  893. ment line encountered in the batch file.
  894.  
  895.  
  896.  
  897.  
  898.  
  899.  
  900.  
  901.  
  902.  
  903.  
  904.  
  905.  
  906.  
  907.  
  908.  
  909.  
  910.  
  911.  
  912.  
  913.  
  914.  
  915.  
  916. 12
  917.  
  918.  
  919.                                                                 MENU_MAN OPTIONS
  920.  
  921. The MENU_MAN options  allow customizing the individual menus. None  of these op-
  922. tions  are required: MENU_MAN will  produce selection menus  without any options
  923. being specified. Options may be specified as either upper or lower case letters.
  924.  
  925.  
  926. All of the MENU_MAN options are described below, in option letter order.
  927.  
  928. [B] - Sound  
  929.  
  930. A short beep sound is made to get the users attention when the selection menu is
  931. displayed. Both the pitch and the length of this sound may be changed. If either
  932. value is set to zero, no sound will be produced when the menu is displayed. 
  933.  
  934. The sound option is: 
  935.  
  936.       B#####,#####
  937.  
  938.          where:    the first  ##### is the  pitch in  cycles per second  and the
  939.                      second is the  length in milliseconds.  These numbers   may
  940.                      range from zero to  32,767. The default values are  a pitch
  941.                      of 700 Hz and 200 milliseconds. 
  942.  
  943. EXAMPLE: An option  of B512,500 will sound a half second  512 HZ tone as the se-
  944.          lection menu is displayed. 
  945.  
  946. [C] - Menu Colors  
  947.  
  948. Menu colors may either be defined by background color, or each  area of the menu
  949. may be customized.  There are six areas  of the menus  that can have colors  as-
  950. signed to them. These areas and their default colors are shown below.
  951.  
  952.         ┌──────────────────────────────────────────────────────────────────┐
  953.         │ AREA                 CODE   FOREGROUND      BACKGROUND     VALUE │
  954.         ├──────────────────────────────────────────────────────────────────┤
  955.         │ Non-highlighted test  N     Light grey      Blue            28   │
  956.         │ Highlighted text      H     White           Blue            31   │
  957.         │ Border                B     Yellow          Blue            30   │
  958.         │ Title                 T     Light cyan      Blue            27   │
  959.         │ Shadow border         S     Light grey      Black           7    │
  960.         │ Option highlight bar  O     White           Red             79   │
  961.         └──────────────────────────────────────────────────────────────────┘
  962.  
  963. The color codes are shown in the table  below. To have an area blink, add 128 to
  964. the color code chosen. 
  965.  
  966.  
  967.  
  968.  
  969.  
  970.  
  971.  
  972.  
  973.  
  974.                                                                               13
  975.  
  976.            MENU_MAN OPTIONS                           MENU_MAN Version 2.0
  977.  
  978.        ┌────────────┬───────────────────────────────────────────────────────┐
  979.        │            │  -  -  -  -  B  A  C  K  G  R  O  U  N  D  -  -  -  - │
  980.        │            │                                                       │
  981.        │ FOREGROUND │ BLACK  BLUE  GREEN   CYAN    RED MAGENTA BROWN  WHITE │
  982.        │            ├───────────────────────────────────────────────────────┤
  983.        │ BLACK      │   0     16     32     48     64     80     96    112  │
  984.        │ BLUE       │   1     17     33     49     65     81     97    113  │
  985.        │ GREEN      │   2     18     34     50     66     82     98    114  │
  986.        │ CYAN       │   3     19     35     51     67     83     99    115  │
  987.        │            │                                                       │
  988.        │ RED        │   4     20     36     52     68     84    100    116  │
  989.        │ MAGENTA    │   5     21     37     53     69     85    101    117  │
  990.        │ BROWN      │   6     22     38     54     70     86    102    118  │
  991.        │ LIGHTGREY  │   7     23     39     55     71     87    103    119  │
  992.        │            │                                                       │
  993.        │ DARKGREY   │   8     24     40     56     72     88    104    120  │
  994.        │ LIGHTBLUE  │   9     25     41     57     73     89    105    121  │
  995.        │ LIGHTGREEN │  10     26     42     58     74     90    106    122  │
  996.        │ LIGHTCYAN  │  11     27     43     59     75     91    107    123  │
  997.        │            │                                                       │
  998.        │ LIGHTRED   │  12     28     44     60     76     92    108    124  │
  999.        │ LIGHTMAGENTA  13     29     45     61     77     93    109    125  │
  1000.        │ YELLOW     │  14     30     46     62     78     94    110    126  │
  1001.        │ WHITE      │  15     31     47     63     79     95    111    127  │
  1002.        └────────────┴───────────────────────────────────────────────────────┘
  1003.  
  1004. The color option is: 
  1005.  
  1006.       CM or C## or C@###
  1007.  
  1008.          where:
  1009.                M  Force monochrome color scheme.
  1010.  
  1011.                ## Menu  background color, ranging from  0 to 15,  from the table
  1012.                   above. (Use the FOREGROUND  codes shown in the  column labeled
  1013.                   "BLACK BACKGROUND'.
  1014.  
  1015.                @  The menu area  code from the first table above (N,  H, B, T or
  1016.                   S).
  1017.                ###   Color value from the second table above. 
  1018.  
  1019. EXAMPLE: An option of CT113 will display the title in dark blue on a white back-
  1020.          ground. 
  1021.  
  1022. [EA] - Erase After  
  1023.  
  1024. By default, the menu is left on the screen display after the user  selection has
  1025. been made. This option will remove the menu after a choice has been made and the
  1026. screen will be restored  to what it was before the menu was displayed. A line is
  1027. then displayed showing the user choice that was made.
  1028.  
  1029. The erase after option is: 
  1030.  
  1031.  
  1032. 14
  1033.  
  1034.            MENU_MAN Version 2.0                           MENU_MAN OPTIONS
  1035.  
  1036.       EA
  1037.  
  1038. EXAMPLE: An option  of EA will remove the user menu  after a choice of the third
  1039.          option line has been made and then display the following line: 
  1040.                                                                                 
  1041.             Your Choice was "option 3 menu line"!
  1042.  
  1043. [EB] - Erase Before  
  1044.  
  1045. By default, the menu overlays the current screen display. This option will first
  1046. clear the screen before the menu is displayed. 
  1047.  
  1048. The erase before option is: 
  1049.  
  1050.       EB
  1051.  
  1052. EXAMPLE: An option  of EB will erase the screen before  the selection  menu dis-
  1053.          play. 
  1054.  
  1055. [L] - Menu Highlight Location  
  1056.  
  1057. The default selection menu highlight  location is the first menu line.  This op-
  1058. tion allows the  highlight to be initially  located on any valid menu  line when
  1059. the menu is displayed.
  1060.  
  1061. The menu highlight location option is:
  1062.  
  1063.       L##
  1064.  
  1065.          where:   ## is the menu line to highlight.
  1066.  
  1067. EXAMPLE: An option of L8 will highlight the eight menu line.
  1068.  
  1069. [M] - Display Text Only  
  1070.  
  1071. MENU_MAN normally  displays a  menu consisting  of a title  line and  a variable
  1072. number of  menu lines and then  waits for the user  to select a  menu line. This
  1073. option allows the  text and the menu lines to be  displayed without requesting a
  1074. selection from the user.
  1075.     
  1076. The display text only option is:
  1077.  
  1078.       M#####
  1079.     
  1080.          where:   ##### is  the number  of seconds to  display the text  and the
  1081.                      menu lines and may range from zero to 32,767. 
  1082.  
  1083. EXAMPLE: An options M5 will display the menu title and text lines  for five sec-
  1084.          onds. There is no user  selection required nor is there a  countdown of
  1085.          the display time left. 
  1086.  
  1087.  
  1088.  
  1089.  
  1090.                                                                               15
  1091.  
  1092.            MENU_MAN OPTIONS                           MENU_MAN Version 2.0
  1093.  
  1094. [P] - Menu Position  
  1095.  
  1096. The default menu position is the center  of the screen. The menu position option
  1097. allows menus to be placed at other locations.
  1098.  
  1099. The menu position option is: 
  1100.  
  1101.       P{V}[,]{H}
  1102.  
  1103.          where:   {V} is the vertical position code; 
  1104.     
  1105.                   T - Top 
  1106.                   C - Center 
  1107.                   B - Bottom 
  1108.  
  1109.                {H} is the horizontal position code; 
  1110.  
  1111.                   L - Left 
  1112.                   C - Center 
  1113.                   R - Right 
  1114.  
  1115.                 NOTE    The separator comma is  optional, and a '-' may  also be
  1116.                         used.
  1117.  
  1118. EXAMPLE: An option of PT,R  will display the menu in  the upper right corner  of
  1119.          the screen. 
  1120.  
  1121. [S] - Shadow Border  
  1122.  
  1123. The default menu  display uses a shadow border as if  a light was shining on the
  1124. raised menu from the upper left. This option removes this shadow. 
  1125.  
  1126. The shadow border option is: 
  1127.  
  1128.       S-
  1129.  
  1130. EXAMPLE: An option of S- will not display a shadow border. 
  1131.  
  1132. [T] - Display Time  
  1133.  
  1134. The menu is normally displayed with a bottom border line of "ENTER═>Accept". For
  1135. use in batch file such as AUTOEXEC.BAT  where you normally want a default selec-
  1136. tion and the  ability to run  without user input, a  display time option  may be
  1137. used. When used, this option will display the time remaining on the bottom line.
  1138. If  no user choice  is before the  option time expires, MENU_MAN  returns to the
  1139. batch file with ERRORLEVEL equal to zero.
  1140.                                                                                 
  1141. The display time option is: 
  1142.     
  1143.       T##### 
  1144.     
  1145.          where:   ##### is the number of seconds to wait for a user response and
  1146.                      may range from zero to 32,767. 
  1147.  
  1148. 16
  1149.  
  1150.            MENU_MAN Version 2.0                           MENU_MAN OPTIONS
  1151.  
  1152. EXAMPLE: An option of T12 will wait twelve seconds for a user selection. 
  1153. [W] - Exploding Window Time  
  1154.  
  1155. The menu  is built in stages so as to  give an "exploding" appearance. Normally,
  1156. there is  no delay time between  these stages. However,  in order to  extend the
  1157. "explosion", this  option allows a time  delay to be placed  between the stages.
  1158. The default is 20 milliseconds.
  1159.  
  1160. The exploding window time option is: 
  1161.     
  1162.       W#####
  1163.  
  1164.          where:   ##### is the number of milliseconds to  delay between building
  1165.                      stages  of the  window  menu and  may  range from  zero  to
  1166.                      32,767. 
  1167.     
  1168. EXAMPLE: An option  of W200 will delay 200 milliseconds between stages in build-
  1169.          ing the menu window. 
  1170.  
  1171. [X] - Check Box Style Menu  
  1172.  
  1173. Normal MENU_MAN  menus allow a  single user  selection. A second  menu style  is
  1174. available, called CHECK  BOX style, where any  or all of  the menu items on  the
  1175. menu may be selected. The  selections made with CHECK BOX menus  are conveyed to
  1176. the program  with environment  variables, not through the ERRORLEVEL variable.
  1177.  
  1178. The title  and selection option  REM lines for CHECK  BOX menus are  the same as
  1179. SELECTION menus. However the display  adds a CHECK BOX, "[ ]", at  the beginning
  1180. of each menu line.
  1181.  
  1182. The CHECK BOX menu option is:
  1183.  
  1184.       X[##][-][##]...
  1185.  
  1186.          where:
  1187.                (blank)  No number will display all selection lines as unchecked.
  1188.  
  1189.                0  All selection lines will be checked.
  1190.                ## Selection lines specified will be checked.
  1191.  
  1192.       Environment variables will be created for each CHECK BOX menu select line,
  1193.       with the form of:
  1194.  
  1195.          [menu_identifier][selection_line_#]=T|F
  1196.  
  1197.             where:
  1198.  
  1199.                   menu_identifier   Character  identifier  used in  the MENU_MAN
  1200.                      command line.
  1201.                   selection_line_#  Selection line number.
  1202.                   T|F   T if selection checked, F if selection is unchecked.
  1203.  
  1204.       These  environment variables may  be used to  check the  user input. After
  1205.  
  1206.                                                                               17
  1207.  
  1208.            MENU_MAN OPTIONS                           MENU_MAN Version 2.0
  1209.  
  1210.       testing, and before exiting from the  batch file, they should be  cleared.
  1211.       This is done by specifying:
  1212.  
  1213.          MENU_MAN !, will  clear   ALL   environment  variables   of  the   form
  1214.                      "[char][number(1-23)].
  1215.  
  1216.          MENU_MAN ![menu_identifier],  will clear the  environment variables  of
  1217.                         the form "[menu_identifier][number(1-23)].
  1218.  
  1219.  
  1220.  
  1221.  
  1222.  
  1223.  
  1224.  
  1225.  
  1226.  
  1227.  
  1228.  
  1229.  
  1230.  
  1231.  
  1232.  
  1233.  
  1234.  
  1235.  
  1236.  
  1237.  
  1238.  
  1239.  
  1240.  
  1241.  
  1242.  
  1243.  
  1244.  
  1245.  
  1246.  
  1247.  
  1248.  
  1249.  
  1250.  
  1251.  
  1252.  
  1253.  
  1254.  
  1255.  
  1256.  
  1257.  
  1258.  
  1259.  
  1260.  
  1261.  
  1262.  
  1263.  
  1264. 18
  1265.  
  1266.  
  1267.                                                               MENU_MAN OPERATION
  1268.  
  1269. After  MENU_MAN has displayed the menu and  accepted the users response, it will
  1270. exit and return  to the batch file  with either the ERRORLEVEL  parameter set to
  1271. the number of the menu line selected by the user or the  appropriate environment
  1272. variables set. 
  1273.  
  1274. User Selection Menu Input  
  1275.  
  1276. -> To select a  menu option, press its highlighted letter  or position the high-
  1277.    light  bar on  the desired option  using the  cursor control  keys,  UpArrow 
  1278.     DownArrow   Home  or  End , and then press  ENTER .
  1279.  
  1280. User Check Box Menu Input  
  1281.  
  1282. -> To change the checked status of any menu option, first move the highlight bar
  1283.    to the desired  option using  the cursor control  keys  UpArrow    DownArrow 
  1284.     Home  or   End , and then press  ENTER   Tab  or   Space . You may also just
  1285.    press the highlighted letter of the desired option.
  1286.  
  1287. -> To accept the checked status of all of the menu's options, press  ESCAPE .
  1288.  
  1289. User Menu Positioning  
  1290.  
  1291. After a  MENU_MAN menu has been displayed, it may  be moved around the screen by
  1292. the user. This  feature is useful when text needed to  determine the proper menu
  1293. selection has been displayed but is covered by the menu itself.
  1294.  
  1295. -> To move the MENU_MAN menu  display, hold down either the  Ctrl  or   Alt  key
  1296.    and  the press  ARROWKEY . The menu display  will move one character position
  1297.    in the desired direction.
  1298.  
  1299. ERRORLEVEL Testing  
  1300.  
  1301. To  determine which  selection the  user has  made, you  must test  the variable
  1302. ERRORLEVEL in the  batch file. To  determine if the  user selected option  four,
  1303. use: 
  1304.  
  1305.    if ERRORLEVEL 4 if NOT ERRORLEVEL 5 goto SELECT4
  1306.  
  1307. When using the display time option, to determine if the user made a choice (this
  1308. can be used as a default), use: 
  1309.  
  1310.    if ERRORLEVEL 0 if NOT ERRORLEVEL 1 goto NOCHOICE
  1311.  
  1312. Environment Variable Testing  
  1313.  
  1314. To test the environment variable set from menu "B", option 2, use:
  1315.  
  1316.    if .%B2%==.T goto DOB2TRUE
  1317.    if .%B2%==.F goto DOB2FALSE
  1318.  
  1319. Sample MENU_MAN Batch File  
  1320.  
  1321.  
  1322.                                                                               19
  1323.  
  1324.            MENU_MAN OPERATION                         MENU_MAN Version 2.0
  1325.  
  1326. A sample batch file, MENUDEMO.BAT, is  included in the distribution archive.  It
  1327. contains a variety of menus demonstrating the various MENU_MAN features.
  1328.  
  1329. -> To demonstrate  the various features of MENU_MAN, at the DOS prompt change to
  1330.    the drive and directory on which MENU_MAN was installed, type  M   E   N   U 
  1331.     D   E   M   O  , and then press  ENTER .
  1332.  
  1333. EXAMPLE  
  1334.  
  1335. This batch file segment will produce the selection menu show below -
  1336.  
  1337. ... 
  1338. MENU_MAN C %0 
  1339. rem This line will be the Title 
  1340. rem option 1 menu line 
  1341. rem option 2 menu line 
  1342. rem option 3 menu line 
  1343. rem option 4 menu line 
  1344. if ERRORLEVEL 1 if NOT ERRORLEVEL 2 goto SELECT1
  1345. if ERRORLEVEL 2 if NOT ERRORLEVEL 3 goto SELECT2
  1346. ... 
  1347.                       ┌──────────────────────────────────┐
  1348.                       │ ╒═This line will be the Title═╕  │
  1349.                       │ │ option 1 menu line          │█ │
  1350.                       │ │ option 2 menu line          │█ │
  1351.                       │ │ option 3 menu line          │█ │
  1352.                       │ │ option 4 menu line          │█ │
  1353.                       │ ╘════════ENTER═>Accept════════╛█ │
  1354.                       │  ███████████████████████████████ │
  1355.                       └──────────────────────────────────┘
  1356.  
  1357. The same menu specification, with the  addition of the "X2" CHECK BOX  style op-
  1358. tion, would produce:
  1359.                       ┌──────────────────────────────────┐
  1360.                       │ ╒═This line will be the Title═╕  │
  1361.                       │ │ [ ] option 1 menu line      │█ │
  1362.                       │ │ [X] option 2 menu line      │█ │
  1363.                       │ │ [ ] option 3 menu line      │█ │
  1364.                       │ │ [ ] option 4 menu line      │█ │
  1365.                       │ ╘════════ESCAPE═>Accept═══════╛█ │
  1366.                       │  ███████████████████████████████ │
  1367.                       └──────────────────────────────────┘
  1368.  
  1369. Shareware message  
  1370.  
  1371. A shareware message may be randomly displayed at the start of MENU_MAN. 
  1372.  
  1373. -> To continue  with the MENU_MAN  program after  the display  of the  shareware
  1374.    message, press any key.
  1375.  
  1376. By registering your use  of MENU_MAN, you will be  able to use the  registration
  1377. serial number to suppress the shareware message display.
  1378.  
  1379.  
  1380. 20
  1381.  
  1382.  
  1383.                                                                   MENU_MAN FILES
  1384.  
  1385. MENU_MAN is normally distributed  as compressed archives consisting of  the fol-
  1386. lowing files (these files are included in the compressed file MMANvvv, where vvv
  1387. is the version):
  1388.  
  1389.      Files required for MENU_MAN operation:
  1390.  
  1391. MENU_MAN.EXE  . . Executable program
  1392.  
  1393.      Files included to aid in the use of MENU_MAN:
  1394.  
  1395. MENU_MAN.DOC  . . MENU_MAN documentation manual
  1396. MENU_MAN.ORD  . . Shareware/retail registration order form
  1397. MENU_MAN.SUM  . . MENU_MAN command line option summary
  1398. MENUDEMO.BAT  . . MENU_MAN demonstration batch file
  1399.  
  1400.      Additional files in the distribution archive:
  1401.  
  1402. DESC.SDI  . . . . BBS program description
  1403. FILE_ID.DIZ . . . BBS program description
  1404. README.MM . . . . Text file consisting of program summary, features, and history
  1405. SYSOP.DOC . . . . SYSOP distribution information
  1406. VENDOR.DOC  . . . Diskette/CD ROM vendor distribution information
  1407. MENU_MAN.LST  . . List of MENU_MAN files in the distribution file
  1408.  
  1409. The registered version diskette includes these additional files:
  1410.  
  1411.      Installation files:
  1412.  
  1413. INSTALL.EXE . . . Installation program
  1414. INSTALL.HLP . . . Installation program help file
  1415. INSTALLZ.EXE  . . Installation unpack program
  1416. INST_SYS.ZIP  . . Installation program files
  1417. README  . . . . . Installation read me file
  1418.  
  1419. The files that can be generated or used by MENU_MAN consist of:
  1420.  
  1421. MENU_MAN.REG  . . MENU_MAN registration information.
  1422.  
  1423.  
  1424.  
  1425.  
  1426.  
  1427.  
  1428.  
  1429.  
  1430.  
  1431.  
  1432.  
  1433.  
  1434.  
  1435.  
  1436.  
  1437.  
  1438.                                                                               21
  1439.  
  1440. MENU_MAN FILES                                              MENU_MAN Version 2.0
  1441.  
  1442.  
  1443.  
  1444.  
  1445.  
  1446.  
  1447.  
  1448.  
  1449.  
  1450.  
  1451.  
  1452.  
  1453.  
  1454.  
  1455.  
  1456.  
  1457.  
  1458.  
  1459.  
  1460.  
  1461.  
  1462.  
  1463.  
  1464.  
  1465.  
  1466.  
  1467.  
  1468.  
  1469.  
  1470.  
  1471.  
  1472.  
  1473.  
  1474.  
  1475.  
  1476.  
  1477.  
  1478.  
  1479.  
  1480.  
  1481.  
  1482.  
  1483.  
  1484.  
  1485.  
  1486.  
  1487.  
  1488.  
  1489.  
  1490.  
  1491.  
  1492.  
  1493.  
  1494.  
  1495.  
  1496. 22
  1497.  
  1498.  
  1499.                                                                            INDEX
  1500.  
  1501. Action steps  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  2
  1502.  
  1503. Batch-file-name . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11, 12
  1504. Brackets and parentheses  . . . . . . . . . . . . . . . . . . . . . . . . . .  2
  1505.  
  1506. Check box style menu  . . . . . . . . . . . . . . . . . . . . . . . . . . 11, 17
  1507. Computer key conventions  . . . . . . . . . . . . . . . . . . . . . . . . . .  2
  1508.  
  1509. Display text only . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
  1510. Display time  . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15, 16, 19
  1511.  
  1512. Environment variable testing  . . . . . . . . . . . . . . . . . . . . . . . . 19
  1513. Erase after . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
  1514. Erase before  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
  1515. Errorlevel testing  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
  1516. Example . . . . . . . . . . . . . . . . . . . . . . . . . . . .  5, 6, 13-17, 20
  1517. Exploding window time . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
  1518.  
  1519. From a BBS  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  5
  1520. From a diskette vendor  . . . . . . . . . . . . . . . . . . . . . . . . . . .  5
  1521.  
  1522. Installing the system . . . . . . . . . . . . . . . . . . . . . . . . . . . .  5
  1523. Introduction  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  1
  1524.  
  1525. Major features  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  1
  1526. Manual format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  1
  1527. Menu colors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  1, 13
  1528. Menu highlight location . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
  1529. Menu identifier . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
  1530. Menu position . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
  1531. MENU_MAN files  . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5, 9, 21
  1532. MENU_MAN operation  . . . . . . . . . . . . . . . . . . . . . . . . . . . 19, 21
  1533. MENU_MAN options  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
  1534. MENUDEMO  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20, 21
  1535.  
  1536. Options . . . . . . . . . . . . . . . . . . . . . . . . . .  1, 2, 11-13, 15, 19
  1537.  
  1538. Page layout . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  2
  1539.  
  1540. Registered version  . . . . . . . . . . . . . . . . . . . . . . . . . . .  5, 21
  1541. Running MENU_MAN  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
  1542.  
  1543. Sample menu_man batch file  . . . . . . . . . . . . . . . . . . . . . . . . . 19
  1544. Selection-x-line  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
  1545. Shadow border . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13, 16
  1546. Shareware . . . . . . . . . . . . . . . . . . . . . . . . . . ii, 1-3, 5, 20, 21
  1547. Shareware distributed documentation manual  . . . . . . . . . . . . . . . . .  2
  1548. Shareware message . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
  1549. Sound . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  1, 13
  1550. Support BBS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  ii, 3
  1551. System requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  1
  1552.  
  1553.  
  1554.                                                                               23
  1555.  
  1556.            INDEX                                      MENU_MAN Version 2.0
  1557.  
  1558. Technical support   . . . . . . . . . . . . . . . . . . . . . . . . . . .  ii, 3
  1559. Title-line  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11, 12
  1560.  
  1561. User check box menu input . . . . . . . . . . . . . . . . . . . . . . . . . . 19
  1562. User menu positioning . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
  1563. User selection menu input . . . . . . . . . . . . . . . . . . . . . . . . . . 19
  1564.  
  1565. [B] - sound . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
  1566. [C] - menu colors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
  1567. [EA] - erase after  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
  1568. [EB] - erase before . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
  1569. [L] - menu highlight location . . . . . . . . . . . . . . . . . . . . . . . . 15
  1570. [M] - display text only . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
  1571. [P] - menu position . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
  1572. [S] - shadow border . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
  1573. [T] - display time  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
  1574. [W] - exploding window time . . . . . . . . . . . . . . . . . . . . . . . . . 17
  1575. [X] - check box style menu  . . . . . . . . . . . . . . . . . . . . . . . 11, 17
  1576.  
  1577. C■■■■_MAN programs. . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  2
  1578.  
  1579.  
  1580.  
  1581.  
  1582.  
  1583.  
  1584.  
  1585.  
  1586.  
  1587.  
  1588.  
  1589.  
  1590.  
  1591.  
  1592.  
  1593.  
  1594.  
  1595.  
  1596.  
  1597.  
  1598.  
  1599.  
  1600.  
  1601.  
  1602.  
  1603.  
  1604.  
  1605.  
  1606.  
  1607.  
  1608.  
  1609.  
  1610.  
  1611.  
  1612. 24
  1613.