TOPS.DOC

5.8 KB 7f557a31b0bbda47…
                        TOPS 1.02 - by Glenn Martin
                        ===========================

                               July 17, 1988


TOPS source code is Copyright (C) 1988 by Glenn Martin.  However, the
executable file is free for the asking.  The author gives no warranty of
any kind nor is he responsible for results from using TOPS.

TOPS is a QuickBBS utility that simply reads your USERS.BBS file and makes
up an ASCII bulletin of top downloaders and top uploaders, and a bulletin of
top message posters.  An ANSI version of each bulletin may also be made.
It was previously called TDLUL, but this now supercedes it and it will
no longer be supported.  The basis of TOPS rests in a file named TOPS.CFG.

The TOPS.CFG file consists of 17 lines as follows:

Line  1 : The name of your BBS.
Line  2 : The path to your USERS.BBS.
Line  3 : The path and filename of the ASCII version of the top downloaders
          and uploaders bulletin.  If this is left blank, no such bulletin
          will be made.
Line  4 : The path and filename of the ANSI version of the top downloaders
          and uploaders bulletin.  If this is left blank, an ANSI bulletin
          is not made.  This line must be left blank if line 3 was.
Line  5 : Consists of a single character.  A "K" if you want the top
          downloaders and uploaders bulletin to be based on the amount
          of K of files.  A "#" if you want the bulletin to be based on
          the number of files.  This should be a blank line if line 3 was
          left blank.
Line  6 : The number of top downloaders and top uploaders to show.  A "10"
          here will list the top 10 downloaders and the top 10 uploaders in
          the bulletin.
Line  7 : The path and filename of the ASCII version of the top message
          posters bulletin.  If this is left blank, no such bulletin will
          be made.
Line  8 : The path and filename of the ANSI version of the top message
          posters bulletin.  If this is left blank, an ANSI bulletin is
          not made.  This line must be left blank is line 3 was.
Line  9 : This line consists of a single integer.  If you want the BEST
          message posters to be shown, put a "1" here.  If you want to
          see the worst message posters, put a "2" here.
Line 10 : The number of message posters to include in the bulletin.  A
          "10" here will list 10 message posters in the bulletin.
Line 11 : An integer.  A "1" here will tell TOPS to put a screen clearing
          code in the beginning of each bulletin created.  A "2" will
          tell TOPS not to insert screen clearing codes.
Line 12 : A pause statement.  Any string here is included at the end of
          all bulletins created, and a <Ctrl><A> is added to have QuickBBS
          pause and wait for the <Enter> key to be pressed.  If this line
          is left blank, no pause is made.
Line 13 : BBS name color.  This is an integer from the table below that
          represents which color your BBS name should be in the ANSI
          bulletins.  If you are not making any ANSI bulletins, this line
          should be left blank.
Line 14 : Date and time color.  This also is an integer from the table below
          which represents which color the date and time should be in the
          ANSI bulletins.  Once again, if you are not making any ANSI
          bulletins, this line should be left blank.
Line 15 : Headings color.  This integer represents which color the heading
          for each list should be in.  The headings are "Top Downloaders",
          "Top Uploaders", "Top Message Posters", and the ratio statements.
          Leave this line blank if you are not making any ANSI bulletins.
Line 16 : Number 1 color.  This integer represents the color which the top
          person in each list should be.  This allows you be highlight who
          is at the top of each list.  This line should be left blank if
          no ANSI bulletins are made.
Line 17 : Rest of list color.  This integer represents the color the rest
          of each list should be.  This should also be left blank if no
          ANSI bulletins are made.
Line 18 : Pause color.  This integer represents which color the pause line
          will be in.  This line should be left blank if no ANSI bulletins
          are made, or if pause lines are not used.



                              Table of Colors
                              ===============

                               30 - Black
                               31 - Red
                               32 - Green
                               33 - Yellow
                               34 - Blue
                               35 - Magenta
                               36 - Cyan
                               37 - White



I want to thank Lou Ley for doing a great job on beta testing this program,
and Thomas Baker for bringing QuickBBS to the Orlando area in the first place.
QuickBBS is written and copyrighted by Adam Hudson.

If you need further help or have suggestions, you can reach me at Glenn's
Point (407-859-9648, FidoNet Address 1:18/503, 4pm to midnight).  I'm the
sysop there and will be able to answer very quickly.

Any donations, comments, or requests will be accepted.  Please send them to:

Glenn Martin
3235 Lake Anderson Avenue
Orlando, Florida 32812


In any case, I'd appreciate it if you would complete the enclosed form and
send it to me.  I'm curious and would like to know where my program goes.
Thank you and I hope you find the program useful.


Glenn Martin






Revision History
================

Version 1.02       A bug was found concerning the conversion of the midnight
                   hour.  This would cause a 'PM' to be attached to the time
                   rather than an 'AM'.