
                                KLINGON TRIVIA

                                SYSOP's MANUAL

                                     v2.0

                               October 25, 1993
                           PCBoard 14.x and GAP 4.x
                              WILDCAT!, SPITFIRE
                                QBBS, RBBS, RA

                                      by

                              Robert J. Ferguson
                            Klingon SoftWare Labs
                           3421 N. Palethorp Street
                         Philadelphia, PA 19140-4625

                       (215) 426-6730 -> Voice Support

                            Klingon SoftWare Labs
                               FIDO: 1:273/935

                    (215) 426-5596 -> USRobotics 14.4/HST

                              -=-=-=-=-=-=-=-=-

                    Ŀ
                    -=- MAJOR CREDIT CARDS ACCEPTED! -=-
                   ۳Visa - MasterCard - American Express
                   ۳           >>>Door# 6<<<            
                   
                   
                              -=-=-=-=-=-=-=-=-


                                  ͻ
                                 ۺOVERVIEW
                                 ͼ
                                 

  CONGRATULATIONS! You and your users will find this Trivia door entertaining
and educational. It consists of approximately 200+ questions that were
carefully selected for your entertainment. The door displays a "Trivia
Royalty" bulletin to the caller while it creates bulletins and logs for your
use. Best of all..this door is not CrippleWare. It isn't full of
advertisements and limitations...best of all I don't charge an arm and a leg.
You'll also find we are responsive to your questions. If you need help or
have a suggestion for improving this product, let me know!

  Please be advised that many of the trivia questions were designed to be
complicated ones. Our Klingon Technologies department spent many hours in
research and data collecting for the questions and correct answers. If you
are a true or dedicated tlhIngan (Klingon), you should have no problems
with atleast 60% of the trivia questions.
The next Klingon Trivia Door is right around the corner guys and gals!
Here is a brief list of the changes since the last public release (1.00.0):


                                   ͻ
                                  ۺLOCAL
                                  ͼ
                                  

  We added a dropfile (CALLINFO.BBS) along with the other files, so you may
run this trivia game in local mode (DOS prompt) to be sure that everything is
running smoothly prior to installing it onto your BBS. Don't forget to rename
your SAMPLE.CFG to KLINTRV.CFG, configure it to your liking and at the DOS
prompt type; KLINTRV KLINTRV.CFG (be sure that the CALLINFO.BBS is in the
same directory as the game).


                             ͻ
                            ۺWHAT IS SHAREWARE?
                            ͼ
                            

  ShareWare is a method of marketing software. ShareWare is not a specific
type of software, nor is it a measure of a program's quality or usefulness.
The shareware concept allows you, the end user, to evaluate software prior to
purchasing. In essence, you get to "try before you buy." After evaluating,
if you find a shareware program useful then you must pay for and register the
program in accordance with the terms in the program's documentation. If you
don't find a shareware program useful, you owe nothing. No hassles.....Enjoy!


ͻ
                      What's New in Release 2.00?                      
ͼ


       Klingon Trivia Door - Release Notes: o= New  *= Change  != Fix!



        o Orders for Klingon Trivia Door can be made via MasterCard, Visa,
          and American Express!

        o Tremendous overhaul and code cleanup in this release.

        o The first version of the Klingon Trivia Door User System could
          only read SFDOORS.DAT Klingon Trivia now has the ability to
          support the following User Files: CALLINFO.BBS, USERINFO.DAT,
          USERS, PCBOARD.SYS, DOOR.SYS, DORINFOx.DAT, TRIBBS.SYS,
          SFDOORS.DAT

        o The first version of the full screen chat module is now in place!

        o RIP graphics support!  Supports RIPSCRIP Interface and creates
          ANSI/WC3!.x/PCB/RIP bulletins.

        o Klingon Trivia has a compiler that will allow you to Edit/Add
          questions to your KTREK.DAT file (Registered Version ONLY!).

        o ANSI/RIP toggle mode are now both configurable items.

        o The Klingon Trivia SysOp manual (SYSOP.MAN) is now printer ready.

        o Add/Subtract player's time while online.

        o Enable/Disabled Page SysOp functions.

        o Shell to DOS while player is online (Drop to DOS).

        o Enable/Disable the Alarm.

        o Dump a rude player.

        o Print player's results while online.

        o SysOp can control the player's Questionaire Timer.



                           ͻ
                          ۺFILES AND DESCRIPTIONS
                          ͼ
                          

                  The archive includes the following files:

     README.DOC    -- Special Doc file for Registered SysOp's
     CALLINFO.BBS  -- Sample dropfile
     DESC.SDI      -- Program description
     FILE_ID.DIZ   -- Program description (for BBS)
     INSTALL.BAT   -- Installation program
     UPGRADE.TXT   -- How to upgrade to next version
     ERROR.QB      -- QuickBasic Error Codes
     KLINTRV.EXE   -- The main executable file
     SAMPLE.CFG    -- The sample configuration file
     KTREK.DAT     -- The main trivia data file
     KLINTRV.HST   -- Release History and changes
     SAMPLE.LOG    -- A sample of the log file produced
     SCREENS.ZIP   -- Screens for the KLINTRV\SCREENS sub directory
     SYSOP.MAN     -- The installation instructions...(this file)
     QUICKUP.TXT   -- Quick and Dirty installation instructions.
     REGISTER.ME   -- Information and registration form...This will
                      give you a personalized door, voice or bbs
                      support services, new issues of KTREK.DAT
                      files, a clear conscience and a still poor but
                      happy door programmer. Utility Generator to add
                      or delete your own trivia questions.
     DOOR.BAT      -- Sample door batch file
     RUNLOCAL.BAT  -- Run door in local mode to test


  This ZIP file was created using the -AV function of PKZIP. If my AV is
missing then this file may not be complete or has been tampered with.
Complete and current editions of this program are always available for D/L
on Klingon SoftWare Labs. If the AV is missing please complain to your SysOp
to stop the practice of removing AV's as this is your assurance from the
programmer that the file is complete and virus free.


                                ͻ
                               ۺINSTALLATION
                               ͼ
                               

  Installation is quite simple and straight-forward. Follow these steps and
examples and you should be up and running in a matter of minutes. Although
KLINTRV is an easy program to install on most any BBS, there may be some
SysOp's who has trouble. Support is available in those situations.


      1)  Create a directory to hold all KLINTRV files

      2)  Unzip KLINTRVX.ZIP into the above directory

      3)  Run INSTALL.BAT  <-Important

      4)  Create a configuration file, with a name of your choice
          or modify the SAMPLE.CFG file which is enclosed.

      5)  Create a door batch file or use the sample enclosed.

      6)  Modify your particular BBS System Menus to add the
          door.  The BBS setup varies depending on the type BBS
          SoftWare you are running.  We assumed you are familiar
          with the general DOOR setup on your system.  Therefore our
          description includes only examples of the KLINTRV specific
          configuration file and door batch file.  Refer to your BBS
          documentation for door installation on your particular SoftWare.


                               ͻ
                              ۺBBS USER FILES
                              ͼ
                              

     The BBS user file provides information to KLINTRV!!, such as COM
     port, user name, time allowed in the door, etc.  This file is
     necessary for KLINTRV to function.  The complete path\filename of
     the BBS user file must be passed to KLINTRV.EXE as the 1st parameter
     in the command line.  The user file is created by your BBS EACH time
     a user runs a door....The BBS USER file has a different name on each
     type of BBS.  When you create your KLINTRV configuration file, you
     must tell KLINTRV the name for your particular BBS system.

            The following is a list of the user files used by the
            BBS types we support (we included a typical path):

drive\dir\filename
   C:\WILDCAT\CALLINFO.BBS              Ŀ  <- For Wildcat!
   C:\WC30\WCWORK\NODE1\USERINFO.DAT        <- For Wildcat! 3.x
   C:\PCB\PCBOARD.SYS                       <- For PCBoard using PCBOARD.SYS
                                               only
   C:\PCB\USERS                             <- For PCBoard using USERS only
   C:\BBS\DOOR.SYS                          <- For Systems which support
                                               DOOR.SYS
   C:\BBS\DORINFOx.DEF                      <- For QBBS/RBB/RA.  Replace x
                                               with Node#.
   C:\BBS\TRIBBS.SYS                        <- fOR TriBBS
   C:\BBS\SFDOORS.DAT                     <- For Spitfire

                             ͻ
                            ۺCONFIGURATION FILE
                            ͼ
                            

  One (and only ONE) of the above will be LINE 1 of your configuration file.
You MUST specify the path and name (including any extension) correctly if
you expect KLINTRV to find it. Sample for Lines 2 through 10 are:

   Klingon SoftWare Labs <Ŀ   <- Your BBS Name
   Robert                      <- SysOp's First Name
   Ferguson                    <- SysOp's Last Name
   00000                       <- Registration Number
   100                         <- Minimum security level allowed
                                  in door.
   35                          <- Maximum questions allowed per visit
                                  to the door.
   C:\WC\BULL\BULL1.SCR        <- Path and Name of Color Bulletin
   C:\WC\BULL\BULL1.BBS        <- Path and Name of ASCii Bulletin
   WC                          <- WC Create WC!3.x specific bulls
                                  PCB Create PCBoard specific bulls
                                  Blank for ANSI & ASCii
   2                           <- Number of times allowed to play door
                                  each day.
   RIP                         <- "RIP" create RIP bulletins
                                  "N" do not create RIP bulls
                            
   15 <   <- Number of seconds to allow the user
                                   to answer each question.  The door
                                   will accept a timeout as an incorrect
                                   answer.  The door defaults to 10
                                   seconds.

          Edit the Sample.CFG file to suit your individual BBS.  You
          MUST have all 13 lines and no extra characters.

   Line 1:  This line points to where KLINTRV.EXE will find the callers
            information file.  Just include the line that your
            particular BBS uses.  DO NOT put all of them in the CFG
            file.

   Line 2:  Place the name of your BBS on this line.

   Line 3:  SysOp's first name goes here.

   Line 4:  SysOp's last name goes here.

   Line 5:  Your Registration Number goes here if registered.  If
            you haven't registered you can still use the
            door...just enter 00000 until you get your registration
            number.

   Line 6:  The minimum security level that is allowed in the door.

   Line 7:  Maximum number of questions allowed per visit to the door.
            I would suggest 25-30 as a reasonable number.  The smaller
            this number, the more likely that the users will continue to
            use the door.

   Line 8:  Enter the complete path and name of the ANSI bulletin
            that you want KLINTRV to create.

   Line 9:  Enter the complete path and name of the ASCii bulletin
            that  you want KLINTRV to create.

   Line 10: "WC" to create WC!3.x specific bulletins or NO for ANSI and
            ASCii bulletins. "PCB" on this line will enable the program
            to create PCBoard specific color bulletins.  If you Config
            for WC! or PCB bulletins, Place the name of the bulletin
            on Line 8 of the CFG file.  Be sure to add the ".BBS"
            extension to it.  You may leave Line 9 blank but it still
            MUST be included in the CFG file.

   Line 11: Number of times users are allowed to enter the door each
            day.

   Line 12: Place "RIP" on this line if you wish to create RIP styple
            bulletins.  If you do not support or need them, place an
            "N" on this line.

   Line 13: Place the number of seconds that you wish to allow to
            answer each question.


  If you use the sample CFG file be sure to remove all remarks and use a
pure ASCII editor such as EDLIN or QEDIT. Word processors typically leave
hidden control codes. Those hidden codes could cause the program to depart
to worlds unknown. Save your newly edited file using any name you
want....suggested KLINTRV1.CFG.

DONOR.CL  Registered Users may create a file named DONOR.CL and place it
          in the door directory.  If found, the door will display a
          prompt thanking them for donating the door.

                              ͻ
                             ۺDOOR BATCH FILE
                             ͼ
                             

  Create a batch file or modify the sample KLINTRV.BAT file supplied. This
is what you need:

  @ECHO OFF
  CLS                     Keeps a clean screen (optional)
  CD \DOORS\KLINTRV       Change to the KLINTRV door files directory
  KLINTRV KLINTRV1.CFG    Run KLINTRV using KLINTRV1.CFG configuration
                          Change back to the WCAT BBS directory
                          Restart the BBS.  On BBSs which shell to
                          dos to run the door this line may be
                          omitted or maybe the word "EXIT."  Check
                          your BBS door instructions.

  The above DOOR.BAT file is for a Wildcat! 3.x system using SWAP instead
of TERMINATE for doors.

                               ͻ
                              ۺMULTIPLE NODES
                              ͼ
                              

  Create a configuration file for each node. Each file should have a unique
name.

        EX: KLINTRV1.CFG  KLINTRV2.CFG

  KLINTRV has been tested under LiveCat! and DESQVIEW and performs very well
under either or both.

                               ͻ
                              ۺCOMM PORT IRQ's
                              ͼ
                              

  KLINTRV is written using DoorFrame. DoorFrame supports COM 1-4 on the
standard IRQ's - COM1 or COM3 as a standard uses IRQ4 while  COM2 and COM4
use IRQ3. If your system uses a non-standard IRQ, add the IRQ  number after
the configuration filename. Let's assume your Door is called FOOBAR and you
want to use COM1 but non-standard IRQ5. The command line  passed to your Door
would be:

                             FOOBAR FOOBAR.CFG /5
                             FOOBAR FOOBAR.CFG *5

  The /5 tells DoorFrame to use IRQ5 rather than the standard IRQ4 normally
used with COM1. No /x parameter is needed for the standard IRQ's.

                           ͻ
                          ۺFossil Driver Support
                          ͼ
                          


  KlinTrv supports the use of Fossil drivers.  To tell your Door to use the
Fossil driver instead of the standard COM ports, just put /FD on the command
line when running the door. For example:

                            MYDOOR MYDOOR.CFG /FD
                            MYDOOR MYDOOR.CFG *FD

  indicates that a Fossil driver is present and should be used. If no Fossil
driver is detected, KlinTrv will print a message to that effect and exit
the door gracefully.

                               ͻ
                              ۺTIPS AND TRAPS
                              ͼ
                              

  Be sure to read all the READ.ME, README.1ST AND UPGRADE.DOC files if they
are included in the package. They sometimes contain some very useful
information. Of course you can do like me, just set the darn thing up
without the docs then fuss at the door author for not making it simple
enough to work the first time.

  IF You get an error...check every path to make sure you typed it correctly.
Check the file name...does it match exactly? Does the configuration filename
match? Did you leave off the configuration file extension? Do you have the
correct BRUN module in a directory on your path? If all those seem correct
and the door still won't work...call me......preferably not in the middle
of the night...no door is that important.

  When the door is in use...you can use the SysOp options listed at the
bottom of your screen to chat, increase or decrease the user's time or log
the user off.

                            ͻ
                           ۺMISCELLANEOUS NOTES
                           ͼ
                           

  DoorFrame requires DOS 3.x and up since all files are opened in SHARED
  mode.

  When using PCBOARD.SYS, KLINTRV requires that PCBOARD.DAT be in the same
  directory as PCBOARD.SYS. KLINTRV also accesses the USERS file.

  When using USERS.SYS, KLINTRV also accesses PCBOARD.SYS, PCBOARD.DAT and
  the USERS file.

  The DOOR.SYS used by KLINTRV is the standard 52 line GAP (tm) file.

  The CALLINFO.BBS used by KLINTRV currently contains 36 lines.

  DoorFrame doors may now make use of the IRQ environment variable. For
example, instead of DOOR DOOR.CFG /5 you can use DOOR DOOR.CFG /%IRQ%.
(I use this method here on Klingon SoftWare Labs BBS for WC! and it works
just fine. Use "/%WCIRQID%".)

  DoorFrame is now aware of the PCBoard environment variables %PCBDRIVE% and
%PCBDIR%. If it finds those two variables on the first line of the .CFG
file it will substitute the correct drive and path.

                                 ͻ
                                ۺLEGALITIES
                                ͼ
                                

  THIS SOFTWARE AND ACCOMPANYING MATERIALS ARE DISTRIBUTED "AS IS"  WITHOUT
WARRANTY, EXPRESS, IMPLIED OR STATUTORY, INCLUDING BUT NOT LIMITED TO ANY
IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS  FOR A PARTICULAR PURPOSE.
IN NO EVENT SHALL ANYONE INVOLVED WITH THE CREATION AND PRODUCTION OF THIS
PRODUCT BE LIABLE FOR INDIRECT, SPECIAL, OR CONSEQUENTIAL DAMAGES, ARISING
OUT OF ANY USE THEREOF OR BREACH OF ANY WARRANTY.

                                ͻ
                               ۺDISTRIBUTION
                               ͼ
                               

  You may make this file available for downloading from your BBS or you may
upload it to any BBS of your choice, provided that you do not make any
changes to the contents of the archive (ZIP file). The archive and its
individual contents may not be used by any service that charges any money
whatsoever, without the written permission of the author.

                                ͻ
                               ۺREGISTRATION
                               ͼ
                               

  I am not a subscriber to the "CrippleWare" concept, and this program
reflects that philosophy. This is a full-featured program, whose
functionality is not hampered in any way, whether you register it or not.
It is only $15 to register this door. Registered SysOps will receive an
added utility that will allow you to edit and/or add questions to the
database. There is a 10 second delay that is removed once the program has
been registered.

                                   ͻ
                                  ۺTHANKS
                                  ͼ
                                  

  A *VERY SPECIAL THANKS!* to Dennis Maidon of PAROLE SoftWare Technologies.
Without him, this door game would be non-existant. You're "SECOND-TO-NONE"

  This game is dedicated to my 3yr old daughter Zenobia S. Ferguson and my
5yr old daughter Anye' Y. Moore - "Daddy's Little Klingons."

  Gene Roddenberry Who made a difference in my life, Thank you for Star Trek.
batlh Daqawlu'taH - "You will be remembered with honor."

                                    Qapla'
