home *** CD-ROM | disk | FTP | other *** search
/ Windoware / WINDOWARE_1_6.iso / winutil / addmnu41 / addmenu.txt < prev    next >
Text File  |  1992-07-08  |  6KB  |  132 lines
  1. AddMenu, v0.4.1
  2. Run, v0.2.0
  3.  
  4. Description:
  5.  
  6. Version v0.4.1 presents no new functional enhancements over v0.3.x, but
  7. many bugs have been eliminated.
  8.  
  9. The program, AddMenu, is designed to let you add options to your system
  10. menus.  For example, if you use the File Manager all the time and you get
  11. tired of always double clicking on the appropriate icon, this program
  12. allows you to put the File Manager on your system menus.  Thus, you can
  13. access the desired programs from any menu.  I am eager to hear what people
  14. think, especially any problems encountered, comments about any affect that
  15. it might have on system performance, etc.  Please send comments to
  16. Robert_Ryan@brown.edu or at any of the other e-mail addresses below.
  17.  
  18. The general idea of the program is that you specify some menu text (i.e.,
  19. the text that will show up on the menu) and then specify the command line
  20. (i.e., the program name plus any options, if any).  When you select
  21. "Save", AddMenu will add that command to all of you system menus.  AddMenu
  22. is a Windows 3.x program which is intended to be placed in your "load="
  23. line of your WIN.INI file (or, if you have Windows 3.1, to be placed in
  24. your "StartUp" group with the "Minimized" box checked).  When running, it
  25. "hooks" into the system menus to add the specified options to all menus
  26. and execute them when you select them from the menu.  Note that if you
  27. exit AddMenu, it will remove all of the new options from your system
  28. menus.  It is recommended that you simply minimize AddMenu when you're
  29. done making changes and want to go on working on something else.  Note: If
  30. it is minimized with a hidden icon and you want to "restore" (i.e.,
  31. un-minimize) simply run it again.  All of its settings are stored in
  32. ADDMENU.INI.
  33.  
  34.  
  35. Necessary Files:
  36.  
  37. Program requires COMMDLG.DLL, which comes with Windows 3.1.  According to the
  38. 3.1 documentation, this DLL can be distributed with applications that require
  39. it (such as this one) but cannot be distributed separately.  I haven't
  40. included it in this package, but if I get any requests to do so, I will in
  41. future releases.  This program is fully compatible with Windows 3.0.
  42.  
  43. This program also requires AMFILTER.DLL (included) which installs the two
  44. filters and handles the menu events and posts the appropriate private
  45. messages to this program.
  46.  
  47. Finally, this program also comes with RUN.EXE.  This is a very small program
  48. designed to mimic the behavior of the Program Manager's "Run..." command.  It
  49. is included so that you can have the functionality of the program manager's
  50. "Run..." command from all system menus.  To take advantage of it, you would,
  51. using AddMenu, add the program RUN.EXE to your system menu (presumably with
  52. some menu text along the lines of "&Run...").
  53.  
  54.  
  55. Disclaimer:
  56.  
  57. This program is copywrite of Robert M. Ryan, 1992.  It is provided without
  58. warrantee of any sort.  This program is FreeWare, and can be used and
  59. distributed for non-commercial use without fee providing that:
  60.  
  61.     a) it is not altered without permission of the author (me);
  62.     b) my name remains on the package at all times;
  63.     c) if you ever use any of my source, I must be credited in your source
  64.        files; and
  65.     d) no fee is ever charged for the distribution of the program.
  66.  
  67. If you want to use it for commercial purposes or have any questions about
  68. these policies, do not hesitate to contact me.  While I do not ask for money,
  69. I am eager to hear what people think of the program.  I'm especially
  70. interested in hearing about any problems, incompatibilities, etc. that you
  71. might encounter with this program.  But I'm also keen to hear if you just
  72. like it, too.
  73.  
  74. COMMDLG is copyright Microsoft 1992.
  75.  
  76. Robert M. Ryan, 7 July 1992
  77.     internet:   Robert_Ryan@brown.edu
  78.     bitnet:     ST802200@BROWNVM.BITNET
  79.     Compu$erve: 70324,227
  80.  
  81.  
  82. Known Program Bugs/Limitations:
  83.  
  84. There are several notable limitations/problems with the program as it
  85. currently exists:
  86.  
  87.      1.    No real control of the order of items on the menu (well, sort'a:
  88.     it puts them on the menu in the order you add them).
  89.      2.    Program currently uses both WH_CALLWNDPROC and WH_GETMESSAGE hooks.
  90.     Reportedly, the first adversely affects system performance.  (Can
  91.     anyone substantiate this claim?)
  92.      3.    This program rather arbitrarily uses menu id's starting at 0xE120.
  93.     This is intended to minimized conflicts with existing system menus
  94.     (0xF000 and higher) and likely ids used by other programs.  It is
  95.     possible that these could conflict with other programs.  By manually
  96.     adding a line "First Id=n" to the [AddMenu] section of the profile
  97.     file, where "n" is some number, you can control what ids should be
  98.     used.  I didn't know how else to get around possible conflicts.
  99.         If you specify "n", make sure it's big (say, bigger than 0x2000),
  100.         but not too big (less than 0xEF00) and that the last hexidecimal
  101.         digit is zero (e.g. 0xE001 is not permitted).
  102.      4.    This program is notably inefficient insofar as every change that is
  103.     save is written to the profile file.  Granted, now that we all use
  104.     disk caches that's not really a problem, but I admit that it isn't
  105.     great programming technique.  I'm lazy.
  106.      5. There's no help file.
  107.      6.    And more, as of yet undiscovered, problems ...
  108.  
  109.  
  110. Changes since AddMenu v0.3.0:
  111.  
  112.      1. The program RUN.EXE is now included.  Additionally, a bug in RUN.EXE
  113.     was giving the focus back to the application from which the system
  114.     menu was pulled, putting the new application that was run in back-
  115.     ground.  RUN.EXE now manually gives the new app the focus back when
  116.     RUN.EXE, itself, finishes.
  117.  
  118.      2.    The list of File Types in Browse (in both RUN.EXE and ADDMENU.EXE)
  119.     now has both "Programs" and "All Files (*.*)"
  120.  
  121.      3.    The RUN program now handles the change in focus better.
  122.  
  123.      4. Fixed bugs in the WinExec() procedure.
  124.  
  125.      5. Added error messages.
  126.  
  127.      6. Both RUN and ADDMENU both deal with changing drives and directories
  128.         better (at least more like the Program Manager's Run command).
  129.  
  130.      7. These weren't compatible with Windows 3.0 (I never tested it).  They
  131.         are now (though the user must supply COMMDLG.DLL).
  132.