home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1994 #1 / monster.zip / monster / PCBOARD / RIPKT100.ZIP / CONCERN.DOC next >
Text File  |  1994-04-01  |  9KB  |  168 lines
  1. Concerns / notes of interest of the RIPKit package
  2. =============================================================================
  3.  
  4. There are items and situations in the RIPKit package you need to be aware of.
  5. First of all, you must understand that RIPScrip simply provides a graphical
  6. user interface over a standard text mode application.  Also keep in mind
  7. that RIPScrip is intentionally generic so it can be used by numerous
  8. different host/BBS programs.
  9.  
  10. This documentation file outlines situations you may run into on your system
  11. and may need to modify.  It also discusses some items which could not
  12. easily be covered with RIPscrip.
  13.  
  14. You will see items labeled as either a NOTE or a CONCERN.  A NOTE is an item
  15. which nothing could be done about but you should be aware of--these are NOT
  16. bugs.  CONCERNS are things you should be aware of in your system
  17. configuration and how they apply to the RIPKit.  There is only so much you
  18. can do with an INSTALL.BAT so read this section with great interest.
  19.  
  20. ******************************************************************************
  21. * PCBoard software is extremely flexible.  As such, we cannot cover every    *
  22. * concern or snag you may run into while adding the RIPKit to your system.   *
  23. * Our desire to keep this document up-to-date with problems and solutions    *
  24. * you run into.  If you want to share your experiences with us so we can     *
  25. * update the document file it would be greatly appreciated.  Send any        *
  26. * comments to SYSOP on Salt Air.                                             *
  27. ******************************************************************************
  28.  
  29. ------------------------------------------------------------------------------
  30. CONCERN:  NEWUSER display file (PCBSetup | File Locations | Display Files)
  31.  
  32.           After the NEWUSER file is displayed, PCBoard displays the
  33.           "Do you want to register with us" prompt.  With the RIPKit, this
  34.           prompt has been turned into a two button object.  This object
  35.           will pop-up at the bottom of the display.
  36.  
  37.           The only time you will run into a problem with this is if your
  38.           NEWUSER file is more than 25 lines.  If your screen is longer
  39.           than 25 lines, the "Do you want to register" box will be printed
  40.           over the top of your NEWUSER screen which would impede on the
  41.           caller's ability to read it.
  42.  
  43.           The easiest solution to this problem is to put an @WAIT@ at the
  44.           bottom of your NEWUSER file.  This could be undesirable though
  45.           because it affects your callers who do not call in using RIPmode.
  46.  
  47.           If you want to only add the @WAIT@ for your RIP callers, add the
  48.           following line to the bottom of your NEWUSER file:
  49.  
  50.               %%PCBRIP%\RIPENTER
  51.  
  52.           This will display a "Press ENTER to Continue" prompt only if the
  53.           caller is in RIP mode.  Thanks to PCBoard's ability to display
  54.           language specific versions of display files, this will only
  55.           affect callers who select the RIP language and not your
  56.           regular callers
  57.  
  58. -----------------------------------------------------------------------------
  59. CONCERN:  Potential logon problems ($$LOGON.BAT, Logon Questionnaire, Login
  60.           Security Files, Conference Intro Files).
  61.  
  62.           Between the time the user enters his password and the time the
  63.           news file is displayed four activities could occur:
  64.  
  65.              * A logon questionnaire could run
  66.              * $$LOGON.BAT (if it exists) will run
  67.              * A logon security file could be displayed (if found)
  68.              * The conference introduction file could be displayed (if found)
  69.  
  70.           The first two items may or may not display noteworthy information
  71.           to the caller.  If so, you need to find a way to reset the graphics
  72.           and text windows so they can see this information.
  73.  
  74.           The RIPKit has been designed to reset the screen after the user
  75.           enters their password.  Remember, PCBoard is flexible enough to
  76.           allow them to type in their login name and password all at the
  77.           first name prompt.  In this case, the screen would not be cleared.
  78.           One thing you can do to force the screen to be always reset is
  79.           to put the following text at the beginning of your logon
  80.           questionnaire:
  81.  
  82.              %C:\PCB\RIP\CLEARRIP
  83.  
  84.           This line will display a file called CLEARRIP.RIP located in
  85.           your RIPKit subdirectory.  Why did we specify CLEARRIP when
  86.           the filename really is CLEARRIP.RIP?  Remember, PCBoard supports
  87.           language specific displays when displaying files and with
  88.           RIPscrip, the user has selected (or had selected for them)
  89.           the .RIP language.  If you did not install your files to
  90.           C:\PCB\RIP\, do not forget to specify the right location.  For
  91.           those that are curious, the CLEARRIP.RIP file simply sends the
  92.           following RIPScrip sequence:
  93.  
  94.              !|*|#|#|#
  95.  
  96.           Since this is such a generic file, you can use it in other
  97.           areas of the system where you want to clear the screen.
  98.  
  99. CONCERN:  Conference INTRO files and the screen clearing
  100.  
  101.           With the RIPKit, the screen is normally cleared right after the
  102.           INTRO file is displayed.  Unless your callers can read *extremely*
  103.           quickly, they are going to have a hard time seeing your intro
  104.           screen.  How can you easily modify the INTRO files to pause
  105.           for your RIP callers but not for your other callers (because
  106.           their screen will not clear)?  On Salt Air, we simply added
  107.           the following line to all of the conference INTRO files:
  108.  
  109.                 %%PCBRIP%\RIPENTER
  110.  
  111.           Like the LOGON questionnaire situation, we created a RIPENTER.RIP
  112.           file in the \PCB\RIP subdirectory.  If the caller has selected
  113.           the .RIP language, PCBoard will display the RIPENTER.RIP file.
  114.           Otherwise, nothing will be displayed to the caller.
  115.  
  116.           By the way, a quick way to edit all of your INTRO files is to
  117.           use a utility like SST: the Supersonic Search Tool by Keith
  118.           Ledbetter.  Using this utility you can change to the drive
  119.           where you INTRO files are and type:
  120.  
  121.                 SST -c"edit &f" INTRO.*
  122.  
  123.           This will find all of the INTRO files on the current drive and
  124.           edit them using the EDIT program.  We managed to update all 21
  125.           conference INTRO files on Salt Air in about 10 minutes using
  126.           this method.
  127.  
  128. ------------------------------------------------------------------------------
  129. CONCERN:  Additions to your system
  130.  
  131.           Because the RIPscrip system is a face-lift of your current
  132.           system, you want to be keenly aware of any software or features
  133.           you have implemented on your system which do not come in the
  134.           default configuration of PCBoard.  We have tried to be as
  135.           thorough as possible in making the RIPKit easy to install
  136.           for the customers we were targeting.  There are tens of
  137.           thousands (if not hundreds of thousands) of way to configure
  138.           PCBoard and not all could be accounted for.
  139.  
  140.           The best thing you can do is to call into your system  and
  141.           thoroughly check every feature the user can select.  This will
  142.           help ensure your users will be presented with a clean system
  143.           to work with.
  144.  
  145. ------------------------------------------------------------------------------
  146. CONCERN:  NEWASK Questionnaire
  147.  
  148.           To reset the graphics and text windows at the beginning of your
  149.           NEWASK questionnaire, add the following line to the beginning
  150.           of your questionnaire:
  151.  
  152.                 C:\PCB\RIP\CLEARRIP
  153.  
  154.           If your RIPKit directory is not in C:\PCB\RIP\, do not forget to
  155.           specify the appropriate directory.
  156.  
  157. ------------------------------------------------------------------------------
  158. NOTE:     Viewing a file from the file menu
  159.  
  160.           When you view a file from the file menu, PCBoard reprints the
  161.           "(H)elp, (1-xx), File List Command?" prompt.  I know this
  162.           prompt may confuse some of your callers but there is really
  163.           no easy solution that we see for getting rid of that prompt.
  164.  
  165.           Our initial attempts hinged around stuffing the keyboard to get
  166.           out of that but let's just say that broke other things in the
  167.           system.  For now, recognize this as a limitation with RIPKit.
  168.