home *** CD-ROM | disk | FTP | other *** search
/ Simtel MSDOS 1992 September / Simtel20_Sept92.cdr / msdos / bbs / tops102.arc / TOPS.DOC < prev    next >
Text File  |  1988-07-17  |  6KB  |  125 lines
  1.                         TOPS 1.02 - by Glenn Martin
  2.                         ===========================
  3.  
  4.                                July 17, 1988
  5.  
  6.  
  7. TOPS source code is Copyright (C) 1988 by Glenn Martin.  However, the
  8. executable file is free for the asking.  The author gives no warranty of
  9. any kind nor is he responsible for results from using TOPS.
  10.  
  11. TOPS is a QuickBBS utility that simply reads your USERS.BBS file and makes
  12. up an ASCII bulletin of top downloaders and top uploaders, and a bulletin of
  13. top message posters.  An ANSI version of each bulletin may also be made.
  14. It was previously called TDLUL, but this now supercedes it and it will
  15. no longer be supported.  The basis of TOPS rests in a file named TOPS.CFG.
  16.  
  17. The TOPS.CFG file consists of 17 lines as follows:
  18.  
  19. Line  1 : The name of your BBS.
  20. Line  2 : The path to your USERS.BBS.
  21. Line  3 : The path and filename of the ASCII version of the top downloaders
  22.           and uploaders bulletin.  If this is left blank, no such bulletin
  23.           will be made.
  24. Line  4 : The path and filename of the ANSI version of the top downloaders
  25.           and uploaders bulletin.  If this is left blank, an ANSI bulletin
  26.           is not made.  This line must be left blank if line 3 was.
  27. Line  5 : Consists of a single character.  A "K" if you want the top
  28.           downloaders and uploaders bulletin to be based on the amount
  29.           of K of files.  A "#" if you want the bulletin to be based on
  30.           the number of files.  This should be a blank line if line 3 was
  31.           left blank.
  32. Line  6 : The number of top downloaders and top uploaders to show.  A "10"
  33.           here will list the top 10 downloaders and the top 10 uploaders in
  34.           the bulletin.
  35. Line  7 : The path and filename of the ASCII version of the top message
  36.           posters bulletin.  If this is left blank, no such bulletin will
  37.           be made.
  38. Line  8 : The path and filename of the ANSI version of the top message
  39.           posters bulletin.  If this is left blank, an ANSI bulletin is
  40.           not made.  This line must be left blank is line 3 was.
  41. Line  9 : This line consists of a single integer.  If you want the BEST
  42.           message posters to be shown, put a "1" here.  If you want to
  43.           see the worst message posters, put a "2" here.
  44. Line 10 : The number of message posters to include in the bulletin.  A
  45.           "10" here will list 10 message posters in the bulletin.
  46. Line 11 : An integer.  A "1" here will tell TOPS to put a screen clearing
  47.           code in the beginning of each bulletin created.  A "2" will
  48.           tell TOPS not to insert screen clearing codes.
  49. Line 12 : A pause statement.  Any string here is included at the end of
  50.           all bulletins created, and a <Ctrl><A> is added to have QuickBBS
  51.           pause and wait for the <Enter> key to be pressed.  If this line
  52.           is left blank, no pause is made.
  53. Line 13 : BBS name color.  This is an integer from the table below that
  54.           represents which color your BBS name should be in the ANSI
  55.           bulletins.  If you are not making any ANSI bulletins, this line
  56.           should be left blank.
  57. Line 14 : Date and time color.  This also is an integer from the table below
  58.           which represents which color the date and time should be in the
  59.           ANSI bulletins.  Once again, if you are not making any ANSI
  60.           bulletins, this line should be left blank.
  61. Line 15 : Headings color.  This integer represents which color the heading
  62.           for each list should be in.  The headings are "Top Downloaders",
  63.           "Top Uploaders", "Top Message Posters", and the ratio statements.
  64.           Leave this line blank if you are not making any ANSI bulletins.
  65. Line 16 : Number 1 color.  This integer represents the color which the top
  66.           person in each list should be.  This allows you be highlight who
  67.           is at the top of each list.  This line should be left blank if
  68.           no ANSI bulletins are made.
  69. Line 17 : Rest of list color.  This integer represents the color the rest
  70.           of each list should be.  This should also be left blank if no
  71.           ANSI bulletins are made.
  72. Line 18 : Pause color.  This integer represents which color the pause line
  73.           will be in.  This line should be left blank if no ANSI bulletins
  74.           are made, or if pause lines are not used.
  75.  
  76.  
  77.  
  78.                               Table of Colors
  79.                               ===============
  80.  
  81.                                30 - Black
  82.                                31 - Red
  83.                                32 - Green
  84.                                33 - Yellow
  85.                                34 - Blue
  86.                                35 - Magenta
  87.                                36 - Cyan
  88.                                37 - White
  89.  
  90.  
  91.  
  92. I want to thank Lou Ley for doing a great job on beta testing this program,
  93. and Thomas Baker for bringing QuickBBS to the Orlando area in the first place.
  94. QuickBBS is written and copyrighted by Adam Hudson.
  95.  
  96. If you need further help or have suggestions, you can reach me at Glenn's
  97. Point (407-859-9648, FidoNet Address 1:18/503, 4pm to midnight).  I'm the
  98. sysop there and will be able to answer very quickly.
  99.  
  100. Any donations, comments, or requests will be accepted.  Please send them to:
  101.  
  102. Glenn Martin
  103. 3235 Lake Anderson Avenue
  104. Orlando, Florida 32812
  105.  
  106.  
  107. In any case, I'd appreciate it if you would complete the enclosed form and
  108. send it to me.  I'm curious and would like to know where my program goes.
  109. Thank you and I hope you find the program useful.
  110.  
  111.  
  112. Glenn Martin
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119. Revision History
  120. ================
  121.  
  122. Version 1.02       A bug was found concerning the conversion of the midnight
  123.                    hour.  This would cause a 'PM' to be attached to the time
  124.                    rather than an 'AM'.
  125.