
            ====================================
            |  Document file for MegaCatCheck  |
            ====================================
                 version 1.0  7-Aug-96
                  (c) Copyright 1996,
                     David Huckett
            MegaTech BBS 3:640/800 @ Fidonet
                 +61 (0)77-835-397 Data.

Introduction
------------
Recently I had a hard drive failure and had to rebuild my system from
as usual old outdated backups from tapes and floppies..  Backing up is
one of those tasks I always seem to put off until later.. Usually much
later and in most cases too late. :(

While restoring and rebuilding my file bases I thought of this quick hack
that will do a scan of all your configured section directories and let
you know two things...

   1. The names of all the files that it finds in your Section directories
      that are NOT found in Xenolink's file cat.
      This will allow you to use the list to add the files found if you
      desire.

   2. The names of all the files in your Xenolink file cat that are not
      found in their respective directories on your drive(s).
      You can also use this list to remove the names from the filecat
      or locate the missing files and place them in the correct directory.

The code is very basic and is run from the CLI.  It may also run as a CLI
Door from within Xeno and can be stopped by hitting CTRL C.  I have never
tried it from within Xeno.

It will direct it's output to the shell you started it from or you can
re-direct it with the normal dos re-direction command. eg.

    MegaCatCheck >Ram:Report.txt


Notes
-----

The code is very basic and it can do full directory scans into subdirs etc.
It can be modified easily to use to create a catalogue of your COMPLETE drive.
It can be also modified to actually upload files found not to be in the file
cat of Xeno using a file comment or possibly extract file_id.diz etc.
I had thought of making it so it could be used to scan a supplied directory
and doing a bulk auto upload of it to Xeno. (Good to use from DOpus, especially
when doing a complete rebuild of your system.)

I will leave the options of how far I will develop it to the sysops who use it.
So if you would like it changed or made to do more functions, please let me
know.

Installation
------------
1:     Place MegaCatCheck anywhere you wish to use it, or alternativly
       place it in your command path so it can be run from anywhere on
       your system.

2:     Use it as you wish.. It does not do any alterations to Xeno's
       filecat only reads, so you should not have to back anything up
       before using it.

Licence
-------
MegaCatCheck is copyrighted software, but you may distribute it freely, as
long as ALL the supplied files are included, and NO attempt is made
to modify any of them.


Legal Stuff
-----------
MegaCatCheck is supplied without ANY WARRANTIES WHATSOEVER. I
accept no responsibility for any loss or damage, whether it be financial,
physical, or psychological, resulting from the use or the purported
use of MegaCatCheck for any purpose whatsoever. 



Post any bugs to me in XENOLINK_UTIL or Netmail me at 3:640/800 

****************************
(c) 1995, David Huckett
10 McIntyre Street
Ayr 4807 Queensland.
Australia.
****************************
