home *** CD-ROM | disk | FTP | other *** search
/ Windoware / WINDOWARE_1_6.iso / winutil / bckmn139 / backmenu.txt < prev    next >
Text File  |  1991-03-01  |  8KB  |  240 lines
  1. Back-Menu V1.39
  2. ===============
  3.  
  4. Back-Menu is a program that allows you to define a pop-up menu on the
  5. Windows 3.0 background and use it to quickly run applications and tools.
  6. The idea came from using X-Windows and Sunview, where the user has a root
  7. menu that can be configured.
  8.  
  9. It allows you to describe a set of actions and associate command lines with
  10. them. To bring up the menu simply click with the mouse button (let, middle or
  11. right) on the Windows desktop. This will bring up the description list.
  12. Selecting a description will cause the appropriate command line to be executed.
  13.  
  14. There are six fixed options in the menu. The first five appear under the
  15. 'Back-Menu Options' walking menu. They are:-
  16.  
  17.         1) 'Execute...' - allows a command line to be typed and executed.
  18.        Back-Menu now supports a history mechanism, and will remember the last
  19.        10 commands typed. These commands are stored and will be available
  20.        whenever Back-Menu is run.
  21.  
  22.     2) 'Reload Menu From File' - makes Back-Menu read its configuration
  23.        file again to update the menu contents.
  24.  
  25.     3) 'Set Options...' - Brings up a dialog box from which you can
  26.        set the default start-up menu and which mouse button activates
  27.        the menu.
  28.  
  29.     4) 'About...' - speaks for itself.
  30.  
  31.     5) 'Remove Back-Menu' - un-installs the program. This option is
  32.        only present if you are not using Back-Menu as the shell.
  33.  
  34.     6) 'Exit Windows', which safely exits from Windows back to DOS.
  35.  
  36.  
  37.  
  38. Configuration Files
  39. ===================
  40.  
  41. By default, Back-Menu looks for a file called BACKMENU.INI in the same
  42. directory as BACKMENU.EXE. The menu file name can be changed by using
  43. the 'Set Options...' option.
  44.  
  45. A configuration file is simply a set of lines (one for each description/command
  46. line pair). The syntax for a menu item is:-
  47.  
  48.     Menu Item description,application,optional start-up dir
  49.  
  50. Blank lines may be placed between items, to cause a separator line to be
  51. placed in the menu.
  52.  
  53. Eg.                    Gives:
  54.                     +---------+
  55. Item 1,CMD1.EXE                | Item 1  |
  56.                     |---------|
  57. Item 2,CMD2.EXE FRED.TXT        | Item 2  |
  58. Notepad,NOTEPAD.EXE            | Notepad |
  59.                     +---------+
  60.  
  61.  
  62. This version of BACKMENU also supports cascading menus. A cascading menu item
  63. is one that has multiple options associated with it. By clicking on the item,
  64. another menu appears with the options on it. It is even possible to have further
  65. cascading menus associated with one or more items within that menu.
  66.  
  67. Associating multiple items with a single menu item is simple. The definition
  68. is:-
  69.     >Item Name
  70.         Sub menu item 1,program
  71.         Sub menu item 2,program
  72.         ...
  73.     !
  74.  
  75. That is, the sub-menu is enclosed between a '>' and a '!'. The text that follows
  76. the '>' is the text to appear in the menu (a description of the sub-menu).
  77.  
  78. In the example, 'Name' will appear in the menu, and when clicked upon produce a
  79. sub-menu with the items defined. Definining items within a sub-menu is done
  80. in exactly the same way as for a main menu (even to the extent of adding a
  81. sub-menu to this sub-menu). Eg:-
  82.  
  83.     >Editors
  84.         Andy's editor,AE.EXE
  85.         Notepad,NOTEPAD.EXE
  86.         >Word processors
  87.             Word for Windows,WORD.EXE
  88.             Windows Write,WRITE.EXE
  89.         !
  90.         Multi-Pad,MULTIPAD.EXE
  91.     !
  92.     ...
  93.  
  94. There is no limit to the number of items you can have in any particular
  95. menu.
  96.  
  97.  
  98.  
  99. Start-Up Directory
  100. ==================
  101.  
  102. As of version 1.3, Back-Menu will change to the directory containing the
  103. executable program and then run it if a path is specified. Eg.
  104.  
  105.     Corel Draw,C:\CORELDRW\CORELDRW.EXE
  106.  
  107. will change to the directory C:\CORELDRW and then run CORELDRW.EXE. If no
  108. path is specified, the application will be started in the current directory
  109. (whatever that happens to be).
  110.  
  111. It is possible with Back-Menu to start up an application and set a different
  112. working directory for that program. To do this, specify the optional start
  113. up directory after the application. Eg. excel lives in c:\excel. We want to
  114. have excel start up in a work directory d:\data\excel. To do this, the menu
  115.  option would be:-
  116.     Excel + Work directory,c:\excel\excel.exe,d:\data\excel
  117.  
  118.  
  119.  
  120. Using Back-Menu as the Start-Up Shell
  121. =====================================
  122.  
  123. Back-Menu can now be used in place of Program Manager as the default shell
  124. for Windows. To install it simply edit SYSTEM.INI which is in the windows
  125. directory. In the [boot] section of the file there is a line which will
  126. read shell=progman.exe. Replace it with shell=backmenu.exe and you're away.
  127.  
  128.  
  129. Choice of Mouse Button
  130. ======================
  131.  
  132. The choice of which mouse button to use dramatically changes the way Back-Menu
  133. "feels". If the left mouse button is chosen, the menu pops-up when the button
  134. is pressed and disappears as soon as the button is released. With the right
  135. mouse button the menu remains on screen until a bottom-level seleection is
  136. made, regardless of how many times the right button is pressed.
  137.  
  138. Back-Menu also supports the middle mouse button. If you choose this and find
  139. that back-menu no longer functions then take the following steps:-
  140.  
  141.     1) Exit Windows (or reset if Back-Menu is installed as the shell).
  142.     2) Edit WIN.INI in the Windows directory.
  143.     3) Find the line which has [Back-Menu] on it. Below this there will
  144.        be a line Button=Middle. Change this to Button=Left or
  145.        Button=Right.
  146.  
  147.  
  148. Ambiguous File-Name Support
  149. ===========================
  150.  
  151. Back_menu now allows simple ambiguous file names as command line parameters
  152. to programs. If Back-Menu finds an ambiguous file name, it will prompt with
  153. a dialog box to let you choose. The path and filename are substituted in to
  154. the command line. If abort is chosen, the application is not started.
  155. Eg.
  156.     Word, C:\WORD\WINWORD.EXE *.doc
  157.  
  158. At the moment, paths cannnot be specified, and the command line may only
  159. contain the ambiguous file name.
  160.  
  161.  
  162. COMMAND LINE PARAMETERS
  163. =======================
  164.  
  165. It is possible to make Back-Menu prompt for a command line, which is then
  166. passed to the relevant program. To do this, place a % after the program
  167. name in the menu file. Eg.
  168.     Excel,c:\excel\excel.exe %
  169. Back-Menu will bring up a dialog box, which will allow the command line
  170. parameters to be typed. Anything following the % will be placed in the
  171. dialog box for editing.
  172.  
  173.  
  174. BUGS/FEATURES
  175. =============
  176.  
  177. V1.1    Fixed bug that prevented Back-Menu from being reloaded after it had
  178.     been removed.
  179.  
  180.     Restructured code so that it should work with EMS systems. (Not
  181.     tested fully).
  182.  
  183. V1.2    Added cascading menus.
  184.  
  185. V1.3
  186.     Locks up Compaq 386/25e sometimes when starting up DOS window.
  187.  
  188. V1.31
  189.     Added ambiguous file name support.
  190. V1.32
  191.     Made Back-Menu process the windows command line when it is the shell.
  192.  
  193. V1.33
  194.     Modified Open Dialog box to have dirs and files lists.
  195.     Fixed problem if you type in path and filename to opex dialog.
  196. V1.34
  197.     Added '%' to prompt for command line for an application.
  198.     Fixed bug where if you uninstall Back-Menu you get UAE.
  199.     Added about box.
  200.     Changed ambiguous filename support so that the open box has
  201.     the directory specified.
  202. V1.35
  203.     Added support for setting start-up directory.
  204. V1.36
  205.     Whichever mouse button brings up the menu can now be used to select
  206.     items from it (as well as the left mouse button)
  207. V1.37
  208.     Now supports extensions from win.ini (eg. MYTEXT.WRI will cause
  209.     write to be started up on the file).
  210.     Cured bug where if Back-Menu is the only task in the system, the
  211.     menu doesn't stay up the first time the button clicked.
  212. V1.38
  213.     Changed line-reading to fix problems with reading the .ini file.
  214.     Removed the limit of 15 items per menu.
  215.  
  216. V1.39
  217.     There were problems if back-menu was the shell and a command line
  218.     was given to windows which didn't have a path component (It said it
  219.     couldn't find the file). This has been fixed.
  220.     Added history mechanism to Execute... command.
  221.     Re-ordered the fixed menu to place more frequently used items at
  222.     the top.
  223.     Modified % prompting to allow a command line to be edited (eg.
  224.     %-t -r hello.pas will prompt with the rest of the command line
  225.     present for editing).
  226.  
  227. Any criticism/comments/praise/bugs etc can be directed to the author (me) as
  228.  
  229. Ian Heath
  230. Postgraduate Research
  231. University of Southampton
  232. England
  233.  
  234. mail:    ih@uk.ac.soton.ecs
  235. or:      ih@ecs.soton.ac.uk
  236.  
  237. (whichever you prefer).
  238.  
  239. This program is freeware. Share and enjoy!
  240.