@database CLICKCLOSE
@node MAIN
@title "ClickClose 2.1 * Walter Weber-Groß, 1996/7"

   Contents
   ¯¯¯¯¯¯¯¯
   @{" Introduction     " link ZWECK} Why ClickClose
   @{" Legal stuff      " link STATUS} FREE WARE
   @{" In the beginning " link START} How to start
   @{" Description      " link BESCHREIBUNG} How does it work
   @{" Author           " link AUTOR} It's me :)
   @{" Remarks          " link ANMERKUNGEN} Important!

@endnode

@node ZWECK "Introduction"
@next STATUS

   Do you know the WB-Drawer-Game: double clicking on an icon,
   closing the window, double clicking on an icon, closing the
   window and so on, until you've reached the icon of your
   destiny..

   ClickClose simplifies this procudere by doubling your single
   click, opening the icon and closing the window.

   Additionally you can go the way back to the drawer window
   you've started from by clicking the close gadget of the
   current active drawer window.

   All that, provided you have a mouse with a middle button.
   If you have not, you can use the left mouse button combined
   with a @{" QUALIFIER " link START}.
   
   ClickClose doesn't patch any system function.
   
   For further details see chapters @{" Description " link BESCHREIBUNG} and
   @{" Remarks " link ANMERKUNGEN}.

@endnode

@node STATUS "Legal stufff"
@prev ZWECK
@next START

   ClickClose is FREE WARE, but a faultless work is guaranteed
   just on the machines ClickClose was tested on.

   It has been tested with good results on an A2000 with OS2.1
   and on an A1200 with GVP-EC030 accelerator board.

@endnode

@node START "In the beginning"
@prev STATUS
@next BESCHREIBUNG

   Run ClickClose from either Workbench or Shell.

   Available tooltypes/arguments are:

   @{b}CX_PRIORITY@{ub}=<pri>

      <pri> ranges from -128 to 127; default is 0.

   @{b}CX_POPKEY@{ub}=<shortcut>

      The chosen <shortcut> (de)activates the ClickClose functions,
      but @{b}not@{ub} the commodity itself; this is done through
      "Exchange" or something similar.

   @{b}QUALIFIER@{ub}=<qual>

      <qual> is e.g. one of @{b}control@{ub}, @{b}shift@{ub}, @{b}alt@{ub}, @{b}escape@{ub}, @{b}rightbutton@{ub};
      If a QUALIFIER is chosen, ClickClose acts immediately after the
      left mouse button is released while the <qual> key is pressed.

      This is useful while working with a two button mouse.

      By default, ClickClose uses the middle mouse button.

@endnode

@node BESCHREIBUNG "Description"
@prev START
@next AUTOR

   For ClickClose uses the middle mouse button by default (-> @{" QUALIFIER " link START}),
   it's functions are now explained as a result of a released middle
   mouse button referred to as a "MMB".

   Basically there are two differnt types of windows:

   ·  drawer windows
   ·  all other windows

   Two actions are applicable to both types:

   @{b}*@{ub}  A MMB @{b}activates@{ub} the window under the pointer and puts
      it @{b}to front@{ub}, unless it has to stay in background (WFLG_BACKDROP).

   @{b}*@{ub}  A MMB on a @{b}zoom@{ub} gadget centers the window.

   The follwing actions are applicable only to @{b}drawer windows@{ub}:

   -  A MMB on an icon opens the @{b}icon@{ub} and closes the window.

   -  A MMB on the @{b}close gadget@{ub} opens the parent drawer window
      and the closes the active window.

      An execption is the @{i}workbench window@{ui}, for it has no parent
      drawer window; a MMB on its close gadget toggles between
      framed and backdrop display.

   -  A MMB on the @{b}depth gadget@{ub} rearranges the contents of
      the drawer window.

   -  A MMB on the @{b}window title@{ub} updates the contents of the
      drawer represented by the drawer window..

      An exception is the @{i}workbench window@{ui}, but in this case
      nothing happens, at all.

   -  A @{b}double MMB@{ub} on a drawer window whith any icon untouched
      closes all drawer windows except the active one and, of course, the
      workbench window.

      If neither a drawer window nor the screen's titlebar or depth gadget
      (see below) is concerned then ClickClose will close all drawer
      windows except the workbench window.

        @{b}Note@{ub}: If the double MMB occurs even not over the screen's
        titlebar or depth gadget (assumed you use the middle mouse button),
        Click&close will feed a left mouse button event into the input stream.
        That causes a deactivation of the currently active window.

      So, an active ASL file requester isn't concerned by ClickClose' MMB 
      if you use the middle mouse button.

   The following actions apply on @{b}screens@{ub}:

   -  A MMB on the @{b}titlebar@{ub} marks this screen, so you can toggle
      between the current and the marked screen with a MMB on the screen's
      @{u}depth gadget@{uu}.

   -  A MMB on point 0/0 of a screen (upper left corner) marks the current
      screen and switches to the workbench screen.

   In any other cases the MMB will be forwarded with no further action.

@endnode

@node AUTOR "Author"
@prev BESCHREIBUNG
@next ANMERKUNGEN

   Walter Weber-Groß
   Arcostr. 5
   D-10587 Berlin
   Germany

   EMail: wwg@arco.met.fu-berlin.de

@endnode

@node ANMERKUNGEN "Remarks"
@prev AUTOR
@next START

   ClickClose requires the standard "@{b}Workbench@{ub}" menu (OS2.1 to OS3.1).

   If it is not available although there is a "Workbench Screen", nothing
   happens, at all.

   If there is a modified "Workbench" menu, possible results range
   from «nothing happens» to «a trip to india» ·X

   If you have a standard workbench and commodities which basically don't
   modify it there are no problems. (For example, in my Workbench environment
   ClickClose runs together with Magic Menu without any problems).

   One strange but harmless bug should be mentioned here:

   Sometimes (very, very rarely) ClickClose refused its work (e.g. after
   leaving MuchMore 3.3 with numericpad 5) until I pressed any key..:(

@endnode