home *** CD-ROM | disk | FTP | other *** search
/ ftp.wwiv.com / ftp.wwiv.com.zip / ftp.wwiv.com / pub / DOOR / EBBSLST3.ZIP / EBBSLST3.DOC < prev    next >
Text File  |  1993-12-29  |  16KB  |  333 lines
  1.  
  2.  
  3.   ┌────────────────────────────────────────────────────────────────────────┐
  4.   │ ┌────────────────────────────────────────────────────────────────────┐ │ ░░
  5.   │ │                        Online BBS List Door                        │ │ ░░
  6.   │ │   ▄██████  ██████▄  ██████▄  ▄█████▄  ██       ▄▄  ▄▄▄▄▄  ▄▄▄▄▄▄   │ │ ░░
  7.   │ │  ▓██▄▄▄▄  ▓██▄▄▄█▀ ▓██▄▄▄█▀ ▓██▄▄▄▄  ▓██       ▄▄ ▓██▀▀▀  ▀▀██▀▀   │ │ ░░
  8.   │ │  ▒██▀▀▀▀  ▒██▀▀▀██ ▒██▀▀▀██   ▀▀▀▀██ ▒██      ▒██  ▀▀▀██   ▒██     │ │ ░░
  9.   │ │  ▀▀██████ ░██████▀ ░██████▀  ▀█████▀ ░███████ ░██ ░█████   ░██ v3.0│ │ ░░
  10.   │ │            (C) MicroWare 1992-94       Hector Navarro              │ │ ░░
  11.   │ └────────────────────────────────────────────────────────────────────┘ │ ░░
  12.   └────────────────────────────────────────────────────────────────────────┘ ░░
  13.      ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  14.  
  15.                      
  16.                      
  17.                      
  18.                      
  19.                      
  20.                      
  21.                      
  22.                        
  23.                        1. DISCLAIMER           
  24.                        
  25.                        2. INTRODUCTION        
  26.                        
  27.                        3. ABOUT EBBSList         
  28.                        
  29.                        4. SPECIAL SYSOP KEYS       
  30.                        
  31.                        5. COMPATIBILITY          
  32.                        
  33.                        6. INSTALLATION           
  34.                        
  35.                        7. CONFIGURATION FILE        
  36.                        
  37.                        8. MULTINODE USAGE        
  38.                        
  39.                        9. REGISTRATION              
  40.                       
  41.                       10. COMMENTS, QUESTIONS, SUGGESTIONS        
  42.  
  43.  
  44.  
  45.  
  46.                             ░▒▓█ DISCLAIMER █▓▒░      
  47.          
  48.            The EBBSList package  is  subject  to the  following  license
  49.         terms and conditions:   
  50.  
  51.        The EBBSList package  is  supplied  as  it   is.  The  author
  52.           disclaims all warranties, expressed or  implied, including,
  53.           without  limitation, the  warranties of merchantability and
  54.           of  fitness  for   any  purpose.  The  author  assumes   no
  55.           liability for  damages, direct or  consequential, which may
  56.           result from the use of the EBBSList package.
  57.  
  58.        The EBBSList package is a "LIMITED USE SHAREWARE" and is pro-
  59.            vided at no charge for sysop evaluation. IF, you do like it
  60.            and intend to continue using it I would appreciate that you
  61.            do register it after the 60 day trial period.
  62.  
  63.        The EBBSList package,  all  programs,  the  documentation  and
  64.           support  files  are property  of (C) MicroWare 1992-94. All 
  65.           rights are reserved.  You may copy this package for backup 
  66.           purposes. You may also copy and share  unmodified copies of 
  67.           the whole package to send to other BBS.
  68.  
  69.         You MAY NOT  sell the  product for a fee  and/or distribute the 
  70.         product  along  with other products without written permission.  
  71.  
  72.         It  is  forbidden  to  modify,  adapt,  translate,  reverse
  73.         engineer,  decompile and/or disassemble the software in the
  74.         EBBSList package.  Patching the medium at places that carry
  75.         the software  is  seen  as a  program  change and  is  also
  76.         forbidden.
  77.  
  78.  
  79.  
  80.  
  81.                             ░▒▓█ INTRODUCTION █▓▒░
  82.                              
  83.               EBBSList is a small, fast, online BBS database in which    
  84.         users can locate different BBS by entering keywords or anything
  85.         in specific that they are looking for.  If a match is found it
  86.         will be highlighted and immediately displayed on the screen.  
  87.         At the end of the list the amount of matches found will be added
  88.         up.  The search can consist of ANY string that you would like to
  89.         look for.  It will compare what the user entered to the BBS's 
  90.         name, Software, Baud, Hours, Nodes, and Phone number.  If there
  91.         are ANY matches they will be displayed.  EBBSList asks the sysop
  92.         for a 5 line extended description about his board which can be 
  93.         retrieved by selecting the menu option that searches the Extended
  94.         descriptions.  It also has the ability to delete an entry or 
  95.         entries if the user online is the sysop of the BBS to delete.  The
  96.         sysop has the ability to delete ANY BBS in the list.  The deletion
  97.         feature is only available in the registered version though.  It 
  98.         has the ability to only allow a certain security level to add a 
  99.         BBS to the list.  This is to avoid any user from entering a BBS 
  100.         and not knowing the correct information or giving false information 
  101.         thus creating a problem with the BBS's sysop.
  102.         
  103.          
  104.  
  105.                           ░▒▓█ ABOUT EBBSList █▓▒░
  106.           
  107.                        - Supports all COM ports
  108.                        - Automatic time left verification
  109.                        - Automatic carrier detection
  110.                        - Automatic status bar
  111.                        - Automatic inactivity timeout verification
  112.                        - Simultaneous modem and keyboard control
  113.                        - Sysop DOS shell function
  114.                        - Built-in color chat mode
  115.                        - Hotkeys!
  116.                        - BBS list download capability
  117.                        - Automatic entry and extended description sorting
  118.                        - Colorful screens
  119.                        - Compatible with MANY different BBS software
  120.                        - Works quickly on just about any machine 
  121.                        - Very easy to understand and use
  122.                        
  123.  
  124.  
  125.                          ░▒▓█ SPECIAL SYSOP KEYS █▓▒░
  126.                     
  127.                     
  128.                     
  129.                     Alt H  :  Hangs Up
  130.                     Alt X  :  Returns to the BBS without hanging up
  131.                     Alt C  :  Enters Chat Mode
  132.                     Alt J  :  Jumps to DOS (Dos Shell)
  133.                     Alt +  :  Adds one minute to time remaining
  134.                     Alt -  :  Substracts one minute to time remaining
  135.  
  136.                     
  137.  
  138.            
  139.                          
  140.                           
  141.                           
  142.                           ░▒▓█ COMPATIBILITY █▓▒░
  143.            
  144.             This door is compatible with most bulletin board systems
  145.        which will give most of you sysops a chance to use it!  Here
  146.        is the list (as far as I know) of the boards that it's compa-
  147.        tible with:
  148.                  
  149.                  ┌───────────────────────────────────┐
  150.                   │  Force!       │     Remote Access │
  151.                    │   GAP         │     Spitfire      │
  152.                     │   Genesis     │     SuperBBS      │
  153.                      │   Osiris      │     Telegard      │
  154.                       │   PCBoard     │     WildCat 3     │
  155.                        │   QuickBBS    │     WildCat BBS   │
  156.                         │   RBBS        │     WWIV          │
  157.                          └───────────────────────────────────┘             
  158.                                              
  159.   (And BBS software that uses a compatible format with ones mentioned above)
  160.  
  161.          If your BBS software's door exit file is not compatible with the
  162.          ones above then let me know and I can try and make it compatible
  163.          with your software.  All I would need is a copy of the door exit
  164.          file produced by your BBS software.  It needs to include the 
  165.          user's name, baud, com port which the modem is using and the
  166.          users time left on the board.
  167.   
  168.  
  169.  
  170.                              
  171.                              
  172.  
  173.  
  174.  
  175.  
  176.                             
  177.                             ░▒▓█ INSTALLATION █▓▒░
  178.  
  179.          EBBSList is indeed very easy to install. All you have to do                        
  180.         is UNZIP the package to a temporary directory and then run the 
  181.         included install program (INSTALL.EXE).  I hope you like it!
  182.         If for some reason the installation program does not work for 
  183.         you then you can copy the files to the directory you want and
  184.         then modify the EBBSLIST.CFG to your information.  An example
  185.         of what the configuration file should look like is provided
  186.         below.  See CONFIGURATION FILE
  187.  
  188. ─────────────────────────────────────────────────────────────────────────────
  189.    
  190.    [ YOU MUST HAVE PKZIP.EXE IN YOUR PATH FOR THE DOWNLOAD TO WORK!!!!!!!! ]
  191. [ YOU MUST HAVE GSZ or DSZ.COM IN YOUR PATH FOR THE DOWNLOAD TO WORK!!!!!!!! ]
  192.  
  193.       DSZ is a product of Omen Technologies which can be found in any BBS
  194.       that has transfer protocols available for download.  GSZ is the same
  195.       as DSZ but has a graphical interface.  Much nicer!  PKZIP is a product
  196.       of PKWARE and can also be found in a BBS near you.
  197.  
  198.  You can do this by adding the line   PATH=C:\DIR  to your AUTOEXEC.BAT
  199.  DIR would be the directory where the file DSZ/GSZ.COM and PKZIP resides at.
  200.  
  201. ─────────────────────────────────────────────────────────────────────────────
  202.  
  203.  
  204.                          ░▒▓█ CONFIGURATION FILE █▓▒░
  205. ─────────────────────────────────────────────────────────────────────────────
  206.                         ( MUST be called EBBSLIST.CFG )
  207.  
  208. Line 1: Name of your BBS
  209. Line 2: The name you use when you log in to the BBS. (i.e. Sysop, John Doe)
  210. Line 3: Minimum security level to enter a new BBS.  0=disable feature
  211. Line 4: Line sent to user when his security level is insufficient.
  212. Line 5: Path AND Filename of the ANSI bulletin.
  213. Line 6: Path AND Filename of the ASCII (non-color) bulletin.
  214.  
  215. ─────────────────────────────────────────────────────────────────────────────
  216.                                
  217.                                
  218.                                BATCH EXAMPLES
  219. ─────────────────────────────────────────────────────────────────────────────
  220.              For Remote Access, QuickBBS, SuperBBS sysops:
  221.          * This door will work with a TYPE 7 exit from your menus *
  222.  
  223.         Example Batch:
  224.                                      
  225.                           @Echo Off
  226.                           cd \bbsdir\doordir
  227.                           ebbslist c:\qbbs\dorinfo#.def <-- This is a MUST!
  228.                           cd \bbsdir
  229.                           exit
  230.  
  231. ─────────────────────────────────────────────────────────────────────────────            
  232.              For PCBoard sysops the batch should look like:
  233.         
  234.         Example Batch:
  235.                                      
  236.                           @Echo Off
  237.                           cd \bbsdir\doordir
  238.                           ebbslist c:\pcb\door.sys <-- This is a MUST!
  239.                           cd \bbsdir
  240.                           board
  241.  
  242.  
  243.      For MULTINODE use the batch would be almost the same with the exception
  244. of a few PCBoard variables:
  245.                           
  246.                 @Echo Off
  247.                 cd \bbsdir\doordir
  248.                 ebbslist %PCBDRIVE%%PCBDIR%\door.sys <-- This is a MUST!
  249.                 %PCBDRIVE%
  250.                 cd %PCBDIR%
  251.                 board
  252.                           
  253.                  See MULTINODE USAGE for more info on multinode
  254. -----------------------------------------------------------------------------
  255.         ATTENTION: You MUST specify the path to the door exit file! 
  256. -----------------------------------------------------------------------------
  257. ─────────────────────────────────────────────────────────────────────────────            
  258.  
  259.  These are the only two BBS I know how to set it up with, if you encounter
  260.  any difficulties with any other type of BBS, please give me a call and
  261.  let me know...
  262.  
  263. ─────────────────────────────────────────────────────────────────────────────            
  264.                            
  265.                             
  266.                          ░▒▓█ MULTINODE USAGE █▓▒░
  267.  
  268.           EBBSList is not yet totally multinode capable, though it will
  269.  run under DESQview with no problems whatsoever if you have sufficient 
  270.  memory.  I have tried running it under two nodes on my BBS and have had 
  271.  problems only when I try to do the EXACT same thing at the EXACT same time
  272.  on both nodes.  It's probably one in a thousand chance that two users will
  273.  try to do the same thing at the same time on the door.  I setup the program
  274.  so that if it encountered a problem while trying to open the same file on
  275.  both nodes it will pause for 5 seconds on ONE of the nodes to give the 
  276.  other node a chance to finish reading or writing to the file before 
  277.  proceeding.  I am not responsible for anything that might happen while
  278.  trying to run the door multinode.  The only major thing I can think of that
  279.  might happen is that one of the nodes might lock up.  You do not need to 
  280.  create separate configuration files for each node like other doors require.
  281.  Just simply specify the path to the door exit file for that particular node
  282.  and EBBSList will take care of the rest!  Remeber, to run ebbslist you need
  283.  to specify the path AND file name to the door exit file:
  284.  
  285.                       EBBSLIST C:\NODE1\EXIT1.FIL
  286.  
  287.  
  288.  
  289.                            ░▒▓█ REGISTRATION █▓▒░
  290.  
  291.                     [ TO REGISTER FILL OUT REGISTER.FRM ]
  292.           
  293.           
  294.           EBBSList is NOT public domain, it's SHAREWARE. This means that 
  295.      you have to pay a registration fee of $15 US (add $5 if you would like
  296.      a diskette sent to you) if you find EBBSList to be useful and decide 
  297.      to keep it.  The registration cost is minimal and will allow the 
  298.      author to write new and improved versions of MicroWare products.
  299.  
  300.           Please note that the unregistered version is the same as the 
  301.      registered version except that a "Please encourage sysop to register" 
  302.      and a slight delay is sent to the user before entering the door.  The 
  303.      registered version of EBBSList doesn't display anything to do with re-
  304.      gistration and does not have ANY pauses whatsoever plus you get a 
  305.      setup program that will allow you to change the colors of the list so
  306.      that you can customize it to your BBS's colors.  The deletion feature
  307.      will also be enabled so that either you or your users can delete BBS
  308.      entered by them.  The sysop can delete ANY BBS he wants to.  Also, upon 
  309.      user exit of the door they will be notified that the door has been 
  310.      registered and to whom and what BBS it has been registered to.  Upgrades 
  311.      are always FREE and available through our support BBS.  As a registered 
  312.      sysop you will be noticed of any updates or newer versions through mail 
  313.      or via FAX.
  314.             
  315.             
  316.                   ░▒▓█ COMMENTS, QUESTIONS, SUGGESTIONS █▓▒░
  317.  
  318.  
  319.             If you happen to find ANY bugs or problems in the program
  320.         please leave me a message on the DOORS Conference on RIME, call,
  321.         or write me at:
  322.                                 
  323.                                 Online X-PRESS
  324.                                 (407)366-3335
  325.                        Home and Support BBS of MicroWare
  326.  
  327.                                 Hector Navarro
  328.                                 P.O.Box 1183
  329.                                 Goldenrod, FL 32733-1183
  330.  
  331.           Your help is gladly appreciated!  Thanks for your support!
  332.  
  333.