home *** CD-ROM | disk | FTP | other *** search
/ ftp.wwiv.com / ftp.wwiv.com.zip / ftp.wwiv.com / pub / DOOR / ADOPT50.ZIP / ADOPT.DOC < prev    next >
Text File  |  1993-12-12  |  11KB  |  255 lines
  1.  
  2.                             Adopt - A - Door
  3.  
  4.                                   v5.0
  5.  
  6.                            December 12, 1993
  7.  
  8.                         PCBoard 14.x and GAP 4.x
  9.                            WILDCAT!, Spitfire
  10.                              QBBS, RBBS, RA
  11.  
  12.                                    by
  13.  
  14.                              Dennis Maidon
  15.  
  16.                           PAROLE TECHNOLOGIES
  17.                           9411 Buffalo Rd
  18.                           Clayton, NC  27520
  19.  
  20.                           (919) 965-3600 -> Voice
  21.  
  22.                           The Parole Board BBS
  23.                             FIDO: 1:151/185
  24.  
  25.               (919) 965-4696 -> US Robotics Dual Standard
  26.               (919) 965-9885 -> US Robotics Dual Standard
  27.  
  28.                             Free Advice BBS
  29.  
  30.               (919) 934-1002  -> US Robotics Dual Standard
  31.  
  32.  
  33.  
  34.                                 OVERVIEW
  35.                                 ________
  36.  
  37.     Adopt-A-Door runs just before you regular door program and displays
  38.     the name(s) of your users that have donated funds to purchase a door
  39.     program for your BBS.  What better way to solicit funds that to
  40.     advertise the name of a very generous user.
  41.  
  42.                                  FILES
  43.                                ---------
  44.         ADOPT.EXE       <- The EXEcutable file
  45.         ADOPT.CFG       <- Sample of the CFG file for ADOPT
  46.         ADOPT.DOC       <- This file you are reading now.
  47.         DOOR.BAT        <- Sample of Batch file to run ADOPT
  48.         PAROLE.COM      <- I need to advertise just a bit.
  49.         READ.ME         <- Last minute thoughts and ideas
  50.         ADCNF.EXE       <- Create the ADOPT.CNF file
  51.  
  52.         This ZIP file was created using the -AV function of PKZIP.  If
  53.         my AV is missing then this file may not be complete of has been
  54.         tampered with.  Complete and current editions of this program
  55.         are always available for D/L on The Parole Board BBS.  If the AV
  56.         is missing please complain to your sysop to stop the practice of
  57.         removing AV's as this is your assurance from the programmer that
  58.         the file is complete and virus free.
  59.  
  60.  
  61.                               INSTALLATION
  62.                               ____________
  63.  
  64.    Installation is fairly easy and straight-forward. The following steps and
  65.    examples should have you up and running in a very short period of time.
  66.    It is assumed that you are familiar with setting up DOORS on your system.
  67.    To this end, only examples of the configuration file and Door batch file
  68.    are described.
  69.  
  70.       1) Create a directory to hold all ADOPT files
  71.  
  72.       2) Unzip ADOPT.ZIP into the the above directory
  73.  
  74.       3) Create a configuration file, with a name of your choice, or
  75.          modify the  ADOPT.CFG file that is enclosed.
  76.          A description follows:
  77.  
  78.    C:\WILDCAT\CALLINFO.BBS ──┐  <- For Wildcat!
  79.    C:\WC30\USERINFO.DAT      │  <- For Wildcat! 3.0  (NODEx dir)
  80.    C:\PCB\PCBOARD.SYS        │  <- For PCBoard using PCBOARD.SYS only
  81.    C:\PCB\USERS              │  <- For PCBoard using USERS only
  82.    C:\BBS\DOOR.SYS           │  <- For Systems that support DOOR.SYS
  83.    C:\BBS\DORINFOx.DEF       │  <- For QBBS/RBB/RA.  Replace x with Node #.
  84.    C:\BBS\SFDOORS.DAT        │  <- For Spitfire
  85.    C:\BBS\TRIBBS.SYS       ──┘  <- For TriBBS
  86.    The Parole Board BBS         <- Your BBS Name
  87.    Dennis                       <- SysOp's First Name
  88.    Maidon                       <- SysOp's Last Name
  89.    Jim Smith                    <- Name of the donor(s)
  90.    ESP!                         <- Adopted door's name
  91.    YES                          <- Create .DNR Log
  92.    00000                        <- Registration Number
  93.    C:\WILDCAT\                  <- Path to create the .DNR log
  94.    YES                          <- YES = SUPER Screen   NO = Standard Screen
  95.    NO                           <- Turn off Prompt
  96.  
  97.      Edit this .CFG file to suit your individual BBS.  All 11 lines MUST
  98.      be present.
  99.  
  100.    Line 1:  This line points to where ADOPT.EXE will find the callers
  101.             information file.  Just include the line that your particular
  102.             BBS uses.  DO NOT put all of them in the CFG file.
  103.  
  104.    Line 2:  Place the name of your BBS on this line.
  105.  
  106.    Line 3:  SysOp's first name goes here.
  107.  
  108.    Line 4:  SysOp's last name goes here.
  109.  
  110.    Line 5:  Place the donor(s) name(s) on this line.  If there are more
  111.             than one it will look better to separate them by a "&" as in
  112.             Bob Smith & Johnny House.
  113.  
  114.    Line 6:  Place the name of the adopted door on this line.
  115.  
  116.    Line 7:  YES to create .DNR log or leave blank
  117.  
  118.    Line 8:  Your Registration Number goes here if registered
  119.  
  120.    Line 9:  Path and directory to place .DNR log.  Be sure to add the
  121.             trailing backslash. "\"
  122.  
  123.    Line 10: YES = Super Screen or NO for regular screen.  The SUPER
  124.             screen is configurable.
  125.  
  126.    Line 11: (Y/N) Turn off prompt line if need be
  127.  
  128.         If you use the above CFG file be sure to remove all remarks and use
  129.    a pure ASCII editor such as EDLIN or QEDIT.  Hidden control codes could
  130.    cause the program to depart for worlds unknown.
  131.  
  132.       4) Create a batch file or modify the ADOPT file supplied. A
  133.          description of this file follows:
  134.  
  135.             ECHO off
  136.             CD \DOORS\ESP           Location of ADOPT files
  137.             ADOPT ADOPT.CFG       EXE filename and CFG filename (Name
  138.                                       used in creating file in #3 above)
  139.             ESP! ESP!.CFG          The Adopted Door Program
  140.             CD\WCAT
  141.             CAT.BAT
  142.  
  143.        5) When running in more than one node, be sure to supply a
  144.           different configuration name for each node (your choice of name).
  145.           Adopt has been tested under LIVECAT! and performs very well.
  146.  
  147. NOTE: When using Wildcat! 3.x, Line 1 of the CFG file *MUST* point to
  148.       your NODE directory, not the HOME directory.
  149.  
  150. NOTE: ADOPT supports COM 1-4 on the standard IRQ's - COM1/COM3 = IRQ4 and
  151.       COM2/COM4 = IRQ3. If you wish to use a non-standard IRQ, add the IRQ
  152.       number after the configuration filename. Let's assume your Door is
  153.       called FOOBAR and you want to use COM1 and IRQ5. The command line
  154.       passed to your Door would be:
  155.  
  156.         FOOBAR FOOBAR.CFG /5
  157.         FOOBAR FOOBAR.CFG *5
  158.  
  159.       The /5 tells ADOPT to use IRQ5 rather than the standard IRQ4 that
  160.       is normally used with COM1. No /x parameter is needed for the standard
  161.       IRQ's.
  162.  
  163. Fossil Driver Support
  164. ---------------------
  165. DoorFrame supports the use of Fossil drivers.  To tell your Door to use the
  166. Fossil driver instead of the standard COM ports, just put /FD on the command
  167. line when running the door. For example:
  168.  
  169.      MYDOOR MYDOOR.CFG /FD
  170.      MYDOOR MYDOOR.CFG *FD
  171.  
  172. indicates that a Fossil driver is present and should be used. If no Fossil
  173. driver is detected, DoorFrame will print a message to that effect and exit
  174. the door gracefully.
  175.  
  176.      If you select the super Screen option ("Y" on line 10 of the CFG
  177. file), you will need to run ADCNF.EXE which will create a file named
  178. ADOPT.CNF.  This file MUST be in each door directory in which you run
  179. Adopt.  Each individual door directory must contain it's own CFG and CNF
  180. files.
  181.  
  182.      The ADCNF.EXE program allows you to set the colors and text that
  183. you like on the Super screen.  The regular screen is already locked into
  184. it's text and colors.  I use this one for doors that have already been
  185. 'adopted' and the Super Screen when I am advertising for a donor.  The
  186. file created is a binary file so do not try to alter or edit it with an
  187. ascii editor.  It just won't work.
  188.  
  189.                                ADOPT-A-DOOR
  190.                                ____________
  191.  
  192.     The concept, ADOPT-A-DOOR, allows a caller to register (ADOPT) a door. It
  193.     would be the same as sending in a donation, only this way it is earmarked
  194.     for registering a particular door. In a way, the user feels he/she is
  195.     "getting something in return".
  196.  
  197.  
  198.                               LEGALITIES
  199.                               __________
  200.  
  201.  
  202.       THIS SOFTWARE AND ACCOMPANYING MATERIALS ARE DISTRIBUTED "AS IS"
  203.       WITHOUT WARRANTY, EXPRESS, IMPLIED OR STATUTORY, INCLUDING BUT NOT
  204.       LIMITED TO ANY IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
  205.       FOR A PARTICULAR PURPOSE. IN NO EVENT SHALL ANYONE INVOLVED WITH
  206.       THE CREATION AND PRODUCTION OF THIS PRODUCT BE LIABLE FOR INDIRECT,
  207.       SPECIAL, OR CONSEQUENTIAL DAMAGES, ARISING OUT OF ANY USE THEREOF
  208.       OR BREACH OF ANY WARRANTY.
  209.  
  210.                              DISTRIBUTION
  211.                              ____________
  212.  
  213.    You may make this file available for downloading from your BBS or you may
  214.    upload it to any BBS of your choice, provided that you do not make any
  215.    changes to the contents of the archive (ZIP file). The archive and its
  216.    individual contents may not be used by any service that charges any money
  217.    whatsoever, without the written permission of the author.
  218.  
  219.                              REGISTRATION
  220.                              ____________
  221.  
  222.    I am not a subscriber to the "Crippleware" concept, and this program
  223.    reflects that philosophy. This is a full-featured program, whose
  224.    functionality is not hampered in any way, whether you register it or
  225.    not.  It is only $15 to register this door.  that's not too much to
  226.    ask for a program that could save you big bucks.
  227.  
  228.    Remember, should you have any problems, questions or suggestions, be sure
  229.    to drop me a message on either of the aforementioned BBS or via FIDO
  230.    DOORWARE  conference or NETMAIL.  (1:151/185)
  231.  
  232.  
  233.                                  THANKS
  234.                              --------------
  235.  
  236.      Special thanks goes out for my wife who is definitely a
  237.      "Computer Widow".
  238.  
  239.      Ted Freeman the author of DOORFRAME, a first class BBS Doors
  240.      Development Library.  Ted still lives on in the fantastic software
  241.      he wrote.
  242.  
  243.      My BBS users who have had to endure constant badgering to help me
  244.      test the programs that I have written.
  245.  
  246.      Mark Tetrault and Rick Emmick, SysOps of of two fantastic WILDCAT!
  247.      BBSs, without whom, this program would never have worked.
  248.  
  249.      Mustang! Software -  Home of the best Damn BBS software available
  250.      today.
  251.  
  252.      ADOPT - A - DOOR is written using MicroSoft's Visual Basic for DOS
  253.      (Professional Version)
  254.  
  255.