tgdoors 1.01 documentation.  door statistics bulletin generator. by ron dean
released to the public as freeware.

i've been meaning to write this program since tim announced he was working on
tg 3.00.  I just got caught up in other utilities for tg. at the time.

anyway here it is, in all it's glory.


installing:

first create a file called "TGDOORS.LST" (see the example in this archive)
then type TGDOORS <outputpathfile>

TGDOORS.LST should follow the format like this:

the name of the command or batch file that starts the door, and the door name
of description, followed one after the other "NO BLANK LINES!" and end the
file directly after the last entry.

BRE.BAT * Barren Realms
FOOBAR.BAT * Food Fight
DOORS.BAT FHX * Falcon's Honor

----------
OPTIONALLY -- you can use the included utility "GOTGD.EXE" to scan all your
existing menu files and it will automatically create your door entries in the
tgdoors.lst for you.  you must execute this program from your main tg dir with
config.tg.  remember, after GOTGD runs you will need to edit and clean up the
tgdoors.lst file that it created, all it does is scan for the door commands in
the menu files, then takes the long description and door execution command
and place it in a raw format in the tgdoors.lst file for you to edit and
clean up. this utility is good if you have doors scattered out all though your
menus, too many of them to remember exact commands etc.
----------


the program and must be placed in the main telegard directory along with 
CONFIG.TG ...

the first time you run the file it will create/initialize all of it's data
files and forever after do it's on maintenance.

TGDOORS.LST must stay in the same directory as TGDOORS.EXE, which is in with
Telegard's CONFIG.TG


it reads the "SYSOP.LOG" to get the one day totals and keeps track of the
over all totals with a data file created the first run, along with the DMF
date maintenance file.

it can be run 4,000,000 times a day if you want.  I run mine once a day right
before midnight.  it will only update the overall totals once a day to keep
the usage and minutes accurate.


adding and deleteing doors, just make the changes to your TGDOORS.LST file, the
program is smart, it will account for the update and changed entries in your
list file.


syntax is "TGDOORS outputfile"
          "TGDOORS C:\BBS\TEXT\BULLET4.MSG"

files:
            TGDOORS.LST   you make it (or you can use GOTGD.EXE to do it)
            TGDOORS.DAX   the maintenance index file
            TGDOORS.DMF   maintenance date time file

Ron,

you con contact me at fido 3811/350 (netmail/email)

oh ya, this program will take up space on your disk, and that is the only
thing i guarenty.
