Short:        Small, quick, and useful taskbar util
Author:       ah210@chebucto.ns.ca
Uploader:     ah210 chebucto ns ca
Type:         util/wb
Version:      1.1
Architecture: m68k-amigaos

Wibby is (c) 2000-2001 John Mason

Please read the Changes file for info on new features and bugfixes.

Wibby is another taskbar type program, but my main goal in writing it was to make
something that was small, fast, and useful.  Please, let me know if you like Wibby!

== DISCLAIMER ==================================================================

As usual, no one, including myself, will be held responsible for any direct or
indirect damages of any kind resulting from the use of Wibby (or the reading
of this text file for that matter!).

================================================================================

Requirements:

  Any Amiga with Kickstart 3.0 or greater (not tested on 2.x, might work)
  Some RAM
  WBStart.library (by Stefan Becker) for more intelligent "Left out icons" mode


Installation:

  Put Wibby in your WBStartup drawer. :)

Setup:

  Wibby can be configured using Tooltypes.  Currently they are:

  OPENON - The screen(s) to open on.  The values for this tooltype are:

    ALL        - Wibby will open on any and all screens.
    WORKBENCH  - Wibby will only open on the Workbench Screen.
    THESE      - Wibby will only open on screens you specify (see below)
    NOTTHESE   - Wibby will open on all screens except those you specify (see
                 below)

    For the THESE and NOTTHESE settings, you must also specify a list of
    screennames.  To do this, add some tooltypes like these:

    SCREEN1=Workbench Screen
    SCREEN2=Someother Screen
    etc.

    Note that the screen name used here should match the screen's default title,
    which is shown in brackets following the screen name in screens mode unless
    the default title is the same as the screen's current title.  Since the screen
    associated with a given program can change, future versions may check screens
    by taskname instead...

  LEFTOUTVOLNAME - The volume to use for the left out icon mode (see below).
                   Note the volume name should NOT include a colon.

  HELPSTAYS - If this is set to YES, then one the help box has opened, it will
              stay open, even if you switch modes.

  HELPTIME  - Use this to specify in tenths of a second how long Wibby should
              wait before opening its help box.  If this is not specified, Wibby
              will default to a one second delay.

  MODERESET - This tooltype causes Wibby to return to a default mode each
              time you use it.  If this tooltype is present, you can also
              add the DEFAULTMODE tooltype, and give it one of these values:

              WINDOWS     - Default to windows mode
              SCREENS     - Default to screens mode
              COMMODITIES - Default to commodities mode

  GUI Pen Tooltypes:

  Wibby allows you to set the colours used for its interface.  There are
  seven tooltypes for doing this:

  TEXTFG - The colour for each button's title
  TEXTBG - The background for each button
  SHINE  - The colour for the shine of each button (top and left sides)
  SHADOW - The colour for the shadow of each button (bottom and right sides)
  HELPFG - The colour for the help box's text
  HELPBG - The colour for the help box's background
  HELPBORDER - The colour for the help box's border

  To set the colour to use for each of these items, set the tooltype value
  to the RGB value you want, ie:

  "TEXTFG=255,255,255" for full white
  "TEXTFG=0,0,0"       for full black
  "TEXTFG=255,0,0"     for full red

  Wibby will try to find the best pen in the screen's palette to represent
  your chosen colour, so the colours may not be exactly the same on each
  screen.


Usage:

  Once installed, Wibby will appear when you move the mouse to the bottom of the
Workbench screen.  If you need to point at the bottom of the screen without
activating Wibby, hold down the left shift key.  When Wibby opens, there should
be several buttons along the bottom of the screen, one for each of the currently
available objects, depending on the current mode.

There are four modes -- Windows, Screens, Commodities, and Left out icons, so
if you are in windows mode (the default) then you'll see a button for each
window open on the Workbench screen.  As you point at one of the buttons, the
Workbench screen's title bar will show you the full title of the object you're
pointing at, as well as the mode that you are currently using.

Clicking on any button should bring that window to the front, and holding shift
while clicking a button should send that window to the back.  Also, holding alt
while clicking a button should zip the window, as if you had clicked the zoom
gadget.  In other modes, things work slightly differently:

Mode               Click              Shift Click        Alt Click
================   ================   ======--========   =============
Screens            Bring screen       N/A                N/A
                   to front

Commodities        Show commodity's   Hide commodity's   N/A (kill commodity?)
                   interface          interface

Left out icons     Run program        N/A                N/A

To switch modes, simply click the right mouse button once.

Wibby has a help feature for buttons that are too small to read easily --
if you keep the mouse pointer on Wibby for a certain period of time,
a help box will appear next to the mouse pointer that gives you the full
name of the object you're pointing at.  It will float left and right as
you move to mouse so you can see the full names of every item.

Contact:

  If you use Wibby regularly, please send me an email.  My address is
  ah210@chebucto.ns.ca.  The more feedback I get, the better motivated I'll
  be to keep working on the program.

  Also, take a look at my website at http://chebucto.ns.ca/~ah210 for some
  of my other programs.