home *** CD-ROM | disk | FTP | other *** search
/ Amiga Elysian Archive / AmigaElysianArchive.iso / comm / tf_v05b.lha / TopFiles.DOC < prev   
Text File  |  1993-05-29  |  7KB  |  177 lines
  1. *****          *****    *             |                               
  2.   *            *     *  *             |   By              (v0.5beta)     
  3.   *  **** **** ***      *   ***   **  |       /                       
  4.   *  *  * *  * *    **  *  *   * *    |      < rispy  /               
  5.   *  *  * *  * *     *  *  ****   **  |       \      < oftware        
  6.   *  *  * *  * *     *  *  *        * |               >               
  7.   *  **** **** *    *** *   ***   **  |              /                
  8.           *                           |                               
  9.           *                           |                               
  10.  
  11. Introduction
  12. ============
  13.  
  14.   It is hard to believe that there with all of the talented programmers
  15. out there in DLG-land that not a single person wrote a 'Here are the files
  16. that have been downloaded the most' program.  Imagine my amazement when
  17. one of us (namely Allen) received not a single reply to my query for such
  18. a program from the combined conscious of DLG_CHAT!  So, we wrote one up in
  19. a jif... and added a few 'toys' to it along the way.  Not only does it
  20. keep track of which files, but also what their sizes are and how many
  21. times they have been downloaded.  In the future, we'll probably add the
  22. ability to show the area the file is in as well.
  23.  
  24.   Anyhow, we're sure you could really care less about that rather strange
  25. tale of a guy whose single plea for help went unanswered, until that man
  26. decided to single-handedly take on the world...
  27.  
  28.   Err... sorry.  Just got finished watching one of those Disney
  29. 'Incredible Journey'-type things.
  30.  
  31. Requirements
  32. ============
  33.  
  34.   Nothing special, really...
  35.  
  36.   *  DLG Pro BBS, any version should do (dlg.library is *not* called)
  37.   *  A dos.library of v36 or higher
  38.   *  An assignment to FILE: where there are numbered subdirectories
  39.      containing your <xxx>.fd files
  40.  
  41. Usage
  42. =====
  43.   
  44.   Simple.
  45.  
  46.   TopFiles [options] [(TO) outputfile]
  47.  
  48.   Simply supply the necessary options or output filename as needed.  The
  49. output file can be any legal AmigaDOS file.  If it isn't supplied,
  50. standard out (ie, the console) is used.  The TO is completely optional.
  51.  
  52.   Options, at this point in time, include:
  53.    
  54.  Option   Abbrev      Usage               Result
  55.  ------   ------      ---------------     --------------------------------
  56.   Size      S         TopFiles Size 5     Sets the number of files to
  57.                                           keep track to 5.  Legal values
  58.                                           are any numbers greater than 0.
  59.                                           Defaults to 10.
  60.  
  61.   Free      F         TopFiles Free       Allows NORATIO files to be
  62.                                           included in the listing.
  63.  
  64. Sample Output
  65. =============
  66. (Usage was "TopFiles FREE SIZE 20 TO DLGTexts:TopFiles.TXT")
  67.  
  68. --------------------CUT HERE--------------------------
  69. Top 10 Downloaded Files:
  70.  
  71. Num Name                                  Size (b)  DLs
  72. --- ------------------------------------- --------- ---
  73.  1. MTV-USER.TXT                               5579   7
  74.  2. FTP-FAQ.LHA                                5056   6
  75.  3. PETSHOPBOYSINHELL.MOD                    158806   4
  76.  4. UNZIP51DX.LHA                             82551   4
  77.  5. LHA_E138.RUN                             109140   4
  78.  6. MAGICMENU1.17.LHA                         80502   4
  79.  7. ARQ1_78.LZH                               33650   4
  80.  8. SUPERDARK113.LHA                         135605   4
  81.  9. AMYTRACE.LZH                              44180   4
  82. 10. SHAG                                      15898   4
  83. 11. TIN-HELP.TXT                               3518   3
  84. 12. MTV_FLZ.LHA                               24079   3
  85. 13. POLICY4.TXT                               75962   3
  86. 14. TRANZSEVEN.MOD                           218388   3
  87. 15. VAPORTXT.ZIP                              95729   3
  88. 16. LEMMINGS-CODES.LZH                         2098   3
  89. 17. DEGRADER130.LZH                           16384   3
  90. 18. DLGBL01.LHA                               24618   3
  91. 19. AQ_122.LHA                                75224   3
  92. 20. RDMICONS.LZH                              98688   3
  93.  
  94.  
  95. Listing Generated by TopFiles
  96. TopFiles is Copyright (C) 1993, CrispySoft
  97.  
  98. ----------------------END CUT---------------------------
  99.  
  100. Help!
  101. =====
  102.  
  103.   First, the standard disclaimer:
  104.  
  105.   Crispy Software, or any of its subcompnents, make absolutely no
  106. guarantees as to this programs abilities.  All risk involved with
  107. TopFiles is rests solely on the user of the TopFiles program.
  108.  
  109.   That aside, if you do have problems, we would like to hear about them. 
  110. You can contact us at the following locations:
  111.  
  112.   Fidonet : Support@1:11/400.0        [this will soon change...again...]
  113.   AmigaNet: Support@40:206/12.0
  114.   Internet: support@crispy.carb.il.us
  115.   WWIVlink: 2@26853                   [this will soon change...again...]
  116.   
  117. If the previous electronic addresses don't cut it, try snail mail to
  118. here:
  119.  
  120.           Crispy Software
  121.           403 W. Freeman Apt 15
  122.           Carbondale, IL  62901
  123.  
  124.                -or-
  125.  
  126. You could always call the system.  No guarantees on whether or not you
  127. actually survive the shock when you see what we did to DLG... [especially
  128. if we get finish up our 'Run MS-DOS BBS's As A Door' program... hehe..]
  129.  
  130.               M E N T A L
  131.               V O R T E X
  132.             01-618-529-3486
  133.  
  134.               3/12/2400 
  135.    [someday soon, a real modem will appear here...]            
  136.  
  137. Distribution
  138. ============
  139.  
  140. Even though TopFiles is Copyright (C) 1993, Crispy Software, this program
  141. can still be freely distributed so long as it is not done through ADS except
  142. as noted below. SAN and Fred Fish distribution more than welcome.  Companies
  143. that distribute PD/shareware via disk or anyone I forgot: call, write, 
  144. contact me for further instructions.
  145.  
  146. Dedications
  147. ===========
  148.  
  149. [For those who haven't switched from WWIV, it is traditional that members
  150. of the WWIV modding community include a 'Dedications' section in their
  151. documentation.  What can we say, habits are hard to break...]
  152.  
  153. Chewbacca                 [Rest In Peace, my friend]
  154. Lola The Sheep            [from Night on Earth]
  155. Mike Oliphant             [Finally!  Programmer's docs we can use! :P]
  156. Gary Gulliver             [ADS?  Isn't that Amiga Dictatorial Society?]
  157.  
  158. History
  159. =======
  160.  
  161. Version 0.5:
  162. ------------
  163.   * STILL NOT TESTED FOR MUNGWALL/ENFORCER PROBLEMS!
  164.   * Finished support for command line options
  165.   * Exclude unimplemented
  166.   * Have one warning to deal with, but code works ok anyhow. :P
  167.   * Fixed version string
  168.   * Actually ran GO on this one :)
  169.   * Still being compiled with `catch.o', just to be on the safe side
  170.   * Need to work on use     breaks.  Disabled right now, for the most part. :(
  171.   * Add 'Area' option?
  172.   * Add 'Colorize' option?
  173.  
  174. Version 0.1:
  175. -----------
  176.   * Initial [Test] Version
  177.