home *** CD-ROM | disk | FTP | other *** search
/ ftp.wwiv.com / ftp.wwiv.com.zip / ftp.wwiv.com / pub / BBS / NWSMKR20.ZIP / NWSMAKER.DOC < prev    next >
Text File  |  1992-12-13  |  8KB  |  216 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.                                  NewsMaker 2.0
  12.  
  13.                                       For
  14.  
  15.                                     RBBS-PC
  16.  
  17.                        Copyright (C) 1992 By Benny Carr
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29. Legalities
  30. ==========
  31.  
  32. This software and accompanying materials are distributed "AS IS" without
  33. warranty, expressed, implied, or statutory, including but not limited to
  34. any implied warranties of merchantability and fitness for a particular
  35. purpose.  In no event shall anyone involved with the creation and production
  36. of this product be liable for indirect, special, or consequential damages
  37. arising out of any use thereof or breach of any warranty.
  38.  
  39. What this means, plainly put, is that if you choose to run this program
  40. and it eats your system alive, well, I'm real sorry about that, but I can't
  41. be held responsible.  By using this product you are assuming all liability.
  42.  
  43.  
  44. Copyright
  45. =========
  46.  
  47. Yes it is.  This program is Copyrighted and is the property of Benny Carr.
  48. You are being granted a limited license to use it.  You may not disassemble
  49. nor alter this program in any manner.  You may not distribute this package
  50. in conjunction with any other package, either commercial, shareware, or any
  51. other kind of ware, unless requesting and receiving permission from the
  52. author of NewsMaker.
  53.  
  54.  
  55. Registration
  56. ============
  57.  
  58. Naw.  Nope.  None required.  In the spirit of RBBS-PC and other fine
  59. "freebie" packages, there is no charge required to use this program.  If
  60. you wanna use it ... be my guest.  It would be nice to hear from you that
  61. your using it, but if not enjoy it!
  62.  
  63.  
  64. What Did You Get
  65. ================
  66.  
  67.        NWSMAKER.DOC - Hopefully you got this cause your reading it.
  68.        NWSMAKER.CFG - Example Configuration File
  69.        NWSMAKER.EXE - The actual program
  70.        MAIN.CFG     - Sample config file for Main Conference
  71.        APOGEE.CFG   - Sample config file for Apogee Conference
  72.        MAIN1.TXT    - Sample Text file
  73.  
  74.  
  75. What Is It
  76. ==========
  77.  
  78. NewsMaker will read a configuration file and create the 3 flavors (Plain,
  79. ASCII, and ANSI) of News text files for RBBS-PC.  NewsMaker will allow
  80. the SysOp to configure the Header Box color, the color of text within
  81. the box, and the actual news text color.  NewsMaker will work with multiple
  82. configuration files.  This will in turn allow you, the SysOp, to use NewsMaker
  83. to create News files for all of your conferences and sub-boards, and to even
  84. customize the colors for each.
  85.  
  86.  
  87.  
  88. How Do I Use It
  89. ===============
  90.  
  91. The first thing you should do is create a sub-directory to hold the various
  92. files associated with NewsMaker.  Now copy the NWSMAKER.EXE into this new
  93. sub-directory.  Next you'll need at least 1 configuration file.  You can either
  94. copy 1 or both of the supplied sample *.CFG files and modify them to suit your
  95. needs, or build them from scratch.  Below is an explanation of MAIN.CFG.
  96.  
  97. New Woodstk RBBS <----- Your BBS Name
  98. MAIN <----------------- Conference name (Up to 7 characters)
  99. C:\RBBS\TEXT\ <-------- Path/Dir for *.NWS files, with trailing \
  100. MAIN*.TXT <------------ Name of text file to process.  Wildcards ok
  101. {CS <------------------ Clear Screen
  102. {PB <------------------ Page Break
  103. 1;31;40m <------------- Header Box color
  104. 1;33;40m <------------- Color of text within box
  105. 1;36;40m <------------- Color of news text
  106.  
  107.  
  108. Line 1)  Your BBS Name would go here.
  109. Line 2)  This is the name of the conference that the *.NWS files will be      
  110.          produced for.  In other words, if this is MAIN then MAIN.NWS,
  111.          MAING.NWS, and MAINC.NWS will be produced.  If the name in line 2 is 
  112.          APOGEE then APOGEE.NWS, APOGEEG.NWS, and APOGEEC.NWS will be produced. 
  113.          And so on and so forth.
  114. Line 3)  This is the directory where NewsMaker should put the *.NWS files that 
  115.          it makes.  This line include the complete path with the trailing \.
  116. Line 4)  Name of the text files to read.  Wildcards are allowed here.  What I 
  117.          do is create text files for my MAIN conference with names such as    
  118.          MAIN1.TXT, MAIN2.TXT, MAIN3.TXT etc etc etc.  Text files for APOGEE  
  119.          would be APOGEE1.TXT, APOGEE2.TXT etc etc etc.
  120. Line 5)  Clear Screen
  121. Line 6)  Page Break
  122. Line 7)  Color to be used for the header box.  Must be typed exactly as the   
  123.          example is.  NewsMaker will handle the escape stuff but you have to 
  124.          put the little m at the end.
  125. Line 8)  Color to be used for the text within the box.
  126. Line 9)  Color to be used for the News Text.
  127.  
  128.  
  129. Now you should create a text file for NewsMaker to read.  The text file(s)
  130. *MUST* reside in the sub-directory along with NWSMAKER.EXE and the various *.CFG
  131. files.  These files can be created with your favorite text editor.  The very 1st
  132. line of the text file is going to be used by NewsMaker as the title of the news
  133. bulletin, and will be centered automatically by NewsMaker.  The remaining text
  134. will be the actual news you want to display.  NewsMaker works on the "way you
  135. type it is the way you get it" principle.  What the heck does this mean?  Well,
  136. this means that however you type your *.TXT files is the way NewsMaker will
  137. build the text within the *.NWS files.  Any spacing you do will be re-created
  138. within the *.NWS files.
  139.  
  140. You can have many news items by simply creating many *.TXT files.  If you
  141. want to delete one of the news items simply delete the .TXT file that
  142. you no longer need and run NewsMaker again.
  143.  
  144.   * Please note that NewsMaker will sort the various *.TXT files you've
  145.   * created by file date and will need access to DOS's SORT, either by
  146.   * a path statement in your AUTOEXEC.BAT or by placing SORT in the same      
  147.   * directory as NewsMaker.
  148.  
  149.  
  150. At this point typing NWSMAKER along with the name of one of your *.CFG files  
  151. and hitting enter should do it for you.  (EX: NWSMAKER MAIN.CFG or NWSMAKER
  152. APOGEE.CFG or any other one that you may have.)
  153.  
  154.  
  155. Support And New Releases
  156. ========================
  157.  
  158. Support and new releases can be obtained by contacting me in one of the 
  159. ways listed below.
  160.  
  161. Benny Carr    BusiLink Net      10:101/3
  162.               FidoNet           1:273/229
  163.               New Woodstk RBBS  1-215-750-6670
  164.  
  165. I also browse the RBBS-PC Echo so you can find me there.
  166.  
  167.  
  168.  
  169. History
  170. =======
  171.  
  172.    Version 1.0       October 30, 1992.  1st public release
  173.  
  174.    Version 1.1       November 14, 1992.  Bad Bug Killed.  Applied
  175.                      insecticide to a bug that would pop up when
  176.                      using NewsMaker in an environment where SHARE
  177.                      was loaded.  Seems NewsMaker didn't care for it
  178.                      and would continuously write an undefined error
  179.                      to the NWSMAKER.LOG until you either stopped it
  180.                      or you ran out of disk space.  Sorry bout that one
  181.                      gang.  (Thanks to Gary G. for helping out on that
  182.                      one.)
  183.  
  184.    Version 1.2       November 18, 1992.  Bad Bug Killed, finally.
  185.                      Version 1.1 knocked it out but didn't quite kill
  186.                      it.  This time it's dead.
  187.  
  188.    Version 2.0       December 13, 1992.  Cleaned up some little creatures
  189.                      that were lurking about.  Added support for the creation 
  190.                      of *.NWS files for multiple conferences/subboards.
  191.                      Gave it some life, added color.
  192.                      
  193.  
  194. Credits
  195. =======
  196.  
  197. Thanks go to BusiLink (tm) Net and it's members that gave the Beta copies a 
  198. try, and for providing distribution of the Betas.  
  199.  
  200. Thanks go to all that tried a Beta copy along the way.
  201.  
  202. Thanks to the Copyright holders and various authors for RBBS-PC.  If it
  203. wasn't for them this program would serve no real purpose.  :)
  204.  
  205. Thanks go out to those of you out there that are willing to try NewsMaker
  206. and for your input towards any future releases.
  207.  
  208. Thanks go to Gary Glueckert for letting me abuse his drives while looking
  209. for the Big Bad Bug in 1.0 (& 1.1).  Also for his suggestions and thoughts
  210. concerning this program.  And another thanks to him for the fine programs he
  211. himself writes for RBBS-PC.
  212.  
  213. Thanks to my family for letting me play.
  214.  
  215. And, thanks to Ed Harrigan for his constant answers to my constant questions.
  216.