TrashIcon V0.6   © Mark McPherson, 6-Feb-93
-------------------------------------------

  TrashIcon - A Workbench 2.04+ application icon to delete files.

DESCRIPTION
  The workbench has a standard trashcan, but unfortunately, each disk
must have its own, and it cannot be 'Left Out'.  TrashIcon basically
puts an icon at a (possibly user-defined) position on the workbench
screen, and deletes all files that are dragged onto it.

OPTIONS
  The icon used for the appicon is just the program's icon, which can
of course be changed, if the user wants (which is quite likely - I'm 
a programmer, not an artist!)  The default options are taken from the
icon's tooltypes.  These are as follows:

        FORCE - If set, then deletion overides any protection flags
                on the file, thus causing ALL files to be deleted.

    RECURSIVE - If set, then if a directory is dragged to the icon,
                it, and all its contents are deleted.  If not set,
                then a directory will only be deleted if it is empty.

      CONFIRM - If set, then a requestor will pop up asking the user to
                confirm the action of deleting files.  It will display
                the number of files and directories in a manner similar
                to that of the workbench menu item 'Delete...'

     XPOS=xxx - If set, then this is the x-coordinate that the appicon
                will be set at when placed on the workbench screen. If
                there is something else already there, or it is off the
                boundaries of the screen, then it will be placed by
                Workbench.

     YPOS=xxx - Same as XPOS=xxx, but for the y-coordinate.


  If the icon is double clicked on, then an options window will appear. 
This gives the user the ability to overide the default flags in the
tooltypes.  It also contains an 'About' requester.  Please look at this -
after all, I did take the effort to put it there!  To quit the program,
just click on the 'Quit' gadget.


NOTES
  If a file has an icon, then if that file cannot be deleted, neither will
its icon.  The exception is when there is an icon without a file.


FILES
  TrashIcon      - the program
  TrashIcon.info - The program's icon file, including example tooltypes.
  TrashIcon.Doc  - This documentation file


HISTORY
  V0.1 - Internal release.  Inital program.  No Options window.
  V0.5 - Internal release.  Added options window.
  V0.6 - This release.  Handles XPOS,YPOS positioning.


TESTING
  This version has been tested under V37.175, and V39.106, on both
accelerated and unaccelerated machines.  It even worked on all of
them!


AUTHOR
  I am currently a student at the University of Kent at Canterbury,
where studying for a degree in Computer Science.  This is my second
public release of one of my programs.  The other being MmDir which
made multiple, nested, directories in one go.  At the present, as
well as trying to finish all the work our lecturers give us to do,
a group of friends and I are working on a networking system for
linking an arbitrary number of Amigas together.  The hardware is
working, and the software is designed, and SLOWLY being written.

I can be contacted on the Internet, and JANET, at "msm@ukc.ac.uk".
If you can, please send me some E-Mail to say you use this program,
along with comments on what else is necessary.  There IS quite a lot
that could be added to it, but I need some incentive to work on it.
ie - Tell me you like my program, and what you want added, and I'll
try to oblige  :o)


DISTRIBUTION
  All code is copyright (C) 1993 Mark McPherson.  It is freely
distributable and can be copied so long as no charge is made.  It
may not be modified, sold or included in any commercial distribution
without my written permission.  I also ask that this documentation
file accompanies the main program.  The author takes no responsibility
for any loss or damage that may arise from using this program.