+-----------------------------------------------------------------------------+
| Download.TXT Cleaner v0.1 (beta)                                            |
| Written by Drew [PWA]                                                       |
| Docs Last Updated 02-19-95                                                  |
+-----------------------------------------------------------------------------+


+-----------------------------------------------------------------------------+
| 0. Table of Contents                                                        |
+-----------------------------------------------------------------------------+
    1. Introduction
    2. Installation
    3. Configuration
    4. General Notes
    5. 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. Installation                                                             |
+-----------------------------------------------------------------------------+
    It is suggested to put this utility in its own directory.  This is not
mandatory, but it's good for organization. :)


+-----------------------------------------------------------------------------+
| 3. 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.


+-----------------------------------------------------------------------------+
| 4. 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 a **beta**.  There are a couple of more features that
I wish to add, but before doing so, I'd like more input and hence, am
releasing this.

    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