                                  TaskBox V3.04
                                  -------------
(c) Copyright 1996 Kevin Ash
    e-mail:     k.a.ash@newcastle.ac.uk
    [ valid till June '97 ]
    snail mail: see section 4

Description: A simple OS/2 task manager

0.  Contents
------------

1.  Files
2.  Installation
3.  Usage
3.1 Running
3.2 General
3.2.1 Activating
3.2.2 Mouse Usage
3.2.3 Keyboard
3.2.4 TaskBox menu
3.2.5 Task menu
3.3 Settings
4.  Getting in touch
4.1 Updates
5.  Misc
6   Legal

1.  Files
---------

    TaskBox.txt         --  this file
    TaskBox.exe         --
    TaskBox.dll         --
    ka_crtm.dll         --  common code dll
    install.cmd
    Clock\              --  directory containing clock module
    AppStart\           --  directory containing appstart module
    res__src.zip        --  source resource files

2.  Installation
----------------

    In most cases running the install script should be sufficient.

    However if you don't use the wps or want to start TaskBox( or the clock) from a
command prompt you may want to add the directory that the files are contained in to
the libpath and path statements in the config.sys file.

3.  Usage
---------

    I hope you find this program relatively self explanatory, but if you do have a
problem and can't find the solution in this document you can always e-mail me.

    command line args
    -----------------
        /WATCH  <time_out>  - create a 2nd thread which cause`s TaskBox to exit
                              if it doesn`t receive a message from 1st thread
                              in <time_out> seconds( 30 seconds if not specified)
        /SILENT_EXIT        - if /WATCH specified don`t ask user if okay to exit
                              just exit
3.1 Running
-----------

    To run TaskBox double click the WPS icon( or alternatively enter a command prompt and
change to the directory in which TaskBox is contained in( eg cd D:\bin\TaskBox ) and then
type TaskBox ).

3.2 General
-----------

3.2.1 Activating
----------------
    To make the TaskBox Visible( or move it to the top if already on screen) move the mouse
over the activation bar.

3.2.2 Mouse Usage
-----------------

  Mouse button 1(or 3)          --   Pressing on a task button causes that button to be hilited.
                                   If you move to another task button( keeping the mouse button
                                   pressed) all tasks from the first to the last button will
                                   remain selected so that you can apply a menu option to
                                   multiple windows.

                                     If however you release the button on the same task button
                                   you`ll access a menu short cut( see Button Actions $3.3 ).

                                   Hint! for those of you without 3 button mouse use <ctrl>
                                       mouse button 1 to simulate the 3rd mouse button

  Mouse button 2 click          --   If mouse is over a task button Task menu will be opened,
                                    otherwise open the TaskBox menu.


  Resizing                      --  Resize as you would a normal window.
  Moving                        --  Press and hold mouse button 2 and move the window to
                                    the desired location.
  Changing fonts                --  Open the `Font Palette` and drag `n` drop the desired font
                                    on to the target window.
  Changing colour`s             --  Open one of the `Color Palettes` repeat as above.
  Changing scheme               --  Open the `Scheme Palette` repeat as above.
                                    Hint! You can use the `Scheme Pallete` to change the border
                                    size to a small border to conserve  on screen space.

3.2.3 Keyboard
--------------

    <space>                     --   On pressing hilite selected task button.
                                     On releasing if on the same task button access shortcut,
                                   otherwise leave all selected soan option from the task menu
                                   can be selected.
    <enter>                     --  Access shortcut for task button with focus
    <ctrl>                      --  If pressed access shortcuts will be treated as a
                                    mouse button 3 click.
    <shift>+F10 (or <alt>+M)    -- Display menu
    <alt>+F7                    -- Move taskbox
    <alt>+F8                    -- Size the taskbox
    <alt>+F4                    -- Exit taskbox
    <alt>+L                     -- Lower the taskbox
	<alt>+S	                    -- Enter settings dialog( see section 3.3 )
    <arrow keys>                -- Used for moving around task buttons.

3.2.4 TaskBox menu
------------------
    i)   Lower           --    To Lower the TaskBox
    ii)  Settings        --    Enter the Settings Dialog
    iii) Size            --    to size the TaskBox
    iv)  Move            --    to move the TaskBox
    v)   Quit            --    Quit this program

3.2.5 Task menu
---------------
    i)   switch to       --  make selected task active
    ii)  lower           --  lower the task(s)
    iii) tile            --  tile the task(s)( doesn`t work very well when the TaskBox is not
                             on the edge of the screen and is alway`s visible  )
    iv)  cascade         --
    v)   system menu     --  access the task's system menu (NB: shortcut`s listed won`t work )
    vi)  remove from taskbox -- remove selected task(s) from TBox
    vii) TaskBox         --  access TaskBox menu


3.3 Settings
------------

NoteBook Settings Dialog
------------------------

  TaskBox Settings page 1
  ------------------------

    Display
    -------
    This is used to decide what information appears on the TaskBox.

    (auto) task top
    ---------------
        when checked task's are automatically raised to top when a task button gains
    input focus.

    Maximum/Minimum width
    ---------------------
      The slider and spinbutton control on this page allows the width of each task
    window on the TaskBox to be customized.

    NB: these will be disabled if display is set to Icon only

    Button Actions
    --------------
      This group is used to customize the menu shortcuts. For both mouse
    buttons you can choose one of the following options.

            (1) Minimize/Restore  --  If window can't be minimized and can be hidden it will
                                        hidden instead
            (2) Maximize/Restore  --
            (3) Switch to.        --  Switch to this task
            (4) lower             --  change the windows z-order

  TaskBox Settings page 2
  ------------------------

    Activation Bar Pos
    -------------------
      The activation bar is the bar( along the bottom of the screen the first time you run
    the program), that causes the TaskBox to be pushed to the front of the screen when the
    mouse moves over it.


    Activation Bar width/height
    ---------------------------
      This lets you choose the width( height) of the bar.
        Hint! to change the activation bars colour set it`s width to a higher value
          ( say 20) before dropping a colour from a colour pallete this will help
          prevent missing the bar and changing the colour of the desktop.
        Hint! to disable the activation bar set its width to 0( if TaskBox to Edge
            isn`t checked to activate it you'llhave to select it from the window list)

    TaskBox to edge
    ---------------
      With this option checked the TaskBox will be snapped to the edge of the screen. The
    edge of the screen is same edge as the Activation Bar.
      Without this option checked the TaskBox will remain in the same position.

    TaskBox Always Visible
    ----------------------
      As it says if this is checked the TaskBox will remain visible all the time.
    NB: it does not automatically float to the top so it may be covered by other windows.

    Bubble help
    -----------
        switch the bubble help on/off.

    Keep on desktop
    ---------------
        with this checked you won't be able to move the Taskbox off the desktop.

    Remove List ( the list box )
    -----------
     This contains a list of all the programs that you have chosen to remove
   from the TaskBox.
     By Selecting the tasks and selecting "Remove from list" the task's selected will
   no longer be removed from the TaskBox.
    You can add new tasks to be removed by typeing into the entry box and pressing
   enter.
    ( You can include wildcards currently only understands ?( any single character)
      and *( any number of characters). )
   Hint! to remove all wps folders enter "* - * view" into this field

NB:  All TaskBox's settings are saved into TaskBox.ini, so if the worst comes to the
worst you can always delete this file and revert to the default settings, This file can be
located in the same directory as the executable, but it may be hidden.

4.  Getting in Touch
-------------------

    If you use this program and like it, let me know by sending an e-mail message to
the address at the top of the document or better still
send a postcard with any comments to:-

         41 Abbot Court, Gateshead, Tyne & Wear, NE8 3JY, ENGLAND.

    If you don't like this program, discover any bugs or have any suggestions, please let
me know why or what they are by e-mailing a message to the address at the top of the
document.

4.1 Updates
-----------

    You should be able to get the latest version from:-

    http://www.ncl.ac.uk/~n4050728/os2/

5 Misc.
-------
    TODO
            -   allow the user to choose an alternative icon for a program
            -   better documentation

    Known problems - if lockup is selected from the launchpad the activation bar is
                      still displayed( It doesn't work though )

    New since V3.03:
        - fixed problem with a menu operation being  used for multiple tasks
            even though only one task was selected.
        - fixed problem with newline characters not being converted to spaces
        - fixed a couple of other minor bugs

    New since V3.02:
        - added multiple select
        - added tile/cascade option
        - added auto-raise feature
        - moved common code into ka_crtm.dll
            to check the version of this file type
            BLDLEVEL KA_CRTM.DLL
        - changed activation bar so that when TaskBox active it doesn`t
          block it
        - fixed problem with sizing routine

    New since V3.01:
        - hopefully fixed probs with random crashes, had thought version 3.00
            had cured it but was incorrect
        - fixed probs with presparams not being saved

    New since V3.00:
        - got rid of the clock( had got alot of complaints about the fact you couldn't
                                turn it off )
        - fixed problem with it crashing when selecting lockup
        - fixed problem with random crashes due to memory access violations( SYS3175 errors)
        - improved the resizing routine.
        - I now allow you to add programs to the removed list in the settings book.
        - added a module box( so modules can have windows on the taskbox and not
            just entries on menu's )

    Thanks  -   to everyone who has made suggestions, etc( too many to list but you
                know who you are )

6 Legal Stuff
-------------
TaskBox is (c) Copyright 1996 by Kevin Ash.

TaskBox is distributed in the hope that it will be useful, but with
ABSOLUTELY NO WARRANTY; without even the implied warranty of MERCHANTABILITY
or FITNESS FOR A PARTICULAR PURPOSE.
