+-----------------------------------------------------------------------------+
| Download.TXT Cleaner v1.0                                                   |
| Written by Drew [PWA]                                                       |
| Docs Last Updated 03-26-95                                                  |
+-----------------------------------------------------------------------------+


+-----------------------------------------------------------------------------+
| 0. Table of Contents                                                        |
+-----------------------------------------------------------------------------+
    1. Introduction
    2. Packaging
    3. Installation
    4. Configuration
    5. General Notes
    6. Last Words


+-----------------------------------------------------------------------------+
| 1. Introduction                                                             |
+-----------------------------------------------------------------------------+
    This utility will shrink/clean your download.txt file.  It can remove
entries (for):

    1. Non-existent files in specified (upload) directories.
    2. .QWK transfers
    3. .CAP (message captures)
    4. Exclude according to specified user names.

This is ideal for other utilities which scan the download.txt file for their
purposes (ie: Nukers, Weekly/Monthly bulletin generators, download counters,
etc.).


+-----------------------------------------------------------------------------+
| 2. Packaging                                                                |
+-----------------------------------------------------------------------------+
    Your zip file should contain the following files:

        DTC.EXE        The utility (DOS executable) itself.
        DTC.CFG        Main configuration file.
        DTC.DOC        Documentation (you are reading it now).
        DIRS.CFG       Directories to search for transfered files.
        USERS.CFG      User exclusion file.
        EXAMPLE.BAT    Sample batch file to use.
        HISTORY.DOC    Revision history.
        OTHERDJP.DOC   Other stuff I've written.
        FILE_ID.DIZ    File (zip) description.
        PWA.NFO        PWA info file.
        TSP.NFO        My bbs ad.

    If any of these files are missing, be warned that you may have a copy
that has been tampered with.  If you have any extra files, they are extraneous
and unnecessary.

    Typically, my bbs ad may not be there, which is not a problem.  However,
the idiots who contribute this to the fidonet backbone (usually originating 
from the Clipper Workshop BBS) edit the FILE_ID.DIZ, remove PWA.NFO and
OTHERDJP.DOC, and insert their own bbs ad which is bigger than most ppe's.
Just be aware, since who knows what other stupidities they may pull.


+-----------------------------------------------------------------------------+
| 3. Installation                                                             |
+-----------------------------------------------------------------------------+
    It is suggested to put this utility in its own directory.  This is not
mandatory, but it's good for organization. :)


+-----------------------------------------------------------------------------+
| 4. Configuration                                                            |
+-----------------------------------------------------------------------------+
    Edit DTC.CFG for all options.  It's relatively short and simple, so should
be painless as well.

    If you wish to scan multiple directories to remove non-existent files,
make sure you specify the directories in DIRS.CFG, one per-line, and say "yes"
to line 7 in DTC.CFG.

    If you wish to exclude transfers made by specific users, put the users's
names in USERS.CFG, one per line, and say "yes" to line 6 in DTC.CFG.


+-----------------------------------------------------------------------------+
| 5. General Notes                                                            |
+-----------------------------------------------------------------------------+
    I only know of one other program that did anything similar to this.  But
it was a PPE and took *forever* to run.  Hence, I decided to write this up and
have it run as quickly as possible.

    This utility does *not* alter the original download.txt file.  This is a
safety precaution so in case something bad happens, you know it's not this
utility's fault. :)  The new output file is specified in the config file, so
you, the sysop, will have to manually rename/delete files.  Basically, the
ideal steps to take after running this utility are:

    1. Rename download.txt to download.bak
    2. Rename output.txt to download.txt

See EXAMPLE.BAT for exactly what I mean if you do not understand this.

    This version is the first non-beta release.  I originally wanted to add
a couple of more features to this (namely, removing entries by arbitrary
filename and/or extension as well as by date), but since there was no real
input on this matter, I've decided to leave it as such.  Hence, this version
is pretty much identical to the last beta release (v0.2) with some code and
compiler optimizations here and there.  Functionally, there should be no
difference.

    This utility was written in C and compiled with Borland C++ 3.1.  It has
been tested under a DOS/Desqview environment, but should work with OS/2 as
well.


+-----------------------------------------------------------------------------+
| 6. Last Words                                                               |
+-----------------------------------------------------------------------------+
    Thanks to Raw Liquid for bringing up this idea.  I've had this thing
laying around for ages, and if it weren't for him, I would never have gotten
around to finishing it up. :)

    Otherwise, if you need to reach me for some reason, you can send internet
email to "drew@xinet.com", or leave me a message on Attitude Net, or call my
board: The Silicon Phalanx at 310-575-8567 and apply for access.

Peace,
--Drew