ViewVC Help
View File | Revision Log | Show Annotations | Download File
/cvs/rxvt-unicode/README.FAQ
(Generate patch)

Comparing rxvt-unicode/README.FAQ (file contents):
Revision 1.42 by root, Thu Jul 6 19:43:21 2006 UTC vs.
Revision 1.72 by root, Sat May 14 08:28:25 2016 UTC

2 Meta, Features & Commandline Issues 2 Meta, Features & Commandline Issues
3 My question isn't answered here, can I ask a human? 3 My question isn't answered here, can I ask a human?
4 Before sending me mail, you could go to IRC: "irc.freenode.net", channel 4 Before sending me mail, you could go to IRC: "irc.freenode.net", channel
5 "#rxvt-unicode" has some rxvt-unicode enthusiasts that might be 5 "#rxvt-unicode" has some rxvt-unicode enthusiasts that might be
6 interested in learning about new and exciting problems (but not FAQs :). 6 interested in learning about new and exciting problems (but not FAQs :).
7
8 I use Gentoo, and I have a problem...
9 There are two big problems with Gentoo Linux: first, most if not all
10 Gentoo systems are completely broken (missing or mismatched header
11 files, broken compiler etc. are just the tip of the iceberg); secondly,
12 it should be called Gentoo GNU/Linux.
13
14 For these reasons, it is impossible to support rxvt-unicode on Gentoo.
15 Problems appearing on Gentoo systems will usually simply be ignored
16 unless they can be reproduced on non-Gentoo systems.
7 17
8 Does it support tabs, can I have a tabbed rxvt-unicode? 18 Does it support tabs, can I have a tabbed rxvt-unicode?
9 Beginning with version 7.3, there is a perl extension that implements a 19 Beginning with version 7.3, there is a perl extension that implements a
10 simple tabbed terminal. It is installed by default, so any of these 20 simple tabbed terminal. It is installed by default, so any of these
11 should give you tabs: 21 should give you tabs:
42 52
43 How can I start urxvtd in a race-free way? 53 How can I start urxvtd in a race-free way?
44 Try "urxvtd -f -o", which tells urxvtd to open the display, create the 54 Try "urxvtd -f -o", which tells urxvtd to open the display, create the
45 listening socket and then fork. 55 listening socket and then fork.
46 56
47 How can I start urxvtd automatically when I run URXVT_NAME@@c? 57 How can I start urxvtd automatically when I run urxvtc?
48 If you want to start urxvtd automatically whenever you run urxvtc and 58 If you want to start urxvtd automatically whenever you run urxvtc and
49 the daemon isn't running yet, use this script: 59 the daemon isn't running yet, use this script:
50 60
51 #!/bin/sh 61 #!/bin/sh
52 urxvtc "$@" 62 urxvtc "$@"
58 This tries to create a new terminal, and if fails with exit status 2, 68 This tries to create a new terminal, and if fails with exit status 2,
59 meaning it couldn't connect to the daemon, it will start the daemon and 69 meaning it couldn't connect to the daemon, it will start the daemon and
60 re-run the command. Subsequent invocations of the script will re-use the 70 re-run the command. Subsequent invocations of the script will re-use the
61 existing daemon. 71 existing daemon.
62 72
63 How do I distinguish wether I'm running rxvt-unicode or a regular xterm? I need this to decide about setting colors etc. 73 How do I distinguish whether I'm running rxvt-unicode or a regular
74xterm? I need this to decide about setting colours etc.
64 The original rxvt and rxvt-unicode always export the variable 75 The original rxvt and rxvt-unicode always export the variable
65 "COLORTERM", so you can check and see if that is set. Note that several 76 "COLORTERM", so you can check and see if that is set. Note that several
66 programs, JED, slrn, Midnight Commander automatically check this 77 programs, JED, slrn, Midnight Commander automatically check this
67 variable to decide whether or not to use color. 78 variable to decide whether or not to use colour.
68 79
69 How do I set the correct, full IP address for the DISPLAY variable? 80 How do I set the correct, full IP address for the DISPLAY variable?
70 If you've compiled rxvt-unicode with DISPLAY_IS_IP and have enabled 81 If you've compiled rxvt-unicode with DISPLAY_IS_IP and have enabled
71 insecure mode then it is possible to use the following shell script 82 insecure mode then it is possible to use the following shell script
72 snippets to correctly set the display. If your version of rxvt-unicode 83 snippets to correctly set the display. If your version of rxvt-unicode
79 90
80 # Bourne/Korn/POSIX family of shells: 91 # Bourne/Korn/POSIX family of shells:
81 [ ${TERM:-foo} = foo ] && TERM=xterm # assume an xterm if we don't know 92 [ ${TERM:-foo} = foo ] && TERM=xterm # assume an xterm if we don't know
82 if [ ${TERM:-foo} = xterm ]; then 93 if [ ${TERM:-foo} = xterm ]; then
83 stty -icanon -echo min 0 time 15 # see if enhanced rxvt or not 94 stty -icanon -echo min 0 time 15 # see if enhanced rxvt or not
84 echo -n '^[Z' 95 printf "\eZ"
85 read term_id 96 read term_id
86 stty icanon echo 97 stty icanon echo
87 if [ ""${term_id} = '^[[?1;2C' -a ${DISPLAY:-foo} = foo ]; then 98 if [ ""${term_id} = '^[[?1;2C' -a ${DISPLAY:-foo} = foo ]; then
88 echo -n '^[[7n' # query the rxvt we are in for the DISPLAY string 99 printf '\e[7n' # query the rxvt we are in for the DISPLAY string
89 read DISPLAY # set it in our local shell 100 read DISPLAY # set it in our local shell
90 fi 101 fi
91 fi 102 fi
92 103
93 How do I compile the manual pages on my own? 104 How do I compile the manual pages on my own?
94 You need to have a recent version of perl installed as /usr/bin/perl, 105 You need to have a recent version of perl installed as /usr/bin/perl,
95 one that comes with pod2man, pod2text and pod2html. Then go to the doc 106 one that comes with pod2man, pod2text and pod2xhtml (from Pod::Xhtml).
96 subdirectory and enter "make alldoc". 107 Then go to the doc subdirectory and enter "make alldoc".
97 108
98 Isn't rxvt-unicode supposed to be small? Don't all those features bloat? 109 Isn't rxvt-unicode supposed to be small? Don't all those features bloat?
99 I often get asked about this, and I think, no, they didn't cause extra 110 I often get asked about this, and I think, no, they didn't cause extra
100 bloat. If you compare a minimal rxvt and a minimal urxvt, you can see 111 bloat. If you compare a minimal rxvt and a minimal urxvt, you can see
101 that the urxvt binary is larger (due to some encoding tables always 112 that the urxvt binary is larger (due to some encoding tables always
108 98398 1664 24 15695 1824 rxvt --disable-everything 119 98398 1664 24 15695 1824 rxvt --disable-everything
109 188985 9048 66616 18222 1788 urxvt --disable-everything 120 188985 9048 66616 18222 1788 urxvt --disable-everything
110 121
111 When you "--enable-everything" (which *is* unfair, as this involves xft 122 When you "--enable-everything" (which *is* unfair, as this involves xft
112 and full locale/XIM support which are quite bloaty inside libX11 and my 123 and full locale/XIM support which are quite bloaty inside libX11 and my
113 libc), the two diverge, but not unreasnobaly so. 124 libc), the two diverge, but not unreasonably so.
114 125
115 text data bss drs rss filename 126 text data bss drs rss filename
116 163431 2152 24 20123 2060 rxvt --enable-everything 127 163431 2152 24 20123 2060 rxvt --enable-everything
117 1035683 49680 66648 29096 3680 urxvt --enable-everything 128 1035683 49680 66648 29096 3680 urxvt --enable-everything
118 129
146 the case of rxvt-unicode this hardly matters, as its portability limits 157 the case of rxvt-unicode this hardly matters, as its portability limits
147 are defined by things like X11, pseudo terminals, locale support and 158 are defined by things like X11, pseudo terminals, locale support and
148 unix domain sockets, which are all less portable than C++ itself. 159 unix domain sockets, which are all less portable than C++ itself.
149 160
150 Regarding the bloat, see the above question: It's easy to write programs 161 Regarding the bloat, see the above question: It's easy to write programs
151 in C that use gobs of memory, an certainly possible to write programs in 162 in C that use gobs of memory, and certainly possible to write programs
152 C++ that don't. C++ also often comes with large libraries, but this is 163 in C++ that don't. C++ also often comes with large libraries, but this
153 not necessarily the case with GCC. Here is what rxvt links against on my 164 is not necessarily the case with GCC. Here is what rxvt links against on
154 system with a minimal config: 165 my system with a minimal config:
155 166
156 libX11.so.6 => /usr/X11R6/lib/libX11.so.6 (0x00002aaaaabc3000) 167 libX11.so.6 => /usr/X11R6/lib/libX11.so.6 (0x00002aaaaabc3000)
157 libc.so.6 => /lib/libc.so.6 (0x00002aaaaadde000) 168 libc.so.6 => /lib/libc.so.6 (0x00002aaaaadde000)
158 libdl.so.2 => /lib/libdl.so.2 (0x00002aaaab01d000) 169 libdl.so.2 => /lib/libdl.so.2 (0x00002aaaab01d000)
159 /lib64/ld-linux-x86-64.so.2 (0x00002aaaaaaab000) 170 /lib64/ld-linux-x86-64.so.2 (0x00002aaaaaaab000)
160 171
161 And here is rxvt-unicode: 172 And here is rxvt-unicode:
162 173
163 libX11.so.6 => /usr/X11R6/lib/libX11.so.6 (0x00002aaaaabc3000) 174 libX11.so.6 => /usr/X11R6/lib/libX11.so.6 (0x00002aaaaabc3000)
164 libgcc_s.so.1 => /lib/libgcc_s.so.1 (0x00002aaaaada2000) 175 libgcc_s.so.1 => /lib/libgcc_s.so.1 (0x00002aaaaada2000)
165 libc.so.6 => /lib/libc.so.6 (0x00002aaaaaeb0000) 176 libc.so.6 => /lib/libc.so.6 (0x00002aaaaaeb0000)
166 libdl.so.2 => /lib/libdl.so.2 (0x00002aaaab0ee000) 177 libdl.so.2 => /lib/libdl.so.2 (0x00002aaaab0ee000)
167 /lib64/ld-linux-x86-64.so.2 (0x00002aaaaaaab000) 178 /lib64/ld-linux-x86-64.so.2 (0x00002aaaaaaab000)
168 179
169 No large bloated libraries (of course, none were linked in statically), 180 No large bloated libraries (of course, none were linked in statically),
170 except maybe libX11 :) 181 except maybe libX11 :)
171 182
177 rite of passage: ... and you failed. 188 rite of passage: ... and you failed.
178 189
179 Here are four ways to get transparency. Do read the manpage and option 190 Here are four ways to get transparency. Do read the manpage and option
180 descriptions for the programs mentioned and rxvt-unicode. Really, do it! 191 descriptions for the programs mentioned and rxvt-unicode. Really, do it!
181 192
182 1. Use inheritPixmap: 193 1. Use transparent mode:
183 194
184 Esetroot wallpaper.jpg 195 Esetroot wallpaper.jpg
185 urxvt -ip -tint red -sh 40 196 urxvt -tr -tint red -sh 40
186 197
187 That works. If you think it doesn't, you lack transparency and tinting 198 That works. If you think it doesn't, you lack transparency and tinting
188 support, or you are unable to read. 199 support, or you are unable to read. This method requires that the
200 background-setting program sets the _XROOTPMAP_ID or ESETROOT_PMAP_ID
201 property. Compatible programs are Esetroot, hsetroot and feh.
189 202
190 2. Use a simple pixmap and emulate pseudo-transparency. This enables you 203 2. Use a simple pixmap and emulate pseudo-transparency. This enables you
191 to use effects other than tinting and shading: Just shade/tint/whatever 204 to use effects other than tinting and shading: Just shade/tint/whatever
192 your picture with gimp or any other tool: 205 your picture with gimp or any other tool:
193 206
194 convert wallpaper.jpg -blur 20x20 -modulate 30 background.xpm 207 convert wallpaper.jpg -blur 20x20 -modulate 30 background.jpg
195 urxvt -pixmap background.xpm -pe automove-background 208 urxvt -pixmap "background.jpg;:root"
196 209
197 That works. If you think it doesn't, you lack XPM and Perl support, or 210 That works. If you think it doesn't, you lack GDK-PixBuf support, or you
198 you are unable to read. 211 are unable to read.
199 212
200 3. Use an ARGB visual: 213 3. Use an ARGB visual:
201 214
202 urxvt -depth 32 -fg grey90 -bg rgba:0000/0000/4444/cccc 215 urxvt -depth 32 -fg grey90 -bg rgba:0000/0000/4444/cccc
203 216
204 This requires XFT support, and the support of your X-server. If that 217 This requires XFT support, and the support of your X-server. If that
205 doesn't work for you, blame Xorg and Keith Packard. ARGB visuals aren't 218 doesn't work for you, blame Xorg and Keith Packard. ARGB visuals aren't
206 there yet, no matter what they claim. Rxvt-Unicode contains the 219 there yet, no matter what they claim. Rxvt-Unicode contains the
207 neccessary bugfixes and workarounds for Xft and Xlib to make it work, 220 necessary bugfixes and workarounds for Xft and Xlib to make it work, but
208 but that doesn't mean that your WM has the required kludges in place. 221 that doesn't mean that your WM has the required kludges in place.
209 222
210 4. Use xcompmgr and let it do the job: 223 4. Use xcompmgr and let it do the job:
211 224
212 xprop -frame -f _NET_WM_WINDOW_OPACITY 32c \ 225 xprop -frame -f _NET_WM_WINDOW_OPACITY 32c \
213 -set _NET_WM_WINDOW_OPACITY 0xc0000000 226 -set _NET_WM_WINDOW_OPACITY 0xc0000000
228 however: Xft fonts often draw glyphs larger than their acclaimed 241 however: Xft fonts often draw glyphs larger than their acclaimed
229 bounding box, and rxvt-unicode has no way of detecting this (the correct 242 bounding box, and rxvt-unicode has no way of detecting this (the correct
230 way is to ask for the character bounding box, which unfortunately is 243 way is to ask for the character bounding box, which unfortunately is
231 wrong in these cases). 244 wrong in these cases).
232 245
233 It's not clear (to me at least), wether this is a bug in Xft, freetype, 246 It's not clear (to me at least), whether this is a bug in Xft, freetype,
234 or the respective font. If you encounter this problem you might try 247 or the respective font. If you encounter this problem you might try
235 using the "-lsp" option to give the font more height. If that doesn't 248 using the "-lsp" option to give the font more height. If that doesn't
236 work, you might be forced to use a different font. 249 work, you might be forced to use a different font.
237 250
238 All of this is not a problem when using X11 core fonts, as their 251 All of this is not a problem when using X11 core fonts, as their
297 What's with this bold/blink stuff? 310 What's with this bold/blink stuff?
298 If no bold colour is set via "colorBD:", bold will invert text using the 311 If no bold colour is set via "colorBD:", bold will invert text using the
299 standard foreground colour. 312 standard foreground colour.
300 313
301 For the standard background colour, blinking will actually make the text 314 For the standard background colour, blinking will actually make the text
302 blink when compiled with "--enable-blinking". with standard colours. 315 blink when compiled with "--enable-text-blink". Without
303 Without "--enable-blinking", the blink attribute will be ignored. 316 "--enable-text-blink", the blink attribute will be ignored.
304 317
305 On ANSI colours, bold/blink attributes are used to set high-intensity 318 On ANSI colours, bold/blink attributes are used to set high-intensity
306 foreground/background colors. 319 foreground/background colours.
307 320
308 color0-7 are the low-intensity colors. 321 color0-7 are the low-intensity colours.
309 322
310 color8-15 are the corresponding high-intensity colors. 323 color8-15 are the corresponding high-intensity colours.
311 324
312 I don't like the screen colors. How do I change them? 325 I don't like the screen colours. How do I change them?
313 You can change the screen colors at run-time using ~/.Xdefaults 326 You can change the screen colours at run-time using ~/.Xdefaults
314 resources (or as long-options). 327 resources (or as long-options).
315 328
316 Here are values that are supposed to resemble a VGA screen, including 329 Here are values that are supposed to resemble a VGA screen, including
317 the murky brown that passes for low-intensity yellow: 330 the murky brown that passes for low-intensity yellow:
318 331
332 URxvt.color12: #0000FF 345 URxvt.color12: #0000FF
333 URxvt.color13: #FF00FF 346 URxvt.color13: #FF00FF
334 URxvt.color14: #00FFFF 347 URxvt.color14: #00FFFF
335 URxvt.color15: #FFFFFF 348 URxvt.color15: #FFFFFF
336 349
337 And here is a more complete set of non-standard colors. 350 And here is a more complete set of non-standard colours.
338 351
339 URxvt.cursorColor: #dc74d1 352 URxvt.cursorColor: #dc74d1
340 URxvt.pointerColor: #dc74d1 353 URxvt.pointerColor: #dc74d1
341 URxvt.background: #0e0e0e 354 URxvt.background: #0e0e0e
342 URxvt.foreground: #4ad5e1 355 URxvt.foreground: #4ad5e1
409 has been designed yet). 422 has been designed yet).
410 423
411 Until then, you might get away with switching fonts at runtime (see "Can 424 Until then, you might get away with switching fonts at runtime (see "Can
412 I switch the fonts at runtime?" later in this document). 425 I switch the fonts at runtime?" later in this document).
413 426
427 How can I make mplayer display video correctly?
428 We are working on it, in the meantime, as a workaround, use something
429 like:
430
431 urxvt -b 600 -geometry 20x1 -e sh -c 'mplayer -wid $WINDOWID file...'
432
433 Why is the cursor now blinking in emacs/vi/...?
434 This is likely caused by your editor/program's use of the "cvvis"
435 terminfo capability. Emacs uses it by default, as well as some versions
436 of vi and possibly other programs.
437
438 In emacs, you can switch that off by adding this to your ".emacs" file:
439
440 (setq visible-cursor nil)
441
442 For other programs, if they do not have an option, your have to remove
443 the "cvvis" capability from the terminfo description.
444
445 When urxvt first added the blinking cursor option, it didn't add a
446 "cvvis" capability, which served no purpose before. Version 9.21
447 introduced "cvvis" (and the ability to control blinking independent of
448 cursor shape) for compatibility with other terminals, which
449 traditionally use a blinking cursor for "cvvis". This also reflects the
450 intent of programs such as emacs, who expect "cvvis" to enable a
451 blinking cursor.
452
414 Keyboard, Mouse & User Interaction 453 Keyboard, Mouse & User Interaction
415 The new selection selects pieces that are too big, how can I select single words? 454 The new selection selects pieces that are too big, how can I select single words?
416 If you want to select e.g. alphanumeric words, you can use the following 455 If you want to select e.g. alphanumeric words, you can use the following
417 setting: 456 setting:
418 457
424 To get a selection that is very similar to the old code, try this 463 To get a selection that is very similar to the old code, try this
425 pattern: 464 pattern:
426 465
427 URxvt.selection.pattern-0: ([^"&'()*,;<=>?@[\\\\]^`{|})]+) 466 URxvt.selection.pattern-0: ([^"&'()*,;<=>?@[\\\\]^`{|})]+)
428 467
429 Please also note that the *LeftClick Shift-LeftClik* combination also 468 Please also note that the *LeftClick Shift-LeftClick* combination also
430 selects words like the old code. 469 selects words like the old code.
431 470
432 I don't like the new selection/popups/hotkeys/perl, how do I change/disable it? 471 I don't like the new selection/popups/hotkeys/perl, how do I change/disable it?
433 You can disable the perl extension completely by setting the 472 You can disable the perl extension completely by setting the
434 perl-ext-common resource to the empty string, which also keeps 473 perl-ext-common resource to the empty string, which also keeps
443 URxvt.perl-ext-common: default,-selection-popup,-option-popup 482 URxvt.perl-ext-common: default,-selection-popup,-option-popup
444 483
445 This will keep the default extensions, but disable the two popup 484 This will keep the default extensions, but disable the two popup
446 extensions. Some extensions can also be configured, for example, 485 extensions. Some extensions can also be configured, for example,
447 scrollback search mode is triggered by M-s. You can move it to any other 486 scrollback search mode is triggered by M-s. You can move it to any other
448 combination either by setting the searchable-scrollback resource: 487 combination by adding a keysym resource that binds the desired
488 combination to the "start" action of "searchable-scrollback" and another
489 one that binds M-s to the "builtin:" action:
449 490
450 URxvt.searchable-scrollback: CM-s 491 URxvt.keysym.CM-s: searchable-scrollback:start
492 URxvt.keysym.M-s: builtin:
451 493
452 The cursor moves when selecting text in the current input line, how do I switch this off? 494 The cursor moves when selecting text in the current input line, how do I switch this off?
453 See next entry. 495 See next entry.
454 496
455 During rlogin/ssh/telnet/etc. sessions, clicking near the cursor outputs strange escape sequences, how do I fix this? 497 During rlogin/ssh/telnet/etc. sessions, clicking near the cursor outputs strange escape sequences, how do I fix this?
457 circumstances, it will move your cursor around when you click into the 499 circumstances, it will move your cursor around when you click into the
458 line that contains it. It tries hard not to do this at the wrong moment, 500 line that contains it. It tries hard not to do this at the wrong moment,
459 but when running a program that doesn't parse cursor movements or in 501 but when running a program that doesn't parse cursor movements or in
460 some cases during rlogin sessions, it fails to detect this properly. 502 some cases during rlogin sessions, it fails to detect this properly.
461 503
462 You can permamently switch this feature off by disabling the "readline" 504 You can permanently switch this feature off by disabling the "readline"
463 extension: 505 extension:
464 506
465 URxvt.perl-ext-common: default,-readline 507 URxvt.perl-ext-common: default,-readline
466 508
467 My numerical keypad acts weird and generates differing output? 509 My numeric keypad acts weird and generates differing output?
468 Some Debian GNUL/Linux users seem to have this problem, although no 510 Some Debian GNU/Linux users seem to have this problem, although no
469 specific details were reported so far. It is possible that this is 511 specific details were reported so far. It is possible that this is
470 caused by the wrong "TERM" setting, although the details of wether and 512 caused by the wrong "TERM" setting, although the details of whether and
471 how this can happen are unknown, as "TERM=rxvt" should offer a 513 how this can happen are unknown, as "TERM=rxvt" should offer a
472 compatible keymap. See the answer to the previous question, and please 514 compatible keymap. See the answer to the previous question, and please
473 report if that helped. 515 report if that helped.
474 516
475 My Compose (Multi_key) key is no longer working. 517 My Compose (Multi_key) key is no longer working.
476 The most common causes for this are that either your locale is not set 518 The most common causes for this are that either your locale is not set
477 correctly, or you specified a preeditStyle that is not supported by your 519 correctly, or you specified a preeditType that is not supported by your
478 input method. For example, if you specified OverTheSpot and your input 520 input method. For example, if you specified OverTheSpot and your input
479 method (e.g. the default input method handling Compose keys) does not 521 method (e.g. the default input method handling Compose keys) does not
480 support this (for instance because it is not visual), then rxvt-unicode 522 support this (for instance because it is not visual), then rxvt-unicode
481 will continue without an input method. 523 will continue without an input method.
482 524
483 In this case either do not specify a preeditStyle or specify more than 525 In this case either do not specify a preeditType or specify more than
484 one pre-edit style, such as OverTheSpot,Root,None. 526 one pre-edit style, such as OverTheSpot,Root,None.
527
528 If it still doesn't work, then maybe your input method doesn't support
529 compose sequences - to fall back to the built-in one, make sure you
530 don't specify an input method via "-im" or "XMODIFIERS".
485 531
486 I cannot type "Ctrl-Shift-2" to get an ASCII NUL character due to ISO 14755 532 I cannot type "Ctrl-Shift-2" to get an ASCII NUL character due to ISO 14755
487 Either try "Ctrl-2" alone (it often is mapped to ASCII NUL even on 533 Either try "Ctrl-2" alone (it often is mapped to ASCII NUL even on
488 international keyboards) or simply use ISO 14755 support to your 534 international keyboards) or simply use ISO 14755 support to your
489 advantage, typing <Ctrl-Shift-0> to get a ASCII NUL. This works for 535 advantage, typing <Ctrl-Shift-0> to get a ASCII NUL. This works for
490 other codes, too, such as "Ctrl-Shift-1-d" to type the default telnet 536 other codes, too, such as "Ctrl-Shift-1-d" to type the default telnet
491 escape character and so on. 537 escape character and so on.
492 538
493 Mouse cut/paste suddenly no longer works. 539 Mouse cut/paste suddenly no longer works.
494 Make sure that mouse reporting is actually turned off since killing some 540 Make sure that mouse reporting is actually turned off since killing some
495 editors prematurely may leave the mouse in mouse report mode. I've heard 541 editors prematurely may leave it active. I've heard that tcsh may use
496 that tcsh may use mouse reporting unless it otherwise specified. A quick 542 mouse reporting unless it is otherwise specified. A quick check is to
497 check is to see if cut/paste works when the Alt or Shift keys are 543 see if cut/paste works when the Alt or Shift keys are pressed.
498 depressed.
499 544
500 What's with the strange Backspace/Delete key behaviour? 545 What's with the strange Backspace/Delete key behaviour?
501 Assuming that the physical Backspace key corresponds to the BackSpace 546 Assuming that the physical Backspace key corresponds to the Backspace
502 keysym (not likely for Linux ... see the following question) there are 547 keysym (not likely for Linux ... see the following question) there are
503 two standard values that can be used for Backspace: "^H" and "^?". 548 two standard values that can be used for Backspace: "^H" and "^?".
504 549
505 Historically, either value is correct, but rxvt-unicode adopts the 550 Historically, either value is correct, but rxvt-unicode adopts the
506 debian policy of using "^?" when unsure, because it's the one only only 551 debian policy of using "^?" when unsure, because it's the one and only
507 correct choice :). 552 correct choice :).
508 553
509 Rxvt-unicode tries to inherit the current stty settings and uses the 554 It is possible to toggle between "^H" and "^?" with the DECBKM private
510 value of `erase' to guess the value for backspace. If rxvt-unicode 555 mode:
511 wasn't started from a terminal (say, from a menu or by remote shell),
512 then the system value of `erase', which corresponds to CERASE in
513 <termios.h>, will be used (which may not be the same as your stty
514 setting).
515
516 For starting a new rxvt-unicode:
517 556
518 # use Backspace = ^H 557 # use Backspace = ^H
519 $ stty erase ^H 558 $ stty erase ^H
520 $ urxvt 559 $ printf "\e[?67h"
521 560
522 # use Backspace = ^? 561 # use Backspace = ^?
523 $ stty erase ^? 562 $ stty erase ^?
524 $ urxvt 563 $ printf "\e[?67l"
525
526 Toggle with "ESC [ 36 h" / "ESC [ 36 l".
527
528 For an existing rxvt-unicode:
529
530 # use Backspace = ^H
531 $ stty erase ^H
532 $ echo -n "^[[36h"
533
534 # use Backspace = ^?
535 $ stty erase ^?
536 $ echo -n "^[[36l"
537 564
538 This helps satisfy some of the Backspace discrepancies that occur, but 565 This helps satisfy some of the Backspace discrepancies that occur, but
539 if you use Backspace = "^H", make sure that the termcap/terminfo value 566 if you use Backspace = "^H", make sure that the termcap/terminfo value
540 properly reflects that. 567 properly reflects that.
541 568
557 use the `keysym' resource to alter the keystrings associated with 584 use the `keysym' resource to alter the keystrings associated with
558 keysyms. 585 keysyms.
559 586
560 Here's an example for a URxvt session started using "urxvt -name URxvt" 587 Here's an example for a URxvt session started using "urxvt -name URxvt"
561 588
589 URxvt.keysym.Prior: \033[5~
590 URxvt.keysym.Next: \033[6~
562 URxvt.keysym.Home: \033[1~ 591 URxvt.keysym.Home: \033[7~
563 URxvt.keysym.End: \033[4~ 592 URxvt.keysym.End: \033[8~
564 URxvt.keysym.C-apostrophe: \033<C-'>
565 URxvt.keysym.C-slash: \033<C-/>
566 URxvt.keysym.C-semicolon: \033<C-;>
567 URxvt.keysym.C-grave: \033<C-`>
568 URxvt.keysym.C-comma: \033<C-,>
569 URxvt.keysym.C-period: \033<C-.>
570 URxvt.keysym.C-0x60: \033<C-`>
571 URxvt.keysym.C-Tab: \033<C-Tab>
572 URxvt.keysym.C-Return: \033<C-Return>
573 URxvt.keysym.S-Return: \033<S-Return>
574 URxvt.keysym.S-space: \033<S-Space>
575 URxvt.keysym.M-Up: \033<M-Up> 593 URxvt.keysym.Up: \033[A
576 URxvt.keysym.M-Down: \033<M-Down> 594 URxvt.keysym.Down: \033[B
595 URxvt.keysym.Right: \033[C
577 URxvt.keysym.M-Left: \033<M-Left> 596 URxvt.keysym.Left: \033[D
578 URxvt.keysym.M-Right: \033<M-Right>
579 URxvt.keysym.M-C-0: list \033<M-C- 0123456789 >
580 URxvt.keysym.M-C-a: list \033<M-C- abcdefghijklmnopqrstuvwxyz >
581 URxvt.keysym.F12: command:\033]701;zh_CN.GBK\007
582 597
583 See some more examples in the documentation for the keysym resource. 598 See some more examples in the documentation for the keysym resource.
584 599
585 I'm using keyboard model XXX that has extra Prior/Next/Insert keys. How do I make use of them? For example, the Sun Keyboard type 4 has the following map 600 I'm using keyboard model XXX that has extra Prior/Next/Insert keys. How do I make use of them? For example, the Sun Keyboard type 4 has the following map
586 KP_Insert == Insert 601 KP_Insert == Insert
628 directory and also tells urxvt to use a large number of extensions. I 643 directory and also tells urxvt to use a large number of extensions. I
629 develop for myself mostly, so I actually use most of the extensions I 644 develop for myself mostly, so I actually use most of the extensions I
630 write. 645 write.
631 646
632 The selection stuff mainly makes the selection perl-error-message aware 647 The selection stuff mainly makes the selection perl-error-message aware
633 and tells it to convert pelr error mssages into vi-commands to load the 648 and tells it to convert perl error messages into vi-commands to load the
634 relevant file and go tot he error line number. 649 relevant file and go to the error line number.
635 650
636 URxvt.scrollstyle: plain 651 URxvt.scrollstyle: plain
637 URxvt.secondaryScroll: true 652 URxvt.secondaryScroll: true
638 653
639 As the documentation says: plain is the preferred scrollbar for the 654 As the documentation says: plain is the preferred scrollbar for the
640 author. The "secondaryScroll" confgiures urxvt to scroll in full-screen 655 author. The "secondaryScroll" configures urxvt to scroll in full-screen
641 apps, like screen, so lines scorlled out of screen end up in urxvt's 656 apps, like screen, so lines scrolled out of screen end up in urxvt's
642 scrollback buffer. 657 scrollback buffer.
643 658
644 URxvt.background: #000000 659 URxvt.background: #000000
645 URxvt.foreground: gray90 660 URxvt.foreground: gray90
646 URxvt.color7: gray90 661 URxvt.color7: gray90
697 urxvt.boldFont: -xos4-terminus-bold-r-normal--14-140-72-72-c-80-iso8859-15 712 urxvt.boldFont: -xos4-terminus-bold-r-normal--14-140-72-72-c-80-iso8859-15
698 urxvt.italicFont: xft:Bitstream Vera Sans Mono:italic:autohint=true 713 urxvt.italicFont: xft:Bitstream Vera Sans Mono:italic:autohint=true
699 urxvt.boldItalicFont: xft:Bitstream Vera Sans Mono:bold:italic:autohint=true 714 urxvt.boldItalicFont: xft:Bitstream Vera Sans Mono:bold:italic:autohint=true
700 715
701 I wrote rxvt-unicode to be able to specify fonts exactly. So don't be 716 I wrote rxvt-unicode to be able to specify fonts exactly. So don't be
702 overwhelmed. A special note: the "9x15bold" mentioend above is actually 717 overwhelmed. A special note: the "9x15bold" mentioned above is actually
703 the version from XFree-3.3, as XFree-4 replaced it by a totally 718 the version from XFree-3.3, as XFree-4 replaced it by a totally
704 different font (different glyphs for ";" and many other harmless 719 different font (different glyphs for ";" and many other harmless
705 characters), while the second font is actually the "9x15bold" from 720 characters), while the second font is actually the "9x15bold" from
706 XFree4/XOrg. The bold version has less chars than the medium version, so 721 XFree4/XOrg. The bold version has less chars than the medium version, so
707 I use it for rare characters, too. Whene ditign sources with vim, I use 722 I use it for rare characters, too. When editing sources with vim, I use
708 italic for comments and other stuff, which looks quite good with 723 italic for comments and other stuff, which looks quite good with
709 Bitstream Vera anti-aliased. 724 Bitstream Vera anti-aliased.
710 725
711 Terminus is a quite bad font (many very wrong glyphs), but for most of 726 Terminus is a quite bad font (many very wrong glyphs), but for most of
712 my purposes, it works, and gives a different look, as my normal 727 my purposes, it works, and gives a different look, as my normal
713 (Non-bold) font is already bold, and I want to see a difference between 728 (Non-bold) font is already bold, and I want to see a difference between
714 bold and normal fonts. 729 bold and normal fonts.
715 730
716 Please note that I used the "urxvt" instance name and not the "URxvt" 731 Please note that I used the "urxvt" instance name and not the "URxvt"
717 class name. Thats because I use different configs for different 732 class name. That is because I use different configs for different
718 purposes, for example, my IRC window is started with "-name IRC", and 733 purposes, for example, my IRC window is started with "-name IRC", and
719 uses these defaults: 734 uses these defaults:
720 735
721 IRC*title: IRC 736 IRC*title: IRC
722 IRC*geometry: 87x12+535+542 737 IRC*geometry: 87x12+535+542
726 IRC*boldFont: suxuseuro 741 IRC*boldFont: suxuseuro
727 IRC*colorBD: white 742 IRC*colorBD: white
728 IRC*keysym.M-C-1: command:\033]710;suxuseuro\007\033]711;suxuseuro\007 743 IRC*keysym.M-C-1: command:\033]710;suxuseuro\007\033]711;suxuseuro\007
729 IRC*keysym.M-C-2: command:\033]710;9x15bold\007\033]711;9x15bold\007 744 IRC*keysym.M-C-2: command:\033]710;9x15bold\007\033]711;9x15bold\007
730 745
731 "Alt-Shift-1" and "Alt-Shift-2" switch between two different font sizes. 746 "Alt-Ctrl-1" and "Alt-Ctrl-2" switch between two different font sizes.
732 "suxuseuro" allows me to keep an eye (and actually read) stuff while 747 "suxuseuro" allows me to keep an eye (and actually read) stuff while
733 keeping a very small window. If somebody pastes something complicated 748 keeping a very small window. If somebody pastes something complicated
734 (e.g. japanese), I temporarily switch to a larger font. 749 (e.g. japanese), I temporarily switch to a larger font.
735 750
736 The above is all in my ".Xdefaults" (I don't use ".Xresources" nor 751 The above is all in my ".Xdefaults" (I don't use ".Xresources" nor
737 "xrdb"). I also have some resources in a separate ".Xdefaults-hostname" 752 "xrdb"). I also have some resources in a separate ".Xdefaults-hostname"
738 file for different hosts, for example, on ym main desktop, I use: 753 file for different hosts, for example, on my main desktop, I use:
739 754
740 URxvt.keysym.C-M-q: command:\033[3;5;5t 755 URxvt.keysym.C-M-q: command:\033[3;5;5t
741 URxvt.keysym.C-M-y: command:\033[3;5;606t 756 URxvt.keysym.C-M-y: command:\033[3;5;606t
742 URxvt.keysym.C-M-e: command:\033[3;1605;5t 757 URxvt.keysym.C-M-e: command:\033[3;1605;5t
743 URxvt.keysym.C-M-c: command:\033[3;1605;606t 758 URxvt.keysym.C-M-c: command:\033[3;1605;606t
763 Also consider the form resources have to use: 778 Also consider the form resources have to use:
764 779
765 URxvt.resource: value 780 URxvt.resource: value
766 781
767 If you want to use another form (there are lots of different ways of 782 If you want to use another form (there are lots of different ways of
768 specifying resources), make sure you understand wether and why it works. 783 specifying resources), make sure you understand whether and why it
769 If unsure, use the form above. 784 works. If unsure, use the form above.
770 785
771 When I log-in to another system it tells me about missing terminfo data? 786 When I log-in to another system it tells me about missing terminfo data?
772 The terminal description used by rxvt-unicode is not as widely available 787 The terminal description used by rxvt-unicode is not as widely available
773 as that for xterm, or even rxvt (for which the same problem often 788 as that for xterm, or even rxvt (for which the same problem often
774 arises). 789 arises).
775 790
776 The correct solution for this problem is to install the terminfo, this 791 The correct solution for this problem is to install the terminfo, this
777 can be done like this (with ncurses' infocmp): 792 can be done by simply installing rxvt-unicode on the remote system as
793 well (in case you have a nice package manager ready), or you can install
794 the terminfo database manually like this (with ncurses infocmp. works as
795 user and root):
778 796
779 REMOTE=remotesystem.domain 797 REMOTE=remotesystem.domain
780 infocmp rxvt-unicode | ssh $REMOTE "cat >/tmp/ti && tic /tmp/ti" 798 infocmp rxvt-unicode | ssh $REMOTE "mkdir -p .terminfo && cat >/tmp/ti && tic /tmp/ti"
781 799
782 ... or by installing rxvt-unicode normally on the remote system, 800 One some systems you might need to set $TERMINFO to the full path of
801 $HOME/.terminfo for this to work.
783 802
784 If you cannot or do not want to do this, then you can simply set 803 If you cannot or do not want to do this, then you can simply set
785 "TERM=rxvt" or even "TERM=xterm", and live with the small number of 804 "TERM=rxvt" or even "TERM=xterm", and live with the small number of
786 problems arising, which includes wrong keymapping, less and different 805 problems arising, which includes wrong keymapping, less and different
787 colours and some refresh errors in fullscreen applications. It's a nice 806 colours and some refresh errors in fullscreen applications. It's a nice
794 URxvt.termName: rxvt 813 URxvt.termName: rxvt
795 814
796 If you don't plan to use rxvt (quite common...) you could also replace 815 If you don't plan to use rxvt (quite common...) you could also replace
797 the rxvt terminfo file with the rxvt-unicode one and use "TERM=rxvt". 816 the rxvt terminfo file with the rxvt-unicode one and use "TERM=rxvt".
798 817
818 nano fails with "Error opening terminal: rxvt-unicode"
819 This exceptionally confusing and useless error message is printed by
820 nano when it can't find the terminfo database. Nothing is wrong with
821 your terminal, read the previous answer for a solution.
822
799 "tic" outputs some error when compiling the terminfo entry. 823 "tic" outputs some error when compiling the terminfo entry.
800 Most likely it's the empty definition for "enacs=". Just replace it by 824 Most likely it's the empty definition for "enacs=". Just replace it by
801 "enacs=\E[0@" and try again. 825 "enacs=\E[0@" and try again.
802 826
803 "bash"'s readline does not work correctly under urxvt. 827 "bash"'s readline does not work correctly under urxvt.
804 See next entry. 828 See next entry.
805 829
806 I need a termcap file entry. 830 I need a termcap file entry.
807 One reason you might want this is that some distributions or operating 831 One reason you might want this is that some distributions or operating
808 systems still compile some programs using the long-obsoleted termcap 832 systems still compile some programs using the long-obsoleted termcap
809 library (Fedora Core's bash is one example) and rely on a termcap entry 833 library (Fedora's bash is one example) and rely on a termcap entry for
810 for "rxvt-unicode". 834 "rxvt-unicode".
811 835
812 You could use rxvt's termcap entry with resonable results in many cases. 836 You could use rxvt's termcap entry with reasonable results in many
813 You can also create a termcap entry by using terminfo's infocmp program 837 cases. You can also create a termcap entry by using terminfo's infocmp
814 like this: 838 program like this:
815 839
816 infocmp -C rxvt-unicode 840 infocmp -C rxvt-unicode
817 841
818 Or you could use this termcap entry, generated by the command above: 842 Or you could use the termcap entry in doc/etc/rxvt-unicode.termcap,
819 843 generated by the command above.
820 rxvt-unicode|rxvt-unicode terminal (X Window System):\
821 :am:bw:eo:km:mi:ms:xn:xo:\
822 :co#80:it#8:li#24:lm#0:\
823 :AL=\E[%dL:DC=\E[%dP:DL=\E[%dM:DO=\E[%dB:IC=\E[%d@:\
824 :K1=\EOw:K2=\EOu:K3=\EOy:K4=\EOq:K5=\EOs:LE=\E[%dD:\
825 :RI=\E[%dC:SF=\E[%dS:SR=\E[%dT:UP=\E[%dA:ae=\E(B:al=\E[L:\
826 :as=\E(0:bl=^G:cd=\E[J:ce=\E[K:cl=\E[H\E[2J:\
827 :cm=\E[%i%d;%dH:cr=^M:cs=\E[%i%d;%dr:ct=\E[3g:dc=\E[P:\
828 :dl=\E[M:do=^J:ec=\E[%dX:ei=\E[4l:ho=\E[H:\
829 :i1=\E[?47l\E=\E[?1l:ic=\E[@:im=\E[4h:\
830 :is=\E[r\E[m\E[2J\E[H\E[?7h\E[?1;3;4;6l\E[4l:\
831 :k1=\E[11~:k2=\E[12~:k3=\E[13~:k4=\E[14~:k5=\E[15~:\
832 :k6=\E[17~:k7=\E[18~:k8=\E[19~:k9=\E[20~:kD=\E[3~:\
833 :kI=\E[2~:kN=\E[6~:kP=\E[5~:kb=\177:kd=\EOB:ke=\E[?1l\E>:\
834 :kh=\E[7~:kl=\EOD:kr=\EOC:ks=\E[?1h\E=:ku=\EOA:le=^H:\
835 :mb=\E[5m:md=\E[1m:me=\E[m\017:mr=\E[7m:nd=\E[C:rc=\E8:\
836 :sc=\E7:se=\E[27m:sf=^J:so=\E[7m:sr=\EM:st=\EH:ta=^I:\
837 :te=\E[r\E[?1049l:ti=\E[?1049h:ue=\E[24m:up=\E[A:\
838 :us=\E[4m:vb=\E[?5h\E[?5l:ve=\E[?25h:vi=\E[?25l:\
839 :vs=\E[?25h:
840 844
841 Why does "ls" no longer have coloured output? 845 Why does "ls" no longer have coloured output?
842 The "ls" in the GNU coreutils unfortunately doesn't use terminfo to 846 The "ls" in the GNU coreutils unfortunately doesn't use terminfo to
843 decide wether a terminal has colour, but uses its own configuration 847 decide whether a terminal has colour, but uses its own configuration
844 file. Needless to say, "rxvt-unicode" is not in its default file (among 848 file. Needless to say, "rxvt-unicode" is not in its default file (among
845 with most other terminals supporting colour). Either add: 849 with most other terminals supporting colour). Either add:
846 850
847 TERM rxvt-unicode 851 TERM rxvt-unicode
848 852
858 Why doesn't vim/emacs etc. make use of italic? 862 Why doesn't vim/emacs etc. make use of italic?
859 See next entry. 863 See next entry.
860 864
861 Why are the secondary screen-related options not working properly? 865 Why are the secondary screen-related options not working properly?
862 Make sure you are using "TERM=rxvt-unicode". Some pre-packaged 866 Make sure you are using "TERM=rxvt-unicode". Some pre-packaged
863 distributions (most notably Debian GNU/Linux) break rxvt-unicode by 867 distributions break rxvt-unicode by setting "TERM" to "rxvt", which
864 setting "TERM" to "rxvt", which doesn't have these extra features. 868 doesn't have these extra features. Unfortunately, some of these
865 Unfortunately, some of these (most notably, again, Debian GNU/Linux)
866 furthermore fail to even install the "rxvt-unicode" terminfo file, so 869 furthermore fail to even install the "rxvt-unicode" terminfo file, so
867 you will need to install it on your own (See the question When I log-in 870 you will need to install it on your own (See the question When I log-in
868 to another system it tells me about missing terminfo data? on how to do 871 to another system it tells me about missing terminfo data? on how to do
869 this). 872 this).
870 873
876 If you encounter strange problems like typing an accented character but 879 If you encounter strange problems like typing an accented character but
877 getting two unrelated other characters or similar, or if program output 880 getting two unrelated other characters or similar, or if program output
878 is subtly garbled, then you should check your locale settings. 881 is subtly garbled, then you should check your locale settings.
879 882
880 Rxvt-unicode must be started with the same "LC_CTYPE" setting as the 883 Rxvt-unicode must be started with the same "LC_CTYPE" setting as the
881 programs. Often rxvt-unicode is started in the "C" locale, while the 884 programs running in it. Often rxvt-unicode is started in the "C" locale,
882 login script running within the rxvt-unicode window changes the locale 885 while the login script running within the rxvt-unicode window changes
883 to something else, e.g. "en_GB.UTF-8". Needless to say, this is not 886 the locale to something else, e.g. "en_GB.UTF-8". Needless to say, this
884 going to work. 887 is not going to work, and is the most common cause for problems.
885 888
886 The best thing is to fix your startup environment, as you will likely 889 The best thing is to fix your startup environment, as you will likely
887 run into other problems. If nothing works you can try this in your 890 run into other problems. If nothing works you can try this in your
888 .profile. 891 .profile.
889 892
890 printf '\33]701;%s\007' "$LC_CTYPE" 893 printf '\33]701;%s\007' "$LC_CTYPE" # $LANG or $LC_ALL are worth a try, too
891 894
892 If this doesn't work, then maybe you use a "LC_CTYPE" specification not 895 If this doesn't work, then maybe you use a "LC_CTYPE" specification not
893 supported on your systems. Some systems have a "locale" command which 896 supported on your systems. Some systems have a "locale" command which
894 displays this (also, "perl -e0" can be used to check locale settings, as 897 displays this (also, "perl -e0" can be used to check locale settings, as
895 it will complain loudly if it cannot set the locale). If it displays 898 it will complain loudly if it cannot set the locale). If it displays
976 979
977 - Make sure your XIM server is actually running. 980 - Make sure your XIM server is actually running.
978 - Make sure the "XMODIFIERS" environment variable is set correctly when 981 - Make sure the "XMODIFIERS" environment variable is set correctly when
979 *starting* rxvt-unicode. 982 *starting* rxvt-unicode.
980 When you want to use e.g. kinput2, it must be set to "@im=kinput2". 983 When you want to use e.g. kinput2, it must be set to "@im=kinput2".
981 For scim, use "@im=SCIM". Youc an see what input method servers are 984 For scim, use "@im=SCIM". You can see what input method servers are
982 running with this command: 985 running with this command:
983 986
984 xprop -root XIM_SERVERS 987 xprop -root XIM_SERVERS
985
986
987 988
988 My input method wants <some encoding> but I want UTF-8, what can I do? 989 My input method wants <some encoding> but I want UTF-8, what can I do?
989 You can specify separate locales for the input method and the rest of 990 You can specify separate locales for the input method and the rest of
990 the terminal, using the resource "imlocale": 991 the terminal, using the resource "imlocale":
991 992
1005 cannot be completely avoided even if both sides cooperate. 1006 cannot be completely avoided even if both sides cooperate.
1006 1007
1007 So the only workaround is not to kill your Input Method Servers. 1008 So the only workaround is not to kill your Input Method Servers.
1008 1009
1009 Operating Systems / Package Maintaining 1010 Operating Systems / Package Maintaining
1010 I am using Debian GNU/Linux and have a problem...
1011 The Debian GNU/Linux package of rxvt-unicode in sarge contains large
1012 patches that considerably change the behaviour of rxvt-unicode (but
1013 unfortunately this notice has been removed). Before reporting a bug to
1014 the original rxvt-unicode author please download and install the genuine
1015 version (<http://software.schmorp.de#rxvt-unicode>) and try to reproduce
1016 the problem. If you cannot, chances are that the problems are specific
1017 to Debian GNU/Linux, in which case it should be reported via the Debian
1018 Bug Tracking System (use "reportbug" to report the bug).
1019
1020 For other problems that also affect the Debian package, you can and
1021 probably should use the Debian BTS, too, because, after all, it's also a
1022 bug in the Debian version and it serves as a reminder for other users
1023 that might encounter the same issue.
1024
1025 I am maintaining rxvt-unicode for distribution/OS XXX, any recommendation? 1011 I am maintaining rxvt-unicode for distribution/OS XXX, any recommendation?
1026 You should build one binary with the default options. configure now 1012 You should build one binary with the default options. configure now
1027 enables most useful options, and the trend goes to making them 1013 enables most useful options, and the trend goes to making them
1028 runtime-switchable, too, so there is usually no drawback to enbaling 1014 runtime-switchable, too, so there is usually no drawback to enabling
1029 them, except higher disk and possibly memory usage. The perl interpreter 1015 them, except higher disk and possibly memory usage. The perl interpreter
1030 should be enabled, as important functionality (menus, selection, likely 1016 should be enabled, as important functionality (menus, selection, likely
1031 more in the future) depends on it. 1017 more in the future) depends on it.
1032 1018
1033 You should not overwrite the "perl-ext-common" snd "perl-ext" resources 1019 You should not overwrite the "perl-ext-common" and "perl-ext" resources
1034 system-wide (except maybe with "defaults"). This will result in useful 1020 system-wide (except maybe with "defaults"). This will result in useful
1035 behaviour. If your distribution aims at low memory, add an empty 1021 behaviour. If your distribution aims at low memory, add an empty
1036 "perl-ext-common" resource to the app-defaults file. This will keep the 1022 "perl-ext-common" resource to the app-defaults file. This will keep the
1037 perl interpreter disabled until the user enables it. 1023 perl interpreter disabled until the user enables it.
1038 1024
1055 This forking is done as the very first within main(), which is very 1041 This forking is done as the very first within main(), which is very
1056 early and reduces possible bugs to initialisation code run before 1042 early and reduces possible bugs to initialisation code run before
1057 main(), or things like the dynamic loader of your system, which should 1043 main(), or things like the dynamic loader of your system, which should
1058 result in very little risk. 1044 result in very little risk.
1059 1045
1060 On Solaris 9, many line-drawing characters are too wide.
1061 Seems to be a known bug, read
1062 <http://nixdoc.net/files/forum/about34198.html>. Some people use the
1063 following ugly workaround to get non-double-wide-characters working:
1064
1065 #define wcwidth(x) wcwidth(x) > 1 ? 1 : wcwidth(x)
1066
1067 I am on FreeBSD and rxvt-unicode does not seem to work at all. 1046 I am on FreeBSD and rxvt-unicode does not seem to work at all.
1068 Rxvt-unicode requires the symbol "__STDC_ISO_10646__" to be defined in 1047 Rxvt-unicode requires the symbol "__STDC_ISO_10646__" to be defined in
1069 your compile environment, or an implementation that implements it, 1048 your compile environment, or an implementation that implements it,
1070 wether it defines the symbol or not. "__STDC_ISO_10646__" requires that 1049 whether it defines the symbol or not. "__STDC_ISO_10646__" requires that
1071 wchar_t is represented as unicode. 1050 wchar_t is represented as unicode.
1072 1051
1073 As you might have guessed, FreeBSD does neither define this symobl nor 1052 As you might have guessed, FreeBSD does neither define this symbol nor
1074 does it support it. Instead, it uses its own internal representation of 1053 does it support it. Instead, it uses its own internal representation of
1075 wchar_t. This is, of course, completely fine with respect to standards. 1054 wchar_t. This is, of course, completely fine with respect to standards.
1076 1055
1077 However, that means rxvt-unicode only works in "POSIX", "ISO-8859-1" and 1056 However, that means rxvt-unicode only works in "POSIX", "ISO-8859-1" and
1078 "UTF-8" locales under FreeBSD (which all use Unicode as wchar_t. 1057 "UTF-8" locales under FreeBSD (which all use Unicode as wchar_t).
1079 1058
1080 "__STDC_ISO_10646__" is the only sane way to support multi-language apps 1059 "__STDC_ISO_10646__" is the only sane way to support multi-language apps
1081 in an OS, as using a locale-dependent (and non-standardized) 1060 in an OS, as using a locale-dependent (and non-standardized)
1082 representation of wchar_t makes it impossible to convert between wchar_t 1061 representation of wchar_t makes it impossible to convert between wchar_t
1083 (as used by X11 and your applications) and any other encoding without 1062 (as used by X11 and your applications) and any other encoding without
1093 1072
1094 The rxvt-unicode author insists that the right way to fix this is in the 1073 The rxvt-unicode author insists that the right way to fix this is in the
1095 system libraries once and for all, instead of forcing every app to carry 1074 system libraries once and for all, instead of forcing every app to carry
1096 complete replacements for them :) 1075 complete replacements for them :)
1097 1076
1098 I use Solaris 9 and it doesn't compile/work/etc.
1099 Try the diff in doc/solaris9.patch as a base. It fixes the worst
1100 problems with "wcwidth" and a compile problem.
1101
1102 How can I use rxvt-unicode under cygwin? 1077 How can I use rxvt-unicode under cygwin?
1103 rxvt-unicode should compile and run out of the box on cygwin, using the 1078 rxvt-unicode should compile and run out of the box on cygwin, using the
1104 X11 libraries that come with cygwin. libW11 emulation is no longer 1079 X11 libraries that come with cygwin. libW11 emulation is no longer
1105 supported (and makes no sense, either, as it only supported a single 1080 supported (and makes no sense, either, as it only supported a single
1106 font). I recommend starting the X-server in "-multiwindow" or 1081 font). I recommend starting the X-server in "-multiwindow" or
1109 1084
1110 At the time of this writing, cygwin didn't seem to support any 1085 At the time of this writing, cygwin didn't seem to support any
1111 multi-byte encodings (you might try "LC_CTYPE=C-UTF-8"), so you are 1086 multi-byte encodings (you might try "LC_CTYPE=C-UTF-8"), so you are
1112 likely limited to 8-bit encodings. 1087 likely limited to 8-bit encodings.
1113 1088
1089 Character widths are not correct.
1090 urxvt uses the system wcwidth function to know the information about the
1091 width of characters, so on systems with incorrect locale data you will
1092 likely get bad results. Two notorious examples are Solaris 9, where
1093 single-width characters like U+2514 are reported as double-width, and
1094 Darwin 8, where combining chars are reported having width 1.
1095
1096 The solution is to upgrade your system or switch to a better one. A
1097 possibly working workaround is to use a wcwidth implementation like
1098
1099 http://www.cl.cam.ac.uk/~mgk25/ucs/wcwidth.c
1100

Diff Legend

Removed lines
+ Added lines
< Changed lines
> Changed lines