                        Metal Software Top Ten v4.0
                        ---------------------------
           Written by Ray Akey for C-Net Amiga ** v2.18g and up**

 --=-=-=-= See bottom of file for NEW BBS info and registration =-=-=-=--

Changes:
--------
1. Now breaks the barrier limit of 500 users!!
2. Slightly faster processing time.


Installation:
-------------
Copy TopTen, Top20Dloads, TopSelect, TopTen.rexx, TopUD.rexx, TopFiles.rexx,
TopCalls.rexx, TopFiles.rexx and TopMess.rexx to your pfiles directory.

Copy TopTen.config to your SYSDATA directory.

Add TopTen and Top20Dloads as BBSEVENTs in the following format:

ALL start_Time ALL end_time -o RUNC pfiles:TopTen
ALL start_Time ALL end_time -o RUNC pfiles:Top20Dloads

NOTE:  Start_time and End_time should be the same time.

TopSelect:
----------
If TopSelect writing is enabled (see configuration), this P-File is used to
allow users to add any of the selected files to his/her select list. TopSelect
menu options are:

                           Q:uit TopSelect.
                           L:ist Top Files.
                           ?:    TopSelect menu.
                           *:    Select file #.
                          *C:    Clear select list.
                          SS:    Scan Selections.

TopSelect may be added to your BBSMENU by adding the following line at the very
end of the section titled "4; ud/base":

	TS, TSelect									|\#2pfiles:System/TopSelect\


TopTen.rexx:
------------
The file TopTen.rexx displays ALL TopStats files if you wish to add a menu 
command such as "TT" for TopTen.  Add to your BBSMENU in the EVERYWHERE commands
after the last entry in that section:

TT, TTen		|\#1pfiles:topten.rexx\

TopUD.rexx:
-----------
The file TopUD.rexx is suitable to add to the sys.entry.main file in your 
UDBase0 and will display the correct Top Up/Downloaders (40 or 80 column) file
when a user enters the UDBase. If installed in bbsmenu the output will be 
displayed regardless of the user's "Help Level".  TopUD.rexx is added to 
"Udbase0:ttx.entry.main" OR "bbsmenu" as follows:

ttx.entry main installation:
----------------------------
Add the following text to udbase0:ttx.entry.main:

\#1pfiles:TopUD.rexx\

bbsmenu installation:
---------------------
Look for the line in bbsmenu under "3; Main Prompt" that reads 'Uploads' and
add so that it looks as follows:

	Uploads	|\#1Pfiles:system/TopUD.rexx\


TopMess.rexx:
-------------
The file TopMess.rexx is suitable to add to the sys.entry.main file in your 
Base0 and will display the proper Top Messages file (40 or 80 column) when a 
user enters the Message Base.  It is added as follows to your 
"Base0:ttx.entry.main" or "Base0:sys.entry.main" as follows:

\#1pfiles:TopMess.rexx\

TopFiles.rexx:
--------------
The file TopFiles.rexx is suitable to add to the sys.entry.main file in your 
Base0 and will display the proper Top 20 downloads file (40 or 80 column)
wherever you wish to have it displayed.  It is added, as follows, to your 
"Base0:ttx.entry.main":

\#1pfiles:TopFiles.rexx\

Configuration:
--------------
Load the file TopTen.config into your favorite text editor.

The lines are formatted as follows:

Line 1:  Set to a 1 for bargraph display, 0 for regular numeric display.
         (the bargraph display ALSO shows the value numerically to the left of
          the bargraphs).
Line 2:  The number of top users to display.  A "10" here would be the top ten
         in the BARGRAPH display.  Due to the method used to format the
         NUMERIC display if enabled, a "10" on this line with LINE 1 set to "0"
         would display the top TWENTY users.. Experiment with this by first 
         setting line 1 to 0 and run it, then again with line 1 set to a "1".
         You'll see what I mean.
Line 3:  The color for ODD numbered bars in the bargraph display.  The first, 
         third, fifth and so on, bars would be this color.
Line 4:  The color for EVEN numbered bars in the bargraph display.  The second,
         fourth, sixth and so on, bars would be this color.  Lines 3 and 4
         may be set to the same color if you wish all bars to be the same
         color.  For maximum effect, I suggest using different colors though.
Line 5:  The color Handles will be displayed in.
Line 6:  The color the xxMB, and message count are displayed in.
Line 7:	enable writing of Top Selections (Sysdata:Top20Select) if TopSelect is
         installed.  1 = YES, 0 = NO

The program is STILL by no means complete.. There are still many things to be 
added such as making all text external, etc,.. but this is a completely stable
and functional release.  Tested for many hours on my support BBS and a couple 
of my beta testers' boards.
         
The readable output files are generated to your gfiles directory... It's VERY 
flexible and produces a very nice output that is formatted to look perfect if 
used in your UDBase and Base entry files via the included ARexx programs.

Enjoy and please direct any comments or suggestions to Heavy Metal on Future
World or call my BBS:

------------------------------------------------------------------------------
                           The Metal Shoppe BBS
                             Windsor, Ontario
                                  CANADA
                              CLINK: 1:5178/0

   Full C-Net Amiga and AMIGA support.  Headquarters of METAL SOFTWARE.

                  Line 1: 519-255-7378  1200-2400  baud.
                  Line 2: 519-256-0278  2400-19200 baud.

If you like my P-Files, please consider helping me have the time to write
more by sending $10 or 20 bucks to the address below.  The more registration
fees I get, the less I will have to work on other things and can concentrate
on programming.  THANK-YOU for using MS-TopTen!.

	REGISTRATION;	Send your cheque or money order to:

                             Metal Software
                             c/o Ray Akey
                             411 Bridge Ave.
                             Windsor, Ontario
                             CANADA  N9B 2M3

------------------------------------------------------------------------------
