home *** CD-ROM | disk | FTP | other *** search
/ ftp.wwiv.com / ftp.wwiv.com.zip / ftp.wwiv.com / pub / BBS / GUEST13.ZIP / GUEST.DOC < prev    next >
Text File  |  1994-09-22  |  16KB  |  377 lines
  1.  
  2.  
  3.                     ****************************************
  4.                            ATLANTIS SOFTWARE PRESENTS
  5.                     ****************************************
  6.  
  7.                               THE GUEST REGISTRY
  8.  
  9.                                  Version 1.23
  10.  
  11.                        Copyright (c) 1994   By Jimmy Rose
  12.                     ****************************************
  13.  
  14.  
  15.  
  16.  
  17.                       SHAREWARE NOTICE
  18.                        ________________
  19.  
  20.     The Guest Registry is being distributed as shareware. If you
  21.     enjoy this program please register it. Whenever you find any
  22.     shareware Program that you like and find useful, please consider
  23.     registering. This will help encourage future developement of
  24.     other useful programs and also ensure that your favorites will
  25.     be supported and enhanced. 
  26.  
  27.  
  28.                             REGISTERED VERSION INFO
  29.                             _______________________
  30.  
  31.         If you have registered this program then your name will appear 
  32.     on the opening screen. 
  33.  
  34.     The Guest Registry is a copyrighted program!
  35.     DO NOT distribute the registerd version.
  36.  
  37.         Read the file "upgrade.doc" for instructions on installing the
  38.     registered version.
  39.  
  40.  
  41.                                 INTRODUCTION
  42.                                 ____________
  43.  
  44.         This is the ORIGINAL AND BEST Guest Registry Program! Don't be
  45.         fooled by the newcomers. This program is written entirely in
  46.         C++ for maximum efficiency.
  47.  
  48.         The Guest Registry is a very popular door for all major BBS's.
  49.         It may be configured as a Main Menu item on many boards.
  50.         Guests (users) can enter information about themselves and view
  51.         other guest profiles.
  52.  
  53.         Includes information such as hobbies, favorite books and movies,
  54.         marital status, dating availability, children, pets, and much more.
  55.         All questions are optional, and guests may edit personal stats at
  56.         any time.
  57.  
  58.  
  59.         
  60.  
  61.                            REGISTRATION & SUPPORT
  62.                            ______________________
  63.  
  64.         The Guest Registry will be supported indefinately. The latest
  65.         shareware version will always be available for download from
  66.         The Prophecy BBS (513) 423-2336, FidoNet 1:110/950.
  67.         It is a free download on your first call. 
  68.     For registration information see the file "order.txt".
  69.         Atlantis Software products are also available as free downloads
  70.         from the following distribution sites:
  71.  
  72.         Photo Finish BBS (513) 539-4439, 24 hrs, 14400.
  73.         Monroe, Ohio. The Sysop is Martin A. Wheeler III.
  74.  
  75.         Paradox BBS (912) 449-3018, 24 hrs, 14400
  76.         Blackshear, Georgia. The Sysop is Harry Roney.
  77.  
  78.         The Academy BBS (513) 424-1533, 24 hrs, 14400
  79.         Middletown, Ohio. The Sysop is Margaret "Madmaggie" Elam.
  80.  
  81.     
  82.     Please see the "Notes" section at the end of this file for
  83.     additional information on obtaining assistance.
  84.  
  85.         If you have any comments, suggestions, or features you'd like
  86.         to see added to The Guest Registry, please write or send E-mail.
  87.         I want to hear your ideas. All questions as will be answered as
  88.         quickly as possible. The Shareware version supports 20 guests.
  89.         The registered version will support an unlimited number.
  90.  
  91.  
  92.  
  93.                                 REQUIREMENTS
  94.                                 ____________
  95.  
  96.         You need an IBM compatible computer and a BBS. The Guest
  97.         Registry will work with TriBBS, Wildcat, PC Board, Spitfire,
  98.         RBBS, WWIV, Gap, Renegade, Remote Access, and other BBS's
  99.         that can run one of these doors.
  100.         It is assumed that you are familiar with your BBS software
  101.         and have installed other doors. If not, step by step instructions
  102.         are provided for some boards. This program may also be run in
  103.         local mode without a BBS (see below).
  104.  
  105.  
  106.                                 INSTALLATION
  107.                                 ____________
  108.  
  109.         Create a directory for The Guest Registry. Preferably in your
  110.         BBS directory. You can name it whatever you want. For example,
  111.         if you want to create a directory called "guest" in your BBS
  112.         directory, from the Dos prompt type "cd c:\bbs", then type
  113.         "md guest". Don't type the quotation marks.
  114.         This assumes your BBS is on your c: drive. If it's on another
  115.         drive, substitute the appropriate letter.
  116.  
  117.         After you create the directory, unzip the archive contents
  118.         into it. Next you'll need to create a configuration file or modify
  119.         the "sample.cfg" file included with the archive. This is an ascii
  120.         text file that can be created or edited with any text editor.
  121.         The configuration file MUST be in the same directory as The
  122.         Guest Registry. It has the following format:
  123.  
  124.                 Line 1:  Door data type (see below)
  125.                 Line 2:  Path to Door data file (dropfile)
  126.                 Line 3:  BBS name
  127.                 Line 4:  Sysop's name
  128.                 Line 5:  Locked baud rate
  129.  
  130.         Line 1 is the Door data file type and can be any of the following
  131.         TRIBBS for TriBBS                    ; TRIBBS.SYS
  132.         PCB    for PC Board                  ; PCBOARD.DAT, PCBOARD.SYS
  133.         GAP    for Gap                       ; DOOR.SYS
  134.         SF     for Spitfire                  ; SFDOORS.DAT
  135.         RBBS   for RBBS                      ; DORINF0#.DEF
  136.         WC     for Wildcat                   ; CALLINFO.BBS
  137.         WWIV   for WWIV                      ; ????????.???
  138.  
  139.         * Note that TriBBS can run doors with any of the configuration
  140.           dropfiles above. Remote Access may use either GAP or RBBS.
  141.           Other BBS packages may work with multiple dropfiles, but
  142.           make sure you choose only one.
  143.  
  144.         The other lines should be self-explainatory. Here's a sample
  145.         config file:
  146.  
  147.                 TRIBBS
  148.                 c:\tribbs\
  149.                 The Prophecy
  150.                 Jimmy Rose
  151.                 38400
  152.  
  153.         This would configure The Guest Registry to run on a TriBBS
  154.         system. It assumes the BBS is in the "tribbs" directory. Other
  155.         Sample configuration files can be found at the end of this file.
  156.  
  157.         IMPORTANT!
  158.         If you have not already done so, read the "readme.1st" file that
  159.         is included in this archive for information on the sysop.cfg file.
  160.  
  161.         The next step is to create a batch file to call the door. Each
  162.         BBS is different, so it's assumed you know how to create one
  163.         for your system. Here's a sample batch file for TriBBS:
  164.  
  165.                 cd c:\tribbs\guest
  166.                 gr sample.cfg
  167.                 cd c:\tribbs
  168.                 board
  169.  
  170.         The first line changes to the directory where The Guest Registry
  171.         is located.
  172.         The second line calls the door followed by the configuration file.
  173.         You MUST include the name of the configuration file, although you
  174.         can name it anything you like.
  175.         The third and fourth lines return you to the board.
  176.         Each system will be a little different, the one line that will
  177.         be same for every batch file is the second one.
  178.         Finally, edit your bbs files to display the door name and call
  179.         the batch file when selected. You're on your own here!
  180.  
  181.         The Guest Registery can easily be run from your Main Menu on
  182.         systems with extendable menus. It is recommended you do run
  183.         the program from the Main Menu if your system supports this.
  184.  
  185.         To set up The Guest Registry as a Main Menu item on a Tribbs
  186.         system, name the above batch file "mainj", then edit your
  187.         main.mnu file to call the batch file by adding the following
  188.         line:
  189.         J,J,Guest Registry,20
  190.  
  191.         This will call up The Guest Registry whenever the letter J is
  192.         selected from the Main Menu. You may use any availabe letter
  193.         that you like, just substitute the letter you want to use for
  194.         the letter J in all instances above, including the batch file.
  195.         The number at the end of the line is the minumum security level
  196.         a user must have to be able use The Guest Registry. Adjust this
  197.         to your liking.
  198.  
  199.  
  200.  
  201.                                  OPERATION
  202.                                  _________
  203.  
  204.         The Guest Registry may be run locally if you wish. If you want
  205.         to run the door without going through the BBS, make the directory
  206.         where the program is stored the current directory. From the Dos
  207.         prompt type "gr sample.cfg local". You will prompted to enter a
  208.         user name. Whatever name you type in will be used for your Alias.
  209.  
  210.         When The Guest Registry loads you will see a list of commands.
  211.         Here are the Main Menu commands:
  212.      
  213.         R - Register As A Guest:
  214.             This command lets you enter your personal information
  215.             into the registry. You will be asked a series of questions
  216.             for which you will type in your answer. If you don't want
  217.             to answer a paticular question, just hit enter and it will
  218.             be left blank.
  219.             If you are already registered, you can't register again.
  220.             select "E" instead.
  221.  
  222.         S - Search For Guest:
  223.             Asks you to enter a name. If the name is a registered
  224.             guest, the info for that guest is displayed.
  225.             The search is not case-sensitive. You may enter any
  226.             combination of upper and lower case letters.
  227.  
  228.         V - View Guest List:
  229.             Displays a list of all registered guests and displays
  230.             registry for guest that you select.
  231.  
  232.         I - Instructions:
  233.             Shows information screen.
  234.  
  235.         E - Edit Personal Info:
  236.             Let's you make changes to your personal registry file.
  237.             
  238.         Q - Quit and Reurn to the BBS:
  239.             Does just what it says.
  240.      
  241.  
  242.                                HINTS & TIPS
  243.                                ------------
  244.  
  245.         Whenever possible The Guest Registry should be configured to run
  246.         from your Main Menu.
  247.         In the beginning ecourage everyone to register. Post a news item
  248.         to let users know what it is. For some reason people are reluctant
  249.         to enter their info if their are very few names listed.
  250.         However, once more people register, they seem more than willing. I
  251.         ask that all new users please fill out the registry and whenever I
  252.         chat with someone, I ask them if they would mind filling it out if
  253.         they haven't already done so. They always respond with something
  254.         like "sure"! Sysops seem to have a lot of power.  :)
  255.  
  256.         Common Problems:
  257.  
  258.         "It looks fine on the sysop end, but users only see garbage on the
  259.         screen when they enter the door".
  260.         This is always a configuration error. If your serial port is locked,
  261.         change the last line in The Guest Registry configuratiion file to the
  262.         rate at which you lock your serial port. If the serial port is not
  263.         locked, the setting MUST be 0.
  264.         Also, make sure your RTS/CTS flow control is on in your node config.
  265.  
  266.         "It runs fine, but it's not in color".
  267.         Try using a different drop file.
  268.  
  269.         "Users fill out The Guest Registry but their name isn't shown on
  270.         the display screen".
  271.         Unfortunately some boards do not properly read the dropfile when
  272.         alias's aren't used. This will be addressed in future releases.
  273.         If you're experiencing this problem and your BBS does not use
  274.         alias's, contact Atlantis Software for a specialized version.
  275.  
  276.  
  277.                          SAMPLE CONFIGURATION FILES
  278.                          --------------------------
  279.         ________________________________________
  280.         Spitfire.cfg:
  281.  
  282.                 SF
  283.                 c:\spitfire\
  284.                 The Haven
  285.                 Eric Carr
  286.                 0
  287.         ________________________________________
  288.         pcboard.cfg:
  289.  
  290.                 PCB
  291.                 c:\pcbbs\
  292.                 Consultant's BBS
  293.                 Joe Comm
  294.                 14400
  295.         ________________________________________
  296.         wildcat.cfg:
  297.  
  298.                 WC
  299.                 c:\bbs\node1\
  300.                 Dragons Liar
  301.                 The Wraith
  302.                 38400
  303.         ________________________________________
  304.         gap.cfg
  305.  
  306.                 GAP
  307.                 c:\bbs\
  308.                 Salt Lake BBS
  309.                 Martha Mormon
  310.                 9600
  311.         ________________________________________
  312.  
  313.  
  314.                                     NOTES
  315.                                     _____
  316.  
  317.         IMPORTANT! The program data is contained in the files "guest.usr"
  318.         and "userx", where x is the users registry number.
  319.         DO NOT attempt to modify these files! It is a good idea to make
  320.         a backup copy of these file at least once a week. If the files
  321.         become corrupted or are lost due to hard drive failure, or
  322.         human error, then all callers who already entered info will
  323.         have to do so again.
  324.  
  325.         It is not possible to delete a guest. That feature will be
  326.         available in version 2.0. However, it is possible for the
  327.         sysop to edit all info. Simply log on in "local" mode (from
  328.         dos) and when prompted for a name for the local logon enter
  329.         the alias of the person you want to edit. Then select "E"
  330.         from the main menu and enter the persons registry number.
  331.         This may be useful if someone enters vulgar or obscene answers
  332.         that you don't want other users who may be offended to see.
  333.  
  334.         Future plans include a sysop utility for editing or deleting
  335.         users, more space for entering information, additional sysop-
  336.         configuarable questions, and internal mail capabilities.
  337.  
  338.         The Guest Registry was programmed by myself because I wanted
  339.         this feature on The Prohecy BBS and could not find anything
  340.         else suitable. It has become an extremely popular feature
  341.         on BBS's nationwide.
  342.  
  343.         Thanks to Martin Wheeler and Photo Finish BBS (513) 539-4439
  344.         for serving as distribution and test site for The Guest
  345.         Registry and other Atlantis Software products.
  346.  
  347.     If you live in the south, Atlantis Software products may also 
  348.     be found at our Georgia distribution site The Paradox BBS 
  349.     (912) 449-3018, 24 hours, 14400. The sysop is Harry Roney.
  350.  
  351.         This program was written in C++ using Borland Turbo C++ and the
  352.         Tridoor library (c) by Mark Goodwin.
  353.  
  354.         If you have any questions, comments, or suggetions please write
  355.         to:
  356.  
  357.                 Jimmy Rose
  358.                 2000 Linden ave.
  359.                 Middletown, OH 45044-4435
  360.                 USA
  361.  
  362.         Or call the Home of Atlantis Software:
  363.         The Prophecy BBS (513) 423-2336. 24 hours a day. Fido 1:110/950
  364.  
  365.         Voice support is available to REGISTERED users only.
  366.  
  367.         If you do have a problem and call or write, please be prepared to
  368.         provide the following information:
  369.         > Guest Registry version number.
  370.         > BBS Software & version number.
  371.         > Serial port used? (locked?, rate?).
  372.         > Does your BBS use Alias's?
  373.         > Any thing else "specific" to your problem.
  374. *****************************************************************************
  375.            THANKS FOR USING THE GUEST REGISTRY!
  376. *****************************************************************************
  377.