Short:    Purge PFS .DelDir of useful file references
Author:   Giles Burdett (layabouts@the-giant-sofa.demon.co.uk)
Uploader: Giles Burdett (layabouts@the-giant-sofa.demon.co.uk)
Version:  1.4
Type:     disk/misc
Replaces: PurgeDelDir.lha and PurgeDELDIR.lha

    PurgeDelDir has been designed and programmed
    by Giles Burdett.
      - layabouts@the-giant-sofa.demon.co.uk

    PFS is the Professional File System by
    GREat Effects Development.
      - www.greed.nl


PurgeDelDir v1.4
----------------


What is it?

   A tool to erase the entries listed in Device:.DELDIR on a PFS 2 or 3
   formatted partition.


How do I use it?


   Have the command somewhere in your path. I have the directory created
   during the PFS installation, pfs2/tools, in my path, and I keep
   PurgeDelDir in there so it's with all the other PFS related tools.


   Quick start -

                   PurgeDelDir Work:


                   This will erase 32 entries from Work:.DELDIR, with
                   32 being the default value the program uses unless
                   you override it (explained below). This is all a
                   user of PFS 2 will really need.

   More details -

                   PurgeDelDir Work: 50


                   This will erase 50 entries from Work:.DELDIR. Any
                   value between 1 and 992 inclusive can be specified.
                   This is most useful to users of PFS 3 which can
                   have deletion directories of variable size, but both
                   PFS 2 and 3 users can specify a low value to erase
                   fewer entries than exist in Device:.DELDIR.


   Environment control -

                   If you want to permanently override the default
                   value of 32 used by PurgeDelDir, to save yourself
                   typing your preferred value on the command line
                   every time you use it, create a plain text file
                   called -

                            Env:PurgeDelDir/slot_value

                   and simply enter the number you want into this file.

                   Be sure to copy this file (with the directory) to
                   EnvArc: if you want to have it available after you
                   reboot.



Notes

        C source code included. Compiled with vbcc m68k.
        Take a look at the source if you're curious!



Thanks

        Thanks go to the people on the Amiga C mailing list for
        helping me squish some initial bugs!

        Thanks also go to all those who contacted me after the first
        Aminet release to suggest improvements and bugfixes, and
        especially to Jeroen Vermeulen for his many useful remarks
        and suggestions. Thanks Jeroen! :)



Known bugs

        None. Yeah, sure! ;)



History

v1.4   (public release)
       - Corrected maximum allowable entries parameter for PFS 3;
         actually 992 but I read it as 99. Oops! :-)
       - Improved environment variable support; should work
         correctly with HappyEnv now.
       - Better script support (uses correct error levels).


v1.3   (public release)
       - Added support for env variable to override compiled in value.


v1.2
       - Rewritten to use standard dos.library ReadArgs() function.
       - Now compiled with vbcc m68k instead of StormC 2 demo.
       - Filename bug *removed*.


v1.1
       - Minor changes and the one and only known bug (see below)
         still present :(


v1.0   (public release)
       - Contains one known bug that inserts strange characters
         in the filenames the program fills .DelDir with.




Disclaimer

        Use this program at your own risk. I cannot take any responsibility
        for damage, data loss or any other calamity related to the use of
        this software.


============================= Archive contents =============================

Original  Packed Ratio    Date     Time    Name
-------- ------- ----- --------- --------  -------------
    2322    1513 34.8% 09-May-00 01:08:06  PurgeDelDir.info
      64      64  0.0% 08-May-00 22:43:34 +mk
    6092    3692 39.3% 01-Aug-00 00:37:26 +PurgeDelDir
    3111    1276 58.9% 01-Aug-00 00:28:00 +PurgeDelDir.c
    1775    1288 27.4% 09-May-00 00:45:26 +PurgeDelDir.c.info
    3815    1660 56.4% 01-Aug-00 00:36:32 +PurgeDelDir.readme
    1593    1074 32.5% 09-May-00 00:48:38 +PurgeDelDir.readme.info
-------- ------- ----- --------- --------
   18772   10567 43.7% 01-Aug-100 04:04:56   7 files
