home *** CD-ROM | disk | FTP | other *** search
/ Beijing Paradise BBS Backup / PARADISE.ISO / software / BBSDOORW / ANNCEV22.ZIP / ANNOUNCE.DOC < prev    next >
Text File  |  1996-03-25  |  9KB  |  255 lines
  1.  
  2.                                  ANNOUNCE!   
  3.                                 Version 2.2 
  4.  
  5.                       (C)Copyright 1995 Lounge Software
  6.                            An announcement utility 
  7.                              Written by Jim Webb
  8.                              
  9.  
  10.                                 Support board:
  11.  
  12.                               Zippy's Lounge BBS 
  13.                              
  14.                                (403) 475-8703
  15.                               Edmonton, Alberta
  16.                                    Canada
  17.                                Fido 1:342/1020
  18.  
  19.  
  20.  
  21.  
  22. WARRANTY:
  23. ---------
  24.  
  25. This product is provided "as is" without warranty of any kind. The entire
  26. risk as to the results and performance of the program is assumed by you.
  27. Futhermore, the author does not warrant, guarantee, or make any other
  28. representations regarding the use of, or the results of the use of the
  29. program, and you rely on the program and results solely at your own
  30. risk. The author cannot and will not accept responsibility for system
  31. damage, loss of profit, or any other special, consequential or incidental 
  32. damages resulting from the use or inability to use this product.
  33.  
  34. USAGE:
  35. ------
  36.  
  37. This product is being distributed as Shareware. Under this concept you 
  38. may use the SHAREWARE (unregistered) version for a reasonable period of 
  39. time for evaluation after which you should either register your copy 
  40. or discontinue usage.
  41.  
  42.  
  43. DISTRIBUTION:
  44. -------------
  45.  
  46. You are encouraged to distribute ANNOUNCE! provided that all 
  47. files contained in the archive are distributed in their original and
  48. unmodified state.
  49.  
  50.  
  51. DESCRIPTION:
  52. ------------    
  53.  
  54. ANNOUNCE! is a BBS announcement utility program that can be used on ANY BBS 
  55. which creates a DOOR.SYS file(52 line version).  For the BBS that always has
  56. too much to inform the users about.  Instead of having logon screen after
  57. logon screen that most users get tired of seeing or low baud users get tired
  58. of waiting for, you can use ANNOUNCE! for various announcements that you
  59. want your users to know about.  Door Game Resets, User Meets...etc.  
  60. ANNOUNCE! is a MUST HAVE utility for any busy BBS!
  61.  
  62.  
  63. REGISTRATION INFORMATION:
  64. -------------------------
  65.  
  66. There are a couple of ways in which you can Register ANNOUNCE! and
  67. recieve your individual key file, which will allow the program to operate in
  68. FULL Registered mode.  Look for details on how to do this in the file:
  69. REGISTER.FRM included with this archive.
  70.  
  71.  
  72. SHAREWARE VS REGISTERED:
  73. ------------------------
  74.  
  75. The SHAREWARE version of ANNOUNCE! has no limitations or is not 
  76. crippled in any way, other than a pause going into the program and out of                             
  77. the program.  This pause is disabled once you have Registered your copy
  78. and you recieve your individual key file.  This is not in place to be
  79. annoying, just to encourage Registration of the product to cover the cost
  80. of programming time and support.  Future versions, updates, and support
  81. of ANNOUNCE! are yours FREE with Registration.
  82.                               
  83.                               
  84. INSTALLATION:                              
  85. -------------
  86.  
  87. Installation of ANNOUNCE! is very simple.  The first thing you 
  88. should do is unzip the entire archive into whichever directory you plan
  89. to operate ANNOUNCE! from.  
  90.  
  91. Then edit the sample configuration file (announce.cfg) that came with the 
  92. archive.  This .cfg file MUST keep the same name announce.cfg!  
  93. An explanation of this file is included next. This file resides in the same
  94. directory you have the rest of the archive in: 
  95.  
  96.    
  97.                               CONFIGURATION FILE
  98.                               ==================
  99.  
  100. The format of the configuration file used with ANNOUNCE! is:
  101.  
  102. C:\BBS\DOOR.SYS                 <- FULL path to your DOOR.SYS file
  103. Zippy's Lounge                  <- BBS name
  104. Jim                             <- Sysop's first name
  105. Webb                            <- Sysop's last name
  106. 1000                            <- Security Level needed to add & delete
  107.                                    announcements!
  108.  
  109. Your announce.cfg file MUST contain 5 lines.  Line 5 is the security level
  110. needed to add & delete announcements.  Anyone with a level equal to or more
  111. than this line will be able to use these features.  You can set this so you
  112. as Sysop and your Co-Sysop(s) will be able to see and use these features.
  113. Initially, line 5 in the sample announce.cfg file is set to 0.  This is done
  114. so if you want to test ANNOUNCE! locally at the Dos Prompt, you will be able
  115. to use these features.  ANNOUNCE! reads back a security level of 0 when run
  116. in local mode at the Dos Prompt.  Be sure to set this line before you put
  117. ANNOUNCE! on your BBS or EVERYONE will be able to add & delete announcements!
  118.  
  119.  
  120. That's it!  Now you're ready to run ANNOUNCE! on your BBS!
  121.  
  122.      **************************IMPORTANT*************************
  123.                 MAKE SURE TO READ ON TO (UP AND RUNNING)
  124.                         LATER IN THIS DOCUMENT
  125.  
  126.  
  127. RUNNING THE PROGRAM:
  128. --------------------
  129.  
  130. This part is basically up to you.  Depending on which BBS program you are 
  131. running, the .bat file may look a little different.  Refer to your BBS
  132. Manual for information on running Doors from your BBS.  We will use a
  133. sample .bat file which would run ANNOUNCE! from a Wildcat System:
  134.  
  135. DOOR10.BAT
  136. ==========
  137.  
  138. CD\DOORS\ANNOUNCE
  139. ANNOUNCE ANNOUNCE.CFG
  140. CD\WC30
  141.  
  142.  
  143. If you would like to test ANNOUNCE! before putting it up on the BBS,
  144. you can run it locally at any time by typing LOCAL after the call line:
  145.  
  146. EX: ANNOUNCE ANNOUNCE.CFG LOCAL
  147.  
  148.  
  149.  
  150. FOSSIL DRIVER SUPPORT:
  151. ----------------------
  152.  
  153. ANNOUNCE! also supports the use of Fossil drivers.  To tell it to use the
  154. Fossil driver instead of the standard COM ports, just put /FD on the command
  155. line when running the door. For example:
  156.      
  157.      ANNOUNCE ANNOUNCE.CFG /FD
  158.  
  159. indicates that a Fossil driver is present and should be used. If no Fossil
  160. driver is detected, ANNOUNCE! will print a message to that effect 
  161. and exit back to the BBS gracefully.
  162.  
  163.  
  164. ENVIRONMENT VARIABLES:
  165. ----------------------
  166.  
  167. ANNOUNCE! supports COM 1-4 on the standard IRQ's - COM1/COM3 = IRQ4 
  168. and COM2/COM4 = IRQ3. If you wish to use a non-standard IRQ, add the IRQ
  169. number after the configuration filename. Let's assume you want to use COM1 
  170. and IRQ5. The command line passed in the .CFG file would be:
  171.     
  172.     ANNOUNCE ANNOUNCE.CFG /5  or
  173.     ANNOUNCE ANNOUNCE.CFG /%IRQ%  for the environment variable.
  174.  
  175. The /5 tells ANNOUNCE! to use IRQ5 rather than the standard IRQ4 that
  176. is normally used with COM1. No /x parameter is needed for the standard IRQ's.
  177.  
  178.  
  179. ****UP AND RUNNING:****
  180.     ---------------
  181.  
  182. When ANNOUNCE is up and running and ready to go log onto the BBS and go 
  183. intp the door.  ANNOUNCE! will match your security level with that of line
  184. 5 in the announce.cfg file.  You will then be shown the special meanu that
  185. allows you to add and delete announcements.
  186.  
  187. When adding announcements, you will be allowed to choose a background color
  188. for your announcement and a foreground color for your text.  The overall
  189. screen is the brick wall which is used in every announcement.  By being 
  190. able to change background & forground colors, you will be able to give each
  191. announcement a look of its own.  The date of each announcement is also
  192. displayed.
  193.  
  194. Once you have entered in your announcement information, ANNOUNCE! will create
  195. a file called [announce.dat].  Each announcement and its information is 
  196. listed line by line in this ascii file.  At any point and time you can delete
  197. this file to clear ALL announcements.  While online you will also be able to
  198. delete individual announcements as they become old or outdated.  When you
  199. select [V]iew Announcements from the Main Menu along with the prompt
  200. [N]ext Announcement & [Q]uit, you will also be shown [D]elete Announcement.
  201. Use this command to delete each announcement as you see fit.  You may also
  202. delete ALL of the announcements one by one.  This will clear all announcements
  203. and [V]iew Announcements will tell you and the user that "No Announcements
  204. have been made".
  205.  
  206. And that's it....enjoy ANNOUNCE!
  207.  
  208.  
  209. 486DX CPU's:
  210. ------------
  211.  
  212. The math coprocessor in 486DX CPUs cannot handle floating point math which
  213. all MicroSoft Basic's use. This can show up as an ERROR 5, a keyboard 
  214. timeout, etc.
  215.  
  216. Fortunately there is an easy fix for this problem. Simply place the following
  217. line in your AUTOEXEC.BAT file:
  218.  
  219. SET NO87=ON
  220.  
  221.  
  222. ERRORS & PROBLEMS:
  223. ------------------
  224.  
  225. If you encounter any problems while the door is running, it will generate a 
  226. file called "dframe.err" and list the error in there.  I have included the
  227. error codes and some additional information on fixing them in the file
  228. "error.qb" included with this archive.
  229.  
  230.  
  231.  
  232.  
  233. SPECIAL THANKS TO:
  234. ------------------
  235.  
  236. My wife Lynn for her continued support & assistance.  Without out her I would
  237. be a babbling idiot and the computer would be in a million pieces!
  238.  
  239.  
  240. PRODUCT SUPPORT & UPGRADES:
  241. ---------------------------
  242.  
  243. You can recieve support and newer versions of ANNOUNCE! as they come
  244. out, by calling:
  245.  
  246. Zippy's Lounge BBS
  247.  
  248. (403) 475-8703
  249.  
  250. Edmonton, Alberta
  251. Canada
  252.  
  253. Or you can FREQ a listing of the newest versions of ALL Lounge Sofwtare from
  254. our Fido Address 1:342/1020.  FREQ: NEWDOORS.LST.
  255.