ftp.wwiv.com/ftp.wwiv.com.zip/ftp.wwiv.com/pub/BBS/TTALK10A.ZIP/TRITALK.DOC

Text File | 1995-06-20 | 10KB | 299 lines

          ┌─────┐ ┌──────┐ ┌───┐ ┌─────┐ ┌──────┐ ┌─┐    ┌─┐ ┌──┐
          └─┐ ┌─┘ │ ┌──┐ │ └┐ ┌┘ └─┐ ┌─┘ │ ┌──┐ │ │ │    │ │┌┘ ┌┘
            │ │   │ └──┘ │  │ │    │ │   │ └──┘ │ │ │    │ └┘ └─┐
            │ │   │ ┌─┐ ┌┘  │ │    │ │   │ ┌──┐ │ │ │    │ ┌──┐ │
            │ │   │ │ │ └┐ ┌┘ └┐   │ │   │ │  │ │ │ └──┐ │ │  │ │
            └─┘   └─┘ └──┘ └───┘   └─┘   └─┘  └─┘ └────┘ └─┘  └─┘



                                 Version 1.0a
                           c. 1995 by Shawn Stanley
                         [e-mail]
                                Wintermute BBS
                                [phone]

                  Documentation and beta testing/distribution
                               by David de Young
                          Cybernetic Dreams of Pi BBS
                                 TriBBS #1741
                                [phone]
                               [e-mail]



WHAT IS THIS THING?
------------------

This is a an easy to set up, but full-featured multi-nodal teleconferencing
door for TriBBS (TM) by Mark Goodwin.

        FEATURES YOUR USERS WILL ENJOY:

        -- Menu from which to page another node into talk
        -- Full action capability.  (They don't have to pick from a list.)
        -- Private sends to the node of their choice.
        -- Ability to page callers not even in the door from within talk
              with the text of their choice (Registered Version only)
        -- Status reports from the other nodes including last action.
        -- Notification of BBS logons to callers within talk.
        -- /who type listing of all callers logged into the BBS, not just the
           talk program which also reports node idle time if the caller is
           in the door.
        -- Ability for each user to save their personal settings to
              a profile file.
        -- Fossil support if it's available.
        -- Alias support.
        -- Fully customizing of color combinations node by node.

This program is "crippled" only by the fact that the ability to page
users outside of talk mode from within talk mode is not enabled until
registered, and your callers will be limited to 10 minutes at a time
in the door.  Registration will also get rid of any UNREGISTERED messages
and replace them with the board name and sysop name.

HOW DO I SET IT UP?
------------------

Note:  If you are upgrading from TALK version 1.0a or TALK version 1.0b
(The non-TriBBS specific version) you may skip to Appendix B:

TriTalk is easy to set up.  (Or, at least *I think it is.  Heh.)

Here's what you do:

Make a directory and unzip the talk archive into it.

I use c:\bbs\doors\tritalk

Modify the *.cfg files to fit your board's needs.  You will need a different
*.cfg file for each node (including local nodes) including the complete path
to the door.sys file for that node.

My talk1.cfg looks like this:

        menu
        whoson=c:\bbs\tribbs\mwork
        maxnode=3
        doorsys=c:\bbs\tribbs\door.sys
        log=log1.txt
        achilles=180
        color1=bright cyan
        color2=bright cyan
        color3=bright yellow
        system=Cybernetic Dreams of Pi
        sysop=David de Young
        key=*******************

Line by line description of *.cfg file

        enables the telechat menu before entering the door
        complete path to the mwork directory (location of whoson.*)
        number of nodes to check for during a /who
        complete path to dropfile for node [MUST BE DOOR.SYS ONLY!]
        filename for node activity log
        number of seconds between Achilles comments
        color of local text and status reports
        color of echoed and sent text
        color of privately sent text
        Your BBS's name (UNREGISTERED will display until registration)
        Your name (Needed for key file)
        Registration code (Put anything here until registered)

Customizing the colors:

The format of the color parameters in the config file is as follows:

[bright|light] foreground[/background]

The default is normal intensity with a black background.

             examples:  red, green, bright yellow/blue

You may edit the file in the talk directory called news.txt which will
display to users when they type /news.


HOW DO I ADD IT TO MY BBS MENUS?
-------------------------------


On my TriBBS system, I run this door off my main menu as a replacement for
the built in telechat feature.

MAIN&.BAT (batch file which calls the door and should be located
in the respective node's main directory) reads like this:

c:                      | change drive if necessary
cd \bbs\doors\talk      | change to directory where talk is located
talk 1 @talk1.cfg       | talk [node #] @[nodecfgfile] (the "@" is crucial!)
cd \bbs\tribbs          | change back to your bbs directory
board                   | call the bbs

To add it to your Main Menu:

Change to your node's NWORK directory.

Edit MAIN.MNU so that the telechat line reads:

        &,T,Telechat,15

When a user selects "T" from the Main Menu it will now call MAIN&.BAT and
run the door.


THIS PROGRAM IS GREAT!  HOW DO I REGISTER?
------------------------------------------

Easy.  Just send a check or money order for 15 dollars to:

        Shawn P. Stanley
        4904 Vallacher Avenue
        St. Louis Park, MN 55416

Within a day or two after receipt your key file should be ready for you.

IMPORTANT!!!

Your key file is generated from a case specific combination of your sysop
name and your board name.

You must include these with your order so a key file can be made for you.

        Sysop name as you'd like it to appear_______________________

        The name of your BBS________________________________________

You can receive it in one of the following ways:

        #1 Have it sent to your internet address attached to a message.
        #2 Pick it up attached to a message on Cybernetic Dreams of Pi
        #3 By snail mail (as a last resort.)

If you choose #1, be sure to include your complete internet address.

If you choose #2, please include the following information so an
account can be made ready for you on Cybernetic Dreams of Pi.

        Your Full Name
        Your Alias
        Your Phone Number
        Your Date of Birth
        Please choose the password you will be using!

(BE SURE TO WRITE THIS STUFF DOWN!!!!)

UPGRADES:
--------

Future versions of this program will be available for download from Cybernetic
Dreams of Pi BBS and the Lobster Buoy.  The most recent version should also be
available to ftp from ftp.winternet.com /pub/users/pi

SUPPORT:
-------

You can receive support from the author by calling Cybernetic Dreams of Pi
BBS [phone].  Address your questions or comments to Shawn P. Stanley.
He also reads the Tribbs 3rd Party Support Fidonet conference if you
frequent a local bbs that carries it.

That's all folks!


---------------------
Spam is good for you!
---------------------

APPENDIX A:  Achilles daemon (5/17/95)
----------


The following new feature was added just before release:

The optional "achilles daemon" can be invoked by adding the following
lines to your talk#.cfg files:

achilles=[# of seconds between comments]
color4=[color of achilles comments]

ex:  achilles=180
ex:  color4=magenta

The net result is that "achilles" will _always_ be on imaginary node 23 and
will randomly display the one liners from the file achilles.txt (example
texfile enclosed).


APPENDIX B:  Upgrading from TALK 1.0a TALK 1.0b (6/13/95)
----------

To upgrade from the non-TriBBS specific version of TALK 1.0a or 1.0b
simply copy TRITALK.EXE into your old talk directory, delete the old
LOCKFILE.DAT, and make the following changes to *each of your config
files:

Add the following lines:

menu
whoson=[complete path to your TriBBS MWORK directory]
maxnode=[number of nodes to check for in a "whoson"]

Of course, you must also change your batch files to run TRITALK.EXE
instead of TALK.EXE.


APPENDIX C:  Node Connect Notification (6/13/95)
-----------

Optionally, with the addition of talkmsg.exe (included), you can set up
your TriBBS board to notify callers already in talk when a new caller
connects to the BBS.

Enclosed are sample LOGON.BAT and FASTLOG.BAT files which run TALKMSG.EXE.
Simply edit them to fit your board's needs and place them (with the proper
path's specified -- See your TriBBS manual for more information on LOGON.BAT
and FASTLOG.BAT) in each node's directory.

The usage syntax is:

TALKMSG [complete path to door.sys] CONNECT @N @A

You can substitute any text you like for the CONNECT phrase.

@N passes the node #, @A passes the callers alias or user name.

Note:  You can get fancy with this and put text in between the variables
and basically make this say whatever you like when a caller logs in.

Simply, what happens, is TALKMSG reads the caller's info from DOOR.SYS
as he or she logs on, passes the node number and the alias of the
caller (or real name if the alias is unavailable) to a file which will
be displayed to callers in the TriTalk door.

I.e.  TNSLB logs in on node 5.  Callers in talk will see:

CONNECT 5 TNSLB

APPENDIX D: Non-standard IRQ's  (6/20/95)
----------

Added in version 1.0a is support for non-standard IRQ's.

To use them add the following two lines to your config file:

        IRQ=[IRQ]
        ADDRESS=[Port Address in hex, ex: 3F8]

Note:  These settings will not work with ports handled by a fossil driver
as the fossil driver retains control over which address and IRQ are used
by a port.

Also, please note, the test site runs under a fossil driver and uses only
standard IRQ settings so this additional feature has not been tested as
thoroughly as we would like.

Please report any problems/suggestions to the author as soon as possible.