doc/FAQ

   1 --------------------------------------------------------------------------
   2                                    FAQ
   3 --------------------------------------------------------------------------
   4
   5 -----
   6
   7     Q:  How do I know which rxvt version I'm using?
   8
   9     A:  The version number is displayed with the usage (-h).
  10         For rxvt version 2.14 and later, the escape sequence `ESC[8n'
  11         sets the window title to the version number.
  12
  13 -----
  14
  15     Q:  Mouse cut/paste suddenly no longer works.
  16
  17     A:  Make sure that mouse reporting is actually turned off since
  18         killing some editors prematurely may leave the mouse in mouse
  19         report mode.  I've heard that tcsh may use mouse reporting
  20         unless it otherwise specified.  A quick check is to see if
  21         cut/paste works when the Alt or Shift keys are depressed. See
  22         doc/refer.txt
  23
  24 -----
  25
  26     Q:  What's with this bold/blink stuff?  I can never get blinking text!
  27
  28     A:  It is not possible, and likely will never be, for rxvt to have
  29         actual blinking text. Instead (if rxvt was compiled without
  30         NO_BOLDCOLOR), bold/blink attributes are used to set high-intensity
  31         foreground/background colors ... like what you'd see on a PC video
  32         adapter.  There are programs, notably John Davis' SLang-based ones
  33         <ftp://space.mit.edu/pub/davis>, that use bold/blink attributes to
  34         permit 16 colors.
  35
  36         color0-7 are the low-intensity colors.
  37         color8-15 are the corresponding high-intensity colors.
  38
  39         A side issue of this bold/blink stuff is the question of how the
  40         normal default foreground/background colors are to be treated.  If
  41         the default foreground/background match one of the low-intensity
  42         colors (color0-7), the bold/blink attribute will invoke the
  43         appropriate high-intensity color (color8-15).
  44
  45         In the case that the default foreground doesn't match one of the
  46         low-intensity colors, the bold attribute will use an `overstrike'
  47         to simulate a bold font. But note this leaves pixel-droppings and
  48         so, rather than wasting an inordinate amounts of energy to fix it,
  49         its use is simply deprecated.
  50
  51         In the case that the default background doesn't match one of the
  52         low-intensity colors, the blink attribute is simply ignored
  53         (rather than representing it as bold as xterm does).
  54
  55 -----
  56
  57     Q:  I don't like the screen colors.  How do I change them?
  58
  59     A:  You can change the screen colors at run-time using ~/.Xdefaults
  60         resources (or as long-options) ... see the man-page.
  61
  62         Here are values that are supposed to resemble a VGA screen,
  63         including the murky brown that passes for low-intensity yellow:
  64
  65                 Rxvt*color0:    #000000
  66                 Rxvt*color1:    #A80000
  67                 Rxvt*color2:    #00A800
  68                 Rxvt*color3:    #A8A800
  69                 Rxvt*color4:    #0000A8
  70                 Rxvt*color5:    #A800A8
  71                 Rxvt*color6:    #00A8A8
  72                 Rxvt*color7:    #A8A8A8
  73
  74                 Rxvt*color8:    #000054
  75                 Rxvt*color9:    #FF0054
  76                 Rxvt*color10:   #00FF54
  77                 Rxvt*color11:   #FFFF54
  78                 Rxvt*color12:   #0000FF
  79                 Rxvt*color13:   #FF00FF
  80                 Rxvt*color14:   #00FFFF
  81                 Rxvt*color15:   #FFFFFF
  82
  83 -----
  84
  85     Q:  What's with the strange Backspace/Delete key behaviour?
  86
  87     A:  Assuming that the physical Backspace key corresponds to the
  88         BackSpace keysym (not likely for Linux ... see the following
  89         question) there are two standard values that can be used for
  90         Backspace: ^H and ^?.
  91
  92         Rxvt tries to inherit the current stty settings and uses the value
  93         of `erase' to guess the value for backspace.  If rxvt wasn't started
  94         from a terminal (say, from a menu or by remote shell), then the
  95         system value of `erase', which corresponds to CERASE in <termios.h>,
  96         will be used (which may not be the same as your stty setting).
  97
  98         For starting a new rxvt:
  99
 100             use Backspace = ^H
 101                 $ stty erase ^H
 102                 $ rxvt
 103
 104             use Backspace = ^?
 105                 $ stty erase ^?
 106                 $ rxvt
 107
 108         NB: generate either value with BackSpace and Ctrl/Shift-BackSpace.
 109             Toggle with "ESC[36h" / "ESC[36l" as documented in "doc/refer.txt"
 110
 111         For an existing rxvt:
 112             use Backspace = ^H
 113                 $ stty erase ^H
 114                 $ echo -n "^[[36h"
 115
 116             use Backspace = ^?
 117                 $ stty erase ^?
 118                 $ echo -n "^[[36l"
 119
 120         This helps satisfy some of the Backspace discrepancies that occur,
 121         but if you use Backspace = ^?, make sure that the termcap/terminfo
 122         value properly reflects that.
 123
 124         The Delete key (which one would expect to emit ^?) is a another
 125         casualty of the ill-defined Backspace problem.  To avoid confusion
 126         between the Backspace and Delete keys, the Delete key has been
 127         assigned an escape sequence to match the vt100 for Execute (ESC[3~)
 128         and is in the supplied termcap/terminfo.
 129
 130         Some other Backspace problems:
 131                 some editors use termcap/terminfo,
 132                 some editors (vim I'm told) expect Backspace = ^H,
 133                 GNU Emacs (and Emacs-like editors) use ^H for help.
 134
 135         Perhaps someday this will all be resolved in a consistent manner
 136         ... and maybe xterm will have Home/End values too!
 137
 138 -----
 139
 140     Q:  Why doesn't the Backspace key work on my Linux machine?
 141
 142     A:  The XFree86 server has a notorious problem of mapping the Backspace
 143         key as Delete in order to match the Linux console.
 144
 145         The correct way to fix this:
 146
 147           0 - Complain to your Linux distributer and the XFree86 team, maybe
 148               they'll fix it.
 149
 150           1 - Use xmodmap to correct the Backspace mapping
 151
 152                 ! ~/.Xmodmap
 153
 154                 ! a correctly-mapped BackSpace
 155                 keycode 22 = BackSpace
 156
 157                 *** Make sure the keycode above matches the physical
 158                     Backspace key on your machine!! (use xev) ***
 159
 160         This will also fix the BackSpace problem with Motif applications,
 161         such as ``why doesn't Backspace work for Netscape?''
 162
 163         You now have a Backspace key that functions as described in the
 164         previous question.
 165
 166           1a - You may also want to fix the regular xterm if it doesn't
 167               generates the desired value for BackSpace
 168
 169                 xterm*vt100.translations: #override \
 170                 <Key>BackSpace: string(\010) \n
 171             or
 172                 xterm*vt100.translations: #override \
 173                 <Key>BackSpace: string(\177) \n
 174
 175            while you are at it, you may also want to have consistent
 176            values to Home/End/Delete
 177
 178                 xterm*vt100.translations: #override \
 179                 <Key>Home:      string("\033[7~") \n\
 180                 <Key>End:       string("\033[8~") \n\
 181                 <Key>Delete:    string("\033[3~") \n
 182
 183         Finally, you can also remap the rxvt key-binding at run-time (next
 184         question) but you'll lose the ability to have Ctrl/Shift-Backspace
 185         work differently as well as losing the escape sequence toggling of
 186         Backspace.
 187
 188 -----
 189
 190     Q:  I don't like the key-bindings.  How do I change them?
 191
 192     A:  There are some compile-time selections available via configure.
 193         Unless you have run "configure" with the "--disable-resources"
 194         option you can use the `keysym' resource to alter the keystrings
 195         associated with keysym 0xFF00 - 0xFFFF (function, cursor keys, etc).
 196
 197         Here's an example for a tn3270 session started using
 198         `rxvt -name tn3270'
 199
 200                 !#  ----- special uses ------:
 201                 ! tn3270 login, remap function and arrow keys.
 202                 tn3270*font:    *clean-bold-*-*--15-*
 203
 204                 ! keysym - used by rxvt only
 205                 ! Delete - ^D
 206                 tn3270*keysym.0xFFFF:   \004
 207
 208                 ! Home - ^A
 209                 tn3270*keysym.0xFF50:   \001
 210                 ! Left - ^B
 211                 tn3270*keysym.0xFF51:   \002
 212                 ! Up - ^P
 213                 tn3270*keysym.0xFF52:   \020
 214                 ! Right - ^F
 215                 tn3270*keysym.0xFF53:   \006
 216                 ! Down - ^N
 217                 tn3270*keysym.0xFF54:   \016
 218                 ! End - ^E
 219                 tn3270*keysym.0xFF57:   \005
 220
 221                 ! F1 - F12
 222                 tn3270*keysym.0xFFBE:   \e1
 223                 tn3270*keysym.0xFFBF:   \e2
 224                 tn3270*keysym.0xFFC0:   \e3
 225                 tn3270*keysym.0xFFC1:   \e4
 226                 tn3270*keysym.0xFFC2:   \e5
 227                 tn3270*keysym.0xFFC3:   \e6
 228                 tn3270*keysym.0xFFC4:   \e7
 229                 tn3270*keysym.0xFFC5:   \e8
 230                 tn3270*keysym.0xFFC6:   \e9
 231                 tn3270*keysym.0xFFC7:   \e0
 232                 tn3270*keysym.0xFFC8:   \e-
 233                 tn3270*keysym.0xFFC9:   \e=
 234
 235                 ! map Prior/Next to F7/F8
 236                 tn3270*keysym.0xFF55:   \e7
 237                 tn3270*keysym.0xFF56:   \e8
 238
 239 -----
 240
 241     Q:  I'm using keyboard model XXX that has extra Prior/Next/Insert keys.
 242         How do I make use of them?  For example, the Sun Keyboard type 4
 243         has the following mappings that rxvt doesn't recognize.
 244
 245                 KP_Insert == Insert
 246                 F22 == Print
 247                 F27 == Home
 248                 F29 == Prior
 249                 F33 == End
 250                 F35 == Next
 251
 252     A:  Rather than have rxvt try to accomodate all the various possible
 253         keyboard mappings, it is better to use `xmodmap' to remap the
 254         keys as required for your particular machine.
 255
 256 -----
 257
 258     Q:  How do I distinguish if I'm running rxvt or a regular xterm?
 259         I need this to decide about setting colors etc.
 260
 261     A:  rxvt always exports the variable "COLORTERM", so you can check and
 262         see if that is set.  Note that several programs, JED, slrn, Midnight
 263         Commander automatically check this variable to decide whether or not
 264         to use color.
 265
 266 -----
 267
 268     Q:  How do I set the correct, full IP address for the DISPLAY variable?
 269
 270     A:  If you've compiled rxvt with DISPLAY_IS_IP then it is
 271         possible to use the following shell script snippets to correctly set
 272         the display.  If your version of rxvt wasn't also compiled with
 273         ESCZ_ANSWER (as assumed in these snippets) then the COLORTERM
 274         variable can be used to distinguish rxvt from a regular xterm.
 275
 276         Courtesy of Chuck Blake <cblake@BBN.COM> with the following shell
 277         script snippets:
 278
 279         # Bourne/Korn/POSIX family of shells:
 280         [ ${TERM:-foo} = foo ] && TERM=xterm # assume an xterm if we don't know
 281         if [ ${TERM:-foo} = xterm ]; then
 282             stty -icanon -echo min 0 time 15 # see if enhanced rxvt or not
 283             echo -n '^[Z'
 284             read term_id
 285             stty icanon echo
 286             if [ ""${term_id} = '^[[?1;2C' -a ${DISPLAY:-foo} = foo ]; then
 287                 echo -n '^[[7n'         # query the rxvt we are in for the DISPLAY string
 288                 read DISPLAY            # set it in our local shell
 289             fi
 290         fi
 291
 292         csh/tcsh family of shells:
 293
 294         if ( !(${?TERM}) ) then         # if term is unset, we are probably in an xterm
 295             TERM = xterm
 296         endif
 297         if ( ${TERM} =~ xterm ) then
 298             stty -icanon -echo min 0 time 15   # see if enhanced rxvt or not
 299             echo -n '^[Z'
 300             set term_id=$<
 301             stty icanon echo
 302             if ( ""${term_id} == "^[[?1;2C" && ${?DISPLAY} == 0 ) then
 303                 echo -n '^[[7n'         # query the rxvt we're in for the DISPLAY string
 304                 setenv DISPLAY "$<"     # set it in our local shell
 305             endif
 306         endif
 307
 308 -----
 309
 310     Q:  How do I compile the manual pages for myself?  Where do I obtain
 311         yodl from?
 312
 313     A:  You need to obtain yodl and compile it to make the manual pages
 314         from source.  The source code for yodl can currently be obtained
 315         from http://www.xs4all.nl/~jantien/yodl/index.html
 316 --
 317 EOF