 !Help for DirKiller Version 1.04
----------------------------------

Files included in this package :-

!Run
!RunImage
!Sprites
!Help
Templates

 Usage
-------

Once installed on the icon bar, !DirKiller can be used as follows :-

a) If a directory icon is dragged from a directory viewer to the !DirKiller
   icon on the icon bar, then that directory will become the target.

b) If the !DirKiller icon is dragged from the icon bar to a directory
   viewer, then the directory represented by that viewer becomes the target.

c) Menu on the icon permits the user to select one of four states;
   determining the action taken on a target as follows :-

   Access   Unlock everything
   Delete

  Access   Lock everything
   Delete

   Access   Delete all unlocked files and emptied
  Delete   directories

  Access   Kill all
  Delete

   If Confirm is ticked an error window will precede all deletions.

 Notes
-------

Deletion is handled by OS_FSControl 27 (Wipe), whilst locking relies on
recursively reading and maybe altering the attributes of all the objects
within the target directory. The initial state and position of DirKiller on
the icon bar can be altered by setting the system variable 'Dir$Options' in
!Run. To ensure an option is on, include it in the list; to ensure it is
off, precede the option by a '~'. The interpretation is case insensitive.
Any options not included in the list are set to the following values :-

 Options                   Default
---------                 ---------

A(ccess)                  On
D(elete)                  On
C(onfirm)                 On
L(eft side of icon bar)   Off (right hand-side)

 Versions
----------

1.00  Fully functional.

1.01  Parent box bounds for icon dragging corrected to work in all screen
      modes (previous version exhibited peculiar behaviour in mode 16).
      Last chance menu selection now precedes delete operations (it handles
      filenames wider than the screen). Enlarged the stack used by the
      access routine (should cope with any number of directories rather than
      generating errors below about 20 deep). If you drag a group of
      selected objects onto the DirKiller icon they are all deleted without
      a confirmation window. It is now permissible to drag files across.

1.02  Delete operations are now preceded by a standard error window.
      Confirmation is now optional. Responds to !Help.

1.03  Implemented the system variable Dir$Options. Open files can now be
      deleted.

1.04  Optimised the machine code for speed and size.

 Comments
----------

This program was inspired by !Access (Shaun Burnett) and !Dir (Paul
Witheridge). I would like to thank Anthony Hunt and Khalid Owen for
introducing me to shareware.

 Also by this author
---------------------

!DualPrint (1.24)  2 Column BASIC listing.
!FormSize  (1.01)  Calculate template workspace.

 Conditions of Use
-------------------

This application is supplied free for general use "as is", I cannot
guarantee that it is free from bugs or give any warranty about its
suitability for use. You have my permission to give this program to anyone
you please via any medium, provided it is delivered with ALL original files.
Please notify me immediately if you have any problems and I will see what
can be done. I expressly forbid anybody to supply this program on a disc
which is being charged for. If you bought this program contact me
immediately. If you want to borrow some of my code for another shareware
project then please remember to credit me! If you want to use my work for
sale then my acceptance must be sought in writing. I maintain copyright on
all the material supplied and reserve the right to amend these conditions
in cases where I deem misuse.

 Contacts
----------

63 Cromwell Rd
Canterbury
KENT
CT1 3LE

 Mark.J.Collier 1990

