                          Telnet BBS Guide to BBSList 
                                 TBG2BBI v 1.0
                           for mystic 1.07.3 / 1.08
                               by Darryl Perry 
Software --------------------------------------------------------------------
       [ ] PCB PPe      [ ] OBV          [ ] VGA         [ ] OTHER___________
       [ ] Renegade     [ ] Iiniquity    [ ] ASCII       [ ] HTML/CGI/WWW    
       [x] Mystic       [ ] WWVI         [ ] Telegard    [x] MPL
       [ ] ANSI         [ ] TEXT
OS --------------------------------------------------------------------------
              [x] dos  [ ] os/2  [x] windows [x] Win32 [x] *nix
Type ------------------------------------------------------------------------
                infoform [ ]   utility [X]  misc [ ]  door [ ]
Disclaimer-------------------------------------------------------------------

   The author has taken every precaution to insure that no harm or damage
will occur on computer systems operating this util.  Never the less, the
author will NOT be held liable for whatever may happen on your computer
system or to any computer systems which connects to your own as a result of
operating this util.  The user assumes full responsibility for the correct
operation of this software package, whether harm or damage results from
software error, hardware malfunction, or operator error.  NO warranties are
offered, expressly stated or implied, including without limitation or
restriction any warranties of operation for a particular purpose and/or
merchant ability.  If you do not agree with this then do NOT use this
program.

Description------------------------------------------------------------------

TBG2BBI is a utility that will read and parse the full Telnet BBS Guide 
listing, and import it into a Mystic BBS 1.0x BBS List.  This allows the
Telnet BBS Guide entries to be searched via keywords, just like any bbs list
from a Mystic BBS.

If you don't know what The Telnet BBS Guide is, read the Props section at the
end of this document.

Intallation------------------------------------------------------------------

Place the tbg2bbi.mps in your SCRIPTS directory and then compile it with mplc.

Add the game to your desired menu.  This is a utility that your users have 
no need to access, so you will want to give it Sysop permissions.  

The Mystic menu type is GX for running a script.  The data field should have
two entries.  The script name <tbg2bbi> and the bbs list file name to use.

As an example, we will call our bbslist file name 'tbguide'.

Type: GX
Data: tbg2bbi tbguide

And you will need a menu entry to view the BBS list when it is completed.

Type: BL and/or BS
Data: tbguide

Usage-----------------------------------------------------------------------

!!!WARNING!!!
TBB2BBI will first attempt to delete the BBI file before parsing and
recreating it.  This is done so that there will be no duplicate entries from
when the latest list is added from month to month.  If you use the same
filename as your default 'bbslist' that comes out of the box with Mystic,
then you will lose all the existing BBSes in the list.  It is strongly 
suggested that you create a separate bbs list for the Telnet BBS Guide.

!!!You have been warned!!!

When the script is run, it will prompt you for the full path and filename of
the full Telnet BBS Guide List.  That's the one that is in the file format of
telfmmyy.txt.  The short list (telqmmyy.txt) will not work for this script.

Once you enter the full path and filename of the list file, it will show the
list of BBSes.  When that's done, your BBS list is ready for use.

This script can be run as many times as you wish, as it will delete the current
BBI file and recreate it each time it is run.  However, this utility only needs
to be run once for each new issue of the Telnet BBS Guide.

Limitations-----------------------------------------------------------------

TBG2BBI only imports the telnet address, the sysops' email address, the 
location of the BBS.  If there is a phone number in phone field, it will 
import that as well, and set the proper flag in the BBS list.  The other
user added text is not imported because there is no place to hold it in the
Mystic BBS listings.

Bug Fixes/History-----------------------------------------------------------

Version 1.0 is the first release.  Release through the new Warlock Modding
Group

Bug Reports-----------------------------------------------------------------

If you want to send me bug report or a note telling me how much you like it,
please feel free to do so.

Cyberia BBS web page (http://cyberia.darktech.org)
Email me at dperry.geo@yahoo.com
Telnet to telnet://cyberia.darktech.org

Props-----------------------------------------------------------------------
The BBS Corner TELNET BBS GUIDE is Copyright by The BBS Corner & Diamond Mine 
Online, Fredericksburg, VA USA.

To find out more, visit them at:
Web: http://www.dmine.com/telnet
Telnet: bbs.dmine.net
E-mail: telnetbbs@dmine.com
