home *** CD-ROM | disk | FTP | other *** search
/ Between Heaven & Hell 2 / BetweenHeavenHell.cdr / 100 / 62 / read.me < prev    next >
Text File  |  1986-03-04  |  9KB  |  225 lines
  1. Hello, Welcome to Bmenu ....
  2.  
  3. SETTING UP THIS DEMO DISK
  4.  
  5.   Since MSDOS is not a public domain program you will have to supply
  6.   Your own.  Format a disk with the /s (system) switch then copy the
  7.   contents of this disk there.Copy COMMAND.COM if the format didn't.
  8.   Some of the menu items require MORE.COM,  copy that to the disk as 
  9.   well. Then to see the demo boot on your new disk.
  10.  
  11.   I have prepared a sample menu that calls all of the other programs.
  12.  
  13. Contents of the disk:
  14.  BMENU.EXE     This is a menu program.  It reads its menu file and presents
  15.                you with a menu. You can edit the menu with any text editor.
  16.                Once the menu is displayed you can choose menu items by pres-
  17.            sing the up and down arrow keys or pressing a letter key.
  18.  
  19.                When you press a letter key the menu item with that letter
  20.                capitalized leftmost will be chosen and the pointer will move
  21.                there. When the pointer is on the choice you want press return.
  22.          
  23.  
  24.  ESCAPE.EXE    This program will detect the press of an escape key without
  25.                stopping your batch file. Do you want to be given a choice
  26.                when you run the batch file but if your not there you want
  27.                the batch file to continue? Escape will fill that bill. I
  28.                use escape in my autoexec.bat to controll some options while
  29.                I start my computer. If I am doing my normal work I can just
  30.                walk away while its booting, if I am doing somthing special
  31.                then I hit escape at the proper time to modify my bootup
  32.                environment.
  33.  
  34. To use in a batch file:
  35.                Escape creates the file ESCAPE.$$$ if escape is pressed
  36.                while it is running, otherwise that file is deleted and
  37.                will not exist.
  38.  
  39.                   ECHO PRESS ESCAPE TO PREFORM SPECIAL PROCCESSING
  40.                   IF EXIST ESCAPE.$$$ GOTO SPECIAL
  41.                       -- normal proccessing --
  42.                           .
  43.                           .
  44.                           .
  45.  
  46.                  :SPECIAL
  47.                  DEL ESCAPE.$$$
  48.                      -- special proccessing --
  49.  
  50.  
  51.  MENUGET.EXE   Build menus into your batch files! Menuget waits and accepts
  52.                a single ascii character then creates a small file that you
  53.                can test for in your batch file. When Menuget exits there
  54.                will be a file named MENU$<x>.$$$, where x is the letter the
  55.                user pressed. Menuget is used in the same manner as escape.
  56.  
  57.                     (Display your menu (use type <filename> or echo))
  58.                     ECHO  A  Do "A" stuff
  59.                     ECHO  B  Do "B" stuff
  60.                     :GETAGAIN
  61.             MENUGET
  62.                     IF EXIST  MENU$A.$$$ GOTO ASTUFF
  63.                     IF EXIST  MENU$B.$$$ GOTO BSTUFF
  64.                     IF EXIST  MENU$<any letter in your menu>.$$$ <Do what
  65.                             you need to for that menu item>
  66.                     ECHO An error message because the user picked the
  67.                     ECHO wrong thing...
  68.                     GOTO GETAGAIN
  69.                     :ASTUFF
  70.                     .
  71.                     .
  72.                     .
  73.                     GOTO SKIPOTHERS
  74.                     :BSTUFF
  75.                     .
  76.                     .
  77.                     .
  78.                     GOTO SKIPOTHERS
  79.                     .
  80.                     .
  81.                     :SKIPOTHERS
  82.                     ---- continue with other things... ----
  83.  
  84.  
  85.  
  86.  
  87.  DATIME.EXE    I got tired of entering the date and time on separate lines
  88.                and having to enter it just the way the computer wanted.
  89.                Datime accepts the date and the time in any order on one line
  90.                and in many formats:
  91.  
  92.                HH:MM{:SS} {AM|PM}               10:25  13:45:20
  93.                D{D}/M{M}/YY{YY}                 3/5/85 10/4/85 10/12/1985
  94.                D{D}-M{M}-YY{YY}                 3-5-85 10-4-85 10-12-1985
  95.                MONTH  D{D},YY{YY}               MARCH 5,1985  MAY 12,2010
  96.            
  97.                {optional stuff}
  98.  
  99. LINES.EXE     These three are graphic demonsrations. Great to watch. Only
  100. EGGS.EXE      Lisajous needs an input, the others will run unattended but
  101. LISAJOUS.EXE  can accepth input.
  102.  
  103. COOKIE.EXE    A fortune cookie program, randomly selects a peice of wisdom
  104.               from COOKIE.DAT for your enjoyment. COOKIE.DAT may be edited
  105.               with any ascii editor (wordsar in non-document...).
  106.  
  107. HANGMAN.EXE   Can you guess the word before its too late?? The program
  108.               chooses from over 1000 words, and you can add words of your
  109.               own. Words are kept in WORDS.
  110.  
  111.  
  112. BMENU.MNU File Format:
  113.  
  114.   The first line of the file Bmenu gives the menu title. This data will be
  115.   written in the box above the menu. The text is taken littaraly and should
  116.   not be enclosed in any delimiters
  117.  
  118.   Each of the following lines deals with a menu item. For each menu item
  119.   there should be a line in the BMENU.MNU file. Each will have this format:
  120.  
  121.   <PROMPT>,<MENU ITEM>,<COMMAND A>,<COMMAND B>
  122.  
  123.  Prompt Field Format:
  124.  
  125.   P<text>    The text will be used as a prompt if this menu item is
  126.              selected to prompt for an input string.  If no text is
  127.              provided the prompt will be `Enter Parameter'.
  128.  
  129.   -          A dash in this field marks a non menu item. These may
  130.              be used to display static text that many not be selected
  131.              as an action. Note `-,,,' will produce an blank,
  132.              non-selectable line in your menu.
  133.  
  134.   X          Any other character marks a menu item that execute its
  135.              action without prompting for input
  136.  
  137.  
  138.              Case of the first charachter in the prompt field controlls the
  139.              inclusion of the "Strike any key..." prompt after the menu
  140.              selection finishes. Capitalize if no pause is desired, use
  141.              lower case if you want the "Strike any Key... " prompt.
  142.  
  143.  
  144.   Menu Item Field:
  145.  
  146.       Text entered in this field will be shown on the menu. Leading and
  147.       trailing spaces are ignored. The text is centered. If the prompt
  148.       field is a `-' the the pointer will not come to this text. If the
  149.       user enters a letter while the menu is displayed, the pointer is 
  150.       moved to the menu item that has that letter capitalized closest to
  151.       the begining.
  152.       
  153.       Example:    All these menu items are together in one menu.
  154.       
  155.          Menu items:    Press to select    Note 
  156.           xAxYx                Y        A wont work because of last line
  157.             xxxxB             B        This is the only menu with a capital B
  158.             Cxxxx             C        
  159.             AxxDx           A or D    An A in the first column beats
  160.                             any other A
  161.                       
  162.                       
  163.       
  164.   Command A and Command B:
  165.  
  166.       A dos command may be split between these two fields. When the user
  167.       is prompted for input (P<text> in the prompt field) that input string
  168.       is placed between CommandA and CommandB. "'" may be used to enclose
  169.       parts of a command that have important spaces (example: 'dir ' the
  170.       space after dir is important because the user will be prompted for
  171.       a file name and there must be at least one space between the file 
  172.       name and the command DIR.)
  173.  
  174.  
  175.  Hints
  176.  
  177.   Sub Menus:
  178.  
  179.     Bmenu.exe reads the file Bmenu.mnu each time the menu is displayed.
  180.     If you were to copy a new menu file to Bmenu.mnu a new menu will be
  181.     displayed when bmenu returns. To do this NONE of you menus must  be
  182.     named Bmenu.mnu. This way any of them may be copied with one command
  183.     to bmenu Example:
  184.  
  185.     Main.mnu
  186.  
  187.    Main Menu
  188.    X,Call First,Copy first.mnu bmenu.mnu,
  189.    X,Call Second,Copy Second.mnu bmenu.mnu,
  190.    X,END,,
  191.  
  192.    First.mnu
  193.  
  194.    First Menu
  195.    X,Call Main,copy Main.mnu Bmenu.mnu,
  196.    X,Call Second,copy second.mnu bmenu.mnu
  197.    x,END,,
  198.  
  199.  
  200.       ect...
  201.  
  202.    Each submenu is loaded when it is copyed into bmenu.mnu.  Any sort of
  203.    menu structure may be built.
  204.  
  205.  
  206.    Calling Batch files from menus:
  207.  
  208.     X,Call the batch file,command /c <batch filename>,
  209.  
  210.  Setting Up Bmenu:
  211.  
  212.   Copy BMENU.EXE to a disk with a system.
  213.  
  214.   Write your menu files using any ascii text editor. (wordstar in
  215.   non-document,edlin,sidekick notepad...) or copy BMENU.MNU
  216.  
  217.   If you are using a multiple level menu be sure that the main menu is
  218.   copied to bmenu.mnu to start with.
  219.  
  220.   Execute bmenu.exe  (type BMENU) when the menu appears press Escape. This
  221.   step will generate a file MENU.BAT. To run bmenu type MENU. If you wish
  222.   bmenu to start automaticaly, put MENU at the end of your autoexec.bat
  223.   file
  224.  
  225.