home *** CD-ROM | disk | FTP | other *** search
/ The World of Computer Software / World_Of_Computer_Software-02-386-Vol-2of3.iso / b / bmnu12.zip / BMNU.HLP < prev    next >
Text File  |  1992-12-15  |  4KB  |  122 lines
  1.                   --------
  2.                   BMNU.HLP
  3.                   --------
  4.  
  5. BMNU stands for Batch MeNU and is a tool for creating batch file menu
  6. systems.  BMNU is different from my other menu package (see MNU.ZIP).
  7. BMNU reads a menu definition stored in an ASCII file and displays the
  8. menu based upon this definition.  Once a choice has been made (RETURN
  9. key pressed), BMNU returns a code that can be picked up by ERRORLEVEL
  10. from within a batch file.  BMNU is very simple to use for novice com-
  11. puter users but is not as flexible or powerful as MNU.  Source code
  12. is available for 15 dollars.  Although BMNU was written using Borland
  13. C++ 3.1, this is a C program.  Please specify the disk size required
  14. when placing an order (5-1/4 or 3-1/2 inch).  My address follows this
  15. documentation.  You will receive the source and project files (BMNU.C
  16. and BMNU.PRJ) in addition to the support libraries and their header
  17. files.
  18.  
  19. The BMNU package consists of the following files: BMNU.HLP, BMNU.EXE,
  20. MAINMENU.MNU, UTIL.MNU, and PROGS.BAT.  PROGS.BAT shows how BMNU can
  21. be used to construct a batch file menu system.  Menu definitions are
  22. contained in MAINMENU.MNU and UTIL.MNU.  Make sure that BMNU.EXE can
  23. be located on your PATH before running PROGS.BAT.  A startup message
  24. is displayed when you run BMNU.  It mentions that typing BMNU ? or
  25. BMNU /? will display documentation.
  26.  
  27. BMNU.EXE takes a single filespec argument that identifies a menu def-
  28. intion file.  A menu definition file consists of several ENGLISH-like
  29. instructions.  BMNU.EXE reads this file and interprets these instruc-
  30. tions before displaying the menu.  BMNU will display an error message
  31. if it reads an instruction that does not make sense (bad syntax) or a
  32. value is out of range.
  33.  
  34. The following instructions are available.
  35.  
  36. ■ comment
  37.  
  38. A comment is used to clarify an instruction.  A semicolon indicates a
  39. comment.  Everything from the semicolon to end of line is ignored.
  40.  
  41. ■ ATTR: define screen attribute
  42.  
  43. Syntax: ATTR (BD | BK | CH | HC | TL) xx
  44.  
  45. The menu screen can be "snazzied up" by specifying attributes.  Color
  46. and screen blinking are defined by an attribute.  Attributes for bor-
  47. ders (BD), the background (BK), choices (CH), the highlighted choice
  48. (HC), and title (TL) may be specified.  The "xx" consists of two con-
  49. secutive hexadecimal digits: a hex digit has value 0-9 or A-F (10-15)
  50. and each hex digit is four bits long.  An attribute is interpreted as
  51. follows.
  52.  
  53. xx: Bbbbffff
  54.  
  55. The most significant bit of the left-most digit (B) controls blinking
  56. and is set to one if blinking is desired.  Three b-bits follow.  They
  57. define the background color as follows.
  58.  
  59. 000 - BLACK
  60. 001 - BLUE
  61. 010 - GREEN
  62. 011 - CYAN
  63. 100 - RED
  64. 101 - MAGENTA
  65. 110 - BROWN
  66. 111 - LIGHT GRAY
  67.  
  68. The second hex digit consists of four f-bits.  They define the fore-
  69. ground color.
  70.  
  71. 0000 - BLACK
  72. 0001 - BLUE
  73. 0010 - GREEN
  74. 0011 - CYAN
  75. 0100 - RED
  76. 0101 - MAGENTA
  77. 0110 - BROWN
  78. 0111 - LIGHT GRAY
  79. 1000 - DARK GRAY
  80. 1001 - LIGHT BLUE
  81. 1010 - LIGHT GREEN
  82. 1011 - LIGHT CYAN
  83. 1100 - LIGHT RED
  84. 1101 - LIGHT MAGENTA
  85. 1110 - YELLOW
  86. 1111 - WHITE
  87.  
  88. ■ OPTION: define option to be included in menu
  89.  
  90. Syntax: OPTION "option"
  91.  
  92. The number of characters between the " characters must not exceed 70.
  93.  
  94. ■ STYLE: define background style
  95.  
  96. Syntax: STYLE x
  97.  
  98. The x argument is a digit from 0-3 inclusive.  A value of 0 defines a
  99. nongrainy background.  A value of 1 defines a lightgrainy background.
  100. A value of 2 defines a medium grained background.  A value of 3 spec-
  101. ifies a course grained background.
  102.  
  103. ■ TITLE: define menu title
  104.  
  105. Syntax: TITLE "title"
  106.  
  107. The number of characters between the " characters must not exceed 70.
  108.  
  109. If an error is detected in the source file, the line number where the
  110. error occurred and a suitable error message is output to the standard
  111. error device and 255 is returned to DOS.  The IF ERRORLEVEL command
  112. can check this value so that the batch file can exit gracefully.
  113.  
  114. BMNU supports a mouse.  A choice can be selected by moving the mouse
  115. cursor overtop of the choice and pressing the left mouse button.  The
  116. right mouse button or the F1 key brings up help.
  117.  
  118. Geoff Friesen
  119. Box 94
  120. Dauphin, MB
  121. Canada R7N 2T9
  122.