home *** CD-ROM | disk | FTP | other *** search
/ ftp.wwiv.com / ftp.wwiv.com.zip / ftp.wwiv.com / pub / EVENTS / DBLST15.ZIP / BBSLIST.DOC < prev    next >
Text File  |  1996-02-28  |  13KB  |  343 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.                   Digital BBSList v1.5
  9.  
  10.            Copyright (c) 1995-1996 by Frank Burton III
  11.  
  12.  
  13.  
  14.                 -* Shareware Version *-
  15.  
  16.  
  17.  
  18.  ---------------------------------------------------------------------------
  19.  -* Description: *-
  20.  ---------------------------------------------------------------------------
  21.  
  22.   Digital BBSList is the finest BBSList Door you'll find.  Installation on
  23.   any BBS Software is simple.  Several features include a downloadable list,
  24.   a scrollbar matrix menu and fast search functions.  (for a complete list
  25.   of options, see below).  I'm sure you will find Digital BBSList to be one
  26.   of the most popular On-Line BBSList Doors around!
  27.  
  28.  
  29.  ---------------------------------------------------------------------------
  30.  -* Copyright and Registration Notice: *-
  31.  ---------------------------------------------------------------------------
  32.  
  33.   Digital BBSList is a copyrighted program being distributed under the
  34.   shareware concept.  You may test the door online for up to 60 days, after
  35.   this shareware trial period expires, you must register the software or
  36.   discontinue use.  The registration for Digital BBSList is only $5.00
  37.   (US Checks/Money Orders only!)  See the included REGISTER.FRM for more
  38.   info.
  39.  
  40.   Being Shareware, Digital BBSList may be freely distributed in it's original
  41.   form.  CD-ROM Dealers or Shareware Distributors are welcome to spread this
  42.   software without notifying the author, Frank Burton III, as long as their
  43.   is no modification to the software.
  44.  
  45.  
  46.  ---------------------------------------------------------------------------
  47.  -* Warranty: *-
  48.  ---------------------------------------------------------------------------
  49.  
  50.   Digital BBSList is distributed without warranty.  In no event will Frank
  51.   Burton III, or anyone associated with the software be liable to you for
  52.   damages, including any loss of profits, lost savings, or other incidental
  53.   or consequential damages arising out of your use of or inability to use
  54.   the program, even if Frank Burton III has been advised of the possibility
  55.   of such damages. Frank Burton III will not be liable for any such claim by
  56.   any other party.
  57.  
  58.   DSZ (Z-Modem) is copyright Omen Technology INC.
  59.   The Draw is copyright TheSoft Programming Service and Ian E. Davis
  60.  
  61.   -------------------------[ end of disclaimer ]----------------------------
  62.  
  63.  
  64.   Now that the disclaimer is out of the way, on with the show!
  65.  
  66.  
  67.  
  68.               -* Digital BBSList v1.5 *-
  69.  
  70.           Copyright (c) 1995-1996 by Frank Burton III
  71.  
  72.  
  73.  
  74.   Features:
  75.  
  76.       ■ Quick & Easy Installation on ANY BBS Software
  77.      
  78.       ■ No Drop-Files required (CHAIN.TXT optional).
  79.  
  80.       ■ No FOSSIL DRIVER Required
  81.  
  82.       ■ Informative Listing of up to 150 BBS Systems *
  83.  
  84.       ■ Pretty ANSI Graphics
  85.  
  86.       ■ Customizable Main Menu
  87.  
  88.       ■ Fast String-Search Function on Main Menu
  89.  
  90.       ■ Fast Area Code Listing on Main Menu
  91.  
  92.       ■ Registration by KEY file, so you can easily upgrade
  93.         with each version, and still be registered!
  94.  
  95.       ■ Customizable BBSList using external ANSI supporting
  96.         various PIPE codes
  97.  
  98.       ■ Scrollbar Pull-Down Matrix Menu
  99.  
  100.       ■ Random BBSList ANSIs
  101.  
  102.       ■ Downloadable BBSList (requires external DSZ.EXE/COM)
  103.  
  104.       ■ External Editor for SysOps
  105.  
  106.       ■ ASV "Quick Add" program (use to add an entry from command line)
  107.         Great to add in your BBS Logon event for visiting sysops!
  108.  
  109.      * registered version only (up to 10 systems in non-registered version)
  110.        Registration is only $5.00 (us check/money orders only) and disables
  111.        all shareware pauses as well as offering up to 150 systems in list.
  112.  
  113.  
  114.  ---------------------------------------------------------------------------
  115.  -* Setup: *-
  116.  ---------------------------------------------------------------------------
  117.  
  118.      Don't forget you can type BBSLIST /? to see a list of command line
  119.   switches!
  120.  
  121.   1:  To install Digital BBSList, you can either unzip the contents of the 
  122.   DBLSTxxx.ZIP into your main BBS Directory, or you can have it in it's own
  123.   directory.  Make sure a copy of DSZ (DSZ.EXE or DSZ.COM) is in your path.  
  124.   Also the BBSLIST.MNU and BBSLIST.ANS must reside in the same dir as the 
  125.   BBSLIST.EXE.
  126.  
  127.   2:  It will be necessary to shrink your BBS if possible, require ANSi, and
  128.   enable DOS Intercepts.
  129.  
  130.   3:  Installation is complete!  Try adding an entry to the list first to 
  131.   be sure everything is peachy, then let you users have a blast!
  132.  
  133.   4:  Read the below part about how to 'customize' your copy!
  134.  
  135.  
  136.  ---------------------------------------------------------------------------
  137.  -* Customizing: *-
  138.  ---------------------------------------------------------------------------
  139.     
  140.     If you would like to customize your version a little bit, you can edit 
  141.   the BBSLIST.MNU (it's only an ansi file), and change it to whatever you
  142.   wish, and this file is displayed as the main menu in Digital BBSList!
  143.   The actual output of the BBSList is also customizable through an external
  144.   ANSI file as well, edit the file BBSLIST.ANS to whatever you would like
  145.   your BBSList to look like.  Please refer to the PIPE codes section later on
  146.   in the docs for more info.  Starting with v1.3 you can have random BBSLIST
  147.   ANSIs.  To do so, you will need to create a BBSLIST.ANS file, and any other
  148.   BBSLIST Screens you create should be named BBSLIST.1 BBSLIST.2 BBSLIST.3
  149.   etc. without a break in the extension pattern.
  150.  
  151.  
  152.  ---------------------------------------------------------------------------
  153.  -*  PIPE Codes:  *-
  154.  ---------------------------------------------------------------------------
  155.  
  156.     You can modify the look of the BBSList using an external ANSI file called
  157.   BBSLIST.ANS.  This file must exist in order for the BBSList program to run.
  158.   You can edit the ANSI file in any ANSI editor you choose, such as The Draw.
  159.   The use of PIPE codes will offer you the chance to place each listing's info
  160.   (ie, the BBS Name, Number, Speed, etc) anywhere on the screen you wish, as
  161.   well as in any ANSI/DOS color you want.  To use the PIPE codes, you'll have
  162.   to have one of the following combos in your ANSI file.  The combos consist
  163.   of the CTRL-B character, which is also ALT-002,  (This should appear in your
  164.   ANSI editor as a shaded smiley face) as well as a alpha code immediately
  165.   after the CTRL-B.  The following is a list of defined alpha codes that will
  166.   work in the BBSList:
  167.  
  168.   B - BBS Name
  169.   N - BBS Number
  170.   S - BBS Speed
  171.   O - BBS SysOp(s)
  172.   A - BBS Software
  173.   C - Networks
  174.   X - Note Line 1
  175.   Y - Note Line 2
  176.   D - Digital BBSList version: "Digital BBSList v1.3" (without the quotes)
  177.  
  178.   example:
  179.     B : N 
  180.     
  181.     would print out the BBS Name followed by a colon then the BBS Number, 
  182.     such as:
  183.  
  184.     Digital Illusions : 410-284-0970
  185.  
  186.   Remember, each one of these must be preceded by a CTRL-B ().  Please look
  187.   at the included BBSLIST.ANS for an example.  A tip would be to draw the
  188.   ANSI screen out, then in animation mode go back and add the CTRL-B(code)
  189.   wherever you want it to be on the screen, in whatever color you choose.
  190.   It is recommended that you keep your ANSI screen at or about 22 lines
  191.   in length, since the Registration prompt will still be outputed on a line,
  192.   as well as the [ Q:uit, #:Goto Number, ] etc, prompt will be outputed
  193.   on the very next line. (Those prompts taking up a total of two lines on
  194.   the bottom of your screen.  For any more help you may need with this
  195.   option, please contact the author at one of the below addresses.
  196.  
  197.  
  198.  ---------------------------------------------------------------------------
  199.  -* Running the Software: *-
  200.  ---------------------------------------------------------------------------
  201.  
  202.     The following command lines options are available:
  203.  
  204.   
  205.   BBSLIST [filename] [port] [/noline] [/?]
  206.  
  207.      [filename] = path and/or filename of CHAIN.* file.
  208.           examples:
  209.               BBSLIST CHAIN.TXT
  210.               BBSLIST C:\WWIV\CHAIN.002
  211.      [port]     = COM Port Number.
  212.           examples:
  213.               BBSLIST 1
  214.               BBSLIST CHAIN.TXT 2
  215.           (For COM Ports 1 and 2, respectively.)
  216.      [/noline]  = No Line Switch; If enabled than the bottom
  217.           status line will not be used.
  218.      [/?]       = Shows this help screen.
  219.  
  220.  
  221. **  Attention SysOps, if your software supports CHAIN.TXT, then read up:
  222.  
  223.     You can optionally run Digital BBSList with a command line argument 
  224.   passing the path and filename to your CHAIN.TXT drop file.  Doing so 
  225.   will enable the user's name in status line.  The following examples 
  226.   demonstrate:
  227.  
  228.   BBSLIST C:\WWIV\CHAIN.TXT
  229.     or
  230.   BBSLIST CHAIN.TXT
  231.     or
  232.   BBSLIST CHAIN.002
  233.     or                          
  234.   BBSLIST %1  (for those who run Digital BBSList as a chain in WWIV).
  235.  
  236.   ** Please remember, that is totally optional!
  237.  
  238.   If you wish to disable the bottom status line use the /NOLINE switch
  239.   from the command line!  Type BBSLIST /? for a list of switches.
  240.  
  241.   All command line options are totally optional.. you can also use multiple
  242.   options on one command line:
  243.  
  244.   BBSLIST C:\WWIV\CHAIN.TXT 1 /NOLINE
  245.     would run the BBSList, read chain.txt, use port 1, no status line
  246.  
  247.   BBSLIST CHAIN.002 3
  248.     would run the BBSList, read chain.002, use port 3, use status line
  249.  
  250.   BBSLIST /NOLINE
  251.     would run the BBSList with no status line, and no com port (cannot 
  252.     download the list)
  253.   
  254.  ---------------------------------------------------------------------------
  255.  -*  DBEdit:  *-
  256.  ---------------------------------------------------------------------------
  257.  
  258.     DBEdit is an external Editor for Digital BBSList for SysOps who want to
  259.  "weed" out "dead" systems.  If several systems that you know of have either
  260.  went down or changed their number, modem speed, etc, you can easily run the
  261.  external editor program to update the BBSList Data file!
  262.  
  263.  ** Please note, this is NOT an online chain, it should be run locally only
  264.  running DBEDIT.EXE remotely WILL lock your system!
  265.  
  266.  ---------------------------------------------------------------------------
  267.  -*  DBAdd:  *-
  268.  ---------------------------------------------------------------------------
  269.  
  270.    DBAdd is a great SysOp utility to add BBSList entries straight from one
  271.  command line!  I highly recommend this util be used for ASV accounts to add
  272.  entries to your BBSList automatically from EVERY Visiting SysOp who calls
  273.  your BBS!  The Syntax is as follows:
  274.  
  275.  DBADD /NAME BBS Name /NUMBER ###-###-#### /SYSOP Alias /SPEED 28800 /SOFTWARE Type
  276.  
  277.  type DBADD /? for help!
  278.  
  279.  ** at this time, networks and the misc note lines are not available using the
  280.  DBAdd program.
  281.  
  282.  (Thanks to Carolina Cowboy for the suggestion!)
  283.  
  284.  ---------------------------------------------------------------------------
  285.  -*  Thanks:  *-
  286.  ---------------------------------------------------------------------------
  287.  
  288.     Thanks to Fireball of the Flamethrower BBS and Asphixia of Epidemic
  289.   for ßeta testing the program for me.  Also, thanks to all my users who
  290.   found those 'undocumented features'. :)  Thanks to Ann for the best times
  291.   of my life. >kiss<
  292.  
  293.  
  294.  ---------------------------------------------------------------------------
  295.  -*  Support:  *-
  296.  ---------------------------------------------------------------------------
  297.  
  298.     For any problems, you can e-mail me at any of the below addresses, or
  299.   see me on my BBS, Digital Illusions 410-284-0970, 28.8 v.34/etc etc.  I
  300.   will ALWAYS have the latest version online and ready for download.  Also,
  301.   see below for the sub-type to join on one of the large WWIV-nets for
  302.   direct chat with myself, and many other users offering suggestions and
  303.   comments on the BBSList!
  304.  
  305.  
  306.  ---------------------------------------------------------------------------
  307.  -*  Author:  *-
  308.  ---------------------------------------------------------------------------
  309.  
  310.     I, Frank Burton III, can be reached via E-Mail at the following addresses:
  311.  
  312.     DigiNet : 1@1    (or Frank@1)
  313.     WWIVnet : 1@8339 (or Frank@8339)
  314.     InterNet: fburton@mail.bcpl.lib.md.us
  315.  
  316.     Digital Illusions
  317.     410-284-0970 - 28.8 - 24/7
  318.  
  319.     Snail Mail:
  320.  
  321.     Frank Burton III
  322.     C/O Digital BBSList
  323.     1539 Merritt Blvd
  324.     BOX #177
  325.     Baltimore, MD  21222
  326.  
  327.     I am open for suggestions as well!
  328.  
  329.     Join the support sub-type DBLST on WWIVnet / DigiNet / TerraNet / More!
  330.     If you run the WWIV Software and are in one of the major WWIV-Nets!
  331.  
  332.   ----------------------------[ end of docs ]------------------------------
  333.        Digital BBSList v1.5  Copyright (c) 1995-1996 by Frank Burton III
  334.   -------------------------------------------------------------------------
  335.  
  336.  
  337.   Dont forget to register!  See REGISTER.FRM for more info!
  338.  
  339.  
  340.  
  341.  
  342.     
  343.