TMDock V1.00
                           ============

                        ©1996 Andreas Mair

*** INTRODUCTION ***

"TMDock" is a simple tool that builds Docks on any public screen by using
the "toolmanager.library" and a simple settings file. After you run this
tool it will open all Docks specified in the settings file and will wait
until send it a "Ctrl+C".

This tool was developed for MusicManIII. But as you will see it will also
work with other applications, too. If someone wants to include it in his
program package I'd like to here of that. If it's a commercial or Share-
ware package you must inform me (hey, don't you think about registering
me for FREE? If this tool helps you, why not?).

If you have any suggestions on this tool, find any bugs or anything else,
please contact me.
If there is interest in making this tool better, why not?

The settings file is an ascii file that you can easily edit with any text
editor that produces ascii files. The settings file must have the follow-
ing format:


*** INSTALLING ***

You only have to copy "TMDock" to any place you want. A good place would
be "C:". Copy the default settings file or your own one to
"S:TMDock.Prefs". You may also use a different name for the settings file
but then you have to specify the filename whenever you start TMDock
(e.g. "TMDock MyDir:MyTMDock.Prefs").


*** SETTINGS ***

There are two types of lines: the "DOCK" line and the "PROG" line

* The "DOCK" line's template:

  NAME/A,X/N,Y/N,VERTICAL/S,COLUMNS/N,HOTKEY/K,TITLE/K,
  TEXT/S,FRONTMOST/S,PATTERN/S,MENU/S,SCREEN/K

  Where:

  - NAME/A
    The name for the Dock.

  - X/N,Y/N
    The x/y position of the Dock. (Default is "0")

  - VERTICAL/S
    If supplied a vertical Dock will be built. Otherwise a horizontal
    dock will be built.

  - COLUMNS/N
    The number of columns the Dock should have. If this is not supplied
    the default depends on whether it's a vertical or a horizontal Dock.
      Vertical:   default is the number of "PROG" lines given
      Horizontal: default is "1"

  - HOTKEY/K
    The hotkey that hides/showes the Dock. (Default is no hotkey)

  - TITLE/K
    If supplied the Dock will have window borders and that title.
    (Default is no title)

  - TEXT/S
    If supplied the Dock will not show images but texts.
    (Default is show images)

  - FRONTMOST/S
    If supplied the Dock will open on the frontmost PublicScreen. This
    switch overrides "SCREEN/K". (Default is open on default PublicScreen)

  - PATTERN/S
    If supplied a pattern will be displayed around small images.
    (Default is no pattern)

  - MENU/S
    If supplied Dock will have a pull-down menu (to close Dock or quit
    ToolManager). (Default is no menu)

  - SCREEN/K
    The PublicScreen the Dock should open on.
    (Default is to open on default PublicScreen)


* The "PROG" line's template:

  NAME/A,COMMAND/K/A,AREXX/S,CLI/S,HOTKEY/S,WB/S,DIR/K,OUTPUT/K,KEY/K,ICON/K

  Where:

  - NAME/A
    The name of the Dock item. This name is displayed if it's a TEXT Dock.

  - COMMAND/K/A
    The command string the should be executed if item is selected.

  - AREXX/S, CLI/S, HOTKEY/S, WB/S
    The type of the item. (Default is CLI)

  - DIR/K
    The current directory of the executed command.

  - OUTPUT/K
    Where should the output of the executed command go to?

  - KEY/K
    The hotkey that should activate the item.

  - ICON
    The path and filename of the icon that should be displayed if no
    TEXT Dock.


Please read the documentation for the "ToolManager" on how to create
Docks.

To define a Dock you have to create a "DOCK" line and then as much "PROG"
lines as you want. Repeat this procedure for every Dock you want. Note that
no other lines are allowed!


*** REQUIREMENTS ***

"TMDock" requires at least Kickstart/Workbench V2.04 and ToolManager V2.1
installed ("toolmanager.library" V3).
To run "TMDock" just type its name in a Shell window. The one and only
argument you may supply is the name of settings file you want to use.
If none supplied "S:TMDock.Prefs" will be used.


*** COPYRIGHT ***

"TMDock" is Copyright by

Andreas Mair
Karlsbader Str. 23
D-86529 Schrobenhausen
 Germany

E-Mail: amair@informatik.fh-augsburg.de


"ToolManager" is Copyright by Stefan Becker.


*** HISTORY ***

V1.00 (23.09.1996)
------------------

  first release. Very poor error handling!