*****          *****    *             |                               
  *            *     *  *             |   By              (v0.5beta)     
  *  **** **** ***      *   ***   **  |       /                       
  *  *  * *  * *    **  *  *   * *    |      < rispy  /               
  *  *  * *  * *     *  *  ****   **  |       \      < oftware        
  *  *  * *  * *     *  *  *        * |               >               
  *  **** **** *    *** *   ***   **  |              /                
          *                           |                               
          *                           |                               

Introduction
============

  It is hard to believe that there with all of the talented programmers
out there in DLG-land that not a single person wrote a 'Here are the files
that have been downloaded the most' program.  Imagine my amazement when
one of us (namely Allen) received not a single reply to my query for such
a program from the combined conscious of DLG_CHAT!  So, we wrote one up in
a jif... and added a few 'toys' to it along the way.  Not only does it
keep track of which files, but also what their sizes are and how many
times they have been downloaded.  In the future, we'll probably add the
ability to show the area the file is in as well.

  Anyhow, we're sure you could really care less about that rather strange
tale of a guy whose single plea for help went unanswered, until that man
decided to single-handedly take on the world...

  Err... sorry.  Just got finished watching one of those Disney
'Incredible Journey'-type things.

Requirements
============

  Nothing special, really...

  *  DLG Pro BBS, any version should do (dlg.library is *not* called)
  *  A dos.library of v36 or higher
  *  An assignment to FILE: where there are numbered subdirectories
     containing your <xxx>.fd files

Usage
=====
  
  Simple.

  TopFiles [options] [(TO) outputfile]

  Simply supply the necessary options or output filename as needed.  The
output file can be any legal AmigaDOS file.  If it isn't supplied,
standard out (ie, the console) is used.  The TO is completely optional.

  Options, at this point in time, include:
   
 Option   Abbrev      Usage               Result
 ------   ------      ---------------     --------------------------------
  Size      S         TopFiles Size 5     Sets the number of files to
                                          keep track to 5.  Legal values
                                          are any numbers greater than 0.
                                          Defaults to 10.

  Free      F         TopFiles Free       Allows NORATIO files to be
                                          included in the listing.

Sample Output
=============
(Usage was "TopFiles FREE SIZE 20 TO DLGTexts:TopFiles.TXT")

--------------------CUT HERE--------------------------
Top 10 Downloaded Files:

Num Name                                  Size (b)  DLs
--- ------------------------------------- --------- ---
 1. MTV-USER.TXT                               5579   7
 2. FTP-FAQ.LHA                                5056   6
 3. PETSHOPBOYSINHELL.MOD                    158806   4
 4. UNZIP51DX.LHA                             82551   4
 5. LHA_E138.RUN                             109140   4
 6. MAGICMENU1.17.LHA                         80502   4
 7. ARQ1_78.LZH                               33650   4
 8. SUPERDARK113.LHA                         135605   4
 9. AMYTRACE.LZH                              44180   4
10. SHAG                                      15898   4
11. TIN-HELP.TXT                               3518   3
12. MTV_FLZ.LHA                               24079   3
13. POLICY4.TXT                               75962   3
14. TRANZSEVEN.MOD                           218388   3
15. VAPORTXT.ZIP                              95729   3
16. LEMMINGS-CODES.LZH                         2098   3
17. DEGRADER130.LZH                           16384   3
18. DLGBL01.LHA                               24618   3
19. AQ_122.LHA                                75224   3
20. RDMICONS.LZH                              98688   3


Listing Generated by TopFiles
TopFiles is Copyright (C) 1993, CrispySoft

----------------------END CUT---------------------------

Help!
=====

  First, the standard disclaimer:

  Crispy Software, or any of its subcompnents, make absolutely no
guarantees as to this programs abilities.  All risk involved with
TopFiles is rests solely on the user of the TopFiles program.

  That aside, if you do have problems, we would like to hear about them. 
You can contact us at the following locations:

  Fidonet : Support@1:11/400.0        [this will soon change...again...]
  AmigaNet: Support@40:206/12.0
  Internet: support@crispy.carb.il.us
  WWIVlink: 2@26853                   [this will soon change...again...]
  
If the previous electronic addresses don't cut it, try snail mail to
here:

          Crispy Software
          403 W. Freeman Apt 15
          Carbondale, IL  62901

               -or-

You could always call the system.  No guarantees on whether or not you
actually survive the shock when you see what we did to DLG... [especially
if we get finish up our 'Run MS-DOS BBS's As A Door' program... hehe..]

              M E N T A L
              V O R T E X
            01-618-529-3486

              3/12/2400 
   [someday soon, a real modem will appear here...]            

Distribution
============

Even though TopFiles is Copyright (C) 1993, Crispy Software, this program
can still be freely distributed so long as it is not done through ADS except
as noted below. SAN and Fred Fish distribution more than welcome.  Companies
that distribute PD/shareware via disk or anyone I forgot: call, write, 
contact me for further instructions.

Dedications
===========

[For those who haven't switched from WWIV, it is traditional that members
of the WWIV modding community include a 'Dedications' section in their
documentation.  What can we say, habits are hard to break...]

Chewbacca                 [Rest In Peace, my friend]
Lola The Sheep            [from Night on Earth]
Mike Oliphant             [Finally!  Programmer's docs we can use! :P]
Gary Gulliver             [ADS?  Isn't that Amiga Dictatorial Society?]

History
=======

Version 0.5:
------------
  * STILL NOT TESTED FOR MUNGWALL/ENFORCER PROBLEMS!
  * Finished support for command line options
  * Exclude unimplemented
  * Have one warning to deal with, but code works ok anyhow. :P
  * Fixed version string
  * Actually ran GO on this one :)
  * Still being compiled with `catch.o', just to be on the safe side
  * Need to work on use	 breaks.  Disabled right now, for the most part. :(
  * Add 'Area' option?
  * Add 'Colorize' option?

Version 0.1:
-----------
  * Initial [Test] Version
