home *** CD-ROM | disk | FTP | other *** search
/ C!T ROM 5 / ctrom5b.zip / ctrom5b / CT / CT9501 / MINIMENU / MINIMENU.DOC < prev    next >
Text File  |  1994-09-19  |  9KB  |  193 lines
  1.                               MINIMENU 1.1
  2.            easy menu shell for children that cannot yet read
  3.                   (C) 1993,1994 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. MINIMENU.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.1 and uses Zinc Interface Library 3.6
  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 (blank icon)
  106. &Test     -        .               test.com 1 2 3
  107. * Shooting gallery
  108. Shootout  gun      d:\wargames     shoot.exe /l apple
  109. * Submenu (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.  
  115. The first non-comment line is the header. This line starts with a word that
  116. represents the text to be displayed on the exit button. An ampersand can be
  117. used to designate a hot key. Hot keys are used by pressing Alt-(key). The
  118. rest of the line is the text to be displayed in the title bar of the menu
  119. window. If you do not want to have an exit button, use - for it's text. The
  120. menu can still be exited with Ctrl-Break.
  121.  
  122. The other non-comment lines each consist of four items. First is the name of
  123. the program to be displayed on its button in the menu window. Here too, a hot
  124. key can be designated by preceding the chosen character with an ampersand.
  125. If you want a space to appear in this name, use the á (ascii 160) instead.
  126. Second is the name of the icon to be displayed on the button. This icon must
  127. reside in an iconfile, see below. A - indicates that no icon is present.
  128. The third word represents the complete drive+path where the program can be
  129. found (its home directory), this may also be just one dot to designate the
  130. current directory. The rest of the line consists of the command to start the
  131. program from its home directory. This command should always include a .com,
  132. .exe. or .bat extension.
  133.  
  134. Icon file
  135. ---------
  136. The icon file is of an internal format and can be maintained with a few
  137. utilities. Icons can be obtained from various sources. Many can be found
  138. on BBS's, simtel or garbo on Internet or can be obtained from user groups.
  139. You can also create your own with an icon editor like Ike (for Windows).
  140. The icons should be of the Windows 3.x .ico format. When you have an icon
  141. in a file called umbrella.ico and want to add it to the MINIMENU icon file
  142. test.icn type:
  143.  
  144. C> addicon test.icn umbrella.ico rain
  145.  
  146. This adds the icon as "rain" to test.icn (addicon needs icon2dat.exe in
  147. the current directory). In the command file the icon is referred to as rain.
  148. If you want to see which icons are present in iconfile test.icn type:
  149.  
  150. C> listicon test.icn
  151.  
  152. To delete icon "rain" from test.icn use:
  153.  
  154. C> delicon test.icn rain
  155.  
  156. You can use basic.icn as a starting point for your own icon files. This
  157. file only contains the icons "blank" and "quit". The first one is displayed
  158. for every program that has - as the second item in the command file. The
  159. other one is displayed on the exit button. Both can be replaced if you like,
  160. but do keep their names (blank and quit) because these are hard coded in
  161. MINIMENU.
  162.  
  163. Swap directory
  164. --------------
  165. If you use the DOS version of MINIMENU, it is important that you designate
  166. a swap directory. MINIMENU swaps itself out of the conventional memory to
  167. make room for the chosen program. If there is no extended memory, it will
  168. swap itself to disk. When the child turns the computer off during the chosen
  169. program, a hidden file, containing the swapped MINIMENU program, is left
  170. on disk. To ensure that the disk is not slowly filled up because of this,
  171. you must do the following:
  172. - make a swap directory e.g.: mkdir c:\minimenu\swap
  173. - add the following lines to your autoexec.bat file:
  174.   set SWAPDIR=c:\minimenu\swap
  175.   attrib c:\minimenu\swap\*. -h
  176.   del c:\minimenu\swap\*.
  177.  
  178.  
  179. WE HOPE YOU AND YOUR CHILD WILL ENJOY USING MINIMENU !!!
  180.  
  181. Carel & Anneke Sicherer-Roetman
  182. Roghorst 160
  183. 6708 KS Wageningen
  184. Netherlands
  185.  
  186. History:
  187.  
  188. 1.0 (930112) : - initial release
  189. 1.1 (940919) : - added possibility to omit exit button in window
  190.                - added SWAPDIR environment variable for DOS version
  191.                - improved error handling in Windows version
  192.  
  193.