home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1994 #1 / monster.zip / monster / BBS_UTIL / BM0406_A.ZIP / DOCS.ZIP / RRIP102.DOC < prev    next >
Text File  |  1993-06-14  |  11KB  |  236 lines
  1.  
  2.                          *>>>  RIP for RBBS   <<<*
  3.  
  4.       Yet another Original RBBS Enhancement from the Cellar Door RBBS
  5.  
  6.                              By Dan Drinnon
  7.  
  8.                                Ver. 1.02  06-14-93
  9.  
  10.                     Copyright (c) 1993 Daniel T. Drinnon
  11.  
  12.  
  13. What is RRIP?
  14. -------------
  15. RRIP is a mod to RBBS 17.4 to add a 4th type of Graphics Support for your
  16. callers.  It is beyond the scope of this mod to go into what RIP graphics
  17. is, this mod simply lets you have RIP graphics as one of the graphics options
  18. for your callers.  It is up to you to create and design RIP menus and
  19. screens for your BBS, the 3 RIP menu screens for RBBS included here are for
  20. completness and look a lot like Stock RBBS's ANSI menu screens.
  21.  
  22. FILES:
  23. ------
  24. RRIP102.DOC        - This Documentation
  25. HELP09             - RBBS Graphics Help
  26. MENU2R             - RBBS-PC Main Menu in RIP Format
  27. MENU3R             - RBBS-PC File Menu in RIP Format
  28. MENU4R             - RBBS-PC Utilities Menu in RIP Format
  29. R-PCRRIP.MRG       - RBBS-PC.BAS Merge for RIP Graphic Support
  30. RSB2RRIP.MRG       - RBBSSUB2.BAS Merge for RIP Graphic Support
  31. RSB3RRIP.MRG       - RBBSSUB3.BAS Merge for RIP Graphic Support
  32. RSB4RRIP.MRG       - RBBSSUB4.BAS Merge for RIP Graphic Support
  33. RSB5RRIP.MRG       - RBBSSUB5.BAS Merge for RIP Graphic Support
  34. CNFGRRIP.MRG       - CONFIG.BAS Merge for RIP Graphics Support
  35.  
  36. ADDITIONAL FILES YOU WILL/MAY NEED:
  37. -----------------------------------
  38.  
  39. RIP.SYS (?)  This is a device driver for showing RIP locally on your BBS.
  40.              The "RIP People" are suposedly working on this driver and
  41.              it should be out shortly.  In the meantime, RIP menus and
  42.              screens will be nothing but TEXT characters on the BBS.  I have
  43.              some suspicions that RIP.SYS might need to be in a GRAPHICS
  44.              screen mode (EGA 16 color) to work, this may mean further
  45.              modifications to RBBS to work this way.
  46.  
  47. RRIP102:
  48. --------
  49. This Modification is for RBBS-PC v17.4.  It's associated MRG files are to
  50. be applied against STOCK RBBS source without any RFIX changes applied.
  51. To incorporate this modification, you will need the RBBS-PC 17.4 source
  52. files, Ken Goosens' BLED utility and your BASIC compiler.
  53.  
  54.  
  55. IMPLEMENTATION:
  56. ---------------
  57. This modification originally presented a problem for the Users.  Because
  58. of the extra graphics option, the User's record as saved in the USERS file
  59. would be wrong as far as their graphics preference is set when they call
  60. your BBS up after you add this modification.  In otherwords, if they had
  61. COLOR before, they would have MONO after this modification!  Also, their
  62. default text color may be incompatible causing all kinds of display problems.
  63. Therefore, the RBBS Questionaire facility is used to FORCE all OLD callers
  64. to re-select their graphic preferences at logon.  To incorporate this, simply
  65. run config on your RBBS config file (and ALL subboard config files) and select
  66. option #186 to make all users answer required questionaire.  Next, select
  67. option #82, name of required questionaire, and enter ANY PATHNAME and for
  68. the file, enter "GRAPHICS".  "GRAPHICS", in this modification, is a "magic"
  69. questionaire name that will tell RBBS to make the caller re-select their
  70. graphics preference at log on.  Any NEW USERS will not be asked twice to
  71. select graphics.  So, rounding this up, first make all users answer required
  72. questionaire, name the required questionaire in config "GRAPHICS", and
  73. that is it.  All old callers will be asked to set their graphics right after
  74. the "Logging So-and-So" message in RBBS.
  75.  
  76. You might want to make a news or bulletin entry explaining the new feature.
  77.  
  78. Remember, if you DO NOT use the above procedures and the questionaire method,
  79. your old users may call up and have Black Text on a Black Background and
  80. not be able to navigate well through your BBS!  It is S-T-R-O-N-G-L-Y
  81. reccommended to use the Questionaire method!
  82.  
  83. Here are the NEW user graphic color numbers:
  84.  
  85.               NORMAL                  BOLD
  86. Graphics R  G  Y  B  P  C  W    R  G  Y  B  P  C  W
  87.   none  30 34 38 42 46 50 54 | 58 62 66 70 74 78 82 
  88.   mono  31 35 39 43 47 51 55 | 59 63 67 71 75 79 83 
  89.   ansi  32 36 40 44 48 52 56 | 60 64 68 72 76 80 84 
  90.   RIP   33 37 41 45 49 53 57   61 65 69 73 77 81 85
  91.  
  92.  
  93. The default format for RBBS RIP files is to have a "R" as the last
  94. character of the BODY of the filename.  If your MENU2 file is called "MENU2"
  95. in CONFIG, then the MONO file is MENU2G, the ANSI file is MENU2C, and the
  96. RIP file is MENU2R.
  97.  
  98. I have included some RIP default 'out of the box' menus for testing purposes.
  99.  
  100.  
  101. FEATURES:
  102. ---------
  103. Aside from the obvious RIP support, a couple of additional features are
  104. included with this modification.  First, the problem of text colors not
  105. being set to their default color after a More prompt has been fixed.  Second,
  106. when the More prompt is to be earased, such as when listing files, if the
  107. user has ANSI or RIP selected, the BBS will send a CR and an [ESC] K instead
  108. of a CR and 79 SPACES.  This speeds things up a little.  Additionally, the
  109. Graphics preference names have been changed from NONE,ASCII,COLOR to NONE,
  110. MONO,COLOR,RIP.  Also, if your user has selected RIP, and you have no
  111. RIP menu or text files for what is to be displayed, then RBBS will look
  112. for the ANSI color menu before giving up and transmitting the default menu.
  113. You do not need to have any RIP files for this mod to work!  RBBS will
  114. automatically display the ANSI "C" files if it can't find any "R" RIP
  115. files for display when your user has RIP as their graphics preference.
  116.  
  117.  
  118. LIMITATIONS FOR USE:
  119. --------------------
  120. RRIP102 is to be considered 'USERWARE' and is to be distributed free of
  121. charge.  I retain ALL rights to RRIP102 - the source, documentation, and
  122. merge files when the merge files are not merged against stock RBBS.
  123. RRIP102 and the distributed files within the RRIP102 archive may only be
  124. used under the following conditions:
  125.  
  126. You may modify RRIP102 any way you wish on YOUR BBS, but you may not distribute
  127. this modified RRIP102 without permission.  If you are an author, keeper,
  128. maintainer of a major set of RBBS mods, such as Maple, DGS, STUNY, etc, you
  129. have my permission to use these mods here and now provided you recognize
  130. in your credits who and where this mod came from.  It is your option to include
  131. this documentation with your major mods.  It is also to your descretion how
  132. you place these mods in your major mods (ie the column 70 comment stub).  The
  133. key point here is to be sure to give credit where credit is due!
  134.  
  135. And always remember, "We are proud of the company that RBBS-PC keeps", and I
  136. will be a GROUCH just for you if you do not honor what I stated above!
  137.  
  138. The owners of the copyright of RBBS-PC may incorporate RRIP102 into the
  139. OFFICAL RBBS code at which time this copyright will belong to them.
  140.  
  141. The OFFICIAL name of the RRIP102 distribution file is RRIPxxx.ZIP, where
  142. xxx denotes the version number of RRIP102.  Subsequent upgrades will only
  143. be released by me.
  144.  
  145. RRIP102 has been submitted to the Authors of RBBS-PC, with permission
  146. to incorporate it into the next official version of RBBS.
  147.  
  148. The Latest version of RRIPxxx will always be available on my BBS, The Cellar
  149. Door (505) 763-1795.  If you are a RBBSNet or FidoNet Sysop, you can Freq 
  150. RRIPxxx from 8:903/2 or 1:313/6, respectively.  FILERequest RRIP*.* to get the
  151. latest version.  The BBS allows downloads on first call after you complete the 
  152. new user registration.  Logging on and answering the New User Questionaire is 
  153. Quick and Painless.
  154.  
  155.  
  156. MERGING RRIP102:
  157. ----------------
  158. The files RBBS-PC.BAS, RBBSSUB2.BAS thru RBBSSUB5.BAS are the only files
  159. required to be modified.  It is beyond the scope of this documentation
  160. to tutor about how to compile RBBS-PC or how to use BLED.  If you are
  161. unfamiliar with either one - READ THE RESPECTIVE DOCS!
  162.  
  163. To Modify the RBBS-PC source, use Ken Gossens' BLED utility to merge the
  164. RRIP102 *.MRG files into the RBBS source files:
  165.  
  166. BLED /L /B RBBS-PC.BAS R-PCRRIP.MRG RBBS-PC.NEW
  167. BLED /L /B RBBSSUB2.BAS RSB2RRIP.MRG RBBSSUB2.NEW
  168. BLED /L /B RBBSSUB3.BAS RSB3RRIP.MRG RBBSSUB3.NEW
  169. BLED /L /B RBBSSUB4.BAS RSB4RRIP.MRG RBBSSUB4.NEW
  170. BLED /L /B RBBSSUB5.BAS RSB5RRIP.MRG RBBSSUB5.NEW
  171. BLED /L /B CONFIG.BAS CNFGRRIP.MRG CONFIG.NEW
  172.  
  173. Copy over your newly made RBBS-PC source files (*.NEW) to *.BAS files.
  174. Compile RBBS and CONFIG as you usually would.
  175.  
  176. IF all went well, you now have built in RIP support for your BBS!
  177.  
  178. IF it didn't go well - look over your changes and try again!
  179.  
  180. Sometimes running RBBS with Lots of other merges, conflicts may arise.
  181. You may have to modify RBBS-PC manually for RIP to make it all work.
  182.  
  183. MAKING RIP SCREENS FOR RBBS:
  184. ----------------------------
  185. To make screens for RBBS with RIP support, be sure to give Mouse Field
  186. commands the leading "/" when needed.  This option turns OFF turbokeys,
  187. which is ON for RIP, and allows you to have more than 1 command on the
  188. command line, for example, if you make an ICON for "read your mail", the
  189. mouse field commands would be:  "/R M S^M"  (less the quotes).  Please
  190. experiment!
  191.  
  192. GUARANTEES:
  193. -----------
  194. RRIP102 is fully guaranteed to work as advertised all of the time.  It
  195. is compatible with any RBBS setup and has absolutely no bugs.  If you
  196. find a problem with RRIP102, send in your RMA number and receipt and
  197. your money will be cheerfully and expressly returned.
  198.  
  199. RRIP102 has been tested on RBBS 17.4 with no other mods. It has been in
  200. use for a long enough time now that if you have problems, you need to
  201. check your work!  It's Perfect <G>.
  202.  
  203.  
  204. ACKNOWLEGEMENTS:
  205. ---------------
  206. * Special thanks to all those who have progressivly made RBBS the BEST. Past,
  207.  Present and Future!
  208.  
  209. * Special thanks to Pete Eibl of the Maple RBBS!
  210.  
  211.  
  212. REACHING THE AUTHOR:
  213. --------------------
  214. To reach the author, enter a message in the RBBSNet RBBS-PC echomail
  215. conference or log onto the Cellar Door and leave a message there.  Paging
  216. hours are from 5:30pm - 11:30pm Mountain Time.  I can try to help you out
  217. if you have any problems.  The BBS number is at the bottom of this document.
  218.  
  219.  
  220. REVISIONS:
  221. ----------
  222.  
  223. 1.00  -  06-10-93 Initial Release
  224. 1.01  -  06-14-93 Fixed the include Menus
  225.                   Included ICON files used with Menus
  226.                   Added RIP autodetect at ansitest time
  227. 1.02  -  06-14-93 Fix to force TurboKeys to Always be on with RIP - makes
  228.                    building RIP menus a lot easier.
  229.  
  230. -------------
  231. RRIP102 - by:
  232. DAN DRINNON
  233. THE CELLAR DOOR RBBS 9600 v32
  234. (505) 763-1795  RBBSNet 8:903/2  FidoNet 1:313/6
  235.  
  236.