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 >
Wrap
Text File
|
1993-06-14
|
11KB
|
236 lines
*>>> RIP for RBBS <<<*
Yet another Original RBBS Enhancement from the Cellar Door RBBS
By Dan Drinnon
Ver. 1.02 06-14-93
Copyright (c) 1993 Daniel T. Drinnon
What is RRIP?
-------------
RRIP is a mod to RBBS 17.4 to add a 4th type of Graphics Support for your
callers. It is beyond the scope of this mod to go into what RIP graphics
is, this mod simply lets you have RIP graphics as one of the graphics options
for your callers. It is up to you to create and design RIP menus and
screens for your BBS, the 3 RIP menu screens for RBBS included here are for
completness and look a lot like Stock RBBS's ANSI menu screens.
FILES:
------
RRIP102.DOC - This Documentation
HELP09 - RBBS Graphics Help
MENU2R - RBBS-PC Main Menu in RIP Format
MENU3R - RBBS-PC File Menu in RIP Format
MENU4R - RBBS-PC Utilities Menu in RIP Format
R-PCRRIP.MRG - RBBS-PC.BAS Merge for RIP Graphic Support
RSB2RRIP.MRG - RBBSSUB2.BAS Merge for RIP Graphic Support
RSB3RRIP.MRG - RBBSSUB3.BAS Merge for RIP Graphic Support
RSB4RRIP.MRG - RBBSSUB4.BAS Merge for RIP Graphic Support
RSB5RRIP.MRG - RBBSSUB5.BAS Merge for RIP Graphic Support
CNFGRRIP.MRG - CONFIG.BAS Merge for RIP Graphics Support
ADDITIONAL FILES YOU WILL/MAY NEED:
-----------------------------------
RIP.SYS (?) This is a device driver for showing RIP locally on your BBS.
The "RIP People" are suposedly working on this driver and
it should be out shortly. In the meantime, RIP menus and
screens will be nothing but TEXT characters on the BBS. I have
some suspicions that RIP.SYS might need to be in a GRAPHICS
screen mode (EGA 16 color) to work, this may mean further
modifications to RBBS to work this way.
RRIP102:
--------
This Modification is for RBBS-PC v17.4. It's associated MRG files are to
be applied against STOCK RBBS source without any RFIX changes applied.
To incorporate this modification, you will need the RBBS-PC 17.4 source
files, Ken Goosens' BLED utility and your BASIC compiler.
IMPLEMENTATION:
---------------
This modification originally presented a problem for the Users. Because
of the extra graphics option, the User's record as saved in the USERS file
would be wrong as far as their graphics preference is set when they call
your BBS up after you add this modification. In otherwords, if they had
COLOR before, they would have MONO after this modification! Also, their
default text color may be incompatible causing all kinds of display problems.
Therefore, the RBBS Questionaire facility is used to FORCE all OLD callers
to re-select their graphic preferences at logon. To incorporate this, simply
run config on your RBBS config file (and ALL subboard config files) and select
option #186 to make all users answer required questionaire. Next, select
option #82, name of required questionaire, and enter ANY PATHNAME and for
the file, enter "GRAPHICS". "GRAPHICS", in this modification, is a "magic"
questionaire name that will tell RBBS to make the caller re-select their
graphics preference at log on. Any NEW USERS will not be asked twice to
select graphics. So, rounding this up, first make all users answer required
questionaire, name the required questionaire in config "GRAPHICS", and
that is it. All old callers will be asked to set their graphics right after
the "Logging So-and-So" message in RBBS.
You might want to make a news or bulletin entry explaining the new feature.
Remember, if you DO NOT use the above procedures and the questionaire method,
your old users may call up and have Black Text on a Black Background and
not be able to navigate well through your BBS! It is S-T-R-O-N-G-L-Y
reccommended to use the Questionaire method!
Here are the NEW user graphic color numbers:
NORMAL BOLD
Graphics R G Y B P C W R G Y B P C W
none 30 34 38 42 46 50 54 | 58 62 66 70 74 78 82
mono 31 35 39 43 47 51 55 | 59 63 67 71 75 79 83
ansi 32 36 40 44 48 52 56 | 60 64 68 72 76 80 84
RIP 33 37 41 45 49 53 57 61 65 69 73 77 81 85
The default format for RBBS RIP files is to have a "R" as the last
character of the BODY of the filename. If your MENU2 file is called "MENU2"
in CONFIG, then the MONO file is MENU2G, the ANSI file is MENU2C, and the
RIP file is MENU2R.
I have included some RIP default 'out of the box' menus for testing purposes.
FEATURES:
---------
Aside from the obvious RIP support, a couple of additional features are
included with this modification. First, the problem of text colors not
being set to their default color after a More prompt has been fixed. Second,
when the More prompt is to be earased, such as when listing files, if the
user has ANSI or RIP selected, the BBS will send a CR and an [ESC] K instead
of a CR and 79 SPACES. This speeds things up a little. Additionally, the
Graphics preference names have been changed from NONE,ASCII,COLOR to NONE,
MONO,COLOR,RIP. Also, if your user has selected RIP, and you have no
RIP menu or text files for what is to be displayed, then RBBS will look
for the ANSI color menu before giving up and transmitting the default menu.
You do not need to have any RIP files for this mod to work! RBBS will
automatically display the ANSI "C" files if it can't find any "R" RIP
files for display when your user has RIP as their graphics preference.
LIMITATIONS FOR USE:
--------------------
RRIP102 is to be considered 'USERWARE' and is to be distributed free of
charge. I retain ALL rights to RRIP102 - the source, documentation, and
merge files when the merge files are not merged against stock RBBS.
RRIP102 and the distributed files within the RRIP102 archive may only be
used under the following conditions:
You may modify RRIP102 any way you wish on YOUR BBS, but you may not distribute
this modified RRIP102 without permission. If you are an author, keeper,
maintainer of a major set of RBBS mods, such as Maple, DGS, STUNY, etc, you
have my permission to use these mods here and now provided you recognize
in your credits who and where this mod came from. It is your option to include
this documentation with your major mods. It is also to your descretion how
you place these mods in your major mods (ie the column 70 comment stub). The
key point here is to be sure to give credit where credit is due!
And always remember, "We are proud of the company that RBBS-PC keeps", and I
will be a GROUCH just for you if you do not honor what I stated above!
The owners of the copyright of RBBS-PC may incorporate RRIP102 into the
OFFICAL RBBS code at which time this copyright will belong to them.
The OFFICIAL name of the RRIP102 distribution file is RRIPxxx.ZIP, where
xxx denotes the version number of RRIP102. Subsequent upgrades will only
be released by me.
RRIP102 has been submitted to the Authors of RBBS-PC, with permission
to incorporate it into the next official version of RBBS.
The Latest version of RRIPxxx will always be available on my BBS, The Cellar
Door (505) 763-1795. If you are a RBBSNet or FidoNet Sysop, you can Freq
RRIPxxx from 8:903/2 or 1:313/6, respectively. FILERequest RRIP*.* to get the
latest version. The BBS allows downloads on first call after you complete the
new user registration. Logging on and answering the New User Questionaire is
Quick and Painless.
MERGING RRIP102:
----------------
The files RBBS-PC.BAS, RBBSSUB2.BAS thru RBBSSUB5.BAS are the only files
required to be modified. It is beyond the scope of this documentation
to tutor about how to compile RBBS-PC or how to use BLED. If you are
unfamiliar with either one - READ THE RESPECTIVE DOCS!
To Modify the RBBS-PC source, use Ken Gossens' BLED utility to merge the
RRIP102 *.MRG files into the RBBS source files:
BLED /L /B RBBS-PC.BAS R-PCRRIP.MRG RBBS-PC.NEW
BLED /L /B RBBSSUB2.BAS RSB2RRIP.MRG RBBSSUB2.NEW
BLED /L /B RBBSSUB3.BAS RSB3RRIP.MRG RBBSSUB3.NEW
BLED /L /B RBBSSUB4.BAS RSB4RRIP.MRG RBBSSUB4.NEW
BLED /L /B RBBSSUB5.BAS RSB5RRIP.MRG RBBSSUB5.NEW
BLED /L /B CONFIG.BAS CNFGRRIP.MRG CONFIG.NEW
Copy over your newly made RBBS-PC source files (*.NEW) to *.BAS files.
Compile RBBS and CONFIG as you usually would.
IF all went well, you now have built in RIP support for your BBS!
IF it didn't go well - look over your changes and try again!
Sometimes running RBBS with Lots of other merges, conflicts may arise.
You may have to modify RBBS-PC manually for RIP to make it all work.
MAKING RIP SCREENS FOR RBBS:
----------------------------
To make screens for RBBS with RIP support, be sure to give Mouse Field
commands the leading "/" when needed. This option turns OFF turbokeys,
which is ON for RIP, and allows you to have more than 1 command on the
command line, for example, if you make an ICON for "read your mail", the
mouse field commands would be: "/R M S^M" (less the quotes). Please
experiment!
GUARANTEES:
-----------
RRIP102 is fully guaranteed to work as advertised all of the time. It
is compatible with any RBBS setup and has absolutely no bugs. If you
find a problem with RRIP102, send in your RMA number and receipt and
your money will be cheerfully and expressly returned.
RRIP102 has been tested on RBBS 17.4 with no other mods. It has been in
use for a long enough time now that if you have problems, you need to
check your work! It's Perfect <G>.
ACKNOWLEGEMENTS:
---------------
* Special thanks to all those who have progressivly made RBBS the BEST. Past,
Present and Future!
* Special thanks to Pete Eibl of the Maple RBBS!
REACHING THE AUTHOR:
--------------------
To reach the author, enter a message in the RBBSNet RBBS-PC echomail
conference or log onto the Cellar Door and leave a message there. Paging
hours are from 5:30pm - 11:30pm Mountain Time. I can try to help you out
if you have any problems. The BBS number is at the bottom of this document.
REVISIONS:
----------
1.00 - 06-10-93 Initial Release
1.01 - 06-14-93 Fixed the include Menus
Included ICON files used with Menus
Added RIP autodetect at ansitest time
1.02 - 06-14-93 Fix to force TurboKeys to Always be on with RIP - makes
building RIP menus a lot easier.
-------------
RRIP102 - by:
DAN DRINNON
THE CELLAR DOOR RBBS 9600 v32
(505) 763-1795 RBBSNet 8:903/2 FidoNet 1:313/6