home *** CD-ROM | disk | FTP | other *** search
/ Best Objectech Shareware Selections / UNTITLED.iso / boss / util / menu / 009 / menu.doc < prev    next >
Encoding:
Text File  |  1993-01-12  |  7.3 KB  |  165 lines
  1.                               MINIMENU 1.0
  2.            easy menu shell for children that cannot yet read
  3.                    (C) 1993 SichemSoft Netherlands
  4.  
  5. Introduction
  6. ------------
  7. This package was developed by us for our 4 year old daughter. We wanted her
  8. to be able to start any program herself. Since she can't yet read, this was
  9. not possible without our help. We tried several shareware or public domain
  10. "easy" menu shell systems, but all required the user to be able to read.
  11. So, we wrote MINIMENU.
  12. The child only has to point to a picture button with the arrow keys or by
  13. repeatedly pressing Tab and then press Enter or click on it with the mouse.
  14. After the chosen program finishes, MINIMENU appears again, ready for the
  15. next choice.
  16. MINIMENU works both in DOS and in Windows. The parent (or other adult of
  17. course) only has to add a line to a text file and add an icon to an iconfile
  18. and a just installed new game is instantly accessible for the child.
  19.  
  20. Registration
  21. ------------
  22. Please note that this package is for home use only. Any commercial usage
  23. is strictly prohibited. Neither the package, nor any part of it, may be
  24. sold. If you'd like to pass it on, you must include all original files.
  25. This program is SHAREWARE. This means that when you have tried it out and
  26. decide to use it on a regular basis you are required to register. This can
  27. be done at no charge at all, simply by sending us a picture postcard from
  28. where you live or work. The address is:
  29.    Carel & Anneke Sicherer-Roetman
  30.    Roghorst 160
  31.    6708 KS Wageningen
  32.    Netherlands
  33. If you have any questions or suggestions please send them to this address
  34. or email them to: anneke@chem.ruu.nl
  35.  
  36. System requirements
  37. -------------------
  38. This program should run on any IBM-PC compatible computer with at least 512KB
  39. memory and running under DOS 3.x or later. It requires an EGA, VGA or Hercules
  40. graphics adapter or Windows 3.1. A mouse is recommended but not required.
  41.  
  42. Installation
  43. ------------
  44. Just copy the files to a directory, e.g. c:\minimenu.
  45. The package consists of the following files:
  46.  
  47. MENU.DOC           You're reading it now
  48. MENU.EXE           DOS main program
  49. WMENU.EXE          Windows main program (works only under Windows 3.x)
  50. MENU.CMD           Command file (example)
  51. MENU.ICN           Icon file (example)
  52. BASIC.ICN          Basic icon file
  53. ADDICON.EXE        Adds one icon (Windows format) to an icon file
  54. ICON2DAT.EXE       Converts Windows icon format to internal icon format
  55. DELICON.EXE        Deletes one icon from an icon file
  56. LISTICON.EXE       Lists all icons in an iconfile
  57. TEST.BAT           Batch file for use with example command and icon files
  58.  
  59. On the child's computer only (W)MENU.EXE and at least one .ICN and .CMD
  60. file are required. Start (w)menu.exe from the autoexec.bat!
  61.  
  62. Copyrights
  63. ----------
  64. MINIMENU is (C) SichemSoft, Roghorst 160, 6708 KS Wageningen, Netherlands.
  65. MINIMENU was written in Borland C++ 3.0 and uses Zinc Interface Library 3.0
  66. for it's GUI. The utility icon2dat.exe is (C) Zinc Software but can be freely
  67. downloaded from their BBS. MINIMENU uses the SPAWNO routines by Ralf Brown
  68. to minimize memory use while running other programs. The executables were
  69. compressed using LZEXE of Fabrice Bellard.
  70.  
  71. Usage
  72. -----
  73. After installation, type "menu" at the prompt to see an example of how it
  74. works. If you have a mouse, load it's driver first! Use Tab and Enter or
  75. point and click to select your program. Click on Stop or press Alt-S to quit.
  76.  
  77. The complete command line for starting minimenu is:
  78.  
  79. C> menu [ command file [ icon file ] ]
  80.  
  81. Both file names are optional. Default names are menu.cmd and menu.icn
  82. respectively. For a given set of programs, a command file and an icon file
  83. should be prepared. On the child's computer only (W)MENU.EXE and these two
  84. files must be present. Both files are always expected to be in the current
  85. directory when (w)menu.exe starts. (w)menu.exe should be started from the
  86. autoexec.bat. If you have a mouse, be sure to precede this command by a
  87. command to load the mouse driver.
  88. On VGA, 24 buttons can be displayed at once, on Hercules 21 and on EGA 16.
  89. If you need more buttons, use a submenu (see the command file example below).
  90.  
  91. Command file
  92. ------------
  93. The command file is a plain text file that can be created with any text
  94. editor. It consists of comment lines, a header line and command lines.
  95. An example is given here:
  96.  
  97. * example MINIMENU command file
  98. * header line:
  99. &Quit     Games menu
  100. * program lines:
  101. * Captain Comic
  102. Comic     comic    c:\games\comic  comic.bat
  103. * Commander Keen
  104. Keen      keen     c:\games\keen   keen1.exe
  105. * Test program
  106. Test      -        .               test.com 1 2 3
  107. * Shooting gallery
  108. Shootout  gun      d:\wargames     shoot.exe /l apple
  109. * Next menu (this is a second instance of minimenu!)
  110. Numbers   numbers  c:\education    c:\minimenu\menu.exe edu.cmd edu.icn
  111. * (end)
  112.  
  113. Comment lines have a * at the first position.
  114. The first non-comment line is the header. This line starts with a word that
  115. represents the text to be displayed on the exit button. An ampersand can be
  116. used to designate a hot key. Hot keys are used by pressing Alt-(key). The
  117. rest of the line is the text to be displayed in the title bar of the menu
  118. window.
  119. The other non-comment lines each consist of four items. First is the name of
  120. the program to be displayed on its button in the menu window. Here too, a hot
  121. key can be designated by preceding the chosen character with an ampersand.
  122. Second is the name of the icon to be displayed on the button. This icon must
  123. reside in an iconfile, see below. A - indicates that no icon is present.
  124. The third word represents the complete drive+path where the program can be
  125. found (its home directory), this may also be just one dot to designate the
  126. current directory. The rest of the line consists of the command to start the
  127. program from its home directory. This command should always include a .com,
  128. .exe. or .bat extension.
  129.  
  130. Icon file
  131. ---------
  132. The icon file is of an internal format and can be maintained with a few
  133. utilities. Icons can be obtained from various sources. Many can be found
  134. on BBS's, simtel or garbo on Internet or can be obtained from user groups.
  135. You can also create your own with an icon editor like Ike (for Windows).
  136. The icons should be of the Windows 3.x format. When you have an icon in
  137. a file called umbrella.ico and want to add it to the MINIMENU icon file
  138. test.icn type:
  139.  
  140. C> addicon test.icn umbrella.ico rain
  141.  
  142. This adds the icon as "rain" to test.icn (addicon needs icon2dat.exe in
  143. the current directory). In the command file the icon is referred to as rain.
  144. If you want to see which icons are present in iconfile test.icn type:
  145.  
  146. C> listicon test.icn
  147.  
  148. To delete icon "rain" from test.icn use:
  149.  
  150. C> delicon test.icn rain
  151.  
  152. You can use basic.icn as a starting point for your own icon files. This
  153. file only contains the icons "blank" and "quit". The first one is displayed
  154. for every program that has - as the second item in the command file. The
  155. other one is displayed on the exit button. Both can be replaced if you like,
  156. but do keep their names (blank and quit) because these are hard coded in
  157. MINIMENU.
  158.  
  159. WE HOPE YOU AND YOUR CHILD WILL ENJOY USING MINIMENU !!!
  160.  
  161. Carel & Anneke Sicherer-Roetman
  162. Roghorst 160
  163. 6708 KS Wageningen
  164. Netherlands
  165.