home *** CD-ROM | disk | FTP | other *** search
/ TopWare Tools / TOOLS.iso / tools / top1492 / winmenu.txt < prev   
Encoding:
Text File  |  1994-02-24  |  12.3 KB  |  319 lines
  1.  
  2.                 *************************
  3.                 DOCUMENT FILE FOR WINMENU
  4.                 *************************
  5.                 version 1.70
  6.                 (c) Copyright 1994, Dr. A. Olowofoyeku
  7.  
  8. Introduction
  9. ------------
  10. WinMenu is a Shareware Menu Program for Windows 3.1. It allows users
  11. to define menu items in a plain ASCII text file and then presents
  12. these items in a list through which users can double-click on menu
  13. items. Users can have any number of such menu files.
  14.  
  15. Please read the "Legal Stuff" section at the end of this file
  16. BEFORE you make any attempt to use WinMenu.
  17.  
  18.  
  19. Installation
  20. ------------
  21. WinMenu does not have any special installation routine. All you
  22. need to do is copy the following files into your Windows directory
  23. or any other directory which is in the DOS "Path";
  24.         [a] WINMENU.EXE  (WinMenu executable program)
  25.         [b] WINMENU.HLP  (On-line help file)
  26.         [c] WINMENU.INI  (Initialisation file)
  27.         [d] WINMENU.MNU  (Default Menu file)
  28.         [e] FOYEH2.DLL   (Library file)
  29.         [f] REGISTER.TXT (info about registration, and registration sites)
  30.         [g] ORDER.FRM    (a fill-in registration form)
  31.         [h] WINMENU.TXT  (ASCII format document file - this file)
  32.  
  33. After copying these files, then you need to create a program item
  34. for it under one of the Program Manager groups, and supply "WINMENU.EXE"
  35. as the command line (including the full directory path, if the directory
  36. in which it is situated is NOT in the DOS Path).
  37.  
  38.  
  39. REGISTRATION
  40. ------------
  41. WinMenu is NOT a free program. It is released under the Shareware
  42. principle. This means you get to test it for free, for a MAXIMUM period
  43. of 30 days. If you like it and wish to continue to use it beyond this
  44. period, you are then requested to please register your copy. The regis-
  45. tration fee is £10 (Ten Pounds Sterling), or US$15, which is very modest.
  46.  
  47.  
  48. To register your copy of WinMenu, please send the REGISTRATION FEE
  49. to me at the address below, or to your local REGISTRATION SITE (please
  50. see the file REGISTER.TXT for a list of my world wide regsitration
  51. sites, with which you can register in your own currency);
  52.  
  53. Please fill in the form in the file ORDER.FRM (or print the
  54. "REGISTRATION FORM" section in the on-line help).
  55.  
  56.  
  57.         Dr. A. OLOWOFOYEKU
  58.         268 HORWOOD
  59.         NEWCASTLE
  60.         STAFFS ST5 5BQ
  61.         ENGLAND.
  62.         E-Mail: laa12@keele.ac.uk
  63.                 chief@mep.com
  64.  
  65.  
  66. REGISTRATION provides the following benefits;
  67.      [a] A clear conscience
  68.      [b] The satisfaction of being an honest person.
  69.      [c] You will be very cool indeed
  70.  
  71.  
  72.  
  73. If you feel that WINMENU is not worth paying for, then I ask you
  74. to please DELETE it from your disks immediately.
  75.  
  76. Please note that since this program is not crippled or disabled in
  77. anyway (and there are no nagging messages) NO DISKS will be sent
  78. when you register.
  79.  
  80.  
  81.  
  82. Features
  83. --------
  84. As a menuing program, WinMenu provides the following facilities;
  85.         [1] Password control for individual menu items
  86.         [2] Master Password which if used will not permit users to run
  87.             or close the program itself without the correct master password.
  88.         [3] Up to 29 menu items in each menu file
  89.     [4] The facility to change the Windows Shell in SYSTEM.INI, and
  90.         the settings on the "RUN=" and "LOAD=" lines in WIN.INI,
  91.         from WITHIN WinMenu.
  92.         [5] A "Shell to Dos" menu option
  93.         [6] Ability to shut down Windows itself
  94.         [7] On-line help
  95.         [8] Saving the last position of the program's window when you exit,
  96.             so that the program window will be positioned there when next
  97.             WinMenu is run
  98.         [9] Ability to be used as the Windows Shell instead of the Program
  99.             Manager. In this case, the following extra facilities are
  100.             available;
  101.                 [a] Running command line parameters supplied when Windows
  102.                     was started
  103.                 [b] Running the programs in the "Load=" and "Run=" lines in
  104.                     the WIN.INI file
  105.                 [c] Saving the state of the Windows Desktop and restoring it
  106.                     when next Windows is run.
  107.  
  108.  
  109. Summary of Commands/Instructions (same as that in the help file)
  110. ----------------------------------------------------------------
  111.  
  112. ENTRIES IN WINMENU.INI
  113. ----------------------
  114.     1. LOCATION-HORIZONTAL= This keeps track of the LEFT SIDE
  115.     of the WinMenu window when it was last closed. Users will 
  116.     NEVER need to change the settings.
  117.     2. LOCATION-VERTICAL= This keeps track of the TOP of the WinMenu
  118.     window when it was last closed. Users will NEVER need to change 
  119.     the settings.
  120.     3. SAVE-DESKTOP= This indicates whether WinMenu should Save 
  121.     the state of the Windows desktop upon exit. If set to 1 (one) 
  122.     then this is done, and the desktop will be restored when Windows 
  123.     is next run. If set to 0 (zero) thenthe desktop is not saved. 
  124.     This setting will be ignored UNLESS WinMenu is the Windows Shell.
  125.     4. MENU-EDITOR= This specifies the editor to use for editing the 
  126.     current Menu Definition File (this is a plain ASCII text file). 
  127.     The default is the Windows Notepad. You can put your favourite 
  128.     text editor here if you wish. If no entry is found here, then 
  129.     the Windows Notepad will be used.
  130.  
  131.  
  132. Running Menu Items
  133. ------------------
  134. To run a menu item you just need to double-click on the required item.
  135.  
  136. **********
  137. FILE  MENU
  138. **********
  139. Update The Menu List
  140. --------------------
  141. This option is useful only when the contents of the Menu Description File
  142. (MDF) have been changed and you want these changes to take effect
  143. immediately (e.g., supplying a new password for a particular item, or adding
  144. a new menu item). The MDF will be opened and read again. Its contents will
  145. replace the ones currently in the list being used.
  146.  
  147. New Menu File
  148. -------------
  149. This is used to change the current MDF. The default MDF is
  150. WINMENU.MNU but you can always specify another file as a parameter to 
  151. WinMenu. Alternatively, when this item is selected, you are presented 
  152. with a  list of files from which to choose a new one. By default, only 
  153. files with the extension .MNU will be listed. However, you can always
  154. change this.
  155.  
  156. When the new MDF is selected, WinMenu is re-started, with the new MDF 
  157. loaded as the default menu file.
  158.  
  159. Open The Menu File
  160. ------------------
  161. This is used to EDIT the contents of the CURRENT MDF. WinMenu will
  162. load the current MDF into the Windows Notepad editor, or whatever EDITOR 
  163. you have put on the "MENU-EDITOR=" line in WINMENU.INI. After saving the 
  164. changes, you have to select the "Update The Menu List" menu option 
  165. for the changes to have immediate effect.
  166.  
  167. Exit WinMenu
  168. ------------
  169. Selecting this option will close down WinMenu.
  170.  
  171.  
  172. ***********
  173. SYSTEM MENU
  174. ***********
  175.  
  176. Windows Configuration
  177. ---------------------
  178. This allows users to change certain settings in WIN.INI and SYSTEM.INI, viz. 
  179. the Windows Shell, the "RUN=" line, and the "LOAD=" line  (these settings 
  180. should NOT be changed unless users know what they are doing - this is why
  181. the dialog box is marked "Advanced Users Only". You have been warned).  When 
  182. this menu item is selected, a dialog box appears which shows the current 
  183. values of these three  settings. You can move round them with the mouse or 
  184. the TAB key. If you do not want to change anything, click on the "Cancel"  
  185. button. If you want to SAVE any change, click on the "Update Files" 
  186. button - the changes will then be written to WIN.INI and SYSTEM.INI. 
  187.  
  188. Dos Shell
  189. ---------
  190. This will take you to the DOS command line (Windows is STILL running,
  191. but you will be at the DOS prompt, where you can use DOS commands). 
  192. You should return to WinMenu by typing "EXIT" at the DOS prompt.
  193.  
  194. Quit Windows
  195. ------------
  196. As the title suggests, this option will close down the current Windows
  197. Session. You will be asked to confirm that you wish to do this.
  198.  
  199.  
  200.  
  201. HELP  MENU (Contents)
  202. ---------------------
  203. Loads the help file
  204.  
  205. HELP  MENU (About)
  206. -----------------
  207. Displays the infamous "About" box.
  208.  
  209. *************
  210. WINDOWS SHELL
  211. *************
  212. WinMenu can be used as your Windows Shell. You do this by putting
  213. WINMENU.EXE on the "Shell=" line in your SYSTEM.INI file (make sure
  214. that you first make a back up copy of SYSTEM.INI).
  215.  
  216. When WinMenu is your Windows Shell, it will execute the programs in the
  217. "RUN=" and "LOAD=" lines in your WIN.INI file, and also any command line
  218. parameters that you supply when starting Windows.
  219.  
  220. This can be used as a security enhancement measure. If WinMenu is your
  221. Windows Shell, and a Master Password is used,  a user will not be able to
  222. start or quit Windows without supplying the Master Password (see below).
  223.  
  224. "SAVE-DESKTOP"
  225. --------------
  226. Also, when WinMenu is your Windows Shell, AND the "SAVE-DESKTOP="
  227. line in your WINMENU.INI file is set to 1 (default is 0) then the state 
  228. of your Windows Desktop (i.e., all running Windows applications in 
  229. their current state) will be saved when you Exit WinMenu, and restored 
  230. when next you run Windows. If WinMenu is NOT your Windows Shell, this 
  231. line is ignored.
  232.  
  233.  
  234. FORMAT OF MENU DESCRIPTION FILES
  235. --------------------------------
  236. MDFs must have the following format;
  237.  
  238. 1. The FIRST LINE must contain the TITLE of the menu program's Main
  239. Window, or be left blank (i.e., if you do not want to supply a title, 
  240. then the line must be left empty.
  241.  
  242. If a title is supplied (no more than 25 letters), a MASTER PASSWORD may
  243. be supplied, AFTER a comma. If a master password is supplied, it will not be
  244. possible to Exit WinMenu, Update the Menu List, Change the Menu File, open
  245. a Dos Shell, or Quit Windows (i.e., the items in the "FILE" menu will be
  246. inaccessible) without supplying the master password. Note that ALL passwords
  247. are case sensitive.
  248.  
  249. 2. Lines 2 to 30 in each MDF will contain the menu descriptions. There are
  250. four parts to each menu description, and each part MUST be separated from
  251. the one preceding it by a COMMA. Each menu description MUST be on a
  252. single line, and in the following format; 
  253.     Item Title,  Command Line,   Parameters, Password
  254.  
  255. Of these four parts, only the first two are necessary. The parameters 
  256. and  passwords may be left out.
  257.  
  258. e.g., Word Perfect For Windows,  C:\WPWIN\WPWIN.EXE, client.doc, my_passwd
  259.  
  260. In the above example, WPWIN.EXE is told to load client.doc, and my_passwd
  261. is the supplied password.
  262.  
  263. Word For Windows, C:\WINWORD\WINWORD.EXE,  ,my_passwd
  264.  
  265. In the above example, no parameter is passed to WINWORD.EXE, but a
  266. password is supplied.
  267.  
  268.  
  269. Ventura For Windows, D:\VPWIN\VPWIN.EXE
  270.  
  271. In this example, VPWIN.EXE is passed no parameter, and no password is
  272. supplied for this menu description.
  273.  
  274. Licence
  275. -------
  276. WinMenu is copyrighted software, but you may distribute it freely, as
  277. long as ALL the supplied files are included, and NO attempt is made
  278. to modify any of them. Note that WINMENU.EXE will NOT work at all if
  279. it is tampered with in any way. This is an anti-virus security check.
  280.  
  281. WinMenu may NOT be bundled with any commercial software without
  282. PRIOR WRITTEN PERMISSION from me. "Commercial software" does notinclude
  283. shareware, user supported, or public domain programs. WinMenu may be
  284. freely bundled with these, but please inform me in writing of any
  285. program that you bundle it with.
  286.  
  287.  
  288. Legal Stuff
  289. -----------
  290. WinMenu is supplied without ANY WARRANTIES WHATSOEVER. I
  291. accept no responsibility for any loss or damage, whether it be financial,
  292. physical, or psychological, resulting from the use or the purported
  293. use of WinMenu for any purpose whatsoever. 
  294.  
  295. You use WinMenu ENTIRELY at your own risk. If these conditions are 
  296. not acceptable to you, then you have NO LICENCE to use WinMenu. You 
  297. should DELETE the program from your disks IMMEDIATELY.
  298.  
  299.  
  300. Bug Reports
  301. -----------
  302. I have tested WinMenu extensively on PCs based on the 286 processor
  303. and upwards, running under Standard and Enhanced Mode Windows. To the
  304. best of my knowledge, I have ironed out all bugs. I however accept
  305. that there may be bugs of which I am not aware. Bugs reports are 
  306. therefore welcome (even if you are not a registered user). I cannot
  307. promise to fix all bugs, but I will try my best. If you find any bug
  308. or problem, please indicate whether it can be reproduced (bugs should
  309. be reproduceable).
  310.  
  311.  
  312. ****************************
  313. (c) 1994, Dr. A. Olowofoyeku
  314. 268 Horwood
  315. Newcastle
  316. Staffs ST5 5BQ
  317. England.
  318. ****************************
  319.