                                _.
   ______ _______:________ ____/ |______ ________ ________    ______ ._______.
 ._\____ V ______:\   ___/_\____   ____/_\______/_\   ___/____\___  \|       |
 |      \_/     ¬|    \/       /   |/      |     |    \/       /_¬\  \_      |
 |_______|       |___         /____        |_____|___         /_\/_\_________|
<----aC!-:       |--¯\_______/---¯\________|--------¯\_______/ \/\/ :-TRE!---->

                                 presents

                            BB-TopUl v0.6 beta

                       code: BiLBo BaGGins/M!^RNX
                     design: Shapechanger/DeZIGN
                       date: 04-04-95


You now have the Betatester-Archive of the newest BB-TopUl version. There
can be some bugs. If you find some, try to contact and tell me exactly where
the bugs happend. Thanks.




Information:
============
BB-TopUl shows the global TopUploader of all conferences.
The aim was to make it fast and use only a view amount of memory. Speed
depends very much on the speed of your harddrive, so it`s very good if you
run a cache program like DynamiCache. The use of memory is very little. That
is very important if you run a BBS with hundreds of users. If you have 500
users and want the Top 10 Uploaders, you only need 7100 Bytes for the datas
of the user. And that`s only needed during displaying/writing it. During
sorting, it only needs 4000 Bytes.
You can use the program as a door or a util. It detects if you run it as a
door from Tempest or from a Shell. If you run it as a util, it has some
neat features that help you running it in the Text-Welcome file(s) together
with other Bulletins. You can configure if you want screenclears, nonstop
showing, pause a the end or want to have appended it to the exisiting
Text-Welcome file(s) (no more need of joining).
Everything is done with a Config-File. So it`s easy to handle.




Installation:
=============
Copy BB-TopUl(.cfg) to Doors: or where you want.


Use as a door:
--------------

Edit the Text-Welcome files(s):
--------------------------> cut here <--------------------------
~TD(Doors:BB-TopUl)
--------------------------> cut here <--------------------------

Edit the Bulletins.opt file:
--------------------------> cut here <--------------------------
[20-,*,*,*,*] =3   |T-DOOR|Tempest:Doors/BB-TopUl
--------------------------> cut here <--------------------------


Use as a util:
--------------

Edit the Logoff-x.bat files(s):
--------------------------> cut here <--------------------------
Doors:BB-TopUl
--------------------------> cut here <--------------------------

Edit the Bulletins.opt file:
--------------------------> cut here <--------------------------
[20-,*,*,*,*] =3   |PRINT|Tempest:Bulletins/TopUploader.txt
--------------------------> cut here <--------------------------


Edit the BB-TopUl.cfg file:
---------------------------

Example with defaults:
--------------------------> cut here <--------------------------
10                                  // Number of entries to be displayed
1                                   // Output (1 <= output >= 2 )
1                                   // Design (1 <= design >= 3 )
0                                   // Screenclear at start (0=Yes, 1=No)
0                                   // Pause at end (0=Yes, 1=No)
0                                   // Show nonstop (0=Yes, 1=No) (only Util)
0                                   // File 0=New 1=Append        (only Util)
Tempest:Accounts.data               // Name of the Accounts.data  (only Util)
T:Text.txt                          // Name of the outputfile     (only Util)
--------------------------> cut here <--------------------------

1.line: The number of users you want to have displayed
2.line: The output you want to have.
        1 for displaying it in 1 row
        2 for displaying it in 2 rows
3.line: The Design you want to have.
        0 for a random design
        1 for a design by my own (looks like the Boss utils on /X)
        2 for a design by my own (looks like the Pot-Noodle utils on /X)
        3 for a design by Shapechanger/dEZIGN
        4 will come soon as a design by Treach!/ArtCore
4.line: If you want a screenclear before displaying
        0 for Yes
        1 for No
5.line: If you want to have a Pause-Prompt after displaying
        0 for Yes
        1 for No
6.line: If you want to have it shown nonstop                      (ONLY UTIL)
        0 for Yes
        1 for No
        That is very important if you join some Bulletins to one. As the
        Nonstop command is a Toggle, you would turn it on/off everytime.
7.line: If you want to append it to an existing file              (ONLY UTIL)
        0 for creating a new file
        1 for appending it to an existing file.
        With that you can join it to an existing file. For example you first
        create a Lastcaller Bulletin as Text-Welcome, you can than easy
        append the TopUploaders to it.
8.line: Path and Name of the Accounts.data                        (ONLY UTIL)
9.line: Path and Name of the outputfile                           (ONLY UTIL)


Add a Banner in front:
----------------------
Just put it in the same dir as BB-TopUl and name it BB-TopUl.banner.




Try to contact me for whatever on:
==================================
Germany:     Deep Space Nine, Sado City or Metal Decade
USA:         Dawn of Eternity
Sweden:      Interchange
Switzerland: Dial Hard


Changes:
========
04-04-95: - some optimizing
04-03-95: - fixed displayroutine for showing banners
04-02-95: - config-file scurity checks added
          - some routines optimized
          - fixed lines for Userlength showing in Design 2
30-03-95: - bug in design fixed.
          - some optimizing.
          - made option to add Banner in front.
          - some minor bugs fixed
28-03-95  First release of v0.6 beta.
          - some optimzing
          - 3 choiceable designs.
          - new configfile.
          - door/util in one program.
          - configurable features like screenclear, pause prompt, nonstop
