@DATABASE "Comif.guide"
@$VER: Comif 1.0 (1995)
@NODE Main "Comif - Contents"

 @{b}Comif - Collection of Miscellaneous Intuition Features@{ub}

   Comif 1.1 ; © 1995 Stephen Davies ; Freely Distributable

   INTRODUCTION

   @{" Usage      " link Comif_usage} Running/exiting and options

   DESCRIPTIONS

   @{" Size       " link Comif_size } Resize a window from any side/corner
   @{" Depth      " link Comif_depth} Move windows to front and back
   @{" PropReturn " link Comif_prop } Return a proportional gadget knob to its original position
   @{" StringClip " link Comif_clip } Copy/cut/paste the contents of string gadgets

   AND FINALLY

   @{" History    " link Comif_hist } Currently a rather short section
   @{" Credits    " link Comif_cre  } Or blame?

@ENDNODE

@NODE Comif_usage "Comif - Usage"

 @{b}Running/exiting Comif@{ub}

   Comif can be run from the CLI or from Workbench.

   To exit Comif, run it again, send it a Ctrl-C break signal or use a
   commodity controlling program such as CBM's Exchange.


 @{b}Option summary@{ub}

   The following options are supported via icon tool types or as CLI
   arguments (default values in square brackets) :-

     CX_PRIORITY=<number>                              [0]
     SIZE=NO/BORDER/SIZEGAD/BOTH                       [BOTH]
     DEPTH=NO/YES                                      [YES]
     PROPRETURN=NO/YES                                 [YES]
     STRINGCLIP=NO/CONTROL/LALT/RALT/LCOMMAND/RCOMMAND [RCOMMAND]

   Workbench will want to see the tool type "DONOTWAIT" if you put Comif
   in the WBStartUp drawer.

@ENDNODE

@NODE Comif_size "Comif - Size"

 @{b}Option@{ub}

   SIZE=NO/BORDER/SIZEGAD/BOTH  (Default: BOTH)


 @{b}Description@{ub}

   Comif allows you to resize a window from any side/corner.

   You can specify which parts of the window will activate the new sizing
   behaviour. The choices are:-

     NO:      Don't use the wonderful new resizing method
     BORDER:  Any part of the window border not containing a gadget
     SIZEGAD: The window resize gadget
     BOTH:    SIZEGAD and BORDER

   The following steps are required to resize a window using the new method:-

     - Press left mouse button over the chosen area (see above)
     - Move the mouse pointer to the required edge(s) of window
     - Drag the outline of the window to the required new size then release
       the left mouse button.

@ENDNODE

@NODE Comif_depth "Comif - Depth"

 @{b}Option@{ub}

   DEPTH=NO/YES  (Default: YES)


 @{b}Description@{ub}

   With this feature enabled, you can move windows to the front or back
   without having to use the depth gadget.

   In the following paragraph, click means press and release the left mouse
   button without moving the mouse. (Comif will consume the first couple of
   mouse movements incase the mouse moves when its button is pressed)

   To bring a window to the front, simply click on the drag bar, size gadget
   or any part of the window border without a gadget. Use the same procedure
   to send a window to the back, but press the right mouse button before
   releasing the left mouse button.

@ENDNODE

@NODE Comif_prop "Comif - PropReturn"

 @{b}Option@{ub}

   PROPRETURN=NO/YES  (Default: YES)


 @{b}Description@{ub}

   This feature allows you to move the knob of a proportional gadget back
   to wherever it was when you first clicked on the gadget. This feature
   works with normal proportional gadgets and BOOPSI gadgets whose class
   is "propgclass"

   To use, simply press the right mouse button while dragging the knob of
   the proportional gadget, ie. before releasing the left mouse button. 
              
@ENDNODE

@NODE Comif_clip "Comif - StringClip"

 @{b}Option@{ub}

   STRINGCLIP=NO/CONTROL/LALT/RALT/LCOMMAND/RCOMMAND  (Default: RCOMMAND)


 @{b}Description@{ub}

   This feature provides a means of transferring the contents of string
   gadgets to/from the Amiga clipboard. The following key sequences will
   be available while editing a string gadget, where <qualifier> is from
   the user option.

     <qualifier> C       - Copy
     <qualifier> X       - Cut
     <qualifier> V       - Paste (insert)
     <qualifier> shift V - Paste (replace)

   Normal string gadget behaviour allows the contents of a string gadget
   to be cleared, without writing anything to the clipboard, using
   CONTROL-X or RCOMMAND-X. If you choose CONTROL or RCOMMAND as the
   StringClip qualifier, the normal string gadget behaviour will be
   overridden for that qualifier.

   NB. BOOPSI string gadgets are not (yet?) supported.

@ENDNODE

@NODE Comif_hist "Comif - History"

  @{b}StringClip@{ub}

    1.0  First release.

    (No longer supported as a separate utility)


  @{b}Comif@{ub}

    1.0  Wrote a new utility and decided to include the functionality of
         StringClip within the new utility.

         Added a choice of qualifiers for StringClip.

         Fixed minor bug in StringClip.
         (StringClip would not allow a paste/replace unless
          the gadget had room for a paste/insert)


    1.1  Added a timeout (5 secs) to prevent input.device being locked out.
         (ie. Comif v1.0 sometimes caused the Amiga to completely lock-up
              during a window resize)
@ENDNODE

@NODE Comif_cre "Comif - Credits"
 
 @{b}Amiga set-up@{ub}

   A1200 with 170Mb HD, 2+4Mb RAM and 1942 monitor.


 @{b}Author@{ub}

   Stephen Davies
   98 Larches Lane
   Ashton
   Preston
   Lancs
   England
   PR2 1PP


 @{b}Thanks to@{ub}

   Mike Dodd for help with recognising BOOPSI proportional gadgets and also
   for actually using Comif during its development.
   
@ENDNODE