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.54 by root, Fri Jan 25 18:42:22 2008 UTC vs.
Revision 1.71 by root, Wed Dec 31 14:40:24 2014 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:
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 whether 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,
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)
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
172 Rendering, Font & Look and Feel Issues 183 Rendering, Font & Look and Feel Issues
173 I can't get transparency working, what am I doing wrong? 184 I can't get transparency working, what am I doing wrong?
174 First of all, please address all transparency related issues to Sasha 185 First of all, transparency isn't officially supported in rxvt-unicode,
175 Vasko at sasha@aftercode.net and do not bug the author about it. Also, 186 so you are mostly on your own. Do not bug the author about it (but you
176 if you can't get it working consider it a rite of passage: ... and you 187 may bug everybody else). Also, if you can't get it working consider it a
177 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 transparent mode: 193 1. Use transparent mode:
183 194
184 Esetroot wallpaper.jpg 195 Esetroot wallpaper.jpg
185 urxvt -tr -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.jpg 207 convert wallpaper.jpg -blur 20x20 -modulate 30 background.jpg
195 urxvt -pixmap "background.jpg;:root" 208 urxvt -pixmap "background.jpg;:root"
196 209
197 That works. If you think it doesn't, you lack AfterImage support, or you 210 That works. If you think it doesn't, you lack GDK-PixBuf support, or you
198 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
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-text-blink". Without 315 blink when compiled with "--enable-text-blink". Without
303 "--enable-text-blink", 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
415 We are working on it, in the meantime, as a workaround, use something 428 We are working on it, in the meantime, as a workaround, use something
416 like: 429 like:
417 430
418 urxvt -b 600 -geometry 20x1 -e sh -c 'mplayer -wid $WINDOWID file...' 431 urxvt -b 600 -geometry 20x1 -e sh -c 'mplayer -wid $WINDOWID file...'
419 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
420 Keyboard, Mouse & User Interaction 453 Keyboard, Mouse & User Interaction
421 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?
422 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
423 setting: 456 setting:
424 457
468 You can permanently switch this feature off by disabling the "readline" 501 You can permanently switch this feature off by disabling the "readline"
469 extension: 502 extension:
470 503
471 URxvt.perl-ext-common: default,-readline 504 URxvt.perl-ext-common: default,-readline
472 505
473 My numerical keypad acts weird and generates differing output? 506 My numeric keypad acts weird and generates differing output?
474 Some Debian GNUL/Linux users seem to have this problem, although no 507 Some Debian GNU/Linux users seem to have this problem, although no
475 specific details were reported so far. It is possible that this is 508 specific details were reported so far. It is possible that this is
476 caused by the wrong "TERM" setting, although the details of whether and 509 caused by the wrong "TERM" setting, although the details of whether and
477 how this can happen are unknown, as "TERM=rxvt" should offer a 510 how this can happen are unknown, as "TERM=rxvt" should offer a
478 compatible keymap. See the answer to the previous question, and please 511 compatible keymap. See the answer to the previous question, and please
479 report if that helped. 512 report if that helped.
480 513
481 My Compose (Multi_key) key is no longer working. 514 My Compose (Multi_key) key is no longer working.
482 The most common causes for this are that either your locale is not set 515 The most common causes for this are that either your locale is not set
483 correctly, or you specified a preeditStyle that is not supported by your 516 correctly, or you specified a preeditType that is not supported by your
484 input method. For example, if you specified OverTheSpot and your input 517 input method. For example, if you specified OverTheSpot and your input
485 method (e.g. the default input method handling Compose keys) does not 518 method (e.g. the default input method handling Compose keys) does not
486 support this (for instance because it is not visual), then rxvt-unicode 519 support this (for instance because it is not visual), then rxvt-unicode
487 will continue without an input method. 520 will continue without an input method.
488 521
489 In this case either do not specify a preeditStyle or specify more than 522 In this case either do not specify a preeditType or specify more than
490 one pre-edit style, such as OverTheSpot,Root,None. 523 one pre-edit style, such as OverTheSpot,Root,None.
524
525 If it still doesn't work, then maybe your input method doesn't support
526 compose sequences - to fall back to the built-in one, make sure you
527 don't specify an input method via "-im" or "XMODIFIERS".
491 528
492 I cannot type "Ctrl-Shift-2" to get an ASCII NUL character due to ISO 14755 529 I cannot type "Ctrl-Shift-2" to get an ASCII NUL character due to ISO 14755
493 Either try "Ctrl-2" alone (it often is mapped to ASCII NUL even on 530 Either try "Ctrl-2" alone (it often is mapped to ASCII NUL even on
494 international keyboards) or simply use ISO 14755 support to your 531 international keyboards) or simply use ISO 14755 support to your
495 advantage, typing <Ctrl-Shift-0> to get a ASCII NUL. This works for 532 advantage, typing <Ctrl-Shift-0> to get a ASCII NUL. This works for
496 other codes, too, such as "Ctrl-Shift-1-d" to type the default telnet 533 other codes, too, such as "Ctrl-Shift-1-d" to type the default telnet
497 escape character and so on. 534 escape character and so on.
498 535
499 Mouse cut/paste suddenly no longer works. 536 Mouse cut/paste suddenly no longer works.
500 Make sure that mouse reporting is actually turned off since killing some 537 Make sure that mouse reporting is actually turned off since killing some
501 editors prematurely may leave the mouse in mouse report mode. I've heard 538 editors prematurely may leave it active. I've heard that tcsh may use
502 that tcsh may use mouse reporting unless it otherwise specified. A quick 539 mouse reporting unless it is otherwise specified. A quick check is to
503 check is to see if cut/paste works when the Alt or Shift keys are 540 see if cut/paste works when the Alt or Shift keys are pressed.
504 depressed.
505 541
506 What's with the strange Backspace/Delete key behaviour? 542 What's with the strange Backspace/Delete key behaviour?
507 Assuming that the physical Backspace key corresponds to the Backspace 543 Assuming that the physical Backspace key corresponds to the Backspace
508 keysym (not likely for Linux ... see the following question) there are 544 keysym (not likely for Linux ... see the following question) there are
509 two standard values that can be used for Backspace: "^H" and "^?". 545 two standard values that can be used for Backspace: "^H" and "^?".
510 546
511 Historically, either value is correct, but rxvt-unicode adopts the 547 Historically, either value is correct, but rxvt-unicode adopts the
512 debian policy of using "^?" when unsure, because it's the one and only 548 debian policy of using "^?" when unsure, because it's the one and only
513 correct choice :). 549 correct choice :).
514 550
515 Rxvt-unicode tries to inherit the current stty settings and uses the 551 It is possible to toggle between "^H" and "^?" with the DECBKM private
516 value of `erase' to guess the value for backspace. If rxvt-unicode 552 mode:
517 wasn't started from a terminal (say, from a menu or by remote shell),
518 then the system value of `erase', which corresponds to CERASE in
519 <termios.h>, will be used (which may not be the same as your stty
520 setting).
521
522 For starting a new rxvt-unicode:
523 553
524 # use Backspace = ^H 554 # use Backspace = ^H
525 $ stty erase ^H 555 $ stty erase ^H
526 $ urxvt 556 $ printf "\e[?67h"
527 557
528 # use Backspace = ^? 558 # use Backspace = ^?
529 $ stty erase ^? 559 $ stty erase ^?
530 $ urxvt 560 $ printf "\e[?67l"
531
532 Toggle with "ESC [ 36 h" / "ESC [ 36 l".
533
534 For an existing rxvt-unicode:
535
536 # use Backspace = ^H
537 $ stty erase ^H
538 $ echo -n "^[[36h"
539
540 # use Backspace = ^?
541 $ stty erase ^?
542 $ echo -n "^[[36l"
543 561
544 This helps satisfy some of the Backspace discrepancies that occur, but 562 This helps satisfy some of the Backspace discrepancies that occur, but
545 if you use Backspace = "^H", make sure that the termcap/terminfo value 563 if you use Backspace = "^H", make sure that the termcap/terminfo value
546 properly reflects that. 564 properly reflects that.
547 565
563 use the `keysym' resource to alter the keystrings associated with 581 use the `keysym' resource to alter the keystrings associated with
564 keysyms. 582 keysyms.
565 583
566 Here's an example for a URxvt session started using "urxvt -name URxvt" 584 Here's an example for a URxvt session started using "urxvt -name URxvt"
567 585
586 URxvt.keysym.Prior: \033[5~
587 URxvt.keysym.Next: \033[6~
568 URxvt.keysym.Home: \033[1~ 588 URxvt.keysym.Home: \033[7~
569 URxvt.keysym.End: \033[4~ 589 URxvt.keysym.End: \033[8~
570 URxvt.keysym.C-apostrophe: \033<C-'>
571 URxvt.keysym.C-slash: \033<C-/>
572 URxvt.keysym.C-semicolon: \033<C-;>
573 URxvt.keysym.C-grave: \033<C-`>
574 URxvt.keysym.C-comma: \033<C-,>
575 URxvt.keysym.C-period: \033<C-.>
576 URxvt.keysym.C-0x60: \033<C-`>
577 URxvt.keysym.C-Tab: \033<C-Tab>
578 URxvt.keysym.C-Return: \033<C-Return>
579 URxvt.keysym.S-Return: \033<S-Return>
580 URxvt.keysym.S-space: \033<S-Space>
581 URxvt.keysym.M-Up: \033<M-Up> 590 URxvt.keysym.Up: \033[A
582 URxvt.keysym.M-Down: \033<M-Down> 591 URxvt.keysym.Down: \033[B
592 URxvt.keysym.Right: \033[C
583 URxvt.keysym.M-Left: \033<M-Left> 593 URxvt.keysym.Left: \033[D
584 URxvt.keysym.M-Right: \033<M-Right>
585 URxvt.keysym.M-C-0: list \033<M-C- 0123456789 >
586 URxvt.keysym.M-C-a: list \033<M-C- abcdefghijklmnopqrstuvwxyz >
587 URxvt.keysym.F12: command:\033]701;zh_CN.GBK\007
588 594
589 See some more examples in the documentation for the keysym resource. 595 See some more examples in the documentation for the keysym resource.
590 596
591 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 597 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
592 KP_Insert == Insert 598 KP_Insert == Insert
635 develop for myself mostly, so I actually use most of the extensions I 641 develop for myself mostly, so I actually use most of the extensions I
636 write. 642 write.
637 643
638 The selection stuff mainly makes the selection perl-error-message aware 644 The selection stuff mainly makes the selection perl-error-message aware
639 and tells it to convert perl error messages into vi-commands to load the 645 and tells it to convert perl error messages into vi-commands to load the
640 relevant file and go tot he error line number. 646 relevant file and go to the error line number.
641 647
642 URxvt.scrollstyle: plain 648 URxvt.scrollstyle: plain
643 URxvt.secondaryScroll: true 649 URxvt.secondaryScroll: true
644 650
645 As the documentation says: plain is the preferred scrollbar for the 651 As the documentation says: plain is the preferred scrollbar for the
718 my purposes, it works, and gives a different look, as my normal 724 my purposes, it works, and gives a different look, as my normal
719 (Non-bold) font is already bold, and I want to see a difference between 725 (Non-bold) font is already bold, and I want to see a difference between
720 bold and normal fonts. 726 bold and normal fonts.
721 727
722 Please note that I used the "urxvt" instance name and not the "URxvt" 728 Please note that I used the "urxvt" instance name and not the "URxvt"
723 class name. Thats because I use different configs for different 729 class name. That is because I use different configs for different
724 purposes, for example, my IRC window is started with "-name IRC", and 730 purposes, for example, my IRC window is started with "-name IRC", and
725 uses these defaults: 731 uses these defaults:
726 732
727 IRC*title: IRC 733 IRC*title: IRC
728 IRC*geometry: 87x12+535+542 734 IRC*geometry: 87x12+535+542
732 IRC*boldFont: suxuseuro 738 IRC*boldFont: suxuseuro
733 IRC*colorBD: white 739 IRC*colorBD: white
734 IRC*keysym.M-C-1: command:\033]710;suxuseuro\007\033]711;suxuseuro\007 740 IRC*keysym.M-C-1: command:\033]710;suxuseuro\007\033]711;suxuseuro\007
735 IRC*keysym.M-C-2: command:\033]710;9x15bold\007\033]711;9x15bold\007 741 IRC*keysym.M-C-2: command:\033]710;9x15bold\007\033]711;9x15bold\007
736 742
737 "Alt-Shift-1" and "Alt-Shift-2" switch between two different font sizes. 743 "Alt-Ctrl-1" and "Alt-Ctrl-2" switch between two different font sizes.
738 "suxuseuro" allows me to keep an eye (and actually read) stuff while 744 "suxuseuro" allows me to keep an eye (and actually read) stuff while
739 keeping a very small window. If somebody pastes something complicated 745 keeping a very small window. If somebody pastes something complicated
740 (e.g. japanese), I temporarily switch to a larger font. 746 (e.g. japanese), I temporarily switch to a larger font.
741 747
742 The above is all in my ".Xdefaults" (I don't use ".Xresources" nor 748 The above is all in my ".Xdefaults" (I don't use ".Xresources" nor
743 "xrdb"). I also have some resources in a separate ".Xdefaults-hostname" 749 "xrdb"). I also have some resources in a separate ".Xdefaults-hostname"
744 file for different hosts, for example, on ym main desktop, I use: 750 file for different hosts, for example, on my main desktop, I use:
745 751
746 URxvt.keysym.C-M-q: command:\033[3;5;5t 752 URxvt.keysym.C-M-q: command:\033[3;5;5t
747 URxvt.keysym.C-M-y: command:\033[3;5;606t 753 URxvt.keysym.C-M-y: command:\033[3;5;606t
748 URxvt.keysym.C-M-e: command:\033[3;1605;5t 754 URxvt.keysym.C-M-e: command:\033[3;1605;5t
749 URxvt.keysym.C-M-c: command:\033[3;1605;606t 755 URxvt.keysym.C-M-c: command:\033[3;1605;606t
778 The terminal description used by rxvt-unicode is not as widely available 784 The terminal description used by rxvt-unicode is not as widely available
779 as that for xterm, or even rxvt (for which the same problem often 785 as that for xterm, or even rxvt (for which the same problem often
780 arises). 786 arises).
781 787
782 The correct solution for this problem is to install the terminfo, this 788 The correct solution for this problem is to install the terminfo, this
783 can be done like this (with ncurses' infocmp and works as user and 789 can be done by simply installing rxvt-unicode on the remote system as
784 admin): 790 well (in case you have a nice package manager ready), or you can install
791 the terminfo database manually like this (with ncurses infocmp. works as
792 user and root):
785 793
786 REMOTE=remotesystem.domain 794 REMOTE=remotesystem.domain
787 infocmp rxvt-unicode | ssh $REMOTE "mkdir -p .terminfo && cat >/tmp/ti && tic /tmp/ti" 795 infocmp rxvt-unicode | ssh $REMOTE "mkdir -p .terminfo && cat >/tmp/ti && tic /tmp/ti"
788
789 ... or by installing rxvt-unicode normally on the remote system,
790 796
791 One some systems you might need to set $TERMINFO to the full path of 797 One some systems you might need to set $TERMINFO to the full path of
792 $HOME/.terminfo for this to work. 798 $HOME/.terminfo for this to work.
793 799
794 If you cannot or do not want to do this, then you can simply set 800 If you cannot or do not want to do this, then you can simply set
804 URxvt.termName: rxvt 810 URxvt.termName: rxvt
805 811
806 If you don't plan to use rxvt (quite common...) you could also replace 812 If you don't plan to use rxvt (quite common...) you could also replace
807 the rxvt terminfo file with the rxvt-unicode one and use "TERM=rxvt". 813 the rxvt terminfo file with the rxvt-unicode one and use "TERM=rxvt".
808 814
815 nano fails with "Error opening terminal: rxvt-unicode"
816 This exceptionally confusing and useless error message is printed by
817 nano when it can't find the terminfo database. Nothing is wrong with
818 your terminal, read the previous answer for a solution.
819
809 "tic" outputs some error when compiling the terminfo entry. 820 "tic" outputs some error when compiling the terminfo entry.
810 Most likely it's the empty definition for "enacs=". Just replace it by 821 Most likely it's the empty definition for "enacs=". Just replace it by
811 "enacs=\E[0@" and try again. 822 "enacs=\E[0@" and try again.
812 823
813 "bash"'s readline does not work correctly under urxvt. 824 "bash"'s readline does not work correctly under urxvt.
823 cases. You can also create a termcap entry by using terminfo's infocmp 834 cases. You can also create a termcap entry by using terminfo's infocmp
824 program like this: 835 program like this:
825 836
826 infocmp -C rxvt-unicode 837 infocmp -C rxvt-unicode
827 838
828 Or you could use this termcap entry, generated by the command above: 839 Or you could use the termcap entry in doc/etc/rxvt-unicode.termcap,
829 840 generated by the command above.
830 rxvt-unicode|rxvt-unicode terminal (X Window System):\
831 :am:bw:eo:km:mi:ms:xn:xo:\
832 :co#80:it#8:li#24:lm#0:\
833 :AL=\E[%dL:DC=\E[%dP:DL=\E[%dM:DO=\E[%dB:IC=\E[%d@:\
834 :K1=\EOw:K2=\EOu:K3=\EOy:K4=\EOq:K5=\EOs:LE=\E[%dD:\
835 :RI=\E[%dC:SF=\E[%dS:SR=\E[%dT:UP=\E[%dA:ae=\E(B:al=\E[L:\
836 :as=\E(0:bl=^G:cd=\E[J:ce=\E[K:cl=\E[H\E[2J:\
837 :cm=\E[%i%d;%dH:cr=^M:cs=\E[%i%d;%dr:ct=\E[3g:dc=\E[P:\
838 :dl=\E[M:do=^J:ec=\E[%dX:ei=\E[4l:ho=\E[H:\
839 :i1=\E[?47l\E=\E[?1l:ic=\E[@:im=\E[4h:\
840 :is=\E[r\E[m\E[2J\E[H\E[?7h\E[?1;3;4;6l\E[4l:\
841 :k1=\E[11~:k2=\E[12~:k3=\E[13~:k4=\E[14~:k5=\E[15~:\
842 :k6=\E[17~:k7=\E[18~:k8=\E[19~:k9=\E[20~:kD=\E[3~:\
843 :kI=\E[2~:kN=\E[6~:kP=\E[5~:kb=\177:kd=\EOB:ke=\E[?1l\E>:\
844 :kh=\E[7~:kl=\EOD:kr=\EOC:ks=\E[?1h\E=:ku=\EOA:le=^H:\
845 :mb=\E[5m:md=\E[1m:me=\E[m\017:mr=\E[7m:nd=\E[C:rc=\E8:\
846 :sc=\E7:se=\E[27m:sf=^J:so=\E[7m:sr=\EM:st=\EH:ta=^I:\
847 :te=\E[r\E[?1049l:ti=\E[?1049h:ue=\E[24m:up=\E[A:\
848 :us=\E[4m:vb=\E[?5h\E[?5l:ve=\E[?25h:vi=\E[?25l:\
849 :vs=\E[?25h:
850 841
851 Why does "ls" no longer have coloured output? 842 Why does "ls" no longer have coloured output?
852 The "ls" in the GNU coreutils unfortunately doesn't use terminfo to 843 The "ls" in the GNU coreutils unfortunately doesn't use terminfo to
853 decide whether a terminal has colour, but uses its own configuration 844 decide whether a terminal has colour, but uses its own configuration
854 file. Needless to say, "rxvt-unicode" is not in its default file (among 845 file. Needless to say, "rxvt-unicode" is not in its default file (among
868 Why doesn't vim/emacs etc. make use of italic? 859 Why doesn't vim/emacs etc. make use of italic?
869 See next entry. 860 See next entry.
870 861
871 Why are the secondary screen-related options not working properly? 862 Why are the secondary screen-related options not working properly?
872 Make sure you are using "TERM=rxvt-unicode". Some pre-packaged 863 Make sure you are using "TERM=rxvt-unicode". Some pre-packaged
873 distributions (most notably Debian GNU/Linux) break rxvt-unicode by 864 distributions break rxvt-unicode by setting "TERM" to "rxvt", which
874 setting "TERM" to "rxvt", which doesn't have these extra features. 865 doesn't have these extra features. Unfortunately, some of these
875 Unfortunately, some of these (most notably, again, Debian GNU/Linux)
876 furthermore fail to even install the "rxvt-unicode" terminfo file, so 866 furthermore fail to even install the "rxvt-unicode" terminfo file, so
877 you will need to install it on your own (See the question When I log-in 867 you will need to install it on your own (See the question When I log-in
878 to another system it tells me about missing terminfo data? on how to do 868 to another system it tells me about missing terminfo data? on how to do
879 this). 869 this).
880 870
991 For scim, use "@im=SCIM". You can see what input method servers are 981 For scim, use "@im=SCIM". You can see what input method servers are
992 running with this command: 982 running with this command:
993 983
994 xprop -root XIM_SERVERS 984 xprop -root XIM_SERVERS
995 985
996
997
998 My input method wants <some encoding> but I want UTF-8, what can I do? 986 My input method wants <some encoding> but I want UTF-8, what can I do?
999 You can specify separate locales for the input method and the rest of 987 You can specify separate locales for the input method and the rest of
1000 the terminal, using the resource "imlocale": 988 the terminal, using the resource "imlocale":
1001 989
1002 URxvt.imlocale: ja_JP.EUC-JP 990 URxvt.imlocale: ja_JP.EUC-JP
1015 cannot be completely avoided even if both sides cooperate. 1003 cannot be completely avoided even if both sides cooperate.
1016 1004
1017 So the only workaround is not to kill your Input Method Servers. 1005 So the only workaround is not to kill your Input Method Servers.
1018 1006
1019 Operating Systems / Package Maintaining 1007 Operating Systems / Package Maintaining
1020 I am using Debian GNU/Linux and have a problem...
1021 The Debian GNU/Linux package of rxvt-unicode in sarge contains large
1022 patches that considerably change the behaviour of rxvt-unicode (but
1023 unfortunately this notice has been removed). Before reporting a bug to
1024 the original rxvt-unicode author please download and install the genuine
1025 version (<http://software.schmorp.de#rxvt-unicode>) and try to reproduce
1026 the problem. If you cannot, chances are that the problems are specific
1027 to Debian GNU/Linux, in which case it should be reported via the Debian
1028 Bug Tracking System (use "reportbug" to report the bug).
1029
1030 For other problems that also affect the Debian package, you can and
1031 probably should use the Debian BTS, too, because, after all, it's also a
1032 bug in the Debian version and it serves as a reminder for other users
1033 that might encounter the same issue.
1034
1035 I am maintaining rxvt-unicode for distribution/OS XXX, any recommendation? 1008 I am maintaining rxvt-unicode for distribution/OS XXX, any recommendation?
1036 You should build one binary with the default options. configure now 1009 You should build one binary with the default options. configure now
1037 enables most useful options, and the trend goes to making them 1010 enables most useful options, and the trend goes to making them
1038 runtime-switchable, too, so there is usually no drawback to enabling 1011 runtime-switchable, too, so there is usually no drawback to enabling
1039 them, except higher disk and possibly memory usage. The perl interpreter 1012 them, except higher disk and possibly memory usage. The perl interpreter
1040 should be enabled, as important functionality (menus, selection, likely 1013 should be enabled, as important functionality (menus, selection, likely
1041 more in the future) depends on it. 1014 more in the future) depends on it.
1042 1015
1043 You should not overwrite the "perl-ext-common" snd "perl-ext" resources 1016 You should not overwrite the "perl-ext-common" and "perl-ext" resources
1044 system-wide (except maybe with "defaults"). This will result in useful 1017 system-wide (except maybe with "defaults"). This will result in useful
1045 behaviour. If your distribution aims at low memory, add an empty 1018 behaviour. If your distribution aims at low memory, add an empty
1046 "perl-ext-common" resource to the app-defaults file. This will keep the 1019 "perl-ext-common" resource to the app-defaults file. This will keep the
1047 perl interpreter disabled until the user enables it. 1020 perl interpreter disabled until the user enables it.
1048 1021
1076 As you might have guessed, FreeBSD does neither define this symbol nor 1049 As you might have guessed, FreeBSD does neither define this symbol nor
1077 does it support it. Instead, it uses its own internal representation of 1050 does it support it. Instead, it uses its own internal representation of
1078 wchar_t. This is, of course, completely fine with respect to standards. 1051 wchar_t. This is, of course, completely fine with respect to standards.
1079 1052
1080 However, that means rxvt-unicode only works in "POSIX", "ISO-8859-1" and 1053 However, that means rxvt-unicode only works in "POSIX", "ISO-8859-1" and
1081 "UTF-8" locales under FreeBSD (which all use Unicode as wchar_t. 1054 "UTF-8" locales under FreeBSD (which all use Unicode as wchar_t).
1082 1055
1083 "__STDC_ISO_10646__" is the only sane way to support multi-language apps 1056 "__STDC_ISO_10646__" is the only sane way to support multi-language apps
1084 in an OS, as using a locale-dependent (and non-standardized) 1057 in an OS, as using a locale-dependent (and non-standardized)
1085 representation of wchar_t makes it impossible to convert between wchar_t 1058 representation of wchar_t makes it impossible to convert between wchar_t
1086 (as used by X11 and your applications) and any other encoding without 1059 (as used by X11 and your applications) and any other encoding without

Diff Legend

Removed lines
+ Added lines
< Changed lines
> Changed lines