home *** CD-ROM | disk | FTP | other *** search
/ Magazyn Amiga 13 / MA_Cover_13.bin / source / c / stefanb_src / old_projects / toolmanager / readme < prev    next >
Encoding:
Text File  |  1996-03-13  |  7.5 KB  |  190 lines
  1. Documentation for ToolManager 2.1b                            13-Mar-1996
  2.  
  3.  
  4.    Permission is granted to make and distribute verbatim copies  of  this
  5. manual provided the copyright  notice  and  this  permission  notice  are
  6. preserved on all copies.
  7.  
  8. COPYRIGHT
  9.  
  10.    Copyright (C) 1990-1996 Stefan Becker
  11.  
  12.    No program, document, data file or  source  code  from  this  software
  13. package, neither in whole nor in part, may be included or used  in  other
  14. software packages unless it is authorized by a  written  permission  from
  15. the author.
  16.  
  17.  
  18. NO WARRANTY
  19.  
  20.    There is no warranty for this software package.  Although  the  author
  21. has tried to prevent errors he can't guarantee that the software  package
  22. described in this document is 100% reliable. You are therefore using this
  23. material at your own risk. The author cannot be made responsible for  any
  24. damage which is caused by using this software package.
  25.  
  26.  
  27. DISTRIBUTION
  28.  
  29.    This software package is freely distributable. It may be transfered to
  30. any media which is used for the distribution of free software like Public
  31. Domain disk collections, CDROMs, FTP servers or bulletin board systems.
  32.  
  33.    In order to ensure the integrity of this software package distributors
  34. should use the original archive file ToolManager2_1b.lha  (file  name  on
  35. Aminet: ToolManagerUpd.lha). The author cannot  be  made  responsible  if
  36. this software package has become unusable due  to  modifications  of  the
  37. archive contents or of the archive file itself.
  38.  
  39.    There is no limit on the fee taken by distributors, e.g. for the media
  40. costs of floppy disks, streamer tapes or compact discs, or the process of
  41. duplicating. Such limits have proven to be harmful to the idea of  freely
  42. distributable software, e.g. the software package was removed instead  of
  43. reducing the price of a floppy disk below the limit.
  44.  
  45.    Although the author does not impose any limit on these fees  he  would
  46. like to express his personal opinions on this matter:
  47.  
  48.    * This software package should be made available to everyone  free  of
  49.      charge whenever this is possible.
  50.  
  51.    * If you have purchased this software package under normal  conditions
  52.      from a Public Domain dealer on a floppy disk and have paid more than
  53.      5DM or US $5 then you have definitely paid too  much.  Please  don't
  54.      support this improper profit making  any  longer  and  switch  to  a
  55.      cheaper source as soon as possible.
  56.  
  57.  
  58. USAGE RESTRICTIONS
  59.  
  60.    No program, document, data file or  source  code  from  this  software
  61. package, neither in whole nor in part, may be used on any  machine  which
  62. is used
  63.  
  64.    * for the research, development, construction, testing  or  production
  65.      of weapons or other military applications. This  also  includes  any
  66.      machine which is  used  in  the  education  for  any  of  the  above
  67.      mentioned purposes.
  68.  
  69.    * by people who accept, support or use violence against other  people,
  70.      e.g. citizens from foreign countries.
  71.  
  72.  
  73.  
  74. I. Description
  75. ==============
  76.  
  77. This small package contains an update to the (still) current  ToolManager
  78. 2.1 release. Changes since that release:
  79.  
  80.     toolmanager.library  V3.2 - Added support for ScreenNotify
  81.                               - Added support for WBStart 2.0
  82.                               - Requires OS 3.0 (V39) or better
  83.     screennotify.library V1.0 - Notify on screen close/private/public
  84.     wbstart.library      V2.0 - From WBStart 2.0 package
  85.                               - Requires OS 3.0 (V39) or better
  86.     toolmanager.doc           - Missing AutoDocs for toolmanager.library
  87.  
  88. ToolManager  now  supports  ScreenNotify,  a  library  which  sends   out
  89. notifications when a public screen is opened or closed. This  means  that
  90. it is now possible to open docks automatically on a public  screen  after
  91. it has been opened. The docks  will  be  closed  automatically  when  the
  92. screen is closed. Now you can change the screen mode  of  your  Workbench
  93. without manually closing all your ToolManager docks!
  94.  
  95. The automatic open/close feature only works if  you  specify  the  public
  96. screen name for a dock object. It won't work for dock  objects  with  the
  97. "FrontMost" flag set or for docks which should open on the default public
  98. screen. You must also set the "Activated" flag for the dock object.
  99.  
  100. Every time a public screen is  opened  ToolManager  will  scan  all  dock
  101. objects and open all docks which have the same public screen name as  the
  102. newly opened screen. When a public screen is  closed  ToolManager  closes
  103. all open docks on this screen and marks them. If  the  public  screen  is
  104. opened again ToolManager will reopen all marked docks.
  105.  
  106. ToolManager has been updated for the new WBStart 2.0 package. WBStart  is
  107. now also a library so the old L:WBStart-Handler is  not  needed  anymore.
  108. Due to the changes in the WB startup method emulation you might  have  to
  109. update some of your Exec Objects.
  110.  
  111.  
  112.  
  113. II. Installation
  114. ================
  115.  
  116. If you already use ToolManager 2.1 then copy the following files  to  the
  117. appropriate directories:
  118.  
  119.     libs/toolmanager.library    ->  LIBS:
  120.     libs/screennotify.library   ->  LIBS:
  121.     libs/wbstart.library        ->  LIBS:
  122.  
  123. If you have used ToolManager 2.1 or 2.1a already then please  remove  the
  124. file L:WBStart-Handler. It is not needed anymore for this version.
  125.  
  126. If you never have used ToolManager before then you have  to  install  the
  127. release 2.1 first. It may be found on Fish Disks/CDROMs or on AmiNet.
  128.  
  129.  
  130.  
  131. III. Question & Answers
  132. =======================
  133.  
  134. Q: When I change the  screen  mode  of  my  Workbench  or  start  certain
  135.    applications then the ToolManager docks will disappear forever. I have
  136.    to start the Preferences Editor and press Save to get my docks back.
  137.  
  138. A: You have installed the screennotify.library but you have forgotten  to
  139.    enter the name "Workbench" in the Public Screen string gadget  in  the
  140.    Dock Object edit window. ToolManager can always close the docks but to
  141.    open them it has to know on which Public Screen they should appear.
  142.  
  143. Q: After installing ToolManager 2.1b some of my Exec Objects of the  type
  144.    WB don't work anymore.
  145.  
  146. A: The WB startup method pf WBStart 2.0 has been made more compatible  to
  147.    the real Workbench. Therefore some of the old path settings might  not
  148.    work anymore. Please check the paths in your Exec Objects. A  look  at
  149.    the output of a tool like SnoopDos might be helpful.
  150.  
  151.  
  152.  
  153. IV. Warnings
  154. ============
  155.  
  156. ToolManager in conjunction with ScreenNotify will cause dead locks  under
  157. certain conditions. When a dead lock occurs  you  can't  move  the  mouse
  158. pointer anymore or enter anything on the keyboard. These dead locks occur
  159. most of the time when other programs want to close a public screen.
  160.  
  161. Unfortunately there is no way to  circumvent  this  problem,  so  if  you
  162. experience dead locks with many of  your  normal  applications  then  you
  163. can't use ScreenNotify at all and MUST remove  the  screennotify.library.
  164. ToolManager will still work without this library, but  you'll  loose  the
  165. automatic dock open/close feature.
  166.  
  167. If you are using MUI 2.3 (or older) you MUST NOT open docks automatically
  168. on MUI public screens or a dead lock will occur! This  problem  has  been
  169. fixed in MUI 3.0 and up.
  170.  
  171.  
  172.  
  173. V. Cobtact addresses
  174. ====================
  175.  
  176. NOTE: I have moved (again) to another city  since  the  last  release  of
  177.       ToolManager. Please DO NOT use the old addresses  anymore  or  your
  178.       mails may get lost!
  179.  
  180.  Postal address:
  181.  
  182.                   Stefan Becker
  183.                   Bonner Ring 68
  184.           D-50374 Erftstadt
  185.                   GERMANY
  186.  
  187.  EMail:           stefanb@yello.ping.de
  188.  
  189.  World Wide Web:  http://www.ping.de/sites/yello/
  190.