		Ŀ
                       TDD v1.00                 
                   The Display Door              
               (C) CalypsoWare/PCCS, 1994        
		



Ŀ
  About TDD    


    The Display Door v1.00

    Thank you for trying The Dispaly Door (TDD).  This program is one many
useful doors available from CalypsoWare(tm).

    TDD takes a simple ASCII text file and displays the information in ASCII
ANSI and RIP graphic formats.  The file may be of any length, with a maximum
of 66 characters per line.  The sysop can define if the user is allowed to
read the whole document before exiting or allowing users the choice of
continuing to read the document after each screen.

    TDD supports ASCII, ANSI, and RIP (Remote Image Protocal) graphics.
TDD is fully interrupt driven and supports Fossils, DigiBoard COM/Xi
boards as well as normal and non-standard com ports.  The FIFO buffers
of the 16550 UART chip are fully supported, enabling locked baud rates
of up to 115,200 baud.  TDD will monitor the carrier state and recycle
if caller drops carrier.  Other features include Sysop Chat, Sysop shell
to DOS, "Twit" key, DESQView aware, and multi-user capable.

   For more information about other products from CalypsoWare, please
call our support BBS at (714) 366-1355 or telnet to calypso.com. Voice
support is also available at (714) 366-1350.


Ŀ
  About Shareware   


        Shareware is a method of software distribution designed to benefit
both the software developer and the end user.  Shareware (SW) should not
be confused with Public Domain (PD) programs.  While  PD programs are
released to the public with no restrictions attached to their use, SW
programs are the copyrighted work of their authors.  The SW programs are
released to the public for evaluation purposes under the assumption that
if the end user likes the program and continues to use it after a
reasonable period of time, that user is obligated to register the
program.
        If you purchased this program from a SW distributor, you have
not registered it.  You must still pay the programmer to register it.
The money you paid to the distributor was to cover the cost of
duplicating/advertising/etc the files.
        Programmers get to distribute their wares without the expense
of advertising, packaging & distribution.  The users benefit from being
able to try out the programs without having to pay for the privilege of
evaluation.  Shareware programmers (the good ones anyway) are generally
more responsive to bug reports & user requests for additional features.
Everyone benefits provided that the users remember to register and
programmers continue to ... well, program<G>.


    Ŀ
      Registration      
    

    Please fill out the file ORDER.FRM, copy it to your printer
and mail it along with a check for $20.00 to Calypso Online Services
at the address shown on the form.

    If you have access to a fax machine, you can fax a copy of the
ORDER.FRM file along with a copy of your check if you are paying by
check and we will arrange a direct withdrawal in the above amount.  Or
fill out the credit card information and we will charge the registration to
your Mastercard or VISA account.

    Or if you want to register painlessly, you can now register
TDD online at the CalypsoWare BBS at (714) 366-1355 with your
MasterCard, VISA or by direct withdrawal from your checking or savings
account..

    By sending in your registration fee, you will be entitled to
the following:
    1) Removal of the UNREGISTERED message when door closes
       and the delay associated with that message.  Once the door is
       registered, there will be now "Returning you to {BBS Name Here}..."
       either, so the door will be usable as a "pre-door" display as well
       as a general display door.
    2) Continued use of this program on any single or multiuser BBS
    3) Free upgrades to future versions
    4) Enhanced support from programmer
    5) The satisfaction of knowing that you are helping to make the
       shareware system alive
    6) A jump to the next Karma level


Ŀ
  Requirements      


    1) TDD will only run on a BBS system that is capable of
		creating a DOOR.SYS file when a user opens a door.
		If your BBS will not create a DOOR.SYS file, there are
		conversion programs around to create a DOOR.SYS file
		from whatever your system creates.  I strongly suggest
		that you ask your BBS software's author to support the
		DOOR.SYS standard!

    2) TDD is designed to be run on any computer that is running an
		operating system that can emulate MS-DOS v3.xx or greater.


Ŀ
  Installation      


    To install TDD, simply copy all the files included in the original
distribution disk (or archive file) into a single directory.
The only files absolutely necessary to the operation of TDD are:
    TDD.EXE                  The door executable
    a configuration file     used by TDD
    a screen file            used by TDD and defined in configuration
                             file above

    You will want to use a text editor to open TDD.CNF or create a new
.CNF file.  The Configuration format is as follows:

D:\WILDCAT
Your BBS Name Here
0
0
STANDARD
0
0
0
00000.0000000000
This is a Sample Banner
TDD.SCR
MORE

Each line will be explained below:

1)      This is the directory where TDD will find the DOOR.SYS file
	created by your BBS software when a user opens a door. If you
	wish to use environmental variables in place of a fixed directory
	name, then use the following formats:
	       %VARIABLE% or \%VAR1%\%VAR2% or \WCWORK\NODE%WCNODEID%
	where the term between % signs is a valid environmental variable.

2)      This is the name of your BBS.  This is string that your registration
    number is keyed to.

3)      This is the IRQ that should be used for the com port that you
	are using UNLESS you are using COM1 or COM2 in which case you
	will put a 0 here. A single environmental variable may be used
	here. (ex.: %wcnodeirq%)

4)      This is the Base Port Address for the com port that you are
	using UNLESS you are using COM1 or COM2 in which case you will
	put a 0 here. A single environmental variable me be used here.
	(ex.: %wcnodeaddr%) Note, address will be a hexidecimal number.

5)      This line is where you would indicate if you are running a
	STANDARD comm port or a DigiBoard. Your choices here are:
		STANDARD        DIGIBOARD       INT14/EBIOS     FOSSIL
	The STANDARD interface is the one that will normally be used. 
	If a sysop is using a DigiBoard, then either the DigiBoard or
	INT14/EBIOS interface  may be  selected. Most sysops will use the
	Int14/EBIOS interface.  All  input/output  to  the  DigiBoard  is
	performed via  Interrupt 14  calls and a Device Driver (available
	from DigiBoard) handles the interface between the program and the
	board. 
    The  DIGIBOARD interface uses Direct  Programming. TDD
	talks to the board directly without the need for a Device Driver.
	In order  to use  this interface,  a program  called RESETDIG.EXE
	must be used in the AUTOEXEC.BAT file to reset the DigiBoard once
	when the  computer is first booted. If you do not have this program
	(it is a part of the GAP Communications BBS package) then the
	Int14/EBIOS interface must be used.
	The FOSSIL interface has been tested and confirmed to work with
	BNU and X00 fossil drivers. 
	**IMPORTANT NOTE ABOUT FOSSILS*** (taken from the GAPCDR docs)
		    Note that due to the limitations of the Fossil's Interrupt 14
		interface, the highest baud rate that can be set is 38400 bps.
		It is possible to configure the Fossil Driver to lock the
		baud rate (BNU supports up to 38400 bps and X00 supports up to
		115200 bps). When the port is locked, the Fossil Drivers are
		supposed to ignore any requests for a change in port speed (we
		have not confirmed if they actually do this). However, the
		GAPCDR Communications routines will reject any baud rate higher
		than 38400 bps and will return an error if you attempt to
		initialize the port at a higher speed. The BBS software must be
		configured for a port speed no higher than 38400 bps.
	

6)      This is the DigiBoard Memory Window, or the address the board
	uses as a communications area between itself and the Host
	Computer. This line is used only if the Interface is set to
	DIGIBOARD. It can be set to 0 if the Interface is STANDARD or
	INT14/EBIOS.
	Valid entries are: C000, C800, D000, and D800

7)      This is the DigiBoard I/O Port Address. This line is used only
	if the Interface is set to DIGIBOARD and can be set to 0
	otherwise.
	Valid entries are: 100, 110, 120, 200, 220, 300 and 320

8)      This is the DigiBoard Channel Number. This line is required for
	the DIGIBOARD and INT14/EBIOS Interfaces. It is normally 1-8 for
	the DIGIBOARD Interface and 4-11 for the INT14/EBIOS Interface.
	The Channel Number is similar to a Port Number. It tells the
	program which of the DigiBoard Communications ports to use.

9)      This is where you will place your registration number you
    receive from CalypsoWare upon registering TDD.

10)     This is the banner that will show at the top of every screen
    shown to the user.

11)     This is the name of the file to display.  As mentioned above,
    this file may be of any number of lines in length, but the lines
    must be limited to 66 characters/line.  Any number beyond this will
    be truncated.  YOU will be required to do any formatting (ie;
    centering) of the text within the 66 character line length limit.

12)     This line defines which prompts TDD shows the users after each
    screen.  On the last screen (or the first if the file is less than 9
    lines long) will just offer users the option to continue on out of
    the door.  Your choices for this line are:
        FORCED      User must view the entire file and TDD will pause
                    after each screen of information is displayed.
        MORE        User is given a Yes or No option on whether they
                    want to continue or not.
        REDISPLAY   User is given the choice to continue, exit or redisplay
                    the file from the top.


Ŀ
  Operation         


   Setup
   
    To run TDD door, you will need to create a batch file that will
launch the door.  For example:
		@echo off
		d:
        cd \TDD
        TDD TDD.CNF

will work with most BBSes.  Some others require that you call the BBS
software at the end of a door batch file.   Check with your BBS
documentation.

MULTI-NODE BBS NOTE:
    TDD will run on multiple node setups, but you must either create
a seperate configuration file for each node or use environmental variables
(as described above) to define the directory where the TDD door can find
the DOOR.SYS file.


Ŀ
  Support           


    TDD is fully supported by CalypsoWare.  We can be reached in the
following manners (in the preferred order):

    1) CalypsoWare Support BBS (714) 366-1355 (select option #2 at the
       PCCS Gateway Menu)

    2) Internet: tdd.support@calypso.com

    3) Fax (714) 366-1390

    4) Voice Support (714) 366-1350


Ŀ
  Legal Disclaimer  

(small print on<g>)
	As with any program, every attempt is made by the programmer to
kill all the bugs in the software before it is release to the public.
Since this is all but impossible, it is recommended that new software
should only be run (for the first time at least) when a current backup
of your hard disk is available.  When shareware is released for public
evaluation, there is little that can be done on the programmer's end to
prevent others from infecting the program with viruses or making
unauthorized changes to the program.  AS SUCH, user agrees to hold
harmless BRETT W. MARTIN, LARRY HOOPER, MICHAEL J. GIBBS, PCCS, INC., 
CALYPSO ONLINE SERVICES, and CALYPSOWARE in regards to any personal,
physical, emotion, financial, sexual or other damage that may occur to
hardware, software or the user that may arise from the use of this program.
Use of this program is considered to be acceptance of these conditions.
	This program remains the copyrighted work of CalypsoWare.  When
you register the program, you are granted a license to use this program
on one (1) BBS system, regardless of how many nodes are active.  You may
sell your registered number to another if the following conditions are met:
	1) All copies of the software and any documentation are
		transferred to the new owner.
	2) You must discontinue use of the program following the sale.
	3) The new owner must contact CalypsoWare to update our user records.

	This program may not be sold in it's unregistered form.  It is
intended to be distributed freely.  Pay BBS systems are exempt from this
requirement provided they are not charging specifically for access to
this one program.  Shareware distributors/User Groups may charge a nominal
copying/library fee not to exceed $7.00.
(small print off<g>)


Ŀ
  Special Thanks    


	Special thanks go out to:
		My (Mike's) wife Lori , my sons Bobby and Adam for tolerating
		      my weird ways.
		Brett Martin, for seeing, and believing in the vision that
		      this concept can (and will) work!
		
        My (Brett's) wife, ... ya, ya, ya, same as Mike said.
		Mike Gibbs, for his tireless efforts in seeing this inital
              release to market.

        Larry Hooper, for the money.


Ŀ
  Appendix          



   Appendix A
   
			Ŀ
             HISTORY:  TDD 
			
Version         Date            Fixes, Changes, etc.
                 
1.00            12/15/94        First public release of the door!


   Appendix C
   
			    LEGAL NOTICES

TDD, CalypsoWare, Calypso Online Services are the trademarks of PCCS.
MS-DOS is the trademark of Microsoft.
DESQView is the trademark of QuarterDeck Office Systems.
GAP is the trademark of GAP Development.
WILDCAT! is the trademark of Mustang Software, Inc.
RIP is the trademark of Telegraphics.

