*********************************************
*                                           *
*                  STICK                    *
*                                           *
*              Gavin Wraith                 *
*                                           *
*********************************************

What is it for?
---------------
The purpose of 'stick' is to provide a shortcut
to creating simple wimp applications whose only
behaviour is to respond to clicks on and drags
to their iconbar icons. The only activities needed
for this are

# creating an icon - I use !Paint to modify an existing 
  icon.

# creating a template - use a template editor.
  
# writing some Obey files.

It also provide a means, less ambitious but more
straightforward than FrontEnd, for passing parameters
by dragging objects. It is a simple makeshift for the
lazy programmer. 

== NB ==

      Dragging icons of stickable applications
      from Resources:$.Apps which have been
      put there by AddApp will not work. Just
      because an application has the icon of a
      stickable application does not mean that it
      itself is stickable.

Where do I put it?
------------------
You should copy 'stick' to !Boot.Library or to
somewhere on your system's Run$Path.

How do I use it?
----------------
The command 

      stick <application>
      
in an Obey file will stick a "stickable"
application's icon on the iconbar. From a taskwindow
to enter the command directly  you must use the
form

      wimptask "stick <application>"

What is a stickable application?
--------------------------------      
By an 'stickable application' I mean a
directory whose name starts with '!', and
which satisfies the following conditions:

1. It must contain a sprite file called one
   of
      !Sprites, !Sprites22, !Sprites24
      
   containing a sprite with the same name as
   the leafname of the application. So if
   the application were called !Foo, there
   would have to be a sprite called !foo. 
   
2. It must contain a template file called
   Templates which must contain the template
   of a window called 'info'.
   
3. It must either contain an Obey file called
   !Run or an Obey file called !Drag, or both.
   
When the application has been stuck by 'stick'
to the iconbar it will respond to clicks on and
drags to its iconbar icon as follows:

  Click with Select:
    If the application contains an Obey file
    called !Select this will be executed.
    If it does not, and it contains an Obey
    file called !Drag, then that will be
    executed. Otherwise !Run will be executed.    
    
  Click with Menu:
    This produces a menu with three items -
    
               Info ->
               Help
               Quit
               
  Click with Adjust:
    If the application contains an Obey file
    called !Adjust this will be executed.
    If it does not, the application will be
    opened.
    
  Drag an item:
    If the application contains an Obey file
    called !Drag then that will be executed
    with the pathname of the item as a
    parameter. Otherwise !Run will be used
    instead of !Drag.
    
In appropriate cases 'Obey' may also be 'TaskObey'.
Note that an application may have both a !Run file 
and a !Drag file.


