home *** CD-ROM | disk | FTP | other *** search
/ Shareware Overload / ShartewareOverload.cdr / comm / rbbs2.zip / 173B-NEW.DOC next >
Text File  |  1990-10-28  |  8KB  |  197 lines
  1. Supplemental Documentation for RBBS-PC 17.3B
  2. October 28, 1990
  3. By Ken Goosens, Fairfax, Virginia
  4.    Doug Azzarito, Palm Beach Gardens, Florida
  5.  
  6. Contents
  7.  
  8. 1.0  Overview of What's New in 17.3B
  9. 2.0  Acknowledgments
  10. 3.0  What Does "Maintenance Release" Mean?
  11. 4.0  How to Upgrade to 17.3B
  12. 5.0  Details of What's New
  13.    5.1  Operational Differences
  14.    5.2  Problems Still in RBBS-PC
  15. 6.0  The RBBS Committment
  16.  
  17.  
  18. 1.0  Overview of What's New in 17.3B
  19.  
  20. Version 17.3B is a "maintenance release" for RBBS-PC.EXE, version 17.3,
  21. with changes to the code alone from 17.3, that fix problems to make
  22. RBBS-PC work as advertised and run more reliably.
  23.  
  24. The files that are different in 17.3B are:
  25.  
  26. RBBS-EXE.ZIP - Executable programs CONFIG.EXE and RBBS-PC.EXE
  27. RBBS-SMF.ZIP - Smaller and faster version of RBBS-PC.EXE
  28. RBBS-BAS.ZIP - Basic source code
  29. RBBS-MRG.ZIP - Merges to 17.3A/0923 to produce 17.3B source code, as well
  30.                as details on changes.
  31.  
  32. 2.0  Acknowledgments
  33.  
  34. People who contributed code fixes to 17.3B include:
  35.  
  36.     Doug Azzarito
  37.     Ken Goosens
  38.  
  39. However, it is the thousands of SysOps who find bugs, report them, and
  40. suggest enhancements that make the Userware concept work.
  41.  
  42. Without their help, fixing the problems in 17.3 would have been a much
  43. longer and more difficult process.  The fact that people worked on fixing
  44. the code and documentation, with no remuneration, and shared the results
  45. with others, attests both to their generosity and to the wisdom of the
  46. policy of releasing the source code.  RBBS-PC is one of the few products
  47. that accepts no money for the software, releases the full product, and is
  48. "user supported" by volunteers.
  49.  
  50. Many people helped by reporting bugs and beta testing the new version,
  51. and we thank them all collectively.
  52.  
  53.  
  54. 3.0  What Does "Maintenance Release" Mean?
  55.  
  56. A maintenance release means that the changes were made mainly to address
  57. problems in operating RBBS and to eliminate bugs, while minimizing the
  58. probability of introducing new problems.  Maintenance releases
  59. include "merges" to allow upgrading the code from the prior version.
  60.  
  61. Many excellent enhancements were contributed which were not included
  62. in this release, which can be frustrating to their authors.  However,
  63. when the current version has problems, it is generally more important
  64. to make it work properly than to add new features.  Enhancements may be
  65. much more difficult to test and run a significant risk of introducing
  66. new problems, and so their addition was deferred to the next release
  67. (17.4).  For the last 3 and a half years, beta testing of the next
  68. release has begun almost immediately after each new release, and this
  69. pace of development continues unabated with 17.4, with about 3
  70. releases per year.
  71.  
  72. However, the policy of deferring enhancements does not mean that no
  73. enhancements may be added or that only bugs are fixed.  Other types
  74. of changes that may occur in a "maintenance" release are:
  75.  
  76. o   minor changes that affect only a few lines and one type
  77.     of processing, that have a very low probability of introducing
  78.     new problems.
  79.  
  80. Past examples have included shortening strings, making prompts clearer or
  81. more consistent, speeding the code, making a variable name clearer,
  82. consolidating code to reduce the size of the executable program, and adding
  83. "last (backwards)" as a named constant in message selection.  Changes in
  84. 17.3B are exclusively "bug fix" changes that correct minor problems with
  85. certain RBBS-PC functions.
  86.  
  87. 4.0  How to Upgrade from 17.3A
  88.  
  89. SysOps with no customized changes need only
  90.  
  91. o   replace CONFIG.EXE and RBBS-PC.EXE
  92.  
  93. There are no changes to any other system files.   Be sure
  94. to keep a backup of the old version, in case you run into any new
  95. problems.
  96.  
  97. Persons who have the QuickBasic compiler can download the file
  98. RBBS-MRG.ZIP, apply the merges to 17.3A/0923 code, and compile their
  99. own version. Details on this process are inside RBBS-MRG.
  100.  
  101. 5.0  Details of What's New
  102.  
  103. The chronological history of every change made to the code in 17.3B
  104. can be found in file RBBS-MRG.ZIP.
  105.  
  106. The most significant changes in 17.3B are:
  107.  
  108.   (a)  The BULLETIN command could display files other than bulletins:
  109.  
  110.      - If the SysOp instructed RBBS-PC to look for bulletins where
  111.        other non-bulletin files existed, some of these files could be
  112.        wrongly identified as bulletins.
  113.  
  114.        The default directory structure of RBBS-PC is designed to separate
  115.        files into groups.  We strongly suggest all SysOps attempt to
  116.        implement this structure, so files of different types will not
  117.        be grouped together.
  118.  
  119.   (b)  When SNOOP is off, PAGE and AUTOPAGE did not work.
  120.  
  121.      - The "SNOOP OFF" feature is intended to completely deactivate the
  122.        local display, but most SysOps will still want OPERATOR PAGE
  123.        requests to work.  This is now the case.
  124.  
  125. 5.1  Operational Differences
  126.  
  127. Other than SysOp PAGE and AUTOPAGE requests now working even with SNOOP
  128. OFF, RBBS-PC will work exactly as 17.3A.  However, we strongly suggest
  129. you upgrade to 17.3B to avoid any possible problems arising from
  130. non-bulletin files being interpreted as bulletins.
  131.  
  132. 5.2  Problems Still in RBBS-PC
  133.  
  134. Known problems not fixed in 17.3B include:
  135.  
  136. o   SysOp chat with a caller sometimes causes an untrapped error.
  137.  
  138. o   When dooring to external protocols from a subboard, uploads go
  139.     into the MAIN FMS directory rather than the subboard's.
  140.  
  141. o   The user can stay on beyond the time RBBS-PC is supposed to exit to
  142.     an external event.   Happens when user uploads.   Moreover, extra
  143.     time for uploading can let the user stay on even longer.  Also can
  144.     happen when doing personal downloads.
  145.  
  146. o   When shelling to a door, the door cannot write entries to the
  147.     caller's log nor update the user's record, because RBBS-PC will just
  148.     overwrite any changes.
  149.  
  150.  
  151. Contributions fixing these problems are most welcome.
  152.  
  153.  
  154. 6.0  The RBBS Committment
  155.  
  156. Most Bulletin Board Software is dedicated to making money for its
  157. authors.   No matter how much the authors love the work, it endures
  158. only so long as the hope of income continues.
  159.  
  160. RBBS is given away for free, and depends not on the flow of money,
  161. but on the continuing dedication and generosity of people who volunteer
  162. to help support and enhance it as a public service, and share their labor
  163. of love with others for the benefit of all.
  164.  
  165. Our committment, as coordinating authors of RBBS, is to
  166.  
  167. o    fix any problems, on a priority basis
  168.  
  169. o    steadily refine and enhance RBBS to better serve the needs
  170.      of its users
  171.  
  172. o    help support and coordinate contributions, testing, and releases.
  173.  
  174. RBBS should be bug free, period.  If there is any possible problem with
  175. it, we want to know.   And we want people to use RBBS not because it is free,
  176. but because it is the best.   We are proud of the fact that independent
  177. evaluations of bulletin board software continue to rate RBBS as equal to
  178. or better than packages costing up to $1350, and that RBBS pioneers
  179. innovations which are widely copied in other packages, such as free
  180. downloads, macros, turning the pause when the screen is full into a
  181. rich list of natural options with a resumable listing, built-in
  182. data base capabilities, and reading messages from the last backwards as
  183. a constant ("l").
  184.  
  185. Contributions people make to RBBS include improving the documentation,
  186. helping other SysOps, sharing menus, macros, and questionnaires, fixing
  187. bugs in the code, developing new enhancements, helping to beta test, and
  188. writing utilities.   The roster of people who have contributed to
  189. RBBS reads like a who's who in microcomputers, nearly all of whom
  190. got started with the help of someone else.  Many of them have gone
  191. on to other things, but their contribution lives on in RBBS though
  192. the support of volunteers, like you, passing on the help they got in
  193. turn to others.
  194.  
  195.      -Ken Goosens
  196.      -Doug Azzarito
  197.