home *** CD-ROM | disk | FTP | other *** search
/ Black Box 4 / BlackBox.cdr / bbsfiles / bm_v11.arj / BLTMSTR.DOC next >
Encoding:
Text File  |  1992-05-12  |  9.8 KB  |  255 lines
  1.                           Manual for BulletMaster
  2.  
  3.                                     v1.1
  4.  
  5.                        Copyright 1992 David C. Higley
  6.  
  7.  
  8.                                 LEGAL STUFF
  9.  
  10. BulletMaster v1.1 is being distributed as SHAREWARE!  It is not FREEWARE
  11. and is the sole property of David C. Higley.  You can use BulletMaster for
  12. a test period not to exceed 30 days to see if the software suits your needs
  13. and is worth registering.  At the end of this 30 day trial period, you must
  14. either register BulletMaster or stop using it and remove all bulletins
  15. generated by BulletMaster from your system.
  16.  
  17. Although I have tested this software and use it myself, I can make no
  18. guarantees as to it's fitness or it's compatibility with your system or
  19. software.  Under no circumstances will David C. Higley accept any
  20. responsibility for any damage to any software or hardware, whether direct
  21. or indirect, resulting from the use of this software.  USE AT YOUR OWN
  22. RISK!!!
  23.  
  24. The software and all documentation contained in this package are
  25. copyrighted property of David C. Higley.
  26.  
  27. You may distribute this package on your BBS as long as there is no fee
  28. directly related to downloading this package.  This includes any transfer
  29. fees, disk fees, copy fees and the like.  It does not include those BBS's
  30. that have a "subscription" for the entire BBS.
  31.  
  32.  
  33.                                   OVERVIEW
  34.  
  35. Now that all that funderfull stuff is over, lets get to it......
  36.  
  37. BulletMaster is a program designed to put out bulletins in as little time
  38. as possible and with as little trouble as possible.  I was constantly
  39. putting off updating bulletins because I didn't want to load the old one
  40. into the ANSI editor, make the changes, correct any boarder malformations,
  41. save that, then change all the colors to the mono version, save that then
  42. do the ASCII one as well.  Sound familiar???
  43.  
  44. With BulletMaster, this tiresome and boring duty of the ever enduring SysOp
  45. has been made VERY SIMPLE.  Now, all you need is an ASCII text editor and
  46. BulletMaster, the rest is history.
  47.  
  48. Some of the features of BulletMaster are as follows :
  49.  
  50. Will convert any ASCII text file (INCLUDING GRAPHICS!!) that has CR/LF
  51. terminated lines (as apposed to LF/CR) into an attractive ANSI color, ANSI
  52. mono and ASCII bulletin file
  53.  
  54. Has date and time of bulletin creation included in the bulletins header
  55.  
  56. Has BBS name in the bulletins header
  57.  
  58. Has the SysOp's name and BBS as a signature
  59.  
  60. Has 4 different types of boarders :  Double line   ╔ ╗
  61.                                      Single line   ┌ ┐
  62.                                      Double top/
  63.                                      Single side   ╒ ╕
  64.                                      Single top/
  65.                                      Double side   ╓ ╖
  66.  
  67. Can be configured to randomize the boarders between the 4 available
  68.  
  69. SysOp definable colors for the ANSI color bulletin background, text,
  70. highlighted and boarder
  71.  
  72. Bulletins can be generated from the command line.
  73.  
  74.  
  75.                                 INSTALLATION
  76.  
  77. To install BulletMaster, uncompress the BULLETU.EXE into your bulletin
  78. directory.  Your pretty much installed now<G>!
  79.  
  80.                           CONFIGURING BulletMaster
  81.  
  82. Configuring BulletMaster is almost as easy as installing it.  A little more
  83. typing is required, but I'm sure that you can struggle thru it.
  84.  
  85. BulletMaster gets most of it's parameters from a configuration file.  This
  86. file is BULLET.CFG and MUST BE NAMED BULLET.CFG.  BULLET.CFG is just a
  87. standard text file with CR/LF terminated lines.  The format of the
  88. configuration file is as follows :
  89.  
  90. Background color (0-7)
  91. Boarder color (0-15)
  92. Text color (0-15)
  93. Highlight color (0-15)
  94. ANSI bulletin extension (must include .)
  95. MONO bulletin extension (must include .)
  96. ASCII bulletin extension (must include .)
  97. Boarder type (0-4)
  98. BBS Name
  99. SysOp name
  100. Scroll stop, page stop, more prompt, whatever you want to call it
  101.  
  102. The colors are entered as a number on thier own line.  The colors and
  103. numbers are as follows :
  104.  
  105. black                    0
  106. blue                     1
  107. green                    2
  108. cyan                     3
  109. red                      4
  110. magenta                  5
  111. brown                    6
  112. light gray               7
  113. dark gray                8
  114. light blue               9
  115. light green              10
  116. light cyan               11
  117. light red                12
  118. light magenta            13
  119. yellow                   14
  120. white                    15
  121.  
  122. The bulletin extensions are the extension of the bulletins that are
  123. displayed for that particular graphics display.  You must include the
  124. period in front of the extension.  EX.  wrong - ANS right - .ANS
  125.  
  126. The boarder types are a single number entered on a line by itself.  The
  127. boarder types are as follows :
  128.  
  129. 0 - random boarder generation
  130. 1 - double line
  131. 2 - single line
  132. 3 - double lines horizontally, single lines vertically
  133. 4 - single lines horizontally, double lines vertically
  134.  
  135. The BBS name is exactly what it says.  It will be displayed as entered.
  136.  
  137. The SysOp's name is also exactly what it says and will be displayed as
  138. entered.
  139.  
  140. The More Prompt is the character or set of characters that your system uses
  141. to put up a More prompt when the end of the bulletin has been reached and
  142. you are in the middle of a page.  This will prevent the bulletin from
  143. clearing to soon if that is a problem.
  144.  
  145. All of these lines MUST BE FILLED IN.  If not, an error will occur.
  146.  
  147.                             RUNNING BulletMaster
  148.  
  149. Running BulletMaster is fairly simple.  The way I run it is as follows.
  150.  
  151. Place the BULLET.EXE and the BULLET.CFG in your bulletin directory.  While
  152. in the bulletin directory, invoke your favorite text editor and type in the
  153. bulletin as you wish it to be displayed.
  154.  
  155. IMPORTANT!!!!  Format the text file so that the right margin is no more
  156. than 74, I use 72 and it works fine..
  157.  
  158. Once you have the text file worded right and spell checked, save it as the
  159. name of the bulletin you are going to generate, but leave off the
  160. extension.  If I am going to generate BULLET1.XXX, I make the text file
  161. BULLET1.  Once you are happy with the text file, run BULLET.
  162.  
  163. When BulletMaster comes up, it will ask you for the name of the text file
  164. that you want to make into a bulletin.  Type in that name (exactly as it is
  165. named on disk).  Then it will ask for the bullet name that you wish to
  166. create.  Type that in (just the filename, NO EXTENSION).  Then it will ask
  167. if you wish to place a "pause" at the end of the bulletin.  This is for
  168. those bulletins that are longer than one page and you want the more prompt,
  169. or whatever, to display at the end.  Just answer that "Y" or "N" for yes or
  170. no.  Next it will ask you if the information given is correct.  If it is
  171. correct, answer "Y", if not, "N".  If it is correct and you answer "Y",
  172. then it will check for the text file.  If it is not present, it terminates.
  173. If it is present, it checks for the bulletins that you want to generate.
  174. If they are present, it will ask you if you want to overwrite them.  If
  175. "Y", it will continue and make the bulletins, if "N", it will terminate.
  176.  
  177. That's pretty much it.  You now have the original text file and 3 new
  178. bulletins.  Keep the text files, they make changing the bulletins allot
  179. easier.  For example, if you have a subscription fee or membership bulletin
  180. and the fee changes.  It is allot easier to load up the text file into your
  181. text editor and change it there, then rerun BulletMaster than to start it
  182. over.
  183.  
  184.  
  185.                           REGISTERING BulletMaster
  186.  
  187. Registering BulletMaster has the following advantages :
  188.  
  189. The 5 second delay and the press key to continue goes away
  190.  
  191. The UNREGISTERED at the bottom of all the bulletins goes away
  192.  
  193. Your BBS name will appear on the opening screen instead of the UNREGISTERED
  194.  
  195. Permanent registration to The Next Generation BBS
  196.  
  197. The satisfaction of knowing that you did the right thing
  198.  
  199. A trip to McDonald's named after you!
  200.  
  201. To register BulletMaster, fill out the registration form contained in the
  202. package and send it, along with a check or money order for $5.00US, to :
  203.  
  204. David C. Higley
  205. 509 West 41st Street
  206. Ashtabula, Ohio 44004
  207.  
  208. When I receive your registration form and fee, I will create a user account
  209. for you on The Next Generation BBS.  When the check clears, I will leave a
  210. message to you telling you how to download your registered copy of
  211. BulletMaster.
  212.  
  213. If you wish me to mail your copy, please include $5.00US additional for the
  214. disk, shipping and handling.
  215.  
  216.  
  217.  
  218.                               PACKAGE CONTENTS
  219.  
  220. The BulletMaster distribution package contains the following files :
  221.  
  222. BULLETU .EXE  -  The BulletMaster executable
  223. BULLET  .CFG  -  The configuration file I used for the example bulletin
  224. BLTMSTR .DOC  -  Your reading it
  225. BULLETIN.ANS  -  Example ANSI color bulletin
  226. BULLETIN.ANC  -  Example ANSI mono bulletin
  227. BULLETIN.     -  Example text file for example bulletins
  228. BULLETIN.ASC  -  Example ASCII bulletin
  229. REGISTER.FRM  -  Registration form
  230. PRODUCT .LST  -  Software available from David C. Higley
  231. HISTORY .DOC  -  Things that are new and improved since last version
  232. REDO    .BAT  -  Example batch file to make generating mass bulletins
  233.                  easier.
  234. These are the ONLY authorized files.  NO ADVERTISEMENTS ARE AUTHORIZED TO
  235. BE DISTRIBUTED WITH THIS PACKAGE.  I did the work for this and I don't want
  236. others adding there names to MY WORK!!
  237.  
  238.  
  239.  
  240.                                   SUPPORT
  241.  
  242. If you have any complains, suggestions or comments or need to reach me for
  243. anything, I may be reached by the following :
  244.  
  245. The Next Generation BBS (Support Board)
  246. 216-992-8099
  247.  
  248. RelayNet
  249.   Programmers or Shareware Forums.
  250. Intelec Network
  251.   Programmers, Turbo Pascal or Shareware Conferences.
  252.  
  253. Leave Messages addressed to David Higley.  I will reply as soon as possible
  254. to any messages recieved.
  255.