home *** CD-ROM | disk | FTP | other *** search
/ ftp.wwiv.com / ftp.wwiv.com.zip / ftp.wwiv.com / pub / DOOR / 1WST1.ZIP / SYSOP.DOC < prev    next >
Text File  |  1994-01-01  |  18KB  |  416 lines
  1.        ██ ██ ██ ██ ? ██ ▄█████▄           ▄█████▄ ▄█████▄ ▐██▌ ██████▄
  2.        ██ ██ ██ ██▄▄▄██ ██   ██     ?     ██▄▄▄▄  ██▄▄▄██  ██  ██   ██
  3.        ██ ██ ██ ██▀▀▀██ ██ ? ██            ▀▀▀▀██ ██▀▀▀██  ██  ██ ? ██
  4.        ▀██████▀ ██ ? ██ ▀█████▀           ▀█████▀ ██ ? ██ ▐██▌ ██████▀
  5.  
  6.  
  7.       ▄████▄   ▄████▄  ███████ ██ ? ██ ▄█████▄ ███████  ▄████▄   ▄████▄
  8.       ▀ ▄▄█▀   ▀ ▄▄█▀    ▐█▌   ██▄▄▄██ ██▄▄▄██   ▐█▌    ▀ ▄▄█▀   ▀ ▄▄█▀
  9.         ▀▀   ?   ▀▀      ▐█▌   ██▀▀▀██ ██▀▀▀██   ▐█▌      ▀▀   ?   ▀▀
  10.         ██       ██      ▐█▌   ██ ? ██ ██ ? ██   ▐█▌      ██       ██
  11.  
  12.                                  ?? TRIVIA ??
  13.  
  14.  
  15.                                 SYSOP'S MANUAL
  16.  
  17.                                     v1.0
  18.  
  19.                                January 1, 1994
  20.                            PCBoard 14.x and GAP 4.x
  21.                              WILDCAT!, SPITFIRE
  22.                                QBBS, RBBS, RA
  23.  
  24.                                      by
  25.  
  26.                                  Angi Wigle
  27.                                  WiggleWare
  28.                                 P.O. Box 897
  29.                             Gaithersburg, MD  20884-0897
  30.  
  31.                                                                         
  32.                                 C'mon Inn BBS
  33.                              
  34.                 (301) 990-7565 -> Boca 14.400 V.32bis, v.42bis
  35.  
  36.  
  37.                              -=-=-=-=-=-=-=-=-
  38.  
  39. OVERVIEW                                   Who Said That? Trivia      -2-
  40. ________
  41.  
  42.  
  43.  
  44. CONGRATULATIONS!  Your users will find this Trivia door entertaining.
  45. It consists of 100 questions that were carefully selected for your
  46. entertainment.  The door displays a "Trivia Royalty" bulletin to the caller
  47. while it creates bulletins and logs for your use.  Best of all..this door
  48. is not crippleware.  It isn't full of advertisements and limitations.
  49. If you choose to register your copy, the UNREGISTERED notice and the opening
  50. delay will be eliminated.  See REGISTER.TXT for more information on the
  51. benefits of registering.
  52.  
  53.  
  54. FILES AND DESCRIPTIONS
  55. ______________________
  56.  
  57.  
  58. The archive includes the following files:
  59.  
  60.      WHOSAID.EXE     -- The main executable file
  61.      SAMPLE.CFG      -- The sample configuration file
  62.      WHOSAID.DAT     -- The main trivia data file
  63.      WHOSAID.HIS     -- Release History
  64.      SCREENS.ZIP     -- Screens for the WHOSAID\SCREENS sub directory
  65.      SYSOP.DOC       -- The installation instructions...(this file)
  66.      QUIKUP.DOC      -- Quick installation instructions.
  67.      REGISTER.TXT    -- Information and registration form...This will
  68.                         give you a personalized door and support.
  69.      DOOR.BAT        -- Sample door batch file
  70.      DONOR.CL        -- Your door sponsor file (only displays in
  71.                         the registered version.)
  72.      ERROR.QB        -- QuickBasic error codes that DoorFrame uses
  73.                         for your troubleshooting and reference
  74.      INSTALL.BAT     -- Your installation batch file.  Use it to make
  75.                         your installation easy!
  76.      
  77.  
  78.  
  79. INSTALLATION                               Who Said That? Trivia      -3-
  80. ____________
  81.  
  82.    Installation is quite simple and straight-forward.  Follow these
  83. steps and examples and you should be up and running in a matter of
  84. minutes.  Although Who Said That Trivia is an easy program to install
  85. on most BBS's, there may be some who have trouble.  Support is available
  86. in those situations.
  87.  
  88.       1) Create a directory to hold all WHOSAID files
  89.          (I use C:\WC30\GAMES\WHOSAID on my Wildcat! board)
  90.  
  91.       2) Unzip WHOSAIDx.ZIP into the above directory
  92.  
  93.       3) Run INSTALL.BAT  <-Important as it creates the directory structure!
  94.  
  95.       4) Create a configuration file, with a name of your choice
  96.          or modify the SAMPLE.CFG file which is enclosed.
  97.  
  98.       5) Create a door batch file or use the sample enclosed.
  99.  
  100.       6) Modify your particular BBS System Menus to add the door.  The BBS
  101.          setup varies depending on the type BBS software you are running.  We
  102.          assume you are familiar with the general DOOR setup on your system.
  103.          Therefore our description includes only examples of the WHOSAID
  104.          specific configuration file and door batch file.  Refer to your
  105.          BBS documentation for door installation on your particular software.
  106.  
  107.  
  108. BBS USER FILES
  109. --------------
  110.  
  111.      The BBS user file provides information to WHOSAID, such as COM
  112.      port, user name, time allowed in the door, etc.  This file is
  113.      necessary for the game to function.  The complete path\filename of
  114.      the BBS user file must be passed to WHOSAID.EXE as the 1st
  115.      parameter in the command line.  The user file is created by
  116.      your BBS EACH time a user runs a door....The BBS USER file has
  117.      a different name on each type of BBS.  When you create your WHOSAID
  118.      configuration file, you must tell WHOSAID the name for your
  119.      particular BBS system.
  120.   
  121.      The following is a list of the user files used by the        
  122.      BBS types we support (we included a typical path).
  123.  
  124. drive\dir\filename
  125.    C:\WILDCAT\CALLINFO.BBS              ──┐  <- For Wildcat!
  126.    C:\WC30\WCWORK\NODE1\USERINFO.DAT      │  <- For Wildcat! 3.x
  127.    C:\PCB\PCBOARD.SYS                     │  <- For PCBoard using PCBOARD.SYS
  128.                                           │     only
  129.    C:\PCB\USERS                           │  <- For PCBoard using USERS only
  130.    C:\BBS\DOOR.SYS                        │  <- For Systems which support
  131.                                           │     DOOR.SYS
  132.    C:\BBS\DORINFOx.DEF                    │  <- For QBBS/RBB/RA.  Replace x
  133.                                           │     with Node#.
  134.    C:\BBS\TRIBBS.SYS                      │  <- For TriBBS
  135.    C:\BBS\SFDOORS.DAT                   ──┘  <- For Spitfire
  136.  
  137.  
  138.  
  139. CONFIGURATION FILE                         Who Said That? Trivia      -4-
  140. ------------------
  141.  
  142. One (and only ONE) of the above will be LINE 1 of your
  143. configuration file.  You MUST specify the path and name (including
  144. any extension) correctly if you expect WHOSAID to find it.  Sample for
  145. Lines 2 through 10 are:
  146.  
  147.    C'mon Inn BBS                <- Your BBS Name
  148.    Wild                         <- SysOp's First Name
  149.    Fire                         <- SysOp's Last Name
  150.    00000                        <- Registration Number
  151.    100                          <- Minimum security level allowed 
  152.                                    in door.
  153.    35                           <- Maximum questions allowed per visit
  154.                                    to the door.
  155.    C:\WC30\BULL\BULL99.SCR      <- Path and Name of Color Bulletin
  156.    C:\WC30\BULL\BULL99.BBS      <- Path and Name of ASCii Bulletin
  157.    WC                           <- WC Create WC!3.x specific bulls
  158.                                    PCB Create PCBoard specific bulls
  159.                                    Blank for ANSI & ASCii
  160.    2                            <- Number of times allowed to play door
  161.                                    each day.
  162.    RIP                          <- "RIP" create RIP bulletins
  163.                                    "N" do not create RIP bulls
  164.    15                           <- Number of seconds to allow the user
  165.                                    to answer each question.  The door
  166.                                    will accept a timeout as an incorrect
  167.                                    answer.  The door defaults to 10
  168.                                    seconds.
  169.  
  170.  
  171.  
  172. CONFIGURATION EXPLANATION                  Who Said That? Trivia      -5-
  173. -------------------------
  174. Edit the Sample.CFG file to suit your individual BBS.  You
  175. must have all 13 lines and no extra characters.
  176.  
  177.    Line 1:  This line points to where WHOSAID.EXE will find the callers
  178.             information file.  Just include the line that your
  179.             particular BBS uses.  DO NOT put all of them in the CFG
  180.             file.
  181.  
  182.    Line 2:  Place the name of your BBS on this line.
  183.  
  184.    Line 3:  SysOp's first name goes here.
  185.  
  186.    Line 4:  SysOp's last name goes here.
  187.  
  188.    Line 5:  Your Registration Number goes here if registered.  If
  189.             you haven't registered you can still use the          
  190.             door...just enter 00000 until you get your registration 
  191.             number.
  192.  
  193.    Line 6:  The minimum security level that is allowed in the door.
  194.  
  195.    Line 7:  Maximum number of questions allowed per visit to the door.
  196.             I would suggest 25-30 as a reasonable number.  The smaller
  197.             this number, the more likely that the users will continue to
  198.             use the door.
  199.  
  200.    Line 8:  Enter the complete path and name of the ANSI bulletin
  201.             that you want WHOSAID to create.
  202.  
  203.    Line 9:  Enter the complete path and name of the ASCii bulletin
  204.             that you want WHOSAID to create.
  205.  
  206.    Line 10:  "WC" to create WC!3.x specific bulletins or NO for ANSI and
  207.              ASCii bulletins. "PCB" on this line will enable the program
  208.              to create PCBoard specific color bulletins.  If you Config
  209.              for WC! or PCB bulletins, place the name of the bulletin
  210.              on Line 8 of the CFG file.  Be sure to add the ".BBS"
  211.              extension to it.  You may leave Line 9 blank but it still
  212.              MUST be included in the CFG file.
  213.  
  214.     Line 11: Number of times users are allowed to enter the door each
  215.              day.
  216.  
  217.     Line 12: Place "RIP" on this line if you wish to create RIP style
  218.              bulletins.  If you do not support or need them, place an
  219.              "N" on this line.
  220.  
  221.     Line 13: Place the number of seconds that you wish to allow to
  222.              answer each question.  (Must be 10 seconds or more.)
  223.  
  224.  
  225.  
  226. -------------------------------------------Who Said That? Trivia      -6-
  227.  
  228. If you use the sample CFG file be sure to remove all remarks and use a pure
  229. ASCII editor such as EDLIN or QEDIT.  Word processors typically leave hidden
  230. control codes that could cause the program to depart for worlds unknown.  
  231. Save your newly edited file using any name you want...suggested WHOSAID.CFG.
  232.  
  233. DONOR.CL       Registered Users may create a file named DONOR.CL and place it
  234.                in the door directory.  If found, the door will display a
  235.                prompt thanking them for donating the door.
  236.  
  237. GOODBYE.NO     Place this file in the door directory to turn the
  238.                [G]oodbye option off.
  239.  
  240. DOOR BATCH FILE
  241.  
  242.          Create a batch file or modify the sample DOOR.BAT file
  243.          supplied. This is what you need:
  244.  
  245.   @ECHO OFF
  246.   CLS                   Keeps a clean screen (optional)
  247.   CD \DOORS\WHOSAID     Change to the WHOSAID door files directory
  248.   WHOSAID WHOSAID.CFG   Run WHOSAID using WHOSAID.CFG configuration
  249.                         Change back to the WCAT BBS directory
  250.                         Restart the BBS.  On BBS's which shell to
  251.                         DOS to run the door this line may be
  252.                         omitted or maybe add the word "EXIT."  Check
  253.                         your BBS door instructions.
  254.  
  255. This DOOR.BAT file is for Wildcat! 3.x systems using SWAP instead of TERMINATE
  256. for doors.
  257.  
  258. MULTIPLE NODES
  259. --------------
  260.  
  261. Create a config file for each node.  Each file should have a unique name.
  262.  
  263.         EX: WHOSAID1.CFG  WHOSAID2.CFG
  264.  
  265. WHOSAID has been tested under LIVECAT and DESQVIEW and performs very well under
  266. either or both.
  267.  
  268. COMM PORT IRQs
  269. --------------
  270.  
  271. WHOSAID is written using DoorFrame.   DoorFrame supports COM 1-4 on the
  272. standard IRQ's - COM1 or COM3 as a standard uses IRQ4 while COM2
  273. and COM4 use IRQ3.  If your system uses a non-standard IRQ, add the
  274. IRQ number after the configuration filename.  Let's assume your
  275. Door is called WHOSAID and you want to use COM1 but non-standard
  276. IRQ5.  The command line passed to your Door would be:
  277.  
  278.         WHOSAID WHOSAID.CFG /5
  279.         WHOSAID WHOSAID.CFG *5
  280.  
  281.       The /5 tells DoorFrame to use IRQ5 rather than the standard
  282. IRQ4 normally used with COM1. No /x parameter is needed for the
  283. standard IRQ's.
  284.  
  285.  
  286. Fossil Driver Support                      Who Said That? Trivia      -7-
  287. ---------------------
  288. To tell your Door to use the Fossil driver instead of the standard COM ports,
  289. just put /FD on the command line when running the door.  For example:
  290.  
  291.      WHOSAID WHOSAID.CFG /FD
  292.      WHOSAID WHOSAID.CFG *FD
  293.  
  294. This indicates that a Fossil driver is present and should be used.  If no
  295. Fossil driver is detected, the program will print a message to that effect
  296. and exit the door gracefully.
  297.  
  298. TIPS AND TRAPS
  299. --------------
  300.  
  301.       Be sure to read all the READ.ME, README.1ST AND UPGRADE.DOC
  302. files if they are included in the package.  They sometimes contain
  303. some very useful information.
  304.  
  305. IF YOU GET AN ERROR:
  306.  
  307. 1.  Check every path to make sure you typed it correctly.
  308. 2.  Check the file name...does it match exactly?
  309. 3.  Does the configuration filename match?
  310. 4.  Did you leave off the configuration file extension?
  311.  
  312. If all those seem correct and the door still won't work...get in touch
  313. with me and I'll try to track down your problem.
  314.  
  315.       When the door is in use...you can use the sysop options
  316. listed at the bottom of your screen to chat, increase or decrease
  317. the users time or log the user off.
  318.  
  319. MISCELLANEOUS NOTES
  320. ===================
  321.  
  322. DoorFrame requires DOS 3.x and up since all files are opened in SHARED mode.
  323.  
  324. When using PCBOARD.SYS, WHOSAID requires that PCBOARD.DAT be in the same
  325. directory as PCBOARD.SYS.  WHOSAID also accesses the USERS file.
  326.  
  327. When using USERS.SYS, WHOSAID also accesses PCBOARD.SYS, PCBOARD.DAT and the
  328. USERS file.
  329.  
  330. The DOOR.SYS used by WHOSAID is the standard 52 line GAP (tm) file.
  331.  
  332. The CALLINFO.BBS used by WHOSAID currently contains 36 lines.
  333.  
  334. DoorFrame doors may now make use of the IRQ environment variable.  For
  335. example, instead of DOOR DOOR.CFG /5 you can use DOOR DOOR.CFG /%IRQ%.
  336. (I use this method here on C'mon Inn BBS for WC! and it works just
  337. fine.  Use "/%WCIRQID%".)
  338.  
  339. DoorFrame is now aware of the PCBoard environment variables %PCBDRIVE% and
  340. %PCBDIR%.  If it finds those two variables on the first line of the .CFG
  341. file it will substitute the correct drive and path.
  342.  
  343.  
  344. LEGALITIES                                 Who Said That? Trivia      -8-
  345. __________
  346.  
  347.  
  348. THIS SOFTWARE AND ACCOMPANYING MATERIALS ARE DISTRIBUTED "AS IS" WITHOUT 
  349. WARRANTY, EXPRESS, IMPLIED OR STATUTORY, INCLUDING BUT NOT LIMITED TO ANY 
  350. IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.  
  351. IN NO EVENT SHALL ANYONE INVOLVED WITH THE CREATION AND PRODUCTION OF THIS 
  352. PRODUCT BE LIABLE FOR INDIRECT, SPECIAL, OR CONSEQUENTIAL DAMAGES, ARISING 
  353. OUT OF ANY USE THEREOF OR BREACH OF ANY WARRANTY.
  354.  
  355. DISTRIBUTION
  356. ____________
  357.  
  358. You may make this file available for downloading from your BBS
  359. or you may upload it to any BBS of your choice, provided that you
  360. do not make any changes to the contents of the archive (ZIP file).
  361. The archive and its individual contents may not be used by any
  362. service that charges any money whatsoever, without the written
  363. permission of the author.
  364.  
  365. REGISTRATION
  366. ____________
  367.  
  368. This is a full-featured program whose functionality is not hampered in any
  369. way, whether you register it or not.  It is only $15 to register this door.
  370. There is a 10 second delay that is removed once the program has been 
  371. registered and you'll be able to display the donor.cl file.  See REGISTER.TXT.
  372.  
  373. THANKS
  374. ------
  375.   LOVING THANKS goes out to my husband Jeff for without his persistance,
  376.   I would have never started my own BBS. (which he now regrets! <G>)
  377.     
  378.   SUPER SPECIAL THANKS goes out to my daughter Gina for selecting most
  379.   of the questions and answers used in the door.  And for believing that
  380.   her mother could finally finish something that she started! <G>
  381.     
  382.   SPECIAL THANKS goes out to Dennis Maidon of the PAROLE BOARD BBS
  383.   in North Carolina for his expertise and assistance in making this
  384.   game possible.  (and for putting up with all of my questions) <VBG>
  385.  
  386.   SPECIAL THANKS goes out to Tom Wildoner of T&J Software BBS in
  387.   Pennsylvania for teaching me how to be a good BETA tester! <BSEG>
  388.  
  389.   THANKS TO Ted Freeman the author of DoorFrame, a first class BBS Doors
  390.   Development Library.  May Ted be remembered always in the fine programs 
  391.   he created.
  392.  
  393.  
  394.     WHO SAID THAT TRIVIA is written using MicroSoft's Visual Basic for DOS
  395.     v1.0.  VB/DOS is copyright 1992, MicroSoft Inc.
  396.  
  397.  
  398. Additional Information                     Who Said That? Trivia      -9-
  399. ==============================================================================
  400.  
  401.     If for some reason you do not wish to support RIP graphics, create a file
  402.     named "RIP.NO" and place it in the door directory.
  403.  
  404.     The game should automatically reset the scores at the beginning of each
  405.     month.
  406.  
  407.     The door will reject an answer selection that contains "N/A".  This means
  408.     that you can also include TRUE/FALSE questions in the database or even
  409.     limit the questions to three answers.  This is for registered users only.
  410.  
  411.     If a user times-out on a question, the door will accept that as an
  412.     incorrect answer.
  413.  
  414.     The game creates additional files during it's operation and after
  415.     setup.  These need to remain in your door directory.  It will also
  416.     create a .LOG file showing your door usage.