home *** CD-ROM | disk | FTP | other *** search
/ ftp.wwiv.com / ftp.wwiv.com.zip / ftp.wwiv.com / pub / HATCH / DBLST14.ZIP / BBSLIST.DOC < prev    next >
Text File  |  1995-12-22  |  11KB  |  315 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.                   Digital BBSList v1.4
  9.  
  10.              Copyright (c) 1995 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.4 *-
  69.  
  70.             Copyright (c) 1995 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.      * registered version only (up to 10 systems in non-registered version)
  105.        Registration is only $5.00 (us check/money orders only) and disables
  106.        all shareware pauses as well as offering up to 150 systems in list.
  107.  
  108.  
  109.  ---------------------------------------------------------------------------
  110.  -* Setup: *-
  111.  ---------------------------------------------------------------------------
  112.  
  113.      Don't forget you can type BBSLIST /? to see a list of command line
  114.   switches!
  115.  
  116.   1:  To install Digital BBSList, you can either unzip the contents of the 
  117.   DBLSTxxx.ZIP into your main BBS Directory, or you can have it in it's own
  118.   directory.  Make sure a copy of DSZ (DSZ.EXE or DSZ.COM) is in your path.  
  119.   Also the BBSLIST.MNU and BBSLIST.ANS must reside in the same dir as the 
  120.   BBSLIST.EXE.
  121.  
  122.   2:  It will be necessary to shrink your BBS if possible, require ANSi, and
  123.   enable DOS Intercepts.
  124.  
  125.   3:  Installation is complete!  Try adding an entry to the list first to 
  126.   be sure everything is peachy, then let you users have a blast!
  127.  
  128.   4:  Read the below part about how to 'customize' your copy!
  129.  
  130.  
  131.  ---------------------------------------------------------------------------
  132.  -* Customizing: *-
  133.  ---------------------------------------------------------------------------
  134.     
  135.     If you would like to customize your version a little bit, you can edit 
  136.   the BBSLIST.MNU (it's only an ansi file), and change it to whatever you
  137.   wish, and this file is displayed as the main menu in Digital BBSList!
  138.   The actual output of the BBSList is also customizable through an external
  139.   ANSI file as well, edit the file BBSLIST.ANS to whatever you would like
  140.   your BBSList to look like.  Please refer to the PIPE codes section later on
  141.   in the docs for more info.  Starting with v1.3 you can have random BBSLIST
  142.   ANSIs.  To do so, you will need to create a BBSLIST.ANS file, and any other
  143.   BBSLIST Screens you create should be named BBSLIST.1 BBSLIST.2 BBSLIST.3
  144.   etc. without a break in the extension pattern.
  145.  
  146.  
  147.  ---------------------------------------------------------------------------
  148.  -*  PIPE Codes:  *-
  149.  ---------------------------------------------------------------------------
  150.  
  151.     You can modify the look of the BBSList using an external ANSI file called
  152.   BBSLIST.ANS.  This file must exist in order for the BBSList program to run.
  153.   You can edit the ANSI file in any ANSI editor you choose, such as The Draw.
  154.   The use of PIPE codes will offer you the chance to place each listing's info
  155.   (ie, the BBS Name, Number, Speed, etc) anywhere on the screen you wish, as
  156.   well as in any ANSI/DOS color you want.  To use the PIPE codes, you'll have
  157.   to have one of the following combos in your ANSI file.  The combos consist
  158.   of the CTRL-B character, which is also ALT-002,  (This should appear in your
  159.   ANSI editor as a shaded smiley face) as well as a alpha code immediately
  160.   after the CTRL-B.  The following is a list of defined alpha codes that will
  161.   work in the BBSList:
  162.  
  163.   B - BBS Name
  164.   N - BBS Number
  165.   S - BBS Speed
  166.   O - BBS SysOp(s)
  167.   A - BBS Software
  168.   C - Networks
  169.   X - Note Line 1
  170.   Y - Note Line 2
  171.   D - Digital BBSList version: "Digital BBSList v1.3" (without the quotes)
  172.  
  173.   example:
  174.     B : N 
  175.     
  176.     would print out the BBS Name followed by a colon then the BBS Number, 
  177.     such as:
  178.  
  179.     Digital Illusions : 410-284-0970
  180.  
  181.   Remember, each one of these must be preceded by a CTRL-B ().  Please look
  182.   at the included BBSLIST.ANS for an example.  A tip would be to draw the
  183.   ANSI screen out, then in animation mode go back and add the CTRL-B(code)
  184.   wherever you want it to be on the screen, in whatever color you choose.
  185.   It is recommended that you keep your ANSI screen at or about 22 lines
  186.   in length, since the Registration prompt will still be outputed on a line,
  187.   as well as the [ Q:uit, #:Goto Number, ] etc, prompt will be outputed
  188.   on the very next line. (Those prompts taking up a total of two lines on
  189.   the bottom of your screen.  For any more help you may need with this
  190.   option, please contact the author at one of the below addresses.
  191.  
  192.  
  193.  ---------------------------------------------------------------------------
  194.  -* Running the Software: *-
  195.  ---------------------------------------------------------------------------
  196.  
  197.     The following command lines options are available:
  198.  
  199.   
  200.   BBSLIST [filename] [port] [/noline] [/?]
  201.  
  202.      [filename] = path and/or filename of CHAIN.* file.
  203.           examples:
  204.               BBSLIST CHAIN.TXT
  205.               BBSLIST C:\WWIV\CHAIN.002
  206.      [port]     = COM Port Number.
  207.           examples:
  208.               BBSLIST 1
  209.               BBSLIST CHAIN.TXT 2
  210.           (For COM Ports 1 and 2, respectively.)
  211.      [/noline]  = No Line Switch; If enabled than the bottom
  212.           status line will not be used.
  213.      [/?]       = Shows this help screen.
  214.  
  215.  
  216. **  Attention SysOps, if your software supports CHAIN.TXT, then read up:
  217.  
  218.     You can optionally run Digital BBSList with a command line argument 
  219.   passing the path and filename to your CHAIN.TXT drop file.  Doing so 
  220.   will enable the user's name in status line.  The following examples 
  221.   demonstrate:
  222.  
  223.   BBSLIST C:\WWIV\CHAIN.TXT
  224.     or
  225.   BBSLIST CHAIN.TXT
  226.     or
  227.   BBSLIST CHAIN.002
  228.     or                          
  229.   BBSLIST %1  (for those who run Digital BBSList as a chain in WWIV).
  230.  
  231.   ** Please remember, that is totally optional!
  232.  
  233.   If you wish to disable the bottom status line use the /NOLINE switch
  234.   from the command line!  Type BBSLIST /? for a list of switches.
  235.  
  236.   All command line options are totally optional.. you can also use multiple
  237.   options on one command line:
  238.  
  239.   BBSLIST C:\WWIV\CHAIN.TXT 1 /NOLINE
  240.     would run the BBSList, read chain.txt, use port 1, no status line
  241.  
  242.   BBSLIST CHAIN.002 3
  243.     would run the BBSList, read chain.002, use port 3, use status line
  244.  
  245.   BBSLIST /NOLINE
  246.     would run the BBSList with no status line, and no com port (cannot 
  247.     download the list)
  248.   
  249.  ---------------------------------------------------------------------------
  250.  -*  Thanks:  *-
  251.  ---------------------------------------------------------------------------
  252.  
  253.     Thanks to Fireball of the Flamethrower BBS and Asphixia of Epidemic
  254.   for ßeta testing the program for me.  Also, thanks to all my users who
  255.   found those 'undocumented features'. :)  Thanks to Ann for the best times
  256.   of my life. >kiss<
  257.  
  258.  
  259.  ---------------------------------------------------------------------------
  260.  -*  Support:  *-
  261.  ---------------------------------------------------------------------------
  262.  
  263.     For any problems, you can e-mail me at any of the below addresses, or
  264.   see me on my BBS, Digital Illusions 410-284-0970, 28.8 v.34/etc etc.  I
  265.   will ALWAYS have the latest version online and ready for download.  Also,
  266.   see below for the sub-type to join on one of the large WWIV-nets for
  267.   direct chat with myself, and many other users offering suggestions and
  268.   comments on the BBSList!
  269.  
  270.  
  271.  ---------------------------------------------------------------------------
  272.  -*  Author:  *-
  273.  ---------------------------------------------------------------------------
  274.  
  275.     I, Frank Burton III, can be reached via E-Mail at the following addresses:
  276.  
  277.     DigiNet : 1@1    (or Frank@1)
  278.     WWIVnet : 1@8339 (or Frank@8339)
  279.     InterNet: 1-4065@tnet.bluethun.com
  280.            - or -
  281.           fburton@free.org
  282.  
  283.     Digital Illusions
  284.     410-284-0970 - 28.8 - 24/7
  285.  
  286.     Snail Mail:
  287.  
  288.     Frank Burton III
  289.     C/O Digital BBSList
  290.     1539 Merritt Blvd
  291.     BOX #177
  292.     Baltimore, MD  21222
  293.  
  294.     I am open for suggestions as well!
  295.  
  296.     Join the support sub-type DBLST on WWIVnet / DigiNet / TerraNet / More!
  297.     If you run the WWIV Software and are in one of the major WWIV-Nets!
  298.  
  299.     For Information about any Software by me, (Digital Software) you can also
  300.     send email to: 
  301.     
  302.     DIGITAL_SOFTWARE-4065@tnet.bluethun.com
  303.  
  304.   ----------------------------[ end of docs ]------------------------------
  305.      Digital BBSList v1.4  Copyright (c) 1995 by Frank Burton III
  306.   -------------------------------------------------------------------------
  307.  
  308.  
  309.   Dont forget to register!  See REGISTER.FRM for more info!
  310.  
  311.  
  312.  
  313.  
  314.     
  315.