#Ä÷	;Gc█"G$H$¼%╢'╖'╟'J+p-102030405060708090:0;0<0=0>0?0@0A0B0C0D0E0F0G0H0I0J0K0L0M0N0O0P0Q0R0S0T0U0V0W0X0Y0Z0[0\0]0^0_0`0a0b0c0d0e0f0g0h0i0j0k0l0m0n0o0p0q0r0s0t0u0v0w0x0y0z0{0|0}0~00Ç0ü0é0â0ä01═5ô85:6:7:8:9:::;:<:=:>:?:@:A:B:C:D:E:F:G:H:I:J:K:L:M:N:O:P:Q:R:S:T:U:V:W:X:Y:Z:[:\:]:^:_:`:a:b:c:d:e:f:g:h:i:j:k:l:m:n:o:p:q:r:s:t:u:v:w:x:y:z:{:|:}:~::Ç:ü:é:â:ä:à:å:ç:ê:ë:è:ï:î:ì:Ä:Å:É:æ:Æ:ô:A;< =á=\>╢>]@6B═F$HxJMìNS"WµX¢Z8[-]┌`≤c_f╩kNq┤vdym{l~π4ü~éQà╣ê╝ÄΦÅ¥æ╢æ╩òöùáÜ╤¥╥¥╙¥╘¥╒¥╓¥╫¥╪¥┘¥┌¥█¥▄¥▌¥▐¥▀¥α¥ß¥Γ¥π¥Σ¥σ¥µ¥τ¥Φ¥Θ¥Ω¥δ¥∞¥φ¥ε¥∩¥≡¥±¥≥¥≤¥⌠¥⌡¥÷¥≈¥°¥∙¥·¥√¥ⁿ¥²¥■¥ ¥₧₧₧₧₧₧₧₧₧	₧
₧₧₧
₧₧₧₧¿ó{ñ¼ªτ¿û¬¼3¡¥«G░H░{▒1▓E┤F┤G┤H┤I┤J┤K┤L┤M┤N┤O┤P┤Q┤R┤»┤,╡-╡τ╡φ╢╕╕╕╕╕╕╕╕ε╕∩╕≡╕±╕≥╕≤╕⌠╕⌡╕┐╣║Ç║ü║é║â║ä║╝>┐■┐î├á─┼¡┼S╞╟¿╟#═Σ╬╛╥┘╙í╒µ╓Ω╪▀┌╦█M▌\α]α^α_α`αaαbαcαdαeαßεΣ∞Θ╠≡╬≈┌²₧ƒáíóúñÑª▄$ó°ª╙	
V╤
@ûφ6
 ┌kZ╡ 
#¢$╚&⌡(ⁿ*╢.¿1$3a5ú7|9ï:|<╧>═?mAZCLF╠HMMMMMMMMMMM╬O╧O╨O╤O╥O╙O╘O╒O╓O╫O╘PΩUF\da^c_c`cacbccc┌eçl]p^p_p`papbpcpdprusutuuuvuwuxuyuzu{uäyàyåyçyêyëyèyïyîyìyΣ}σ}µ}τ}Φ}Θ}Ω}δ}∞}φ}5ü6ü7ü8ü9ü:ü;ü<ü=ü>ü┴êQÄÖÅzÆ▓Ö⌠₧,ñq⌐±»}╢ì╖è╗2└Σ─╞╕╟ä╬ ╙ü┘┬▌#ß~σ∞8φf⌠á∙Basic Help message #0


          --------------------------------------------------------
          This help message is not used by the system.  It is only
          shown here for clarity, and to make sure that all of the
          Help Messages are properly aligned......................
          --------------------------------------------------------
TABLE OF CONTENTS
~3 3 30 44  610 76~
                              RIPterm v1.50.00
           Copyright (c) 1992-93, TeleGrafix Communications, Inc.
                            All Rights Reserved


~3 2 60 93 580 115~
       ~ Online Demos ~005       ~   Warranty Info   ~003      ~Freeware Version~002
       ~Copyright Info~007       ~General Information~006      ~Troubleshooting ~450
~5 0 13 126 626 126~ ~3 2 425 142 580 186~  ~5 0 425 156 580 156~  ~5 0 229 260 394 260~
~3 2 60 142 203 154~ ~3 2 229 142 394 194~  ~5 0 229 156 394 156~  ~3 2 425 198 580 226~
~3 2 60 166 203 186~ ~3 2 229 206 394 234~  ~3 2 229 246 394 290~  ~3 2 425 238 580 258~
~3 2 60 198 203 218~ ~3 2  60 230 203 258~  ~3 2  60 270 203 290~  ~3 2 425 270 580 290~
       ~How to use Help~101      ~  MODEM SETTINGS  ~301      ~ KEYSTROKE MACROS ~365

                            ~ Initialize Modem ~226      ~   Control Keys   ~386
       ~Pull-Down menus~100      ~  Hang-up modem   ~214      ~  Text Variables  ~387
       ~Pull-Down help ~102      ~Modem Auto-Answer ~227      ~ Popup Pick-Lists ~389
                            ~Serial Port Config~222

       ~  System Info  ~201                              ~    Save Setup    ~211
       ~  Requirements ~004      ~    Clear Text    ~208      ~   Jump to DOS    ~224
                            ~  Clear Graphics  ~207      ~   Exit to DOS    ~204
                            ~  Reset Windows   ~209
       ~  System Font  ~228
       ~Zooming Windows~206                              ~ Scroll-Back Mode ~358
       ~  Status Line  ~205      ~  FILE TRANSFERS  ~099      ~ Scroll-Back size ~217

                            ~Uploads/Downloads ~225
       ~ CR/LF option  ~215      ~  Text Log Files  ~219      ~Dialing Directory ~520
       ~Echo Keystrokes~212      ~  ASCII Settings  ~223      ~Telephone Numbers ~009
FREEWARE INFORMATION

     This software is "Freeware".  By Freeware, we mean that it may
     be distributed to friends, family, associates, or anybody you
     wish governed by the following restrictions:  it may NOT be
     freely distributed as part of a Commercial (or Shareware)
     Software Package without explicit written permission from the
     authors (TeleGrafix Communications, Inc.).  It also may not be freely
     distributed for Corporate or Business use without obtaining prior
     written consent from TeleGrafix Communications directly.  This
     software may not be distributed to anybody unless accompanied by
     the following files (either in diskette or archive form):

                              RIPTERM.EXE
                              RIPTERM.HLP
                              RIPTERM.DOC
                              RIPTERM.FNT
                              RIPTERM.RES
                              RIPTERM.PCX
                              WHATSNEW.DOC
LIMITED WARRANTY - LIMITS OF LIABILITY

     THIS SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
     EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE
     IMPLIED WARRANTIES OF MERCHANTABILITY, AND FITNESS FOR A PARTICULAR
     PURPOSE.  TELEGRAFIX COMMUNICATIONS, INC. DOES NOT WARRANT THAT THE
     FUNCTIONS CONTAINED IN THIS SOFTWARE WILL MEET YOUR REQUIREMENTS OR
     THAT THE OPERATION OF THIS SOFTWARE WILL BE UNINTERRUPTED OR ERROR-
     FREE.  THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE
     SOFTWARE IS WITH YOU.  SHOULD THE SOFTWARE PROVIDED BE DEFECTIVE,
     YOU (NOT TELEGRAFIX COMMUNICATIONS, INC) ASSUME THE ENTIRE COST OF
     ALL NECESSARY SERVICING, REPAIR, OR CORRECTION.
Software Requirements

     RIPterm requires that you be using an IBM-PC compatible computer
     system running MS-DOS version 3.0 or higher.  You must have 512K of
     available RAM or more.  A hard disk is strongly recommended.  You
     must have an EGA or higher video adapter a modem connected to serial
     port COM1 through COM4.  A mouse and a color monitor are not
     required, but are strongly recommended.  This software does not
     require Extended (XMS) or Expanded (EMS) memory, but can take
     advantage of either if present to improve software performance.
Online Demos

     For an online demonstration of RIPscrip graphics, you may call
     the following BBS numbers.  You already have the necessary
     Icons to view the system in graphics mode for ArenaBBS.  For
     the remaining systems, you will have to obtain the Icons from
     them yourself.


        1. ~ArenaBBS~13 - 32 line MajorBBS system
           This is TeleGrafix's Tech Support/Entertainment BBS

             PHONE: (714) 840-3520
               > Create an account.  At the Main Menu, type "RIP ON"
               > then tap the <ENTER> key for the graphical menus...


        2. ~Nova Central~14 - 4 line Nova Link Professional BBS
           This is ResNova's Technical Support BBS

             PHONE: (714) 840-8641
               > Create an account.  Go into the Product Information
               > area, choose the RIPterm graphics menu option and
               > you can view a demo there as well.


        3. ~RIP Demo Midwest~15 - 2 line TBBS system.  This system is
           a full RIP Demo System, and is one of our distributers.

             PHONE: (708) 978-2777
               > Signup in "text mode" if you do not have the RDM
               > Icons.  Download the System Icons and away you
               > go.  Be sure to see the Message Forums and other areas.
General Information

     For more information about RIPscrip based products, contact:


       TeleGrafix Communications, Inc    ResNova Software
       16458 Bolsa Chica, #15            16458 Bolsa Chica, #193
       Huntington Beach, CA 92649        Huntington Beach, CA 92649

       Voice: (714) 846-4179             Voice: (714) 840-6082
       Fax  : (714) 846-4189             Fax  : (714) 840-0488
       Data : (714) 840-3520             Data : (714) 840-8641
              ArenaBBS [32 lines]               Nova Central [4 lines]
              The MajorBBS                      Nova Link Professional


                        RIP Demo Midwest
                        Voice: (708) 820-8875
                        Fax  : (708) 898-4994
                        Data : (708) 978-2777
                               RIP Demo Midwest [2 lines]
                               TBBS
RIPterm Copyright Information





                          -----------------------
                              RIPTerm v1.50.00
                          -----------------------




                 "Remote Imaging Protocol"  Terminal System


           Copyright (c) 1992-93, TeleGrafix Communications, Inc.
                            All Rights Reserved.
Entering the phone number to dial

     Please enter the telephone number you wish to dial.  You may enter
     any numeric digits (0-9).  Hyphens are ignored.  Enter a comma
     for a 1/2 second delay (eg, 9,1714-555-1212).  You may need to add
     delays if you have to use a special service or a switchboard to
     obtain an outside line dial-tone.
Dialing the modem

     The dialing window will appear when RIPterm is physically attempting
     to dial the modem.  On this window will be displayed the number of
     seconds that have elapsed, the time that dialing started, the time
     of the last re-dial attempt, the telephone number and other various
     information about the state of the dialing.

     Simply tapping <ENTER> will abort the current dialing attempt and
     start over.  Tapping <ESC> or clicking on "Cancel" will abort dialing
     entirely.
Online Demos


ArenaBBS

     ArenaBBS is a 32-line MajorBBS system.  It is operated by the
     authors of RIPscrip Graphics, Jeff Reeder [Covenant], Mark
     Hayton [Necron], Mara Ward [Kytty], and Jim Bergman [Bergie].
     This system demonstrates the usefulness of RIPscrip graphics
     in conjunction with standard MajorBBS Menuing software.

     ArenaBBS is also the Technical Support system for CovyWare
     products for The MajorBBS.  CovyWare products have been avail-
     able for The MajorBBS Sysops for several years now.


          TeleGrafix Communications, Inc.
          16458 Bolsa Chica, #15
          Huntington Beach, CA 92649

          Voice    : (714) 840-4179
          Fax      : (714) 840-4189
          Data/BBS : (714) 840-3520 [3-2400, 8N1]
          Stats    : 32 lines, The MajorBBS [ibm]
          Owner(s) : Jeff Reeder and Mara Ward


              ~Online Demo Systems~5
Nova Central

     ResNova Software is a distributer of RIPscrip Graphical products.
     They are the authors of Nova Link Professional, a Macintosh based
     multi-user graphical BBS system.


          ResNova Software
          16458 Bolsa Chica, #193
          Huntington Beach, CA 92649

          Voice    : (714) 840-6082
          Fax      : (714) 840-0488
          Data/BBS : (714) 840-8641 [3-9600, 8N1]
          Stats    : 4 lines, Nova Link Professional [mac]
          Owner(s) : Len Anderson


              ~Online Demo Systems~5
RIP Demo Midwest

     RIP Demo Midwest is a RIPscrip Graphics distributer for TeleGrafix
     Communications, Inc.  They sell and perform Technical Support on
     RIPscrip products.  Their BBS, called "RIP Demo Midwest", is a TBBS
     based system that provides an incredible display of what RIPscrip
     graphics can do you a System Operator.  For anybody wanting to see
     awesome online graphics, this system is a must see!


          RIP Demo Midwest

          Voice    : (708) 820-8875
          Fax      : (708) 898-4994
          Data/BBS : (708) 978-2777 [3-14,400, 8N1]
          Stats    : 2 lines, TBBS [ibm]
          Owner(s) : Bernal Schooley


              ~Online Demo Systems~5
File Transfers





                              ~DOWNLOAD~220 a file
                              ~UPLOAD~221   a file



Pull-Down menus

     The pull down menus are very easy to use on RIPterm.  Simply click
     on the right mouse button and while it is depressed, a menu bar
     will appear at the top of your screen displaying the available menu
     items to choose from.  Simply move the mouse pointer to any of these
     items and a list of menu options will appear below the menu bar.
     At this point, move the Mouse Cursor down into this list of items and
     as you move over different items, they will be hilighted.  To select
     any given item, release the right mouse button while on top of the
     desired option.

     Most options in the Pull Down menus have corresponding Hot-Keys that
     you can choose.  Hot-Keys are keyboard short cuts that you can use
     if you know RIPterm well.  Hot-Keys make it so that you do not have
     to use the Mouse to access Pull-Down menu options.

     Some menu options are "toggle" items.  If an option is toggled ON,
     then you will see a check-mark beside the option.

     Finally, there may be items which are not selectable in the Pull
     Down menu system.  These items appear in gray and are considered
     "Ghosted".  Ghosted items cannot be hilighted or selected.
Help on Help

     The Help System of RIPterm is quite simple to use.  You may at any
     time return to the Table of Contents by clicking on the "Contents"
     button at the bottom of the screen.  If you have navigated through
     various Help Screens, you can back-up to the previous screen by
     clicking on the "Back" button.  Any words or phrases which are
     hilighted are "keywords" which you can click on to jump to that
     help topic.  You may also use TAB and SHIFT-TAB to hilight different
     keywords.  The Arrow keys may also be used for convenience.  Simply
     tap <ENTER> and the currently selected keyword (if any) will be
     selected and RIPterm will jump to that help screen.
Help on Menu Help

     This option will allow you to view Help Information on the various
     PULL-DOWN MENU options.  A window will appear instructing you to
     select a pull-down menu option for help.  Simply click on the right
     mouse button and pull down the desired menu.  Select an option, and
     a Help Screen will appear on that item.  When finished, tap the
     <ESC> key to exit "Menu Help" mode.
INIT STRING

     This field is the modem command that is sent to the modem when
     RIPterm starts up.  All modem commands begin with an "AT", short for
     'ATtention'.
AUTO ANSWER

     This modem command is what would be sent to the modem to set it for
     "auto-answer" mode.  Auto-answer means that the modem will answer the
     phone automatically when it rings.
MODEM RESET 

     This is the modem command string that is sent when the modem needs to
     be reset.  This may be necessary if you "hang-up" the modem, abort a
     dial attempt, or exit RIPterm.  For most modems, this command is Z,
     which would be entered as "ATZ^m".
Project: About RIPterm

     This option will display a Help screen displaying the COPYRIGHT
     Information of the Software.
Project: System Info

     This option will display the amount of RAM memory currently avail-
     able as well as the amount of disk space free on the currently
     selected hard disk.
Project: Help System

     This option will display the help system's TABLE OF CONTENTS.
Project: Help on Menus

     This option will allow you to view Help Information on the various
     PULL-DOWN MENU options.  A window will appear instructing you to
     select a pull-down menu option for help.  Simply click on the right
     mouse button and pull down the desired menu.  Select an option, and
     a Help Screen will appear on that item.  When finished, tap the
     <ESC> key to exit "Menu Help" mode.
Project: Exit

     This option will exit RIPterm and return to DOS.  If your modem
     configuration is set to "modem dialing", and you are currently
     online, a dialog box will appear asking if you wish to hang-up
     before exiting.  If you choose NO at this option, you will remain
     online even after you have exited to DOS.  Use this option with
     caution, as if you forget that you are online, you could charge
     up a considerable long distance bill.
Options: Status Line

    The status line displays various important information about the
    current State of RIPterm.  Information displayed left to right:

        ┌───────────┬─────────────┬──────────┬─────────────────┬
        │ F1 = Help │ F10 = Menus │ RIPscrip │ 38400 ■ N81 FDX │
        └───────────┴─────────────┴──────────┴─────────────────┴
             (1)          (2)          (3)      (4)      (5)

        ┬──────┬──────────────────┬─────────┐
        │ COM1 │ RIPterm v1.50.00 │ Offline │
        ┴──────┴──────────────────┴─────────┘
          (6)           (7)           (8)

        (1) How to get the help system table of contents

        (2) How to use the keyboard only to select from the menus

        (3) What terminal emulation is in use, or the name of the log
            file if one has been opened

        (4) The baud rate, parity setting, data bits and stop bits

        (5) Full-duplex (FDX) or half-duplex (HDX)settings

        (6) The COM port that is currently in use

        (7) The current version number of RIPterm

        (8) Whether you are "on-line" or "off-line"

    To display or hide the status line, press ALT-SPACE.
Options: Zoom Windows

     In RIPterm, whenever a window or dialog box pops up on the screen,
     it will "zoom in" and "zoom out" giving a visual feeling of the
     window opening or closing.  This will slow down operation of the
     windowing system a small amount.  For optimal performance of RIPterm,
     toggle Zooming Windows Off.
Options: Clear GRAPHICS Window

     RIPterm uses two windows in RIPscrip graphics mode, a Graphics Window
     and a Text Window.  The Text Window is where all non-graphics data is
     displayed.  The Graphics Window is where all graphical RIPscrip
     commands are displayed.

     Choose this option to clear the Graphics Window only.  If the Graphics
     Window overlaps the Text Window, then some of the text may be erased
     in the process.  The window is cleared to the current background color
     which, by default, is BLACK.

     NOTE: The Graphics Window is often, full screen
Options: Clear the TEXT Window

     RIPterm uses two windows in RIPscrip graphics mode, a Graphics Window
     and a Text Window.  The Graphics Window is where all graphical
     RIPscrip commands are displayed.  The Text Window is where all non-
     graphics data is displayed.

     Choose this option to clear the Texts Window only.  If the Text
     Window overlaps the Graphics Window, then some of the graphics may be
     erased in the process.  The window is cleared to BLACK and the cursor
     moved to the upper left corner of the window.

     NOTE: The Text Window, by default, is full screen.  This may be
           changed by RIPscrip graphics commands.
Options: RESET all Windows

     This command will reset the Text and Graphics Windows to full screen.
     In addition, the screen is cleared and the cursor moved to the upper
     left hand corner of the screen.  This is equivalent to a Clear Screen
     command in other software packages.  In addition, the color palette
     is reset to the standard 16 ANSI colors.
Modem: Modem Settings

     This dialog box is for modifying your modem configuration.  You may
     alter the modem initialization commands, the auto-answer string and
     the modem reset command string.  These options use standard
     Hayes-compatible modem commands.  If you wish to insert a "pause"
     into the command, simply insert a comma (,).

     In addition to modem commands, you may set the COM port, data bits,
     stop bits, parity, and baud rate.  Standard settings are 8 data bits,
     1 stop bit and NO parity (8N1), or 7 data bits, 1 stop bit and EVEN
     parity (7E1).  Additional options allow you to specify touch tone or
     rotary (pulse) dialing, the number of seconds to wait for a
     connection (redial time), whether to add CR/LF, and whether RIPterm
     is connected directly to a modem or not.

     To alter the serial port IRQ settings, choose the interrupt setup
     option from the modem menu.

     These settings are part of the setup, so once you alter them, you
     should choose the SAVE SETUP option from the Modem menu.

          ~INIT STRING~197   ~AUTO ANSWER~198   ~MODEM RESET~199
Modem: Save Setup

    This option will save a number of configuration parameters for
    RIPterm.  Among the various items maintained in the Setup are:

        ■ Modem Setup
        ■ Zooming Windows ON/OFF
        ■ Status Bar ON/OFF
        ■ Serial Port Interrupt settings   (for all four ports)
        ■ Serial Port I/O Address settings (for all four ports)
        ■ CR/LF settings
        ■ Echo Keystrokes setting (duplex)
        ■ Scrollback Buffer Size
        ■ Dialing Directory TOGGLE status
        ■ Use DTR to Hang-up status
        ■ Data Security status
        ■ 101-key Enhanced Keyboard status
        ■ ASCII upload settings
        ■ Default System Font
        ■ Beep ON/OFF status

    Each time you load RIPterm, the setup is loaded and used for the
    current session.

    Setup information is contained in a file called RIPTERM.CNF by
    default.  This can be altered by using the -S parameter when
    starting up RIPterm.  This option instructs RIPterm to use an
    alternate setup file (e.g., RIPTERM -Smysetup.cnf).
Modem: Echo Keystrokes

     This command will toggle whether RIPterm should echo keystrokes to
     the terminal locally, or let the Host BBS perform the echoing.
     Normally, the Host will do this for you so Echo is by default, OFF.
     In some situations though, you may wish to toggle them ON.  One
     such situation is if you are directly connected to another person's
     computer via Modem and are typing to them in a "chat-like" manner.
Modem: Dial the Modem

     This command will prompt you to enter the telephone number to dial.
     You may enter any digits from 0-9.  Hyphens are ignored.  If you
     need to obtain a delay before continuing the rest of the phone
     number, simply enter a comma (,) for a 1/2 second pause.  After
     entering the phone number, the DIALING window will appear showing
     you the current status of RIPterm as it dials the modem.
Modem: Hangup the Modem

     This option will physically attempt to disconnect the modem, thus
     logging you off of whatever Host you are connected to.
Modem: Add CR/LF

     This option will add CR/LF combinations at the end of text lines.
     Normally, this is not necessary.  Some Host Services however,
     require that CR/LF's be ON for you to see text properly.  Normally,
     this option is OFF.  You may toggle it ON if need be.

     If text coming across the modem does not move to the next line, then
     you need to turn this option ON.  If every line of text is separated
     by a blank line, then you need to toggle this option OFF.
Options: Text scroll-back

     This option will activate the text scrollback system.  This allows
     you to view previously displayed text information that has come
     across the modem.  You may set the SCROLLBACK SIZE to a buffer
     size of 5-64k of memory.

     Within Scroll-back, you may choose from the following options:

          SAVE buffer page to a text file
          SAVE entire buffer to a text file
          PRINT the current buffer page, or the entire buffer
          SEARCH for a particular piece of text
          SEARCH again for a previously searched for text string

     At the top of the Scroll-back screen are a number of Icons for the
     above commands.  In addition, are Icons for scrolling UP/DOWN and
     Paging UP/DOWN or moving to the BEGINNING or END of the buffer.

     NOTE: The scroll-back buffer filters out ANSI color codes and
           RIPscrip graphics for an uncluttered text display.
Options: Set Scrollback Size

     This option allows you to specify how much RAM memory RIPterm should
     use for the Scroll-back buffer.  You may choose from 5-64k of memory.
     Depending on how much conventional memory you have on your computer,
     this may limit the amount of memory you can allocate to scroll-back.
     We recommend that you set it to somewhere around 32k unless you know
     that your PC has quite a bit of its 640k memory free for use.  If
     you have numerous Memory Resident Programs (TSR's) loaded, you may
     need to drop the size of your Scroll-back buffer to a smaller value
     for proper operation of RIPterm.

     If RIPterm runs out of memory, it will begin to discard old Scroll-
     back information until it can satisfy the memory request.
Options: Keystroke Macro Editor

     This option will allow you to edit "Hot Keys" in RIPterm.  Macros are
     functions that you can define to perform short-cut operations on the
     BBS Host.  For example, you can instruct RIPterm to make the F5 key
     type your User-ID and hit <ENTER> for you.  This would allow you to
     log-on quickly by simply tapping a single key.  RIPterm's Macro
     system is easy to use, and very powerful!  You can save your macro
     keys to the default Macro file (RIPTERM.KEY), or if you need to have
     multiple macro configurations, you can save macros to different files.
Project: Open Log File

    A log file captures text transmitted from the host into a text
    file.  ANSI color codes and RIPscrip graphics commands are
    filtered out for your convenience.  This command can be very
    powerful on hosts where you want to save data coming across the
    screen to a file that you can read when off-line, at your leisure.
    A log file can be as big as you want, up to the amount of
    currently available disk space.

    To open a log file, select "Open Log File" from the menu.  You
    will be prompted for a filename.  When a log file is open, the
    menu option "Open Log File" changes to "Pause/Close Log", and the
    status bar will show the log file name in the third spot from the
    left, where the terminal emulation is normally displayed.

    If a log file is currently open, selecting "Pause/Close Log" from
    the menu, or clicking on the filename in the status bar will give
    you the option to either pause the log, or to close the file.
    Pausing "suspends" logging to disk temporarily so that you can do
    things without saving them to the log file.  If you are currently
    paused, selecting "Pause/Close Log" again or clicking on the
    filename in the status bar will prompt you to either resume, or
    close the log.

    If a log file is open, and you choose EXIT RIPTERM, it will be
    automatically closed.
Transfer: Download a File

    This command downloads (receives) a file from the host to your
    system.  This is done by what's called a "protocol" transfer.  A
    protocol is like a language that humans speak.  There are a
    number of languages like French, English, and Italian.  If two
    people are speaking in different languages, the net result is
    that no communication occurs.  The same goes for protocols.  Both
    the host and the terminal (RIPterm) must use the same protocol if
    they are to communicate properly.

    To download a file, instruct the host which file you want to
    transfer. Select a protocol from the menu of available protocols.
    When the host says "Ready to download..." or "Ready to send...",
    choose the download option of RIPterm and select the same
    protocol that you chose on the host.  Enter a filename to save to
    your local hard disk and the file transfer will commence.  When
    the transfer is done, you will be returned to terminal mode and
    the file will either exist on your hard disk, or will be
    incomplete or missing entirely if an error occurred.

    The currently supported protocols are:

         X-Modem (checksum)
         X-Modem (CRC)
         X-Modem-1K
         X-Modem-G-1K
         Y-Modem-Batch
         Y-Modem-G
         Z-Modem
         Kermit
         ASCII (text files only!)

     See also, ~UPLOAD A FILE~221
Transfer: Upload a File

    This command upload (send) a file to the host from your system.
    This is done by what's called a "protocol" transfer.  A protocol
    is like a language that humans speak.  There are a number of
    languages like French, English, and Italian.  If two people are
    speaking in different languages, the net result is that no
    communication occurs. The same goes for protocols.  Both the host
    and the terminal (RIPterm) must use the same protocol if they are
    to communicate properly.

    To upload a file, instruct the host to upload, and give the host
    a filename.  Select a protocol from the menu of available
    protocols.  When the host says "Ready to upload..." or "Ready to
    receive...", choose the upload option of RIPterm and select the
    corresponding protocol that you chose on the host.  Enter a
    filename to send from your local hard disk and the file transfer
    will begin.  When the transfer is done, you will be returned to
    terminal mode and if there were no errors in transmission, the
    file will exist on the host.

    The currently supported protocols are:

         X-Modem (checksum)
         X-Modem (CRC)
         X-Modem-1K
         X-Modem-G-1K
         Y-Modem-Batch
         Y-Modem-G
         Z-Modem
         Kermit
         ASCII (text files only!)

     See also, ~DOWNLOAD A FILE~220
Modem: Serial Port Interrupt Setup

     THIS IS AN ADVANCED OPTION AND SHOULD NOT BE USED UNLESS YOU ARE
     FAMILIAR WITH IBM-PC INTERRUPTS AND HARDWARE SETUP!

     This option allows you to customize the Interrupt (IRQ) settings
     for each of your four COM ports.  Normally this will not be
     necessary.  However, some PC's have special configurations that
     require the terminal's setup to be altered if the serial ports
     are to function properly.

     There are five different Interrupts that can be selected for
     each COM port (2, 3, 4, 5, and 7).  If two serial ports in the
     computer use the same Interrupt (ie, a Conflict), then problems
     may arise.
Transfer: ASCII Upload Settings

     This option allows you to modify the default settings for ASCII
     (text) uploads.  Some BBS'es are picky about how fast they can
     take text data being uploaded to them.  With this in mind, you
     can set a short delay in between each line of text sent to the
     host, and/or you can set a delay in between each character sent
     to the host.  Fine tuning this can make ASCII text uploads fast
     and the most optimized they can be for the host systems you
     call.
Project: Jump to DOS

    The "Jump to DOS" feature allows you to shell out to an MS-DOS
    command line while remaining in RIPterm.  You would use this if
    you wanted to obtain a DOS directory, or to run an editor, or use
    DOS in general.  To return to RIPterm from the DOS command line,
    type "EXIT".

    RIPterm will display a special DOS prompt indicating that are
    currently running RIPterm, but executing a DOS shell.  You may
    use any disk drive you want, or change directories.  When you
    type "EXIT", RIPterm will return to your default RIPterm
    directory so that it can re-load files for you.  When you return
    to your RIPterm session, the current graphics screen is restored
    as well as any mouse fields, or other parameters.
Transfer: Upload & Download

     You have the following upload/download protocols to choose from:

         X-Modem (checksum)
         X-Modem (CRC)
         X-Modem-1K
         X-Modem-G-1K
         Y-Modem-Batch
         Y-Modem-G
         Z-Modem
         Kermit
         ASCII (text files only!)

     Simply type <PGDN> for "download file", or <PGUP> for "upload".


Modem: Initialize Modem

     Choosing this option will reset the modem, and send the Modem
     Initialization string to the modem.  This will effectively
     reset the modem to the configured default settings.

     The commands sent to the modem can be altered by choosing
     Modem Settings from the MODEM Pull-down menu (Alt-O).
Modem: Modem Auto-Answer

     This command will transmit the modem Auto-Answer command string
     to the modem.  This command instructs the modem to answer the
     phone after a certain number of rings.

     The commands sent to the modem can be altered by choosing
     Modem Settings from the MODEM Pull-down menu (Alt-O).
Options: System Font

    The System Font allows you to select the font that is used in
    text/ANSI mode.  It does not have any effect on the graphics
    shown. Any subsequent text/ANSI displayed on the screen will
    appear in the chosen system font unless the host explicitly tells
    it to use another font for the text window.

    This mode allows you to specify how "large" text is when you are
    in full-screen text mode.  You have five separate System Fonts to
    choose from.  They are:

            80x43 - default
            80x25 - normal DOS screen size
            40x25 - low-resolution font
            91x43 - get more columns of text at once
            91x25 - get more columns of text at once
Options: 101-key keyboard

    This mode is used in the "doorway mode" (see below).  It allows
    you to send extended 101-key keyboard codes to the doorway system
    running on the host.  This mode is only available on AT
    computers with a 101-key enhanced AT keyboard.  If this option
    locks up your system, disable it.

    This value is part of the RIPterm setup, saved in RIPTERM.CNF.
    If you set this option ON, and it locks your system, and your
    system locks whenever you start up RIPterm, then the option has
    been saved to your setup.  You should run RIPterm with the -E
    option, like this:

        RIPTERM -E

    The first thing you should do is disable the 101-key keyboard
    option and save your setup with ALT-S.  The -E option overrides
    Enhanced 101-key keyboard support for the duration of the current
    session of RIPterm.

Options: Doorway Mode

    This mode is of use on a number of host packages that take
    advantage of "Doors".  When in Doorway mode, any keystroke that
    you enter on your keyboard is transmitted to the host regardless
    of the fact that the keystroke might be a menu shortcut, or
    something that RIPterm would normally process locally.  This
    allows you to use special keystrokes (like INSERT, DELETE, PGUP,
    Function Keys, etc.) on a host program that can take advantage of
    it. The most popular program that takes advantage of this mode is
    DOORWAY by Marshall Dudley.

        PROGRAMMER'S NOTE:

            For the technical minded who want to know how this works,
            this is what's going on:

              ■ The keystroke is recorded using BIOS interrupt
                0x16, sub-function 0x00 for non-101-key keyboards,
                or sub-function 0x10 for 101-key keyboards.

              ■ If register AL contains a value (the ASCII
                character), and AH is equal to 0, then it is
                sent to the host by transmitting the character
                directly over the comm port.

              ■ If AH is not 0, then transmit the contents of AH
                instead to the host by transmitting a null (0),
                then the contents of AH.  If AL == E0, and AH != 0,
                then it is an enhanced 101-key scancode and should
                be sent to the host as a null (0), followed by an
                0xE0, then followed by the raw scan code.
Options: Disable Beeps

    This will disable the Beep character (ASCII character 7, BEL)
    from being played on the PC speaker when received from the host.
    This makes RIPterm "quiet" when you want it to be.  This does not
    override all sounds; just BEEP characters received from the host.
Options: Drop DTR to hangup?

    This option will lower DTR for approximately two seconds to
    disconnect the modem.  If for some reason, the modem still hasn't
    disconnected, hang-up will default to the typical method of
    issuing a +++, followed by an ATH to hang-up the modem.  If after
    all hang-up processing is complete, and the Modem still hasn't
    disconnected, a message saying "Hang-up Failed" will be displayed.
Options: Data Security

Data: Store Information

    This option gives you control over host data queries to your
    system.  This option defaults to ON, giving you the ability to
    scrutinize any queries by the host to ask your system for a piece
    of information.  This does not apply to pre-defined text
    variables, just variables that contain data that you've entered.

    How does this apply to you?  Well, RIPscrip has the inherent
    ability to pop-up dialog boxes onto your screen asking you for a
    piece of information.  Depending on the request, this information
    might be stored to your local RIPterm database for future use (by
    the same host, or potentially another).  This option exists so
    that if a host asks your terminal for a piece of information, you
    have the ability to intervene (i.e., prevent the information from
    being sent).  This override feature is for security purposes in
    the event that your database contains sensitive information that
    you do not want to be given out without your explicit consent.
Data: Show Variables

    This option displays all text variables that have been stored to
    the local RIPTERM.DB database file.  All variables are listed to
    the current text window, but are not sent to the host.  This
    allows you to see what is currently in your database.

    NOTE: The variables are appended to the scrollback buffer.  You
          can view them by selecting text scrollback from the
          Options menu, or pressing ALT-B.
Data: Built-in Variables

    This displays the contents of all text variables that are built
    into RIPterm.  Some variables are pre-defined in the sense that
    RIPterm doesn't need you to instruct it with information.  Among
    the various pre-defined variables are things like $DATE$, $TIME$,
    and other such variables that change frequently.  Some variables
    do not contain valid text data due to their nature.  These might
    include variables like $SBARON$, or $SBAROFF$ which turn display
    or hide the Status Bar.  When listing these variables, the
    contents are listed as blank.

    NOTE: The variables are appended to the scrollback buffer.  You
          can view them by selecting text scrollback from the
          Options menu, or pressing ALT-B.
Modem: Serial Addresses

    THIS IS AN ADVANCED OPTION AND SHOULD NOT BE USED UNLESS YOU ARE
    FAMILIAR WITH IBM-PC BASE I/O ADDRESSES AND HARDWARE SETUP!

    This option allows you to customize the base I/O addresses of the
    four COM ports that RIPterm can utilize.  Normally, you will not
    need to alter these settings.  If you are a PC technician, or you
    have serial port configuration that doesn't comply with the
    COM1-COM4 standards, you may need to alter your addresses for
    these ports to make RIPterm function properly.  The standard
    addresses for COM1-4 are as follows on an AT compatible computer:

        PORT    ADDRESS    IRQ
        ----------------------
        COM1      3F8       4
        COM2      2F8       3
        COM3      3E8       4
        COM4      2E8       3
MODEM SETUP INFORMATION

     This dialog box will allow you to modify your modem configuration.
     You may alter the Modem Initialization commands, the Auto-Answer
     string (not currently used), and the Modem Reset command string.
     These options use standard Hayes-compatible modem commands.  If you
     wish to insert a "pause" into the command, simply insert a comma.

     In addition to modem commands, you may set the current COM port,
     the Data Bits, Stop Bits, Parity Setting and Baud Rate.  Standard
     settings are either 8 data bits, 1 stop bit and NO parity (8N1),
     or 7 data bits, 1 stop bit and EVEN parity (7E1).  Additional options
     allow you to specify Touch Tone or Rotary (pulse) dialing, the number
     of seconds to wait for a connection (Redial Time), whether to add
     CR/LF combinations and whether RIPterm is connected directly to a
     modem or not.

     To alter the serial port IRQ settings, choose the INTERRUPT SETUP
     option.

     These settings are part of the setup, so once you alter them, you
     should choose the SAVE SETUP option.

     See also, ~INIT-STRING~302, ~AUTO-ANSWER~303 and ~RESET-MODEM~304
MODEM INIT STRING HELP

     This field is the modem command that is physically sent to the
     modem when RIPterm boots up.  All modem commands begin with an
     "AT", short for 'ATtention'.  At the end of the command should
     be a ^M (carriage return).  You may specify control characters
     by preceding the character with a caret (^).  So, a CTRL-C would
     be ^C.

     For more information on available Modem Commands, consult your
     modem manual.
MODEM AUTO-ANSWER STRING HELP

     This modem command is what would be sent to the modem to set it
     for "auto-answer" mode.  Auto-Answer means that the modem will
     automatically answer the phone when it RING's.  All modem commands
     begin with an "AT", short for 'ATtention'.  At the end of the
     command should be a ^M (carriage return).  You may specify control
     characters by preceding the character with a caret (^).  So, a
     CTRL-C would be ^C.

     For more information on available Modem Commands, consult your
     modem manual.
MODEM RESET STRING HELP

     This field is the modem command that is physically sent to the
     modem when the modem needs to be reset.  This may be necessary
     if you "hangup" the modem, abort a dial attempt, or exit RIPterm.
     All modem commands begin with an "AT", short for 'ATtention'.
     At the end of the command should be a ^M (carriage return).  You
     may specify control characters by preceding the character with a
     caret (^).  So, a CTRL-C would be ^C.

     For more information on available Modem Commands, consult your
     modem manual.
Full-Duplex mode ON

     Your modem is now configured in Full-Duplex mode.  This means that
     the Host BBS will echo keystrokes that you type to your computer
     instead of your terminal displaying them immediately to the screen.
     This is typically, the normal mode of operation.  If you do not
     see your keystrokes when you type, then this is the wrong mode of
     operation and you should toggle Full-Duplex OFF.
Full-Duplex mode OFF

     Your modem is now configured in Half-Duplex mode.  This means that
     RIPterm will automatically display each keystroke that you type on
     the screen for you instead of letting the Host BBS echo them to
     your PC over the modem (a round-robin approach).  If you see each
     keystroke that you type twice, then you need to be in Full-Duplex
     ON mode.
DEFAULT CONFIG SAVED

     This message is displayed when your default RIPterm configuration
     has been saved successfully to disk.  When you re-load RIPterm,
     the setup will be loaded from disk and the settings saved therein
     will be used instead of the defaults.
CANNOT SAVE DEFAULT CONFIG

     Something went wrong when RIPterm tried to save its Setup data to
     disk.  A number of problems could cause this, like:

          - Disk Full (no space on hard disk)
          - A Disk error (bad sector)
          - Your PC's configuration is not setup properly (ie, FILES=
            not being set to a high enough value)
Image not correct Icon Format

     A RIPscrip command was encountered which instructed RIPterm to load
     an Icon off of your hard disk.  However, the Icon that was found
     was not a valid Icon File.  Your Icon file is most likely corrupt.
     In order to correct this situation, you should download the latest
     Icon Files from the Host BBS and place them in the ICONS\ directory
     under the RIPTERM directory.
ZOOMING WINDOWS ENABLED

     Windows and Dialog Boxes will now "zoom in" and "zoom out" when
     selected.  This provides a visual feeling of the windows opening
     and closing.  This will slightly slow down performance of RIPterm,
     but the visual look and feel may outweigh the performance issue.
ZOOMING WINDOWS DISABLED

     Zooming Windows and Dialog Boxes are now disabled.  Windows will
     now open and close as quickly as possible, giving you optimal
     performance.
Help - Error reading file

     An error occured when trying to read a file from your disk drive.
     This could occur from several situations, including:

          - A bad diskette (not applicable on hard disks)
          - A corrupt file was read
          - Your disk has a bad sector and needs maintenance
          - You are on a network and a "sharing violation" occured

     In any event, you should consult your MS-DOS manual and determine
     the source of the problem.  Until then, the file may not be
     readable.
Can't view help screen

     There was insufficient memory to load the desired help screen.
Chosen Help Screen does not exist

     An attempt was made to view a Help Screen that did not exist in
     the help file.
Selected Help Item out of range

     A Help Keyword was selected, yet has no corresponding Help Screen
     to display.  This message should not occur under normal
     circumstances.
Help on Memory and disk space available

     This option will display the amount of RAM memory currently available
     in your 640k DOS configuration.  In addition, the amount of disk
     space on the currently selected hard disk will be displayed in bytes.
Image too large for clipboard

     A RIPscrip command instructed RIPterm to place a portion of graphics
     on your screen onto the Clipboard, however, the size of the region
     was too big for the clipboard to handle.  This should not normally
     occur.  Line Noise MAY cause this problem.
Word Wrap Overflow!

     This message can occur if a text import block was word wrapped, but
     the Word Wrap table overflowed (ie, too much data).  This should
     not occur under normal circumstances.
Exit to DOS?

     This dialog box allows you to exit RIPterm and return to DOS.  If you
     are currently connected to a Host, you will be prompted whether or
     not you wish to hang-up the modem.
Disconnect the modem before exiting?

     This option allows you to disconnect from the Host before exiting,
     thus preventing unwanted long-distance bills if you forget to
     hang-up.
HELP WITH REDIAL TIMEOUT VALUE

     This option controls how many seconds RIPterm will wait before a
     connection to a Host is established when "dialing the modem".
     RIPterm will wait <X> number of seconds from the time it dials
     the phone line for a connection to be established.  If a connection
     has not been found by this time, RIPterm aborts the dialing attempt
     and tries again.
HELP EDITING THE SCROLLBACK SIZE (IN K)

     This option allows you to specify how much RAM memory RIPterm should
     use for the Scroll-back buffer.  You may choose from 5-64k of memory.
     Depending on how much conventional memory you have on your computer,
     this may limit the amount of memory you can allocate to scroll-back.
     We recommend that you set it to somewhere around 32k unless you know
     that your PC has quite a bit of its 640k memory free for use.  If
     you have numerous Memory Resident Programs (TSR's) loaded, you may
     need to drop the size of your Scroll-back buffer to a smaller value
     for proper operation of RIPterm.

     If RIPterm runs out of memory, it will begin to discard old Scroll-
     back information until it can satisfy the memory request.
SPECIFIED SCROLLBACK SIZE (IN K) IS OUT OF RANGE [5-64]

     You must specify a number of K between 5 and 64 for your Scroll-back
     buffer.  Numbers outside this range are not permitted.
SCROLLBACK HELP

     You are currently in Scroll-back mode.  This allows you to view
     previously displayed text information that has come across the modem.
     You may set the SCROLLBACK SIZE to a buffer size of 5-64k of memory.

     Within Scroll-back, you may choose from the following options:

          SAVE buffer page to a text file
          SAVE entire buffer to a text file
          PRINT the current buffer page, or the entire buffer
          SEARCH for a particular piece of text
          SEARCH again for a previously searched for text string

     At the top of the Scroll-back screen are a number of Icons for the
     above commands.  In addition, are Icons for scrolling UP/DOWN and
     Paging UP/DOWN or moving to the BEGINNING or END of the buffer.

     NOTE: The scroll-back buffer filters out ANSI color codes and
           RIPscrip graphics for an uncluttered text display.
PRINTER NOT RESPONDING

     After choosing the PRINT option, RIPterm discovered that the
     printer is not responding.  This could occur if the printer is not
     turned on, not plugged in, or if the cable connecting the computer
     and the printer is loose or broken.
PRINTER IS OFF-LINE

     The printer is currently "off-line".  Turn it On-Line and click
     on Re-Try.
PRINTER IS OUT OF PAPER

     The printer has run out of paper.  In order to continue, you need
     to insert more paper into your printer and click on Re-Try.
PRINT THE SCROLLBACK PAGE OR THE ENTIRE BUFFER?

     Do you wish to print the contents of the entire Scroll-back buffer,
     or just the currently displayed page?
TEXT NOT FOUND IN SEARCH

     You chose the Search option, but what you tried to search for was
     not contained in the Scroll-back buffer from the top of screen to
     the bottom of the buffer.
TEXT NOT FOUND IN SEARCH-AGAIN

     There are no more occurences of the Search Text found in the
     remainder of the Scroll-back buffer.
MACRO EDITOR

     Macros are functions that you can define to perform short-cut
     operations on the BBS Host.  For example, you can instruct RIPterm
     to make the F5 key type your User-ID and hit <ENTER> for you.  This
     would allow you to log-on quickly by simply tapping a single key.
     RIPterm's Macro system is easy to use, and very powerful!  You can
     save your macro keys to the default Macro file (RIPTERM.KEY), or
     if you need to have multiple macro configurations, you can save
     macros to different files.

     The currently defined macros are displayed in the scrolling window on
     the left side of the Dialog Box.  On the right side, are buttons
     which allow you to edit/add macros, delete existing macros, Clear all
     macros, Load a macro file and Save all macros to a macro file.

     When selecting macros to edit/delete, you may click on an existing
     macro then click on EDIT or DELETE.  If you wish to edit/delete more
     than one macro at the same time, click on each macro while holding
     down the SHIFT key.  If you click on EDIT without any macros being
     hilighted, you go into ADD macro mode.

     You may store multiple macros into Macro .KEY Files for future use.
     You may have as many macro files as you wish limited only by the
     amount of available disk space.


                   ~EDIT~366    ~SAVE~369    ~LOAD~370
ENTER KEYSTROKE FOR THE MACRO EDITOR

     Type the keystroke that you wish to record a macro for.  For example,
     if you wanted to record a macro for the F5 key, simply press the F5
     key.  You may specify CTRL, ALT or SHIFT keys as well.  RIPterm's
     macro editor allows you to define literally hundreds of simultaneous
     macros using nearly as complex a keystroke as you want.  To exit
     the ADD mode, simply hit the <SPACE> key.
TEXT TO SEND HOST WHEN THIS KEY IS TYPED

     Enter the text that should be sent to the Host (or the modem) if this
     macro is entered.  In other words, enter the text that you want to be
     associated with this macro.  For example, if you wanted to send the
     text "Hello World" to the BBS when you hit F5, simply type in "Hello
     World".

     You may enter Control Characters into your macros by specifying a
     caret (^) on your keyboard, followed by the letter of the Control Key
     you want to send.  For example, a CTRL-C would be represented as ^C.
     A Carriage Return is specified as ^M.  Also, an ESCAPE is generated
     by the sequence ^[ ... There are a number of different combinations
     of ~CONTROL CHARACTERS~386 that you may choose from.

     In addition to Control Characters, you can also insert ~TEXT VARIABLES~387
     or ~POPUP LISTS~389 into your Macros.  See the related sections of the
     Help for more information on these features.

ENTER MACRO FILENAME TO SAVE

     Enter the filename that you want to save your defined macros to.  By
     default, the Macro File RIPTERM.KEY is prompted.  If you do not wish
     to store your existing macros as the "Default RIPterm" macros, save
     them to a different file.
ENTER MACRO FILENAME TO LOAD

     Enter the filename of the Macro .KEY file you wish to load.  Macro
     files are contained in the current RIPTERM directory unless other-
     wise specified.  By default, RIPTERM.KEY is prompted, so that you
     can load the default macros quickly and easily.  If you wish to
     load a custom, non-default macro file, simply backspace over the
     existing filename and enter the proper filename you wish to load.
Enter Capture Log Filename

     You are being prompted to enter the Filename that you wish to save
     Log-File data to.  This file can be as large as you want, limited
     only by the amount of available disk space.  Please enter the
     filename to save this information to, or hit <ESC> to abort Log-
     File mode.
Transmit Line Delay

     Sometimes when uploading ASCII files to a Host System, it is
     necessary to pause in between each line so that the system can
     process the data.  If you find that data is becoming lost, or
     garbled by the system when you perform an ASCII upload, you may
     need to increase the Line Delay option for ASCII Uploads.  You
     may specify a time value in 1/10'ths of a second.  Therefore, if
     you specify a value of 11, it would be a 1.1 second pause in
     between lines.
Transmit Character Delay

     Under some circumstances, when performing an ASCII upload to a
     Host System, it is necessary to insert Pauses in between each
     character that is sent to the Host.  This may be necessary in
     situations where the Host must process each character as it is
     sent, rather than every line of text sent.  You may specify a
     time value in 1/10'ths of a second.  Therefore, if you specify
     a value of 11, it would be a 1.1 second pause in between lines.
You must choose one of the hilighted Buttons first...

     The Button you have chosen depends on another Radio button
     being selected.  You must click on one of the hilighted buttons
     in order for this option to be available.
That Button is not available at the moment...

     The Button you have chosen depends on another Button being
     clicked.  Unfortunately, the other Button is unknown or
     cannot be located.  Since this Button depends on something
     that isn't working properly, this Button will not function
     either.

     NOTE: A "~noisy telephone connection~375" can cause this problem.
Noisy Telephone Connections

     If you get a noisy telephone connection, the Graphics that
     you see might become garbled in some fashion.  Since RIPterm
     does more than simply display pictures on the screen, this
     can disturb underlying (invisible) operations as well.

     Solutions: Hang-up and try calling again.  Often times,
                this can resolve the problem.

                Long distance connections are typically the
                noisiest of connections.  Check with your
                operator and find out if you can use a
                different "Long Distance Carrier" like MCI,
                AT&T, US Sprint, etc.

                Use an Error-Correcting modem (provided the
                Service you are calling can support one).
No Help available on that option

     An attempt was made to load a Help Screen that was not available.
     This should not occur under normal circumstances.
CONTROL CHARACTER COMBINATIONS

     Not all BBS'es will allow you to use control characters on their
     Service.  Regardless of that, the capability to send any Control
     Character exists in your Keystroke Macro editor.  The most
     commonly used Control Characters are:

        INDIVIDUAL CONTROL CHARACTERS         SPECIAL KEYSTROKES
        ===========================================================
        ^G ... Beep                           ^[[A ... Up Arrow
        ^L ... Clear Screen (Top of Form)     ^[[B ... Down Arrow
        ^M ... Carriage Return                ^[[C ... Right Arrow
        ^C ... Break (sometimes)              ^[[D ... Left Arrow
        ^H ... Backspace                      ^[[H ... Home Key
        ^[ ... Escape character               ^[[K ... End Key
        ^S ... Pause data transmission        ^[[L ... Control Home
        ^Q ... Resume data transmission
















           ~TEXT VARIABLES~387       ~POPUP LISTS~389       ~MACROS~367
TEXT VARIABLES

     A special feature of RIPterm allows it to understand what a Text
     Variable is.  A text variable is a piece of text that RIPterm
     knows something more about.  For example, the Text Variable
     $DATE$ is known to represent the current Date on your PC.  The
     BBS may ask your PC what the values of one or more of these
     variables is, and if your Terminal knows that particular Text
     Variable, it will tell the BBS.

     There are two types of Text Variables.  There are built-in Text
     Variables that RIPterm will ALWAYS know about.  Then there are
     also User Text Variables that can contain a variety of information
     depending on what the User of RIPterm entered at the time the
     Variable was created.  For example, the BBS might ask you what the
     contents of the $FULL_NAME$ variable is, and if RIPterm doesn't
     know, it could pop-up a field on the screen and ask you about it.
     From then on, RIPterm will remember that piece of information for
     the next time it is needed by a BBS.

     You may use either the pre-defined Text Variables, or the User
     Text Variables at any place that allows Text Variables.


  ~PRE-DEFINED VARIABLES~388   ~POP-UP LIST~389   ~CONTROL CHARACTERS~386   ~MACROS~367
PRE-DEFINED TEXT VARIABLES

     ~$DATE$~400      Date in short format (eg, 12/19/92)
     ~$MONTH$~401     Month Name
     ~$MONTHNUM$~402  Month (in format 1-12)
     ~$DAY$~403       Day in numeric form (eg, 31)
     ~$DOY$~404       Day of year (001-366)
     ~$YEAR$~405      2 digit year (without century) (00-99)
     ~$FYEAR$~406     4 digit year (with century) (0000-9999)
     ~$TIME$~407      Time in standard format (eg, 12:03:14)
     ~$HOUR$~408      Hour (format HH) - normal style
     ~$MHOUR$~409     Hour (format HH) - Military style
     ~$MIN$~410       Minutes (00-59)
     ~$SEC$~411       Seconds (00-59)
     ~$AMPM$~412      Returns either AM or PM depending on time
     ~$DATETIME$~413  Date & Time (eg, Sat Dec 19 14:38:50 1992)
     ~$TIMEZONE$~414  Time Zone or "NONE" if unknown (eg, Pacific)
     ~$DOW$~415       Day of week fully spelled out (eg, Friday)
     ~$ADOW$~416      Abbreviated Day of Week (eg, Mon, Tue, etc)
     ~$WDAY$~417      Weekday where 0 is Sunday (0-6)
     ~$WOY$~418       Week of current year 00-53; Sunday=1st Day of Week
     ~$WOYM$~419      Week of current year 00-53; Monday=1st Day of Week
     ~$RIPVER$~420    RIPterm version.  (eg, "RIPSCRIP010010201")
     ~$STATBAR$~421   If Status Bar is on, returns YES, otherwise NO
     ~$X$~422         X Mouse location   (format: XXXX)
     ~$Y$~423         Y Mouse location   (format: YYYY)
     ~$XY$~424        X/Y Mouse Location (format: XXXX:YYYY)
     ~$XYM$~425       X, Y & button status (format: XXXX:YYYY:LMR)
     ~$M$~426         Mouse Button Status: LMR (eg, 101)
     ~$MSTAT$~427     Mouse Status (format: XXXX:YYYY:LMR)

     ~<MORE>~391

  ~TEXT VARIABLES~387   ~POP-UP LIST DESCRIPTION~389   ~CONTROL CHARACTERS~386   ~MACROS~367
POP-UP LISTS

     In your Keystroke Macros you can take advantage of a Unique feature
     of RIPterm - Popup Pick-Lists.  A Popup Pick-List is simply a list
     that pops up allowing you to choose from one of several available
     values.  Whichever entry in the list you choose will be inserted
     into your Keystroke Macro in place of the List Definition.

     In order to use Popup Pick-Lists in your Keystroke Macros, you must
     define the List in the text of your Macro.

     A List is created by putting the special List instructions inside
     of two parenthesis (( and )).  The list instructions consist of
     an optional Question, followed by one or more entries to put in
     the List.  For example, ((Send Email to?::Sysop,Cosysop,Joe))
     says to Pop-Up a list asking you "Send Email to?", giving you
     the choices of "Sysop", "Cosysop", and "Joe".

     By default, if you hit <ESCAPE> instead of picking an entry in the
     list, then nothing will be inserted into the text of your macro.
     You can indicate that the user MUST pick an entry by puttin an
     asterisk (*) at the beginning of the question.  For example,
     ((*Send Mail to?::Sysop,Joe)).  This would make it so that the User
     MUST choose either SYSOP or JOE.

     In the previous examples, SYSOP, COSYSOP and JOE are the actual text
     responses that are inserted into your Macros.  These commands are
     also the same things that are displayed in the Listing.  If you want
     to use something else instead of the actual "return text", you can.
     When you enter the List Entry, add an @description to the end of it.

     For example, ((Send Mail To?::Sysop@The Head Honcho,Cosysop,Joe))

     ~MORE~390           ~TEXT VARIABLES~387   ~CONTROL CHARACTERS~386  ~MACROS~367
POP-UP LISTS (continued)

     One final feature of Popup Pick-Lists allow you to specify a hotkey
     for each entry in the List.  For example, if you wanted the first
     character of each entry to be hilighted (thus allowing you to select
     that character to activate the entry), simply put a tilda (~~) or an
     underline (_) before and after the keystroke.  For example "_S_ysop"
     would hilight the "S" in "Sysop".  You can hilight more than one
     character, but only the first one will be the active hotkey.  If you
     omit the second tilda or underline, then the remainder of the
     description will be hilighted.

     NOTE: If you use a Tilda or an Underline in the actual Text Response
           command (not the description), then those characters will be
           automatically inserted into your Macro when it gets transmitted
           to the BBS.  This is probably not what you would want to do.
           Bottom line, only use Hotkey features on List Entries where you
           specify a Description!

           If you do not specify a Question, then the List will ask you:
           "Choose one of the following:"

           You may specify up to twenty List Entries for any one list.

     Examples:

       ((Send E-Mail to?::Sysop,Joe,Mike))
       ((*Send EMail to?::Sysop@The Head Honcho,Joe,Mike@My Brother))
       ((::Sysop@_T_he Head Honcho,Joe,Mike@My _B_rother))
       ((Sysop,Joe,Mike,George))



  ~POP-UP LIST DESCRIPTION~389   ~TEXT VARIABLES~387   ~CONTROL CHARACTERS~386  ~MACROS~367
PRE-DEFINED TEXT VARIABLES (continued)

     The following is a list of "active" text variables.  Rather than
     be replaced with some piece of text, they perform some specific
     action.

     ~$SBARON$~428    Turn ON  the Status Bar (Active Text Variable)
     ~$SBAROFF$429    Turn OFF the Status Bar (Active Text Variable)
     ~$ETW$~430       Erase text window
     ~$DTW$~431       Disable text window
     ~$EGW$~432       Erase graphics window
     ~$MKILL$~433     Kill (delete) all mouse field definitions
     ~$BEEP$~434      Beep there terminal (like CTRL-G does)
     ~$BLIP$~435      Make a short "blipping" sound
     ~$MUSIC$~436     Make a musical (cheerful) sound
     ~$PCB$~437       Paste Clipboard at last location
     ~$SMF$~438       Save Mouse Fields
     ~$RMF$~439       Restore Mouse Fields

     ~<PRE-DEFINED TEXT VARIABLES>~388


  ~TEXT VARIABLES~387   ~POP-UP LIST DESCRIPTION~389   ~CONTROL CHARACTERS~386   ~MACROS~367


$DATE$ ... Date in short format (eg, 12/19/92)

     This Text Variable will be transformed into the current Date.
     It will be displayed in the format MM/DD/YY.



     Example:  $DATE$ = 12/19/92
























   ~NEXT~401     ~PRE-DEFINED TEXT VARIABLES~388     ~TEXT VARIABLE DESCRIPTION~387
$MONTH$ ... Month Name

     This Text Variable will be transformed into the name of the
     Current Month.  It will be not abbreviated (eg, "November"
     instead of "Nov")



     Example:  $MONTH$ = December






















   ~NEXT~402   ~PREV~400   ~PRE-DEFINED TEXT VARIABLES~388   ~TEXT VARIABLE DESCRIPTION~387
$MONTHNUM$ ... Month (in format 1-12)

     This Text Variable is transformed into a Number representing
     the Current Month.  January=01 and December=12.  Therefore,
     the possible values for $MONTHNUM$ can range from 01-12.



     Example:  $MONTHNUM$ = 12























   ~NEXT~403   ~PREV~401   ~PRE-DEFINED TEXT VARIABLES~388   ~TEXT VARIABLE DESCRIPTION~387
$DAY$ ... Day in numeric form (eg, 31)


     This Text Variable is transformed into a Number representing
     the Current Day of the month.  Possible values for this
     Variable are from 01-31.



     Example:  $DAY$ = 05






















   ~NEXT~404   ~PREV~402   ~PRE-DEFINED TEXT VARIABLES~388   ~TEXT VARIABLE DESCRIPTION~387
$DOY$ ... Day of year (001-366)


     This Text Variable will be transformed into a Number representing
     the Day of the current Year.  Since a year contains 365 days (unless
     it is a Leap-Year where it contains 366), then the possible values
     that $DOY$ can be are 001-366.



     Example: $DOY$ = 214





















   ~NEXT~405   ~PREV~403   ~PRE-DEFINED TEXT VARIABLES~388   ~TEXT VARIABLE DESCRIPTION~387
$YEAR$ ... 2 digit year (without century) (00-99)


     This Text Variable will be transformed into a two-digit number
     representing the Current Year.



     Example: $YEAR$ = 92























   ~NEXT~406   ~PREV~404   ~PRE-DEFINED TEXT VARIABLES~388   ~TEXT VARIABLE DESCRIPTION~387
$FYEAR$ ... 4 digit year (with century) (0000-9999)

     This Text Variable will be transformed into a four-digit number
     that represents the Current Year.



     Example:  $FYEAR$ = 1992
























   ~NEXT~407   ~PREV~405   ~PRE-DEFINED TEXT VARIABLES~388   ~TEXT VARIABLE DESCRIPTION~387
$TIME$ ... Time in standard format (eg, 12:03:14)

     This Text Variable will be transformed into the Current Time.
     The time will be in military format (hours from 00-23).



     Example:  $TIME$ = 18:09:33
























   ~NEXT~408   ~PREV~406   ~PRE-DEFINED TEXT VARIABLES~388   ~TEXT VARIABLE DESCRIPTION~387
$HOUR$ .... Hour (format HH) - normal style

     This Text Variable will be transformed into a two-digit number
     representing the Current Hour.  This variable may be anywhere
     from 01-12.  This does not use Military format.



     Example:  $HOUR$ = 11























   ~NEXT~409   ~PREV~407   ~PRE-DEFINED TEXT VARIABLES~388   ~TEXT VARIABLE DESCRIPTION~387
$MHOUR$ ... Hour (format HH) - Military style

     This Text Variable will be transformed into a two-digit number
     representing the Current Hour in military format.  This variable
     may range anywhere from 00-23.



     Example: $MHOUR$ = 17























   ~NEXT~410   ~PREV~408   ~PRE-DEFINED TEXT VARIABLES~388   ~TEXT VARIABLE DESCRIPTION~387
$MIN$ ... Minutes (00-59)

     This Text Variable will be transformed into a two-digit number
     representing the Current Minutes in the Hour.  Possible values
     for this Variable are 00-59.



     Example:  $MIN$ = 45























   ~NEXT~411   ~PREV~409   ~PRE-DEFINED TEXT VARIABLES~388   ~TEXT VARIABLE DESCRIPTION~387
$SEC$ ... Seconds (00-59)

     This Text Variable will be transformed into a two-digit number
     representing the Current Seconds of the Minute.  Possible values
     for this Variable are 00-59.



     Example: $SEC$ = 59























   ~NEXT~412   ~PREV~410   ~PRE-DEFINED TEXT VARIABLES~388   ~TEXT VARIABLE DESCRIPTION~387
$AMPM$ ... Returns either AM or PM depending on time

     This Text Variable will be transformed into a two-character
     value of either "AM" or "PM" depending on what time it is.



     Example: $AMPM$ = PM
























   ~NEXT~413   ~PREV~411   ~PRE-DEFINED TEXT VARIABLES~388   ~TEXT VARIABLE DESCRIPTION~387
$DATETIME$ ... Date & Time (eg, Sat Dec 19 14:38:50 1992)

     This Text Variable will be transformed into a combination Date
     and Time.  The format is somewhat different than standard
     Time/date notation.  The format used is:

          DAY-OF-WEEK   MONTH   DAY-OF-MONTH  HH:MM:SS  YEAR



     Example:  $DATETIME$ = Sat Dec 19 14:38:50 1992





















   ~NEXT~414   ~PREV~412   ~PRE-DEFINED TEXT VARIABLES~388   ~TEXT VARIABLE DESCRIPTION~387
$TIMEZONE$ ... Time Zone or "NONE" if unknown (eg, Pacific)

     This Text Variable will be transformed into a a word/phrase that
     describes the Current Time-Zone you are in.  This may be returned
     as anything like "PST" for Pacific Standard Time, "EST" for Eastern
     Standard Time, etc.  If the Time-Zone is not set on your PC, this
     Variable will respond with "NONE".



     Example: $TIMEZONE$ = PST





















   ~NEXT~415   ~PREV~413   ~PRE-DEFINED TEXT VARIABLES~388   ~TEXT VARIABLE DESCRIPTION~387
$DOW$ ... Day of week fully spelled out (eg, Friday)

     This Text Variable will be transformed into the Current Day
     of the Week.  The name will be fully spelled out.  This
     Variable can be any of the values: Sunday, Monday, Tuesday,
     Wednesday, Thursday, Friday and Saturday.



     Example:  $DOW$ = Saturday






















   ~NEXT~416   ~PREV~414   ~PRE-DEFINED TEXT VARIABLES~388   ~TEXT VARIABLE DESCRIPTION~387
$ADOW$ ... Abbreviated Day of Week (eg, Mon, Tue, etc)

     This Text Variable will be transformed into the Current Day
     of the week, in abbreviated form.  This variable may be any
     of the following values: Sun, Mon, Tue, Wed, Thu, Fri and Sat.



     Example:  $ADOW$ = Mon























   ~NEXT~417   ~PREV~415   ~PRE-DEFINED TEXT VARIABLES~388   ~TEXT VARIABLE DESCRIPTION~387
$WDAY$ ... Weekday where 0 is Sunday (0-6)

     This Text Variable will be transformed into a one-digit number
     representing the Number of the Day of the Week.  Possible values
     for this Variable are 0-6, where 0=Sunday (the first day in the
     week).



     Example: $WDAY$ = 2






















   ~NEXT~418   ~PREV~416   ~PRE-DEFINED TEXT VARIABLES~388   ~TEXT VARIABLE DESCRIPTION~387
$WOY$ ... Week of current year 00-53; Sunday=1st Day of Week

     This Text Variable will be transformed into a number from 00-53,
     representing the Week Number in the current year.  Even though
     there are 52 weeks in a year, a week might not begin exactly on
     the first day of the year, so a maximum value for this variable
     can be 53 under these circumstances.  For this Variable, SUNDAY
     is considered to be the first day of the week.



     Example:  $WOY$ = 32




















   ~NEXT~419   ~PREV~417   ~PRE-DEFINED TEXT VARIABLES~388   ~TEXT VARIABLE DESCRIPTION~387
$WOYM$ ... Week of current year 00-53; Monday=1st Day of Week


     This Text Variable will be transformed into a number from 00-53,
     representing the Week Number in the current year.  Even though
     there are 52 weeks in a year, a week might not begin exactly on
     the first day of the year, so a maximum value for this variable
     can be 53 under these circumstances.  For this Variable, MONDAY
     is considered to be the first day of the week.



     Example:  $WOYM$ = 32



















   ~NEXT~420   ~PREV~418   ~PRE-DEFINED TEXT VARIABLES~388   ~TEXT VARIABLE DESCRIPTION~387
$RIPVER$ ... RIPterm version (eg, "RIPSCRIP015000")

     This Text Variable will be transformed into a key-phrase which
     will identify a RIPterm software package.  It is designed to
     be used by a Host BBS to detect what version of RIPscrip
     graphics your Terminal can support.  When this Text Variable
     is used, it will respond back with "RIPSCRIP" followed by
     the full Version Number (eg, 01.50.00), without the periods.



     Example: $RIPVER$ = RIPSCRIP015000




















   ~NEXT~421   ~PREV~419   ~PRE-DEFINED TEXT VARIABLES~388   ~TEXT VARIABLE DESCRIPTION~387
$STATBAR$ ... If Status Bar is on, returns YES, otherwise NO

     This Text Variable will be transformed into a "YES" if the Status
     Bar is currently On on the Terminal.  If the Status Bar is not
     visible, then this Variable will be "NO".



     Example:  $STATBAR$ = YES























   ~NEXT~422   ~PREV~420   ~PRE-DEFINED TEXT VARIABLES~388   ~TEXT VARIABLE DESCRIPTION~387
$X$ ... X Mouse location   (format: XXXX)

     This Text Variable is for reporting the current X location of
     the Mouse to the BBS.  This could be used interactively by the
     BBS (or a game on the BBS) to deterimine the location of the
     mouse cursor.  Only the X value of the Mouse (X,Y) location is
     returned to the BBS.  The value will be 0000-9999 depending on
     what the current position is.



     Example:  $X$ = 0523




















   ~NEXT~423   ~PREV~421   ~PRE-DEFINED TEXT VARIABLES~388   ~TEXT VARIABLE DESCRIPTION~387
$Y$ ... Y Mouse location   (format: YYYY)

     This Text Variable is for reporting the current Y location of
     the Mouse to the BBS.  This could be used interactively by the
     BBS (or a game on the BBS) to deterimine the location of the
     mouse cursor.  Only the Y value of the Mouse (X,Y) location is
     returned to the BBS.  The value will be 0000-9999 depending on
     what the current position is.



     Example:  $Y$ = 0244




















   ~NEXT~424   ~PREV~422   ~PRE-DEFINED TEXT VARIABLES~388   ~TEXT VARIABLE DESCRIPTION~387
$XY$ ... X/Y Mouse Location (format: XXXX:YYYY)

     This Text Variable will be transformed into a combination of
     both the X and Y locations of the Mouse Cursor.  A colon (:) is
     used to separate the two values.  Either the X or Y values may
     range from 0000-9999 depending on the current location.  The
     format that this value takes on is:  XXXX:YYYY



     Example:  $XY$ = 0297:0321





















   ~NEXT~425   ~PREV~423   ~PRE-DEFINED TEXT VARIABLES~388   ~TEXT VARIABLE DESCRIPTION~387
$XYM$ ... X, Y & button status (format: XXXX:YYYY:LMR)

     This Text Variable will be transformed into a combination of
     the X and Y Mouse Cursor location, and a status of which
     Mouse Buttons are pressed (if any).  The format of the returned
     text is XXXX:YYYY:LMR where XXXX is the X cursor location in the
     range 0000-9999.  YYYY is the Y cursor location in the range
     0000-9999.  Finally, LMR stands for Left/Middle/Right.  If either
     of these buttons are depressed (clicked), then the corresponding
     position will contain a 1.  If a button is NOT depressed, then it
     will contain a 0.



     Examples:  $XYM$ = 0123:0297:110

     This means that the (X,Y) location of the cursor is (0123,0297),
     and that the Left and Middle buttons are depressed, but that the
     Right Mouse Button is not depressed.













   ~NEXT~426   ~PREV~424   ~PRE-DEFINED TEXT VARIABLES~388   ~TEXT VARIABLE DESCRIPTION~387
$M$ ... Mouse Button Status: LMR (eg, 101)

     This Text Variable will be transformed into a 3-character code
     representing what the Status of each Mouse Button is.  This
     variable can work with either 2-button Mice, or 3-button Mice.
     In either event, the format of the code is LMR where L=Left,
     M=Middle (if any), and R=Right.  If any of these buttons are
     depressed (ie, clicked), then the code for that button would be
     a "1".  If the button is not depressed, it is a "0".  So, a value
     of "100" would mean that the Left Mouse Button is depressed, but
     none of the others are.



     Example:  $M$ = 001

















   ~NEXT~427   ~PREV~425   ~PRE-DEFINED TEXT VARIABLES~388   ~TEXT VARIABLE DESCRIPTION~387
$MSTAT$ ... Mouse Status (format: XXXX:YYYY:LMR)

     This Text Variable will be transformed into a "YES" if there is
     a Mouse installed on the RIPterm computer.  If no Mouse is
     installed, this variable will contain "NO".



     Example:  $MSTAT$ = YES























   ~NEXT~428   ~PREV~426   ~PRE-DEFINED TEXT VARIABLES~388   ~TEXT VARIABLE DESCRIPTION~387
$SBARON$ ... Turn ON the Status Line

     This Text Variable is somewhat different than the other Text
     Variables described above.  Rather than send something back
     to the Host, it performs a specific operation - it turns ON
     the Status Line.  In this respect, it is considered an ACTIVE
     TEXT VARIABLE.  It evaluates to a null string (nothing).  Its
     sole purpose in life is to enable the Status Line.



     Example:  $SBARON$ = <nil>





















   ~NEXT~429   ~PREV~427   ~PRE-DEFINED TEXT VARIABLES~391   ~TEXT VARIABLE DESCRIPTION~387
$SBAROFF$ ... Turn OFF the Status Line

     This Text Variable is somewhat different than the other Text
     Variables described above.  Rather than send something back
     to the Host, it performs a specific operation - it turns OFF
     the Status Line.  In this respect, it is considered an ACTIVE
     TEXT VARIABLE.  It evaluates to a null string (nothing).  Its
     sole purpose in life is to disable the Status Line.



     Example:  $SBAROFF$ = <nil>





















   ~NEXT~430   ~PREV~428   ~PRE-DEFINED TEXT VARIABLES~391   ~TEXT VARIABLE DESCRIPTION~387
$ETW$ ... Erase text window

    This command erases the current text window (much like a clear
    screen code does).  This command is particularly useful in host
    commands when you click on a mouse area, and after it is finished
    clicking, it could erase the text window THEN transmit the
    remainder of the host command (if any) to the host.


























   ~NEXT~431   ~PREV~429   ~PRE-DEFINED TEXT VARIABLES~391   ~TEXT VARIABLE DESCRIPTION~387

$DTW$ ... Disable text window

    This text variable disables the current text window (preventing
    any received text from showing up on screen).





























   ~NEXT~432   ~PREV~430   ~PRE-DEFINED TEXT VARIABLES~391   ~TEXT VARIABLE DESCRIPTION~387
$EGW$ ... Erase graphics window

    This text variable it erases the current graphics window (much
    like a reset windows command does).  This command is particularly
    useful in host commands when you click on a mouse area, and after
    it is finished clicking, it could erase the graphics window THEN
    transmit the remainder of the host command (if any) to the host.


























   ~NEXT~433   ~PREV~431   ~PRE-DEFINED TEXT VARIABLES~391   ~TEXT VARIABLE DESCRIPTION~387
$MKILL$ ... Kill (delete) all mouse field definitions

    This text variable deletes all currently defined mouse fields
    exactly like the RIPscrip RIP_KILL_MOUSE_FIELDS command does. The
    net benefit of this is that when the user clicks on a mouse
    button, the mouse fields are removed, but the graphics remain on
    the screen so that the fields could be subsequently re-defined
    quickly and easily without having to re-transmit an identical
    menu over again.
























   ~NEXT~434   ~PREV~432   ~PRE-DEFINED TEXT VARIABLES~391   ~TEXT VARIABLE DESCRIPTION~387
$BEEP$ ... Beep there terminal (like CTRL-G does)

    This command issues a beep to the terminal, thus producing
    a CTRL-G sound.



























   ~NEXT~435   ~PREV~433   ~PRE-DEFINED TEXT VARIABLES~391   ~TEXT VARIABLE DESCRIPTION~387
$BLIP$ ... Make a short "blipping" sound

    This active text variable is much like the BEEP variable, except
    that the sound produced is different.  It produces a sound more
    akin to a "barrier" sound; something that sounds like you're
    bumping into a wall or something to that effect.


























   ~NEXT~436   ~PREV~434   ~PRE-DEFINED TEXT VARIABLES~391   ~TEXT VARIABLE DESCRIPTION~387
$MUSIC$ ... Make a musical (cheerful) sound

    This active text variable also produces an audio result.  The
    sound that is generated is a cheerful sound, representing some
    kind of success.  The sound is exactly the same as the sound you
    would hear when you receive a successful download, or when you
    achieve a connection when dialing the modem in RIPterm.


























   ~NEXT~437   ~PREV~435   ~PRE-DEFINED TEXT VARIABLES~391   ~TEXT VARIABLE DESCRIPTION~387
$PCB$ ... Paste Clipboard at last location

    This command pastes the contents of the clipboard at the last
    location where the clipboard was "clipped" from.  This even works
    with icons that are loaded.  The last location taken in this
    situation, is the location the icon was stamped when it was
    originally loaded.  This text variable is very useful in
    situations where you want to "pop-up" a dialog box on the screen
    (saving the previous area behind the dialog onto the clipboard),
    and when the user clicks on the "OK" button, restoring the screen
    contents (by adding a $PCB$ in the host command string).






















   ~NEXT~438   ~PREV~436   ~PRE-DEFINED TEXT VARIABLES~391   ~TEXT VARIABLE DESCRIPTION~387
$SMF$ ... Save Mouse Fields

    This text variable will save all currently defined mouse fields
    and mouse buttons to a temporary file for later retrieval.  This
    is designed especially for the graphical designer who wishes to
    pop-up a dialog box on the screen with one or more mouse fields,
    and when finished, to restore the screen and original mouse
    fields (if any) so that the user is not left "floating".  This
    command is intended to be used with the restore mouse fields text
    variable $RMF$.























   ~NEXT~439   ~PREV~437   ~PRE-DEFINED TEXT VARIABLES~391   ~TEXT VARIABLE DESCRIPTION~387
$RMF$ ... Restore Mouse Fields

    This text variable restores any previously saved mouse fields
    saved with the $SMF$ text variable.  You may have only one set of
    mouse fields saved at any one time.  If there were no mouse
    fields saved, or if the number of mouse fields that were saved
    was 0, then no mouse fields will be active.  Any fields that were
    defined at the time of this command's execution will be erased.
    Due to technical details, this should be the last piece of text
    or the last text variable in any mouse host command (or button
    host command). Having subsequent text variables or host command
    text after this variable (in a mouse field) can lead to
    unpredictable and potentially disastrous results.

    NOTE: You may restore mouse fields more than once if you wish.
          In other words, if you perform a "Save Mouse Fields"
          command, you may execute Restore Mouse Fields one or
          more times after that point.















     ~PRE-DEFINED TEXT VARIABLES~391     ~PREV~438      ~TEXT VARIABLE DESCRIPTION~387
TROUBLESHOOTING

     Modem communications is not a simple thing.  There are many
     different technical factors that can affect RIPterm, making it
     work erratically, or unreliably.  This section is intended to
     try to help you figure out what's wrong and get yourself up and
     running as quickly as possible.

     Please try to narrow down the problem(s) you are having:


          1. ~MOUSE DOESN'T WORK~460
          2. ~MODEM DOESN'T WORK~470
          3. ~CANNOT CONNECT TO A BBS~480
          4. ~"ICON NOT AVAILABLE" APPEARS OFTEN~490
          5. ~TEXT IS ALWAYS GARBLED WHEN CONNECTED TO A BBS~500
          6. ~NOISY PHONE CONNECTIONS (PERIODIC GARBAGE ON SCREEN)~510
TROUBLESHOOTING - MOUSE DOESN'T WORK










     Do you have a:
     --------------

          1. ~Bus Mouse~461      (a "System Mouse")
          2. ~Serial Mouse~462   (connects to a Serial/COM port)
















     ~Troubleshooting menu~450
TROUBLESHOOTING - "BUS" MOUSE DOESN'T WORK

     Make sure your Mouse Driver program is loaded into memory before
     you run RIPterm.  Without a Mouse Driver being loaded, RIPterm
     will not use your Mouse properly.  Consult the manual that came
     with your PC Mouse under the section INSTALLATION or SOFTWARE
     INSTALLATION.

     Most Mouse Drivers come in two flavors, a .SYS file, or a TSR
     program ending in a .COM file extension.  A .SYS file must be
     loaded into your C:\CONFIG.SYS file as any other device driver.
     An example of loading your MOUSE.SYS driver would be as follows:

          CONFIG.SYS file:
          ================
               FILES=40
               BUFFERS=40
               DEVICE=C:\MOUSE\MOUSE.SYS

     If your Mouse came only with a TSR MOUSE.COM driver, then you
     must edit your C:\AUTOEXEC.BAT file and add a line calling the
     TSR so that it can be loaded into memory each time your PC
     boots up.  Add a line similar to the one that follows:

          AUTOEXEC.BAT file:
          ==================
               PATH=C:\;C:\DOS;C:\MOUSE
               PROMPT $P$G
               MOUSE

     Actual modifications may vary - consult your Mouse Manual.

     ~STILL HAVING PROBLEMS~464              ~Troubleshooting menu~450
TROUBLESHOOTING - "SERIAL" MOUSE DOESN'T WORK

     If you are using a Serial Mouse, and it is not responding, you
     might be experiencing a "conflict" between your Modem Serial
     Port, and your Mouse Serial Port.  Under most circumstances,
     a conflict like this will NOT arise in normal applications
     programs that don't use both a Mouse and a Modem simultaneously.

     Below you should find a list of Correct and Incorrect Modem/Mouse
     configurations.

          CORRECT COMBINATIONS        INCORRECT COMBINATIONS
          =======================     =======================
          Modem=COM1 / Mouse=COM2     Modem=COM1 / Mouse=COM3
          Modem=COM1 / Mouse=COM4     Modem=COM2 / Mouse=COM4
          Modem=COM2 / Mouse=COM1     Modem=COM3 / Mouse=COM1
          Modem=COM2 / Mouse=COM3     Modem=COM4 / Mouse=COM2
          Modem=COM3 / Mouse=COM2
          Modem=COM3 / Mouse=COM4
          Modem=COM4 / Mouse=COM1
          Modem=COM4 / Mouse=COM3

     If you are knowledgable about IBM-PC hardware, and how to install
     add-on cards, you may be able to circumvent the above recommended
     Port Combinations.  To do this will require removing the PC cover
     and changing the Interrupt (IRQ) setting of either the Modem Serial
     Port, or the Mouse Serial Port (if possible).  In order to get both
     the Mouse and the Modem operating properly, the two Serial Ports
     must use different IRQ settings!  If none of this makes sense to
     you, we would recommend sticking to the above recommended layouts.


     ~STILL HAVING PROBLEMS~463              ~Troubleshooting menu~450
TROUBLESHOOTING - SERIAL MOUSE STILL DOESN'T WORK!

     Make sure your Mouse Driver program is loaded into memory before
     you run RIPterm.  Without a Mouse Driver being loaded, RIPterm
     will not use your Mouse properly.  Consult the manual that came
     with your PC Mouse under the section INSTALLATION or SOFTWARE
     INSTALLATION.

     Most Mouse Drivers come in two flavors, a .SYS file, or a TSR
     program ending in a .COM file extension.  A .SYS file must be
     loaded into your C:\CONFIG.SYS file as any other device driver.
     An example of loading your MOUSE.SYS driver would be as follows:

          CONFIG.SYS file:
          ================
               FILES=40
               BUFFERS=40
               DEVICE=C:\MOUSE\MOUSE.SYS

     If your Mouse came only with a TSR MOUSE.COM driver, then you
     must edit your C:\AUTOEXEC.BAT file and add a line calling the
     TSR so that it can be loaded into memory each time your PC
     boots up.  Add a line similar to the one that follows:

          AUTOEXEC.BAT file:
          ==================
               PATH=C:\;C:\DOS;C:\MOUSE
               PROMPT $P$G
               MOUSE

     Actual modifications may vary - consult your Mouse Manual.

     ~STILL DOESN'T WORK~464                 ~Troubleshooting menu~450
TROUBLESHOOTING - STILL DOESN'T WORK ... CALL TECHNICAL SUPPORT

     If you are still having problems getting your RIPterm software to
     operate properly, you should contact our Technical Support Staff
     at:


               TeleGrafix Communications, Inc.
               16458 Bolsa Chica, #15
               Huntington Beach, CA 92649

               Voice: (714) 846-4179
               Fax  : (714) 846-4189
               Data : (714) 840-3520


















     ~Troubleshooting menu~450
TROUBLESHOOTING - MODEM DOESN'T WORK

     If you have a Serial Mouse, you may be experiencing a conflict
     between your Mouse and your Modem.  A Serial Mouse can be
     identified if it plugs into one of your IBM-PC communications
     ports named COM1 through COM4.  Not all PC's have 4 COM ports,
     so your PC may be different (somewhat).  A Serial Mouse typically
     has a 25-pin connector oddly shaped like an elongated "D".
     Another type of Serial Mouse has a 9-pin connector also shaped
     like a "D".

     Do you have a Serial Mouse?   ~YES~471   ~NO~472




















     ~Troubleshooting menu~450
TROUBLESHOOTING - MODEM DOESN'T WORK (SERIAL MOUSE PRESENT)

     If you are using a Serial Mouse, and your modem is not responding,
     you might be experiencing a "conflict" between your Modem Serial
     Port, and your Mouse Serial Port.  Under most circumstances,
     a conflict like this will NOT arise in normal applications
     programs that don't use both a Mouse and a Modem simultaneously.

     Below you should find a list of Correct and Incorrect Modem/Mouse
     configurations.

          CORRECT COMBINATIONS        INCORRECT COMBINATIONS
          =======================     =======================
          Modem=COM1 / Mouse=COM2     Modem=COM1 / Mouse=COM3
          Modem=COM1 / Mouse=COM4     Modem=COM2 / Mouse=COM4
          Modem=COM2 / Mouse=COM1     Modem=COM3 / Mouse=COM1
          Modem=COM2 / Mouse=COM3     Modem=COM4 / Mouse=COM2
          Modem=COM3 / Mouse=COM2
          Modem=COM3 / Mouse=COM4
          Modem=COM4 / Mouse=COM1
          Modem=COM4 / Mouse=COM3

     If you are knowledgable about IBM-PC hardware, and how to install
     add-on cards, you may be able to circumvent the above recommended
     Port Combinations.  To do this will require removing the PC cover
     and changing the Interrupt (IRQ) setting of either the Modem Serial
     Port, or the Mouse Serial Port (if possible).  In order to get both
     the Mouse and the Modem operating properly, the two Serial Ports
     must use different IRQ settings!  If none of this makes sense to
     you, we would recommend sticking to the above recommended layouts.
     You may modify RIPterm's IRQ settings by typing ALT-Q.

     ~STILL HAVING PROBLEMS~472              ~Troubleshooting menu~450
TROUBLESHOOTING - MODEM DOESN'T WORK (BUS MOUSE PRESENT)

     Check to make sure you Modem is plugged in and turned on (if it
     is an external Modem).  Make sure that the Serial Cable connecting
     the modem to your computer is securely fastened to the proper
     COM port.

     Check your Modem Settings to make sure they are set correctly.
     You may edit these settings by hitting ALT-O (Modem Options).
     Things you should check for:

          1.  Make sure it is set for the correct Port (1-4)
          2.  Make sure the Baud Rate is set to a speed your modem
              can support (or lower).  Settings for this would be
              300, 1200, 2400, 9600, 19,200 baud.

     Check to make sure that the phone line is connected to the modem. 
     Some modems have two phone jacks, and require that you plug the cord
     going to the wall into a certain one of the two.













     ~STILL HAVING PROBLEMS~464              ~Troubleshooting menu~450
CANNOT CONNECT TO A BBS

     Most problems related to connecting to a BBS have nothing to do with
     the terminal or your modem.

     If you get frequent busy signals, try calling the BBS during the off
     hours.  Many company support boards are busy during the day, but
     relatively inactive during the evenings.  On the other hand,
     entertainment and file boards are frequently busy during the evening
     and late into the night, but sit during much of the day.

     If you are not sure of the phone number you are calling, try calling
     it using your voice phone.  If you don't hear the screeching carrier
     signal, you may not have the correct phone number.  A modem carrier
     has two tones when you first call in - a low tone, and a high tone. 
     The low tone is played for about 1 second, and then the high tone is
     played. If after the high tone you hear a series of lower tones, the
     number you have may be for a fax machine.

     Check to make sure that the phone line is connected to the modem. Some
     modems have two phone jacks, and require that you plug the cord going
     to the wall into a certain one of the two.

     Refer to your modem's documentation for more help on connection
     problems.







     ~Troubleshooting menu~450
"ICON NOT AVAILABLE" APPEARS OFTEN

     If you are getting the message "Icon XXXXXXX.XXX not available", it
     means that either you do not have the icons for the system you are
     calling, or you have the Host ID set incorrectly in the Dialing
     Directory.

     If you did not download RIPterm from the host you are calling, or
     you did not download an icon file from the host, you will need to
     go into the host's file library and download the icons for their
     system.

     If you have the icons, but you still get "Icon not available", check
     that if you have a Host ID set up in your dialing directory, that
     the icons are in that directory.  CHeck the spelling very carefully -
     just one letter difference will prevent the icons from working.

     If you have a Host ID, and you typed the number for the host manually,
     the icons will not be found.  You must use the Dialing Directory for
     icons in a Host ID sub-directory to be found.

     










     ~Troubleshooting menu~450
TEXT IS ALWAYS GARBLED WHEN CONNECTED TO A BBS

     If the text is always garbled when connecting to a host, but there are
     some readable words coming through, then you have a noisy phone line,
     and the only cure is to try calling back, or use an error-correcting
     modem.  See the help section on ~Noisy Phone Lines~510.

     If all the text is garbage, you either have you data bits set
     incorrectly, or your baud rate.  Go into the Options dialog (ALT-O),
     and check your data bits, stop bits and parity.  Most hosts use
     8 data bits, no parity, and 1 stop bit (8N1).  If this already set
     try 7 data bits, even parity, and 1 stop bit (7E1).     
     
     If changing the data bits doesn't help, change the baud rate.  Try
     each setting to see if you can find the right setup.  You don't need
     to hang up and call back - just change the settings and see what
     happens.

     If these suggestions don't resolve the problem, call either the modem
     manufacturer's support line, or call the TeleGrafix tech support line.












     ~Troubleshooting menu~450
NOISY PHONE CONNECTIONS (PERIODIC GARBAGE ON SCREEN)

     If you get a noisy telephone connection, the graphics that you see
     might become garbled in some fashion.  Since RIPterm does more than
     simply display pictures on the screen, this can disturb underlying
     (invisible) operations as well.

     Solutions:  Hang-up and try calling again.  Often times, this can
                 resolve the problem.

                 Long distance connections are typically the noisiest
                 connections.  Check with your operator and find out if
                 you can use a different "Long Distance Carrier" like MCI,
                 AT&T, US Sprint, etc.

                 Use an Error-Correcting modem (provided the host you are
                 calling can support one).















     ~Troubleshooting menu~450
DIALING DIRECTORY HELP
     At the top of the dialing directory dialog box, the filename of the
     dialing directory is displayed (e.g., "RIPTERM.PHO").  Whenever you
     change dialing directory files, this will change to reflect the
     current file in use.

     In the middle of the dialog box is a listing of available hosts to
     choose from.  Ten hosts are displayed at any once, and each directory
     can contain up to 100 entries.  You can scroll through the available
     hosts quickly by using the UP/DOWN arrows on the right of the
     display.  Just underneath the UP arrow, and above the DOWN arrow are
     two different buttons; these are used for PGUP, and PGDN.  The UP
     ARROW, DOWN ARROW, PGUP, PGDN, HOME, and END keys work intuitively.

     Any one of the ten lines in the window can be highlighted by pressing
     ALT-1 through ALT-0 (10).  Any previously highlighted entries will be
     un-highlighted and the given line in the window will be highlighted.
     If you simultaneously hold down the SHIFT key while pressing ALT-1
     through ALT-0, then the associated line will be highlighted in
     addition to any previously highlighted lines (highlight merge).  Do
     not confuse ALT-1 through ALT-0 with the numbers listed on the left
     side of the window.  The numbers in the window are the entries in the
     entire directory, not the window line number.  Pressing an ALT-1
     through ALT-0 will highlight the window line number.  To highlight a
     specific directory entry, see the MARK mode below.

     Each host displays an entry number, the host name, telephone number,
     baud rate, data bits (7 or 8), parity (E, N, O), stop bits (1 or 2),
     and the COM port (COM1 - COM4).

     ~EDIT~521     ~SYSTEM NAME~522    ~PHONE NUMBER~523    ~SYSTEM-ID~524    ~PRINT~525
     ~MARK~528     ~FIND~531           ~SAVE~532            ~LOAD~534         ~ERASE~535
EDIT DIALING DIRECTORY ENTRY

    The name field is the name of the host that will appear in the dialing
    directory window.  You are allowed 25 characters for the host name.

    The telephone number is used to dial the host.  You are allowed up to
    25 characters for the number.  Valid characters are digits 0-9, hyphens
    and parenthesis (if your modem permits it).  You may also enter a comma
    (,) to indicate a half-second pause.  This pause is handled by your
    modem, not by RIPterm.  On some modems, this pause may be two or three
    seconds. Check your modem's documentation to determine the delay value.

    The ID field is where you put the name of the directory where the icons
    for that system are stored.

    The modem button is to indicate a modem or a direct serial connection.

    The port is which serial port you modem is connected to (COM1 - COM4).
    
    The baud rate, data bits, stop bits and parity are for different
    connection types.  In nearly 100% of every situation, there are only
    two combinations of these three values that are used. They are:

              8 data bits         7 data bits
               No parity          Even parity
              1 stop bit          1 stop bit
              -----------         -----------
                8-N-1               7-E-1           <- referred to as
            eight-none-one      seven-even-one      <- pronounced
System Name field in Dialing Directory editor

    The name field is the name of the host that will appear in the
    dialing directory window.  This is the name that will be
    displayed to you whenever you dial the host, and is used in
    general to describe the host.  You are allowed 25 characters
    for the host name.
System Phone Number in Dialing Directory Editor

    This is the telephone number (if any) that is used to dial the
    host.  You are allowed up to 25 characters for the number.  Valid
    characters are digits 0-9, hyphens and parenthesis (if your modem
    permits it).  You may also enter a comma (,) to indicate a
    half-second pause.  This pause is handled by your modem, not by
    RIPterm.  On some modems, this pause may be two or three seconds.
    Check your modem's documentation to determine the delay value.

    Some examples of Telephone Numbers are as follows:

               555-1212 ... Dial 555-1212
         1-714-555-1212 ... Dial (714) 555-1212
             9,555-1212 ... Dial a 9, then pause, then 555-1212

System-ID field in Dialing Directory Editor

    This field takes a bit more explaining than the other fields in
    the directory editor.  Each entry in the directory has the
    ability to have a separate sub-directory associated with it.
    This is used mainly when RIPscrip graphics are being viewed on
    the host. Any icon (.ICN, .MSK, .HIC) or RIPscrip (.RIP) files
    that are received by the host should be placed in the designated
    sub-directory.  This in effect, helps keep your icons separated
    from each other.

    If you omit a directory name in this field, and you dial into a
    RIPscrip host that requires icons or RIPscrip files, RIPterm will
    look for them automatically in the ICONS\ sub-directory.  It is
    recommended that you keep host specific files in their proper
    sub-directories for elegant file maintenance.

    You do not need to create the sub-directory yourself.  The first
    time that you call into that host via the dialing directory,
    RIPterm will check the ID field, and if it is non-blank, will
    automatically create the sub-directory if it doesn't exist.

    If the ID field is non-blank, indicating a sub-directory should
    be used for that specific host, RIPterm will check in that
    directory first for any necessary icons or RIPscrip files.  If
    the needed file is not found in that sub-directory, RIPterm will
    check the ICONS\ sub-directory afterward to see if it is there.
    This facilitates the concept of "file override".

    Keep in mind, that if you dial a host by issuing modem commands
    directly (not using the dialing directory), then the correct
    directory may not be used since RIPterm has no way of knowing
    which dialing directory entry you are calling.  In other words,
    you should use the dialing directory to call ALL RIPscrip hosts!
Print Dialing Directory to a file or to the printer

    This prints the contents of the dialing directory (or highlighted
    entries) to either a disk file, or to a printer attached to LPT1.
    Choosing the disk option will prompt you for a filename.

    Before printing/saving occurs, you will be asked what type of
    output you wish.  You have two choices: TABLE format, or DETAILED
    BREAKDOWN.  Table format will print one entry per line, formatted
    for an 80-column display.

    System Name          System Phone Number
    ===========================================  continued next line
    ArenaBBS (TeleGrafix 1-714-840-3520

                                Baud COM COM       Last  Mod
                                Rate Vals # Calls  Call   ? System
    continued from previous     ====================================
                                2400  8N1 1   39  1/30/93 Y ARENA

    Specifying detailed mode will output a multi-line record for each
    entry. The format of detailed breakdown mode is similar to the
    following:

          Host Name: ArenaBBS (TeleGrafix)
        Telephone #: 1-714-840-3520
          Baud Rate: 2400
          Data Bits: 8
             Parity: NONE
          Stop Bits: 1
           COM Port: 1
            Host ID: ARENA
        Connections: 39
          Last Call: 01/30/93
Print Dialing Directory to what filename?

    This prints the contents of the dialing directory (or highlighted
    entries) to either a disk file, or to a printer attached to LPT1.
    Choosing the disk option will prompt you for a filename.

    Before printing/saving occurs, you will be asked what type of
    output you wish.  You have two choices: TABLE format, or DETAILED
    BREAKDOWN.  Table format will print one entry per line, formatted
    for an 80-column display.

    System Name          System Phone Number
    ===========================================  continued next line
    ArenaBBS (TeleGrafix 1-714-840-3520

                                Baud COM COM       Last  Mod
                                Rate Vals # Calls  Call   ? System
    continued from previous     ====================================
                                2400  8N1 1   39  1/30/93 Y ARENA

    Specifying detailed mode will output a multi-line record for each
    entry. The format of detailed breakdown mode is similar to the
    following:

          Host Name: ArenaBBS (TeleGrafix)
        Telephone #: 1-714-840-3520
          Baud Rate: 2400
          Data Bits: 8
             Parity: NONE
          Stop Bits: 1
           COM Port: 1
            Host ID: ARENA
        Connections: 39
          Last Call: 01/30/93
Print directory in Table format or detailed breakdown?

    This prints the contents of the dialing directory (or highlighted
    entries) to either a disk file, or to a printer attached to LPT1.
    Choosing the disk option will prompt you for a filename.

    Before printing/saving occurs, you will be asked what type of
    output you wish.  You have two choices: TABLE format, or DETAILED
    BREAKDOWN.  Table format will print one entry per line, formatted
    for an 80-column display.

    System Name          System Phone Number
    ===========================================  continued next line
    ArenaBBS (TeleGrafix 1-714-840-3520

                                Baud COM COM       Last  Mod
                                Rate Vals # Calls  Call   ? System
    continued from previous     ====================================
                                2400  8N1 1   39  1/30/93 Y ARENA

    Specifying detailed mode will output a multi-line record for each
    entry. The format of detailed breakdown mode is similar to the
    following:

          Host Name: ArenaBBS (TeleGrafix)
        Telephone #: 1-714-840-3520
          Baud Rate: 2400
          Data Bits: 8
             Parity: NONE
          Stop Bits: 1
           COM Port: 1
            Host ID: ARENA
        Connections: 39
          Last Call: 01/30/93
Select which Dialing Directory entries?

    This option will mark (highlight) one or more dialing directory
    entries for subsequent action.  When chosen, a dialog box will
    appear allowing you enter information.  In this dialog box, you
    can enter one or more numbers indicating which directory entry(s)
    to highlight.  There are a number of options you may choose from
    for highlighting entries.  Some examples are:

        Examples:
        ---------
            1            ... highlight entry 1
            1, 2, 3      ... highlight entries 1, 2 and 3
            1 2 3        ... highlight entries 1, 2 and 3
            1;2;3        ... highlight entries 1, 2 and 3
            1-10         ... highlight entries 1 through 10
            15-          ... highlight entries 15 to the end (100)
            -5           ... highlight from Start (1) to entry 5
            -            ... highlight ALL entries
            1-5, 10, 95- ... highlight 1-5, 10 and 95-100

    In addition, you can also specify a "Mark Merge".  This mode
    allows you to combine your Marked entries with any entries that
    are already marked.  To use Mark Merge mode, enter a plus sign
    (+) as the first character.  For example, if entries 3 and 5 are
    highlighted, and you mark "+ 10-15", then entries 3, 5, and 10-15
    will be highlighted.

    One final option is the Mark Exclude mode.  This mode is similar
    to Mark Merge, except that all entries EXCEPT those highlighted
    are marked.  To choose Mark Exclude mode, specify an exclamation mark
    (!) as the first character.

    Refer to the RIPterm documentation for more details.    
Invalid method of Marking dialing directory entries

    This option will mark (highlight) one or more dialing directory
    entries for subsequent action.  When chosen, a dialog box will
    appear allowing you enter information.  In this dialog box, you
    can enter one or more numbers indicating which directory entry(s)
    to highlight.  There are a number of options you may choose from
    for highlighting entries.  Some examples are:

        Examples:
        ---------
            1            ... highlight entry 1
            1, 2, 3      ... highlight entries 1, 2 and 3
            1 2 3        ... highlight entries 1, 2 and 3
            1;2;3        ... highlight entries 1, 2 and 3
            1-10         ... highlight entries 1 through 10
            15-          ... highlight entries 15 to the end (100)
            -5           ... highlight from Start (1) to entry 5
            -            ... highlight ALL entries
            1-5, 10, 95- ... highlight 1-5, 10 and 95-100

    In addition, you can also specify a "Mark Merge".  This mode
    allows you to combine your Marked entries with any entries that
    are already marked.  To use Mark Merge mode, enter a plus sign
    (+) as the first character.  For example, if entries 3 and 5 are
    highlighted, and you mark "+ 10-15", then entries 3, 5, and 10-15
    will be highlighted.

    One final option is the Mark Exclude mode.  This mode is similar
    to Mark Merge, except that all entries EXCEPT those highlighted
    are marked.  To choose Mark Exclude mode, specify an exclamation mark
    (!) as the first character.

    Refer to the RIPterm documentation for more details.    
Directory Entry numbers must be specified between 1-100!
The Dialing Directory supports entries between 1 and 100.

     Related subjects:

          ~Dialing Directory~520

          ~Edit Dialing Directory Entries~521

          ~Marking Dialing Directory Entries~528
Enter the text to search for in the dialing directory

    This option will highlight zero or more entries that contain the
    specified search text.  Once you choose this option, a dialog box
    will appear prompting you to enter a piece of text to search for
    throughout the dialing directory.  Any entries that contain the
    chosen text will automatically be highlighted.  Search is not
    case sensitive.  The host name, phone number and directory-ID
    fields are searched for the text.  Text can appear anywhere in
    any of these three fields and will still be found.

    You may choose Find Merge mode, or Find Exclude mode (or both)
    exactly the same way as you can with the Mark mode.  The command
    characters (+ and !) are not added to the search string, and must
    be the first characters specified in the search string.  Merge
    mode can be quite useful if you wish to highlight all entries in
    a specific area code, or that contain a common theme (like
    "business", or "daily").
Enter the dialing directory filename to save to

    This option will save either the entire dialing directory, or
    just the highlighted entries to another directory file.  This
    allows you to create new directory files quickly and easily for
    specific purposes. If one or more entries are highlighted, only
    those entries are copied to the new file.  If no entries are
    highlighted, then the entire dialing directory file is copied.
    You will be prompted to enter the destination filename.

    If the destination file exists, it is checked to see if it is a
    RIPterm dialing directory file.  If it is, you will be prompted
    to either merge the highlighted entries into destination file, or
    to overwrite the file with just the highlighted entries.

    In the event that the destination file becomes full, a message to
    the effect will be displayed informing you how many entries
    couldn't be copied.

    This "directory merge" feature is unique to RIPterm.

    NOTE: Modifications to the dialing directory are automatically
          saved to the current directory file.  You do not need to
          choose SAVE AS every time you add or edit an entry.
Merge with existing Dialing Directory file, or Overwrite?

    This option will save either the entire dialing directory, or
    just the highlighted entries to another directory file.  This
    allows you to create new directory files quickly and easily for
    specific purposes. If one or more entries are highlighted, only
    those entries are copied to the new file.  If no entries are
    highlighted, then the entire dialing directory file is copied.
    You will be prompted to enter the destination filename.

    If the destination file exists, it is checked to see if it is a
    RIPterm dialing directory file.  If it is, you will be prompted
    to either merge the highlighted entries into destination file, or
    to overwrite the file with just the highlighted entries.

    In the event that the destination file becomes full, a message to
    the effect will be displayed informing you how many entries
    couldn't be copied.

    This "directory merge" feature is unique to RIPterm.

    NOTE: Modifications to the dialing directory are automatically
          saved to the current directory file.  You do not need to
          choose SAVE AS every time you add or edit an entry.
Load which Dialing Directory file?

    This option allows you to load up another dialing directory file.
    The current directory file will be closed and the specified file
    will be loaded in its place.  All entries are un-highlighted, and
    the window is automatically redisplays the newly loaded entries.
Erase the selected Dialing Directory Entries?

    This option will delete all previously highlighted directory
    entries.  You will be prompted to make absolutely sure that you
    truly wish to erase the entries.  All calling statistics for
    those entries will be erased as well.  Once an option is killed,
    it is permanently deleted.  If no entries are highlighted, this
    option has no affect.
Dialing Directory

     At the top of the dialing directory dialog box, the filename of the
     dialing directory is displayed (e.g., "RIPTERM.PHO").  Whenever you
     change dialing directory files, this will change to reflect the
     current file in use.

     In the middle of the dialog box is a listing of available hosts to
     choose from.  Ten hosts are displayed at any once, and each directory
     can contain up to 100 entries.  You can scroll through the available
     hosts quickly by using the UP/DOWN arrows on the right of the
     display.  Just underneath the UP arrow, and above the DOWN arrow are
     two different buttons; these are used for PGUP, and PGDN.  The UP
     ARROW, DOWN ARROW, PGUP, PGDN, HOME, and END keys work intuitively.

     Any one of the ten lines in the window can be highlighted by pressing
     ALT-1 through ALT-0 (10).  Any previously highlighted entries will be
     un-highlighted and the given line in the window will be highlighted.
     If you simultaneously hold down the SHIFT key while pressing ALT-1
     through ALT-0, then the associated line will be highlighted in
     addition to any previously highlighted lines (highlight merge).  Do
     not confuse ALT-1 through ALT-0 with the numbers listed on the left
     side of the window.  The numbers in the window are the entries in the
     entire directory, not the window line number.  Pressing an ALT-1
     through ALT-0 will highlight the window line number.  To highlight a
     specific directory entry, see the MARK mode below.

     Each host displays an entry number, the host name, telephone number,
     baud rate, data bits (7 or 8), parity (E, N, O), stop bits (1 or 2),
     and the COM port (COM1 - COM4).
Resume session logging or Close file?

    A log file captures text transmitted from the host into a text
    file.  ANSI color codes and RIPscrip graphics commands are
    filtered out for your convenience.  This command can be very
    powerful on hosts where you want to save data coming across the
    screen to a file that you can read when off-line, at your leisure.
    A log file can be as big as you want, up to the amount of
    currently available disk space.

    To open a log file, select "Open Log File" from the menu.  You
    will be prompted for a filename.  When a log file is open, the
    menu option "Open Log File" changes to "Pause/Close Log", and the
    status bar will show the log file name in the third spot from the
    left, where the terminal emulation is normally displayed.

    If a log file is currently open, selecting "Pause/Close Log" from
    the menu, or clicking on the filename in the status bar will give
    you the option to either pause the log, or to close the file.
    Pausing "suspends" logging to disk temporarily so that you can do
    things without saving them to the log file.  If you are currently
    paused, selecting "Pause/Close Log" again or clicking on the
    filename in the status bar will prompt you to either resume, or
    close the log.

    If a log file is open, and you choose EXIT RIPTERM, it will be
    automatically closed.

Pause session logging, or Close the log file?

    A log file captures text transmitted from the host into a text
    file.  ANSI color codes and RIPscrip graphics commands are
    filtered out for your convenience.  This command can be very
    powerful on hosts where you want to save data coming across the
    screen to a file that you can read when off-line, at your leisure.
    A log file can be as big as you want, up to the amount of
    currently available disk space.

    To open a log file, select "Open Log File" from the menu.  You
    will be prompted for a filename.  When a log file is open, the
    menu option "Open Log File" changes to "Pause/Close Log", and the
    status bar will show the log file name in the third spot from the
    left, where the terminal emulation is normally displayed.

    If a log file is currently open, selecting "Pause/Close Log" from
    the menu, or clicking on the filename in the status bar will give
    you the option to either pause the log, or to close the file.
    Pausing "suspends" logging to disk temporarily so that you can do
    things without saving them to the log file.  If you are currently
    paused, selecting "Pause/Close Log" again or clicking on the
    filename in the status bar will prompt you to either resume, or
    close the log.

    If a log file is open, and you choose EXIT RIPTERM, it will be
    automatically closed.
Prompt you before sending any unauthorized information?

    The Data Security option gives you control over host data queries to
    your system.  This option defaults to ON, giving you the ability to
    scrutinize any queries by the host to ask your system for a piece of
    information.  This does not apply to pre-defined text variables, just
    variables that contain data that you've entered.

    How does this apply to you?  Well, RIPscrip has the inherent
    ability to pop-up dialog boxes onto your screen asking you for a
    piece of information.  Depending on the request, this information
    might be stored to your local RIPterm database for future use (by
    the same host, or potentially another).  This option exists so
    that if a host asks your terminal for a piece of information, you
    have the ability to intervene (i.e., prevent the information from
    being sent).  This override feature is for security purposes in
    the event that your database contains sensitive information that
    you do not want to be given out without your explicit consent.
Define what text variable?

     Pre-defined text variables are something that RIPterm always knows
     about.  They are "built-in" to RIPterm, and a host can always get an
     answer to.  These types of variables are defined to provide the host
     with some kind of information about your terminal software, not about
     something you (or your terminal) knows.  In other words, pre-defined
     text variables can be used to send a piece of information to the host
     saying "what time is it", or "what is the date where you are", or
     "where is the mouse located?".  They function exactly like any other
     text variable except that RIPterm knows they exist even if you
     haven't created them yet. By nature, the values that these variables
     return to the host are rarely the same.  They change depending on the
     nature of each variable.
Enter information for text variable

    Creating a text variable enters a piece of information into the RIPterm
    database.  This information will be saved for future use by either
    yourself or by a host.  You may store just about any piece of
    information in this database.  Each piece of information is associated
    with a "name". Any information entered must be from 1-60 characters in
    length. The name of the information (also called the variable name), is
    from 3-12 characters in length.  An example of this might be:

        Variable        Information Stored in variable
        --------------  ------------------------------
        FIRST_NAME      John
        LAST_NAME       Doe
        ADDRESS         123 Anywhere Street
        PHONE_NUMBER    555-1212

    You may choose to save a data variable either to internal memory,
    or to the permanent database.  This database is "indexed" for
    high speed access of information.  In the event that the Index
    becomes corrupted due to a power failure or something of that
    nature, it will be automatically re-indexed for you.
Store in database, or in memory?

   PERMANENT (DATABASE) VARIABLES

     Permanent text variables are saved in a local RIPterm database file
     called RIPTERM.DB.  This file is automatically indexed for high-speed
     retrieval of information.  The index file for this database is called
     RIPTERM.IDX.  Both files are stored in the current RIPterm directory
     for safe keeping.  Any permanent text variable that is created is
     stored in this file.

     A permanent text variable can be created by yourself manually by
     choosing option "Store Data" from the Data menu, or interactively by
     a host via a special RIPscrip command ("Define Text Variable").  Once
     you create a variables, they are stored forever, or until you either
     delete the database file, or modify the entry.  These variables may
     be accessed by yourself, or a host (if you wish it).  This can be
     quite useful in preventing you from having to type the same
     information in over and over again in future on-line sessions. Imagine
     if you could sign-up on a host without having to type a single
     character?  Sound too good to be true?  With text variables, you (and
     other sysops) could do this!

   TEMPORARY (IN MEMORY) VARIABLES

     Temporary (in memory) text variables are just like permanent text
     variables, except that they are not stored in a database file.  They
     are stored in your computer's memory.  They remain until you exit
     RIPterm.  Other than that, they are identical in nature to permanent
     text variables.  Until you exit RIPterm, they will exist and will be
     accessible to you (via macros), or to a host.
Invalid Data Variable name entered


     Variable Identifiers can be 1-12 characters in length.  You may use
     any alphabetic or numeric characters and underscores (_) in the
     identifier.  An underscore cannot be the first character, nor can the
     first character of an identifier be a number.
Enter Volatile User Text Variable

     A volatile (discardable) text variable is somewhat different than the
     previously described text variables.  They do not remain in memory or
     in any database for any period of time.  They are used solely to ask
     you a simple question, transmit the information to the host, then the
     contents of the variable are destroyed forever.  Why would you (or a
     host) want something like this?  This question is answered
     differently for YOU or for a host.

     A volatile text variable for you can be useful during keystroke
     macros.  Let's say you have a very complex macro that you've devised
     for doing something in a game (for example) to another user on the
     host.  Should you have to edit the macro each time you want to
     use it for someone different?  Of course not!  Simply place a
     reference to an "undefined" text variable in your macro.  When you
     execute the macro, RIPterm will look through its list of text
     variables (pre-defined, in-memory and permanent), and if it doesn't
     find a corresponding variable, it would pop-up a quick dialog box
     asking you to enter something for that variable.  Whatever you type
     into that dialog box for the variable is replaced in your macro right
     then and there, and is immediately discarded after the macro is
     finished.  For example, let's say you have the following macro setup
     to attack another player in a game on some host you call:

               F2:  ATTACK $USERNAME$ FIERCELY^m

     When you execute macro F2, RIPterm will transmit "ATTACK " to the
     host, then find the text variable $USERNAME$ in it.  It will check
     its internal tables for this variable, and if it doesn't find it, it
     will pop-up a window asking you to enter the data will appear.

Enter Serial Port I/O Address

    THESE ARE ADVANCED OPTIONS AND SHOULD NOT BE USED UNLESS YOU ARE
    FAMILIAR WITH IBM-PC INTERRUPTS AND HARDWARE SETUP!


    SERIAL PORT INTERRUPT SETUP

    This option allows you to customize the Interrupt (IRQ) settings
    for each of your four COM ports.  Normally this isn't necessary.
    However, some PC's have special configurations that require the
    terminal's setup to be altered.

    There are five different interrupts that can be selected for each
    COM port (2, 3, 4, 5, and 7).  If two serial ports in the computer use
    the same interrupt (i.e., a conflict), then problems may arise.


    SERIAL PORT ADDRESS SETUP

    This option allows you to customize the base I/O addresses of the
    four COM ports that RIPterm can utilize.  Normally, you will not
    need to alter these settings.  If you are a PC technician, or you
    have serial port configuration that doesn't comply with the
    COM1-COM4 standards, you may need to alter your addresses for
    these ports to make RIPterm function properly.  The standard
    addresses for COM1-4 are as follows on an AT compatible computer:

        PORT    ADDRESS    IRQ
        ----------------------
        COM1      3F8       4
        COM2      2F8       3
        COM3      3E8       4
        COM4      2E8       3
