home *** CD-ROM | disk | FTP | other *** search
/ The World of Computer Software / World_Of_Computer_Software-02-387-Vol-3of3.iso / e / epstein1.zip / README.TXT < prev    next >
Text File  |  1993-02-21  |  13KB  |  294 lines
  1.  
  2.  
  3.  
  4.                                                 Epstein MenuMaker
  5.                                                 Beta/Freeware 1.0 (2/20/93)
  6.                                                 (C) 1992 Epstein Enterprises
  7.                                                 (C) 1993 Jeff Epstein
  8.                                                 THIS IS FREE SOFTWARE!
  9.                                                 (Whoopeee!)
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29. LEGAL STUFF
  30. MenuMaker is copyrighted software.  However, you may copy MenuMaker
  31. Beta/Freeware 1.0 and distribute it, as long as there is no fee involved,
  32. and it is unmodified and copied in its entirety, including all documentation,
  33. executable files, and this copyright notice.
  34.  
  35. -----------------------------------------------------------------------------
  36.  
  37. This is the Beta/Freeware version of Epstein MenuMaker.  The files included
  38. in this package should be:
  39.  
  40. INSTALL.BAT     The ultra-primitive installation routine.
  41. MM.BAT          The menu executor.  Don't rename, move, or copy this,
  42.                 or else MenuMaker won't work!  (ouch)
  43. MMB.EXE         The main menuing engine.  Don't rename this either.
  44. MAIN.EMM        A sample main menu.
  45. UTIL.EMM        A sample sub-menu.
  46. SAVE.EXE        The stand-alone screen saver.
  47. SAVEDAT.ESS     Sample screen saver setup file.
  48. NOBREAK.EXE     6K TSR that turns off Ctrl-Break checking.
  49. README.TXT      Documentation.
  50.  
  51. Contents:
  52.         What is Epstein MenuMaker?
  53.         How do I install Epstein MenuMaker?
  54.         What does Epstein MenuMaker look like?
  55.         How do I set up Epstein MenuMaker?
  56.         How do I use Epstein MenuMaker security?
  57.         What are hidden items?
  58.         How do all those batch files work together?
  59.         How do I use the other Epstein utilities?
  60.         How do I create a .ESS file?
  61.         How do I get a non-beta version?
  62.  
  63. WHAT IS EPSTEIN MENUMAKER?
  64. Epstein MenuMaker is a simple menuing system designed to keep your
  65. applications in nice, easy-to-access groups.  It also has these handy
  66. features, among others:
  67.  
  68. - Does not remain in memory during the execution of a program for optimal
  69.         speed and compatibility.
  70. - Menus can be created or modified with any ASCII text editor.
  71. - Offers advanced password protection.
  72. - Includes a screen saver.
  73.  
  74. HOW DO I INSTALL EPSTEIN MENUMAKER?
  75.  
  76. For best results, you should place the directory that you install
  77. MenuMaker in on your AUTOEXEC.BAT file's PATH statement, and also
  78. include it on the APPEND line (if you have one).  For example, if you
  79. install MenuMaker to C:\EPSTEIN, you should include the line:
  80.  
  81. APPEND=C:\EPSTEIN
  82.  
  83. You install MenuMaker by using the INSTALL program.  To Install, use the
  84. format:
  85.  
  86. INSTALL x: \dir
  87.  
  88. Where x: is the drive, and \dir is the directory where you want MenuMaker
  89. installed.
  90.  
  91. During installtion, the EMM.BAT file is created.  You can start MenuMaker
  92. by running the EMM.BAT file.
  93.  
  94. WHAT DOES EPSTEIN MENUMAKER LOOK LIKE?
  95. Once you start MenuMaker, by typing EMM and hitting enter, the Main Menu
  96. is displayed.  Across the top is the information bar that displays
  97. the name, Epstein MenuMaker, and, optionally, a clock with the date and time.
  98. At the bottom of the screen is the title bar, that displays the menu title,
  99. or the built-in help, or the "hidden" items (see HIDDEN ITEMS).  In the
  100. middle, on the floating blue window, there should be a set of sample items.
  101. An item can be either a program item, or a menu item.  A program item runs
  102. a program, and a menu item opens a menu.  The menu that a menu item opens
  103. is called a sub-menu.
  104.  
  105. You can move the highlight bar from item to item by using the cursor keys.
  106. Once an item is highlighted that you wish to execute, you can run it by
  107. pressing [Space] or [Enter].
  108.  
  109. HOW DO I SET UP MENUMAKER?
  110. Once in MenuMaker, you can press [F1] or [?] to get help, [Esc] to quit, or
  111. use the cursor keys to highlight an item and run it.  Each menu can
  112. accommodate up to 20 items, including a gateway back to the previous menu.
  113.  
  114. Each menu is stored in a file with a .EMM extension.  For example, a menu
  115. that has utility programs on it might be named UTILITY.EMM.  Each .EMM
  116. file is an ASCII, plain text file that contains several lines that set
  117. configuration details or define the items that will appear on the menu.
  118.  
  119. The format for each line is:
  120.  
  121. command=parameter;parameter;...parameter
  122.  
  123. Some lines can have as many as five parameters.  Other may only have one.
  124. Here is a short "command reference," on the various commands available to
  125. a .EMM file and what they do.  All commands are optional, although you must
  126. include at least one ITEM= line.  However, most commands have defaults and do
  127. not need to be specified unless you want an option other than the default.
  128.  
  129. ITEM=run;n;Title;C:\DIR;PROGRAM.EXE
  130. -----------------------------------
  131. Defines a new program item on the menu.
  132. -----------------------------------
  133. Parameters:
  134.  
  135. run             Can be one of RUN, PSW, PARAM, or PSW_PARAM.  RUN is the
  136.                 default if left blank.  PSW prompts for a password, if
  137.                 password protection has been enabled (see PSW= command).
  138.                 PARAM prompts for optional command-line parameters, and
  139.                 PSW_PARAM prompts for both password and parameters.
  140. n               Either N or Y.  If Y, there is a pause after the execution
  141.                 of this program.  Otherwise, there is not.  Defaults to N.
  142. Title           The entry name that appears on the menu.  Can be up to 27
  143.                 characters long.
  144. C:\DIR          The default directory to start the program in.
  145. PROGRAM.EXE     The name of the program to run.
  146. -----------------------------------
  147. Additional notes: All parameters are optional.  However, each item line must
  148. contain four semicolons.  For example, the following is valid:
  149. ITEM=;;dBASE III+;;DBASE
  150. However, DBASE.BAT, DBASE.COM, or DBASE.EXE must be on your path for the
  151. above to work.
  152. To create a blank entry use:
  153. ITEM=;;;;
  154. Or you can name a sub-section within a single menu with something like this:
  155. ITEM=;;System Utilities;;
  156.  
  157. MENU=run;MENUFILE.EMM
  158. ---------------------
  159. Creates a gateway to another menu file.
  160. ---------------------
  161. run             Similar to the run parameter in ITEM=, this can be either
  162.                 RUN or PSW.  The default is RUN.  If PSW, then password
  163.                 entry is required if password protection is turned on.
  164. MENUFILE.EMM    The filename of the menu file, .EMM extension optional.
  165.                 A sub-menu file follows exactly the same format as the
  166.                 main menu file, except one entry should be a gateway
  167.                 pointing back to the MAIN.EMM file (see below).
  168. ---------------------
  169. Additional notes: The RUN paremeter is optional.  However, you must
  170. have one semicolon.  For example, the following is valid:
  171. MENU=;MOREPROG
  172. Also, each sub-menu should have an entry like this:
  173. MENU=run;main
  174. to act as a gateway back to the main menu.
  175.  
  176. SAVE=time
  177. ---------
  178. Specifies the delay until the screen saver automatically kicks in.
  179. ---------
  180. time            The time, in minutes, until the screen saver kicks in.
  181.                 Set to 0 for no screen saver.
  182.  
  183. DISPLAY=text
  184. ------------
  185. Specifies the text to display on the screen saver.
  186. ------------
  187. text            The text to display.
  188.  
  189. TITLE=text
  190. ----------
  191. Specifies the text displayed in the title bar of the menu.
  192. ----------
  193. text            The title of the menu.  If the menu is a sub-menu, or has
  194.                 a gateway from another menu, then the menu item serving
  195.                 as a gateway to this menu uses this text as a title, also.
  196.                 For example, if a line in SUBMENU.EMM is "TITLE=Sub Menu 1",
  197.                 and a menu item in MAIN.EMM reads "MENU=;submenu", then
  198.                 there will be an item on the Main Menu that is called
  199.                 "Sub Menu 1".  If this is unspecified, then it defaults
  200.                 to the filename of the menu.
  201.  
  202. CLOCK=mode
  203. ----------
  204. Specifies the clock display mode.
  205. ----------
  206. mode            Either ON, OFF, or ALT.  ON displays the clock in the
  207.                 default mode.  OFF turns off the clock display.  And
  208.                 ALT displays the clock in the alternate format (my favorite).
  209.  
  210. PSW=text
  211. --------
  212. Turns on password protection and sets the password.
  213. --------
  214. text            The password that is required to run an item that has the
  215.                 PSW or PSW_PARAM parameter.  Leave blank for no protection.
  216.  
  217. HOW DO I USE EPSTEIN MENUMAKER SECURITY?
  218. To install the security feature, just include the PSW= line in the menu file
  219. you want to install security for.  Then, whenever the user attempts to quit
  220. MenuMaker, or run an item labeled with PSW or PSW_PARAM, he or she is
  221. required to enter the password.
  222.  
  223. WHAT ARE HIDDEN ITEMS?
  224. You will notice that although MenuMaker can store up to 20 items per menu,
  225. only 18 are displayed initially.  What happened to those last two?  If you
  226. press [F1], then the title bar switches from the menu title to the help list.
  227. If you have more than 18 items and you press [F1] a second time, then the
  228. last two items are displayed, and can be invoked by pressing [A] or [B].
  229. However, this "secret menu" does not need to be displayed to run them.
  230. You can press [A] or [B] at any time, assuming that the last two are defined.
  231. These are best suited to sub-menus that you need to access quickly.  You
  232. can force items into the 19th and 20th positions, thereby hiding them,
  233. by adding blank item lines (ITEM=;;;;) as necessary.
  234.  
  235. HOW DO ALL THOSE BATCH FILES WORK TOGETHER?
  236. EMM.BAT, the program that you run to start Epstein MenuMaker, is simply
  237. charged with the job of changing to the appropriate directory and running
  238. MM MAIN.  MM.BAT is the batch file that controls the system, and you
  239. should not rename/delete/move this file.  MM starts by calling MMB.EXE,
  240. with the parameter passed to it by EMM.  MMB.EXE opens MAIN.EMM, and displays
  241. the menu, ready to accept user input.  If the user quits MMB.EXE by pressing
  242. Esc, then MMB terminates, and leaves an ERRORLEVEL value of 2. MM.BAT picks
  243. up on this, and ends.
  244.  
  245. If the user selects a program or menu, though, then MMB.EXE creates
  246. MMBDAT.BAT, and leaves an ERRORLEVEL value of 1.  MM picks up on this,
  247. and runs MMBDAT.BAT, which again calls MMB.  Although this process may
  248. sound complicated, it is through this unique method that MenuMaker
  249. occupies no memory when it runs a program.
  250.  
  251. HOW DO I USE THE OTHER EPSTEIN UTILITIES?
  252. MenuMaker also includes several other programs, most notably Epstein
  253. ScreenSaver and NoBreak.
  254.  
  255. ScreenSaver is run through the SAVE.EXE program.  You can type SAVE /?
  256. to get command-line help.  Here is a brief overview of the parameters.
  257.  
  258. SAVE text               Displays text while saving.
  259. SAVE /0 text            Displays text while saving using alternate saver.
  260. SAVE /F file            Loads screen saver file.  More on this later.
  261.  
  262. NoBreak is a security feature that turns off Ctrl-Break checking in
  263. batch files.  It occupies 6K of memory.  You can load it by running
  264. NOBREAK.EXE.
  265.  
  266. HOW DO I CREATE A .ESS FILE?
  267. Epstein ScreenSaver can data stored in .ESS files.  You can load a .ESS
  268. file by using running SAVE /F file.ESS.  The format of a .ESS file is
  269. similar to that of a .EMM file.  Each option below is included on a seperate
  270. line in a .ESS file.  Here is the "command reference," for ScreenSaver files:
  271.  
  272. TEXT=text
  273. Sets the screen saver display string.
  274.  
  275. MODE=mode
  276. Either NORM or ALT.  Defaults to NORM.
  277.  
  278. PSW=password
  279. Enables password protection and sets the password.  The user is required
  280. to enter this password before leaving ScreenSaver.  Leave this blank
  281. for no protection.
  282.  
  283. HOW DO I GET A NON-BETA VERSION OF EPSTEIN MENUMAKER?
  284. As of today, this is all that there is.  However, I am working on a real,
  285. full-blown menu system, which will have, among other things, an installation
  286. that will scan the disk and find recognized applications, and, as soon as
  287. available, you can have it for a very modest fee.  Epstein Enterprises
  288. also does computer consultations, so if you need any help on your choice
  289. of computer, software, OS, etc.. for your home or office, then you can
  290. contact me for help.  I can also be contacted on the Internet at
  291. writeon@world.std.com, or on the Boston Computer Society IBM Group BBS
  292. as Jeff Epstein, but nowhere else, unfortunately.  Drop me an e-line, and
  293. I'll see what I can do.
  294.