home *** CD-ROM | disk | FTP | other *** search
/ ftp.wwiv.com / ftp.wwiv.com.zip / ftp.wwiv.com / pub / MISC / FBULL20.ZIP / FBULL.DOC < prev    next >
Text File  |  1997-09-07  |  10KB  |  220 lines
  1. ────────────────────────────────────────────────────────────────────────────
  2.  
  3.                             Fake Bulletin v2.0
  4.                                by SaltySoft
  5.  
  6.                     Copyright (C) 1997 David Kiesling
  7.                            All rights reserved.
  8.  
  9.  
  10.                                Support BBS:
  11.                  Shoe Salt BBS  707-465-3087  33.6 kbps
  12.  
  13.                               World Wide Web:
  14.                       http://www.vpdev.com/saltysoft
  15.  
  16.                                          SaltySoft Software
  17.            Internet Email:               c/o David Kiesling
  18.        dnskiesling@telis.org             550 Sandhill Rd.
  19.                                          Crescent City, CA 95531 USA
  20. ────────────────────────────────────────────────────────────────────────────
  21.  
  22.  
  23.  
  24. Table of Contents
  25.  
  26.      I. Introduction
  27.     II. Setup
  28.    III. Samples & Examples
  29.     IV. Support
  30.      V. Attention Programmers!
  31.     VI. Author's Notes
  32.  
  33.  
  34. ------------------------------ Disclaimer ------------------------------
  35.  
  36.  The author of this program and his affiliates cannot be held legally
  37.  responsible for any damage caused as a result of the use or misuse of
  38.  this program, nor for the precious bytes it takes up on your HD.
  39.  
  40. ------------------------------------------------------------------------
  41. -------------------------- License Agreement ---------------------------
  42.  
  43.  This program is distributed under the freeware concept. You are granted
  44.  a license to use and distribute this .ZIP archive as you wish. However,
  45.  the contents of the compressed .ZIP archive or the uncompressed EXE file
  46.  may NOT be modified in any respect by anyone other than the author.
  47.  
  48. ------------------------------------------------------------------------
  49.  
  50. -=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
  51.  I.  Introduction
  52. -=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
  53.  
  54.  Requirements:  * BBS that can call a batch file to run a door
  55.                 * 8086 or higher processor (I know, I'm pushing it!)
  56.  
  57.  Some BBS software doesn't give the option of simply displaying an ANSI
  58.  or ASCII file as a menu selection on any BBS menu, save for the
  59.  bulletin menu. That's where Fake Bulletin comes in. This is a simple
  60.  door that simply displays an ANSI or ASCII file (a bulletin). Simple,
  61.  eh? It's useful as:
  62.  
  63.    -* a Help option at various BBS menus for novice BBS users
  64.    -* a notice you want users to read before or after using a
  65.       particular door (simple instructions further below)
  66.    -* a notice put in place of a door saying that the door is
  67.       temporarily offline
  68.  
  69.  
  70. -=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
  71.  II.  Setup
  72. -=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
  73.  
  74.  Fake Bulletin is run with the following syntax:
  75.  
  76.        fbull.exe <config file>
  77.  ex:   fbull.exe fbull.cfg
  78.  
  79.      The files don't need to be named fbull.cfg and fbull.lst. The
  80.      filenames can be anything you like; just remember to pass them
  81.      on the command line as shown above.
  82.  
  83.      You will need to have one Config File for each node and a Bulletin
  84.      List File for each separate spot on your BBS you run Fake
  85.      Bulletin. Below are the file layouts.
  86.  
  87.  Layout of Config File:
  88.  ----------------------
  89.  
  90.   LINE 1: C:\TRIBBS\DOOR.SYS    <- Full path to DOOR.SYS file
  91.   LINE 2: 0                     <- Non-standard IRQ for the comport.
  92.                                    0 = use the standard IRQ for the port
  93.   LINE 3: 30                    <- Maximum minutes allowed in door.
  94.                                    0 = read minutes left from dropfile
  95.   LINE 4: 5                     <- Keyboard input timeout in minutes. If
  96.                                    user hasn't press a key in this amount
  97.                                    of time, Fake Bulletin will terminate.
  98.                                    0 = disable this feature
  99.   LINE 5: notice                <- ANSI or ASCII file you want displayed
  100.                                    when the user selects to view that
  101.                                    bulletin. Do not include the file's
  102.                                    extension here. Fake Bulletin will
  103.                                    automatically add a ".ans" or ".bbs"
  104.                                    extension on the end of the filename,
  105.                                    depending on if the caller has ANSI
  106.                                    enabled or not. So putting "notice"
  107.                                    here would display notice.ans if ANSI
  108.                                    is on or notice.bbs if not.
  109.   LINE 6: 1                     <- Would you like the screen to prompt
  110.                                    every 23 lines of the bulletin for
  111.                                    the user to press a key? If not, the
  112.                                    top part of the bulletin will fly by
  113.                                    without giving the user a chance to
  114.                                    read it. If the bulletin is less than
  115.                                    23 lines, this setting is ignored.
  116.                                    1 = enable prompt every 23 lines
  117.                                    0 = disable prompt every 23 lines
  118.  
  119.    Fbull.cfg contained in this archive is a sample config file
  120.    and contains short notes reminding you what each line is for.
  121.  
  122.  
  123. -=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
  124.  III. Samples & Examples
  125. -=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
  126.  
  127.  *  Sample ANSI & ASCII files are included. You by no means have to use
  128.     them; feel free to make your own. These are only examples to give
  129.     you an idea of what to use this program for. The following files
  130.     are contained in SAMPLES.ZIP:
  131.  
  132.      MESSHELP.ANS & MESSHELP.BBS - Help on Message Menu functions (TriBBS)
  133.      FILEHELP.ANS & FILEHELP.BBS - Help on File Menu functions (TriBBS)
  134.      ZIPHELP.ANS  & ZIPHELP.BBS  - Explanation of ZIP files
  135.      BETA.ANS     & BETA.BBS     - Notice that the door "Planets" is
  136.                                    in beta and how to report bugs
  137.      OFFLINE.ANS  & OFFLINE.BBS  - Notice that a door is temporarily
  138.                                    offline
  139.      LORD2REG.ANS & LORD2REG.BBS - Announcement pleading users to
  140.                                    help the SysOp register LORD II
  141.  
  142.  *  To display a bulletin to a user right before/after a particular
  143.     door is run -
  144.  
  145.       Pretend this is a door's batch file:
  146.  
  147.         cd\tribbs\doors\tws   (change to door directory)
  148.         tw2002.exe            (run door)
  149.         cd\tribbs             (change back to BBS directory)
  150.         board                 (reload BBS)
  151.  
  152.       To display the bulletin right BEFORE the door is run, insert
  153.       the two lines with arrows below: (of course omit the comments
  154.       when making your batch file)
  155.  
  156.       -> cd\tribbs\fbull                (change to Fake Bulletin directory)
  157.       -> fbull.exe fbull.cfg fbull.lst  (run Fake Bulletin)
  158.          cd\tribbs\doors\tws            
  159.          tw2002.exe
  160.          cd\tribbs
  161.          board
  162.  
  163.       To display the bulletin right AFTER the door is run, insert
  164.       the two lines commented below: (of course omit those comments
  165.       when making your batch file)
  166.  
  167.          cd\tribbs\doors\tws
  168.          tw2002.exe
  169.       -> cd\tribbs\fbull               (change to Fake Bulletin directory)
  170.       -> fbull.exe fbull.cfg fbull.lst (run Fake Bulletin)
  171.          cd\tribbs
  172.          board
  173.  
  174.  
  175. -=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
  176.  IV. Support
  177. -=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
  178.  
  179.  Please contact me in any of the ways mentioned at the beginning of
  180.  this file for support. I'd love to hear any and all comments,
  181.  questions, or suggestions. There is always room for improvement. :)
  182.  
  183.  
  184. -=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
  185.  V. Attention Programmers!
  186. -=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
  187.  
  188.  Are you a programmer?
  189.  The new owner (as of 01/01/97) of TriBBS, Gary Price, has made a
  190.  new API for PowerBASIC for easier creation of programs that access
  191.  TriBBS's data files. I've used it for recent TriBBS utilities I've
  192.  made. It's completely FREE for anyone that wants it and I highly
  193.  recommend it. It is strictly for PowerBASIC 3.2. You may contact
  194.  Gary Price:
  195.  
  196.  by email - gwprice@worldnet.att.net
  197.  by BBS   - Freejack's Place (Home of TriBBS) 207-739-7121
  198.  by web   - http://www.tribbs.com
  199.  
  200.  PowerBASIC is a programming language which is quickly rising in
  201.  popularity, containing elements of both C and Pascal and even some
  202.  built-in Assembly. Although 99% compatible with QuickBasic 4.5, it's
  203.  far more advanced. It sells for $150 but a free demo may be picked
  204.  up from their web site at http://www.powerbasic.com
  205.  
  206.  
  207. -=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
  208.  VI. Author's Notes
  209. -=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
  210.  
  211.  Being a sysop, I've been looking for a door that will display ANY
  212.  ANSI/ASCII file, with no big tacky copyright notices. Failing to find
  213.  one that suited my tastes, I've finally made my own, and here it is.
  214.  I hope it does the job for you too.
  215.  
  216.  Special thanks to the Fake Bulletin beta testers:
  217.  
  218.      Luke Gabello     - many suggestions
  219.      Chris Richardson - a few suggestions
  220.