home *** CD-ROM | disk | FTP | other *** search
/ Monster Disc 2: The Best of 1992 / MONSTER1.ISO / bbs / rbbs / rfix0704.zip / RFIX.DOC < prev    next >
Text File  |  1992-06-24  |  4KB  |  97 lines
  1. Documentation for Applying Fixes to RBBS
  2. by Ken Goosens, 6-24-92
  3.  
  4. Fixes to RBBS-PC are distributed in a file RFIXmmdd.ZIP.
  5. These are modifications to existing files.  In the case of Basic
  6. source code fixed, they are distributed as merges.  In other
  7. cases, such as .HLP files, a replacement file is given.
  8. Simply copy the replacement files over the original.
  9.  
  10. Details documenting the fixes are in file BULLET6.  The name comes
  11. from the tradition of distributing fixes as a bulletin in RBBS-PC.
  12.  
  13.                   How to Apply Merges
  14.  
  15. Merges can be applied "by hand".  Meaning you go in with an editor,
  16. and replace the sections of code with the new one.   This is necessary
  17. if you are running with unofficial modifications to the code.
  18.  
  19. You cannot use the editor built into Basic, because the RBBS files are
  20. too large to hold in memory with the program.   Good external editors
  21. are SLED, Program Editor, and Personal Editor.
  22.  
  23. Hand applying merges is error prone.   A better way to apply the
  24. merges is to use BLED (Batch Line Editor), available as BLED22.ZIP.
  25. BLED will apply the merges to the current release and produce new
  26. code for recompiling.
  27.  
  28. Merges come in the format:
  29.  
  30.  filename      apply to
  31. ------------   ------------
  32. R-PCmmdd.MRG   RBBS-PC.BAS
  33. RSB1mmdd.MRG   RBBSSUB1.BAS 
  34. RSB2mmdd.MRG   RBBSSUB2.BAS
  35. RSB3mmdd.MRG   RBBSSUB3.BAS
  36. RSB4mmdd.MRG   RBBSSUB4.BAS
  37. RSB5mmdd.MRG   RBBSSUB5.BAS
  38. CNFGmmdd.MRG   CONFIG.BAS
  39. CSUBmmdd.MRG   CNFG-SUB.BAS
  40.  
  41.  filename      replaces
  42. ------------   ------------
  43. RVARmmdd.MRG   RBBS-VAR.BAS
  44. CVARmmdd.MRG   CNFG-VAR.BAS
  45.  
  46. A batch file for applying merges is supplied called MERGE.BAT.
  47. To set it up,
  48.  
  49.    o   put your original source code in a subdirectory, say C:\174
  50.  
  51.    o   put the files in RFIXmmdd.ZIP into another subdirectory where
  52.        you will recompile, say C:\SOURCE.  Make this your current
  53.        directory.
  54.  
  55.    o   edit MERGE.BAT to reflect where you put the original source
  56.        and merges.
  57.  
  58.    o   invoke the batch file with the mmdd on the command line, i.e.
  59.        "merge mmdd", e.g. "merge 0624".   This will update your -VAR
  60.        files and produce new code by applying the merges.
  61.  
  62.                           How to Recompile
  63.  
  64. o    Obtain a suitable Basic compiler.
  65.  
  66. QuickBasic ($70) or Professional Basic ($300) from Microsoft.
  67.  
  68. o    Obtain the assembler .OBJ files.
  69.  
  70. These are in the RBBS distribution file RBBS-ASM.ZIP.
  71.  
  72. Assuming you have the revised code ready to recompile,
  73.  
  74. o    Recompile to produced new executables (RBBS-PC.EXE or CONFIG.EXE)
  75.  
  76. You cannot compile the source code an loading it into the interactive
  77. environment.  You must "batch" compile the code.
  78.  
  79. The exact procedure for recompiling depends on the version of the
  80. compiler.   Sample batch files for recompiling are included as follows:
  81.  
  82. Compiler    Batch for RBBS       Batch for CONFIG
  83. --------    --------------       ----------------
  84. QB 1.02     MRBBS1.BAT           MCNFG1.BAT
  85. QB 2.01     MRBBS2.BAT           MCNFG2.BAT
  86. QB 3.00     MRBBS3.BAT           MCNFG3.BAT
  87. QB 4.5      MRBBS4.BAT           MCNFG4.BAT
  88. PB 7.1      MRBBS7.BAT           MCNFG7.BAT
  89.  
  90. Versions of the compiler other than these are NOT recommended, e.g.
  91. QuickBasic 4.0, 2.0, 1.0.
  92.  
  93. Note:  if you are using DOORS with RBBS, you must patch a library for
  94. the compiler.  Else, upon return from a door, carrier may be dropped.
  95. Directions for patching the compiler are given in RBBS-DOC.ZIP in an
  96. appendix.
  97.