ToolManager 2.1a                                               26.03.1995


I. DISCLAIMER
-------------

   Permission is granted to make and distribute verbatim copies  of  this
manual provided the copyright  notice  and  this  permission  notice  are
preserved on all copies.

COPYRIGHT

   Copyright (C) 1990-1995 Stefan Becker

   No program, document, data file or  source  code  from  this  software
package, neither in whole nor in part, may be included or used  in  other
software packages unless it is authorized by a  written  permission  from
the author.


NO WARRANTY

   There is no warranty for this software package.  Although  the  author
has tried to prevent errors, he can't guarantee that the software package
described in this document is 100% reliable. You are therefore using this
material at your own risk. The author cannot be made responsible for  any
damage which is caused by using this software package.


DISTRIBUTION

   This software package is freely distributable. It may be  put  on  any
media which is used for the distribution of free  software,  like  Public
Domain disk collections, CDROMs, FTP servers or bulletin board systems.

   In  order  to  ensure  the  integrity  of   this   software   package,
distributors should use the original  archive  file  ToolManager2_1a.lha.
The author cannot be made responsible if this software package has become
unusable due to modifications of the archive contents or of  the  archive
file itself.

   There is no limit on the costs  of  the  distribution,  e.g.  for  the
media, like floppy disks, streamer tapes or compact discs, or the process
of duplicating. Such limits have been proven to be harmful to the idea of
freely distributable software, e.g. instead of reducing the price of  the
floppy disk below the limit, the software was  simply  removed  from  the
master disk.

   Although the author does not impose any limit on the  distribution  of
this software package, he would like to express his personal opinions  on
this matter:

   * This software package should be made available to everyone  free  of
     charge whenever it is possible.

   * If you have acquired this software package under  normal  conditions
     from a Public Domain dealer on a floppy disk at a price higher  than
     5DM or US $5, then you have definitely paid too much.  Please  don't
     support this improper profit making  any  longer  and  switch  to  a
     cheaper source as soon as possible.


USAGE RESTRICTIONS

   No program, document, data file or  source  code  from  this  software
package, neither in whole nor in part, may be used on any  machine  which
is used

   * for the research, development, construction, testing  or  production
     of weapons or other military applications. This  also  includes  any
     machine which is  used  in  the  education  for  any  of  the  above
     mentioned purposes.

   * by people who accept, support or use violence against other  people,
     e.g. citizens from foreign countries.


II. Description
---------------

This small package contains an update to the (still) current  ToolManager
2.1 release. Changes since the last release:

    toolmanager.library  V3.1 - Added support for ScreenNotify
    screennotify.library V1.0 - Notify on screen close/private/public
    WBStart-Handler      V1.4 - Fixed path problems
    toolmanager.doc           - Missing AutoDocs for toolmanager.library

ToolManager  now  supports  ScreenNotify,  a  library  which  sends   out
notifications when a public screen is opened or closed. This  means  that
it is now possible to open docks automatically on a public  screen  after
it has been opened. The docks  will  be  closed  automatically  when  the
screen is closed. Now you can change the screen mode  of  your  Workbench
without manually closing all your ToolManager docks!

The automatic open/close feature only works if  you  specify  the  public
screen name for a dock object. It won't work for dock  objects  with  the
"FrontMost" flag set or for docks which should open on the default public
screen. You must also set the "Activated" flag for the dock object.

Every time a public screen is  opened  ToolManager  will  scan  all  dock
objects and open all docks which have the same public screen name as  the
newly opened screen. When a public screen is  closed  ToolManager  closes
all open docks on this screen and marks them. If  the  public  screen  is
opened again ToolManager will reopen all marked docks.


III. Installation
-----------------

If you already use ToolManager 2.1 then copy the following files  to  the
appropriate directories:

    libs/toolmanager.library    ->  LIBS:
    libs/screennotify.library   ->  LIBS:
    l/WBStart-Handler           ->  L:

If you never have used ToolManager before then you have  to  install  the
release 2.1 first. It may be found on Fish Disks/CDROMs or on AmiNet.


IV. Warnings
------------

ToolManager in conjunction with ScreenNotify will cause dead locks  under
certain conditions. When a dead lock occurs  you  can't  move  the  mouse
pointer anymore or enter anything on the keyboard. These dead locks occur
most of the time when other programs want to close a public screen.

Unfortunately there is no way to  circumvent  this  problem,  so  if  you
experience dead locks with many of  your  normal  applications  then  you
can't use ScreenNotify at all and MUST remove  the  screennotify.library.
ToolManager will still work without this library, but  you'll  loose  the
automatic dock open/close feature.

If you are using MUI 2.3 (or older) you MUST NOT open docks automatically
on MUI public screens or a dead lock will occur!  This  problem  will  be
fixed in future MUI versions.


V. Other information
--------------------

NOTE: I have moved to another city since the last release of ToolManager.
      Please DO NOT use the old addresses anymore or your mails  may  get
      lost!

Authors EMail address:

    stefanb@yello.ping.de

Authors postal address:

            Stefan Becker
            Verkehrstrasse 11
    D-44809 Bochum
            GERMANY

