home *** CD-ROM | disk | FTP | other *** search
/ Crawly Crypt Collection 1 / crawlyvol1.bin / bbs / top_dl13 / td.doc next >
Text File  |  1993-12-30  |  6KB  |  157 lines
  1.     ----------------------------------------------------------------------
  2.                /\
  3.     ----------/  \----------
  4.     ---------/    \---------                                1 January 1994
  5.     --------/      \--------
  6.     -------/  BBS   \-------                    TOP_DL
  7.     ------/          \------            (Top Download Tracker)
  8.     -----<  EXPRESS!  >-----                 Version 1.3
  9.     ------\          /------
  10.     -------\   ST   /-------
  11.     --------\      /--------
  12.     ---------\    /---------
  13.     ----------\  /----------
  14.                \/
  15.     ----------------------------------------------------------------------
  16.  
  17.  
  18.     ----------------------------------------------------------------------
  19.                   Copyright 1994 Marc Ferrari and C&R Systems
  20.     ----------------------------------------------------------------------
  21.  
  22.  
  23.     ----------------------------------------------------------------------
  24.     INTRODUCTION:
  25.  
  26.     1.  Top Download Tracker is a utility for BBS Express! ST which
  27.     generates reports of the most downloaded files from BBS Express! ST
  28.     file description files.
  29.  
  30.     2.  Top Download Tracker is a joint effort between Marc
  31.     Ferrari, Quantum Thump BBS (512-795-9175) and Rich Sanchez, C&R BBS
  32.     (717-765-8623)
  33.  
  34.     3.  The file TOP_DL.PRG is by Marc Ferrari, Copyright 1994 and is
  35.     released as Shareware.
  36.  
  37.        Yes its shareware.  5 whopping dollars.  That's it.  You are    
  38.        encourged to spread this archive around so all Express BBS's can
  39.        enjoy its output.
  40.  
  41.        Mailing address:
  42.  
  43.        Marc Ferrari
  44.        3619C North Hills Dr.
  45.        Austin, TX 78731
  46.  
  47.        p.s.  If your NOT yet running the ISIS network software you are
  48.        really missing out.  If you want to know more drop me a line on
  49.        C&R BBS Alias Zaphod or call me at Quantum Thump BBS
  50.        512-795-9175 14.4 v32/42 and I will fill you in.
  51.  
  52.     4.  The Script File TD.SCR is by Rich Sanchez, C&R Systems.
  53.  
  54.     5.  This document is a edited version of the one provided by
  55.     Marc Ferrarri.
  56.  
  57.     ----------------------------------------------------------------------
  58.  
  59.     Greets.  This is the doc file for a nifty little program that needed
  60.     to be written.  After a conversation with Rich on the subject of TOP
  61.     Download listers I was presented with a pretty bleak selection of
  62.     programs to generate my much desired TOP DL lists....  I pondered...
  63.     and pondered... a few more times for proper effect please.   hehehe 
  64.  
  65.  
  66.     Anyway,
  67.  
  68.     I needed something easy to setup and maintain, effective and
  69.     informative.  This is what I came up with.  It's called Top Download
  70.     Tracker and it fills all of the requirements.
  71.  
  72.     It has a CONFIG file called TOP_DL.CFG that must be located in the
  73.     same directory as TOP_DL.PRG.  I won't go into it here but the
  74.     instructions on what to place in the CFG file are in the CFG file!
  75.     Grab your favorite text editor and EDIT it after you read this.
  76.  
  77.  
  78.  
  79.     Here is what you can tell the program to do:
  80.     --------------------------------------------
  81.  
  82.     How many files to include in the TOP Downloaded report.  Example: Top
  83.     10, Top 20 etc.  The range is 1-100.
  84.  
  85.     Which file sigs to create TOP Download lists for.
  86.  
  87.     Where to place the TOP Download reports example: e:\top_dl\.
  88.  
  89.     Of course you can pres ESC while the program is running to Shut it
  90.     down.
  91.  
  92.  
  93.  
  94.     Installation:
  95.     -------------
  96.  
  97.     Make a Folder somewhere on your Hard drive and place This DOC file,
  98.     the CFG file and the .PRG in there.  Also the Script file TD.SCR
  99.     should be placed in this same folder.
  100.  
  101.     Edit the CFG file to suit your tastes.
  102.  
  103.     Add it to your BBS script someplace.  I run mine from the ISIS
  104.     SHELL.TTP with an * in front of the program name so it only runs once
  105.     a day. 
  106.  
  107.     HINT  - You can run it from anything, anytime.  I am hoping that ISIS
  108.     Node 14 will write a script interface for viewing the reports this
  109.     program generates.  Why?  I want to see what he comes up with.
  110.  
  111.     This program is NOT a viewer, it only generates PURE text reports that
  112.     can be easily read by most anything.  Thats why its so small and fast. 
  113.  
  114.     Thats all for installation.
  115.  
  116.     If something is NOT configured correctly, the program will Bitch at
  117.     you, tell you whats wrong and gracefully shutdown.  No muss, no fuss.
  118.  
  119.  
  120.  
  121.     General Info:
  122.     -------------
  123.  
  124.     The Reports it generates are saved with the filename: TOP_DL.[x] where
  125.     [x] is the number of the file Sig that this report pertains to.  This
  126.     way you can easily tell which filename goes with what file sig!  The
  127.     name and number of the file sig IS stored in each report so your users
  128.     will know what they are looking at.
  129.  
  130.     The reports will be stored in whatever folder you specify in the CFG
  131.     file.
  132.  
  133.     Empty file SIGS will not have any reports generated.
  134.  
  135.     If you need something changed, or catch a bug(eeeeek!) Tell me and I
  136.     will kill it.  I have tested the crap out of it and have not been able
  137.     to make it fail yet.
  138.  
  139.     It gets your FILE SIG info from your SYSDATA.DAT file which RICH
  140.     provided the source code for reading for which I am grateful.
  141.     Otherwise it would have been more work for me.  <grin> Dont fear, your
  142.     Sysdata.dat is only opened with READ access.  It will not be harmed in
  143.     the least bit.  Or, you can just put a copy of your SYSDATA.DAT file
  144.     in the same folder as this program.
  145.  
  146.     I left the display pretty plain since I was trying to keep the size of
  147.     the program down and certain sysops dont care for snazzy graphics
  148.     anyway.
  149.  
  150.     You may run the program as often as you wish.  Once a day should be
  151.     sufficient.
  152.  
  153.     BE SURE TO ENJOY IT.
  154.  
  155.     ----------------------------------------------------------------------
  156.  
  157.