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.44 by root, Thu Nov 2 17:37:47 2006 UTC vs.
Revision 1.68 by root, Sun Oct 27 16:20:55 2013 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 three big problems with Gentoo Linux: first of all, most if
10 not all Gentoo systems are completely broken (missing or mismatched
11 header files, broken compiler etc. are just the tip of the iceberg);
12 secondly, the Gentoo maintainer thinks it is a good idea to add broken
13 patches to the code; and lastly, it should be called Gentoo GNU/Linux.
14
15 For these reasons, it is impossible to support rxvt-unicode on Gentoo.
16 Problems appearing on Gentoo systems will usually simply be ignored
17 unless they can be reproduced on non-Gentoo systems.
7 18
8 Does it support tabs, can I have a tabbed rxvt-unicode? 19 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 20 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 21 simple tabbed terminal. It is installed by default, so any of these
11 should give you tabs: 22 should give you tabs:
42 53
43 How can I start urxvtd in a race-free way? 54 How can I start urxvtd in a race-free way?
44 Try "urxvtd -f -o", which tells urxvtd to open the display, create the 55 Try "urxvtd -f -o", which tells urxvtd to open the display, create the
45 listening socket and then fork. 56 listening socket and then fork.
46 57
47 How can I start urxvtd automatically when I run URXVT_NAME@@c? 58 How can I start urxvtd automatically when I run urxvtc?
48 If you want to start urxvtd automatically whenever you run urxvtc and 59 If you want to start urxvtd automatically whenever you run urxvtc and
49 the daemon isn't running yet, use this script: 60 the daemon isn't running yet, use this script:
50 61
51 #!/bin/sh 62 #!/bin/sh
52 urxvtc "$@" 63 urxvtc "$@"
58 This tries to create a new terminal, and if fails with exit status 2, 69 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 70 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 71 re-run the command. Subsequent invocations of the script will re-use the
61 existing daemon. 72 existing daemon.
62 73
63 How do I distinguish whether I'm running rxvt-unicode or a regular xterm? I need this to decide about setting colors etc. 74 How do I distinguish whether I'm running rxvt-unicode or a regular
75xterm? I need this to decide about setting colours etc.
64 The original rxvt and rxvt-unicode always export the variable 76 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 77 "COLORTERM", so you can check and see if that is set. Note that several
66 programs, JED, slrn, Midnight Commander automatically check this 78 programs, JED, slrn, Midnight Commander automatically check this
67 variable to decide whether or not to use color. 79 variable to decide whether or not to use colour.
68 80
69 How do I set the correct, full IP address for the DISPLAY variable? 81 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 82 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 83 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 84 snippets to correctly set the display. If your version of rxvt-unicode
79 91
80 # Bourne/Korn/POSIX family of shells: 92 # Bourne/Korn/POSIX family of shells:
81 [ ${TERM:-foo} = foo ] && TERM=xterm # assume an xterm if we don't know 93 [ ${TERM:-foo} = foo ] && TERM=xterm # assume an xterm if we don't know
82 if [ ${TERM:-foo} = xterm ]; then 94 if [ ${TERM:-foo} = xterm ]; then
83 stty -icanon -echo min 0 time 15 # see if enhanced rxvt or not 95 stty -icanon -echo min 0 time 15 # see if enhanced rxvt or not
84 echo -n '^[Z' 96 printf "\eZ"
85 read term_id 97 read term_id
86 stty icanon echo 98 stty icanon echo
87 if [ ""${term_id} = '^[[?1;2C' -a ${DISPLAY:-foo} = foo ]; then 99 if [ ""${term_id} = '^[[?1;2C' -a ${DISPLAY:-foo} = foo ]; then
88 echo -n '^[[7n' # query the rxvt we are in for the DISPLAY string 100 printf '\e[7n' # query the rxvt we are in for the DISPLAY string
89 read DISPLAY # set it in our local shell 101 read DISPLAY # set it in our local shell
90 fi 102 fi
91 fi 103 fi
92 104
93 How do I compile the manual pages on my own? 105 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, 106 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 107 one that comes with pod2man, pod2text and pod2xhtml (from Pod::Xhtml).
96 subdirectory and enter "make alldoc". 108 Then go to the doc subdirectory and enter "make alldoc".
97 109
98 Isn't rxvt-unicode supposed to be small? Don't all those features bloat? 110 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 111 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 112 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 113 that the urxvt binary is larger (due to some encoding tables always
146 the case of rxvt-unicode this hardly matters, as its portability limits 158 the case of rxvt-unicode this hardly matters, as its portability limits
147 are defined by things like X11, pseudo terminals, locale support and 159 are defined by things like X11, pseudo terminals, locale support and
148 unix domain sockets, which are all less portable than C++ itself. 160 unix domain sockets, which are all less portable than C++ itself.
149 161
150 Regarding the bloat, see the above question: It's easy to write programs 162 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 163 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 164 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 165 is not necessarily the case with GCC. Here is what rxvt links against on
154 system with a minimal config: 166 my system with a minimal config:
155 167
156 libX11.so.6 => /usr/X11R6/lib/libX11.so.6 (0x00002aaaaabc3000) 168 libX11.so.6 => /usr/X11R6/lib/libX11.so.6 (0x00002aaaaabc3000)
157 libc.so.6 => /lib/libc.so.6 (0x00002aaaaadde000) 169 libc.so.6 => /lib/libc.so.6 (0x00002aaaaadde000)
158 libdl.so.2 => /lib/libdl.so.2 (0x00002aaaab01d000) 170 libdl.so.2 => /lib/libdl.so.2 (0x00002aaaab01d000)
159 /lib64/ld-linux-x86-64.so.2 (0x00002aaaaaaab000) 171 /lib64/ld-linux-x86-64.so.2 (0x00002aaaaaaab000)
160 172
161 And here is rxvt-unicode: 173 And here is rxvt-unicode:
162 174
163 libX11.so.6 => /usr/X11R6/lib/libX11.so.6 (0x00002aaaaabc3000) 175 libX11.so.6 => /usr/X11R6/lib/libX11.so.6 (0x00002aaaaabc3000)
164 libgcc_s.so.1 => /lib/libgcc_s.so.1 (0x00002aaaaada2000) 176 libgcc_s.so.1 => /lib/libgcc_s.so.1 (0x00002aaaaada2000)
165 libc.so.6 => /lib/libc.so.6 (0x00002aaaaaeb0000) 177 libc.so.6 => /lib/libc.so.6 (0x00002aaaaaeb0000)
166 libdl.so.2 => /lib/libdl.so.2 (0x00002aaaab0ee000) 178 libdl.so.2 => /lib/libdl.so.2 (0x00002aaaab0ee000)
167 /lib64/ld-linux-x86-64.so.2 (0x00002aaaaaaab000) 179 /lib64/ld-linux-x86-64.so.2 (0x00002aaaaaaab000)
168 180
169 No large bloated libraries (of course, none were linked in statically), 181 No large bloated libraries (of course, none were linked in statically),
170 except maybe libX11 :) 182 except maybe libX11 :)
171 183
172 Rendering, Font & Look and Feel Issues 184 Rendering, Font & Look and Feel Issues
177 rite of passage: ... and you failed. 189 rite of passage: ... and you failed.
178 190
179 Here are four ways to get transparency. Do read the manpage and option 191 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! 192 descriptions for the programs mentioned and rxvt-unicode. Really, do it!
181 193
182 1. Use inheritPixmap: 194 1. Use transparent mode:
183 195
184 Esetroot wallpaper.jpg 196 Esetroot wallpaper.jpg
185 urxvt -ip -tint red -sh 40 197 urxvt -tr -tint red -sh 40
186 198
187 That works. If you think it doesn't, you lack transparency and tinting 199 That works. If you think it doesn't, you lack transparency and tinting
188 support, or you are unable to read. 200 support, or you are unable to read. This method requires that the
201 background-setting program sets the _XROOTPMAP_ID or ESETROOT_PMAP_ID
202 property. Compatible programs are Esetroot, hsetroot and feh.
189 203
190 2. Use a simple pixmap and emulate pseudo-transparency. This enables you 204 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 205 to use effects other than tinting and shading: Just shade/tint/whatever
192 your picture with gimp or any other tool: 206 your picture with gimp or any other tool:
193 207
194 convert wallpaper.jpg -blur 20x20 -modulate 30 background.xpm 208 convert wallpaper.jpg -blur 20x20 -modulate 30 background.jpg
195 urxvt -pixmap background.xpm -pe automove-background 209 urxvt -pixmap "background.jpg;:root"
196 210
197 That works. If you think it doesn't, you lack XPM and Perl support, or 211 That works. If you think it doesn't, you lack GDK-PixBuf support, or you
198 you are unable to read. 212 are unable to read.
199 213
200 3. Use an ARGB visual: 214 3. Use an ARGB visual:
201 215
202 urxvt -depth 32 -fg grey90 -bg rgba:0000/0000/4444/cccc 216 urxvt -depth 32 -fg grey90 -bg rgba:0000/0000/4444/cccc
203 217
297 What's with this bold/blink stuff? 311 What's with this bold/blink stuff?
298 If no bold colour is set via "colorBD:", bold will invert text using the 312 If no bold colour is set via "colorBD:", bold will invert text using the
299 standard foreground colour. 313 standard foreground colour.
300 314
301 For the standard background colour, blinking will actually make the text 315 For the standard background colour, blinking will actually make the text
302 blink when compiled with "--enable-blinking". with standard colours. 316 blink when compiled with "--enable-text-blink". Without
303 Without "--enable-blinking", the blink attribute will be ignored. 317 "--enable-text-blink", the blink attribute will be ignored.
304 318
305 On ANSI colours, bold/blink attributes are used to set high-intensity 319 On ANSI colours, bold/blink attributes are used to set high-intensity
306 foreground/background colors. 320 foreground/background colours.
307 321
308 color0-7 are the low-intensity colors. 322 color0-7 are the low-intensity colours.
309 323
310 color8-15 are the corresponding high-intensity colors. 324 color8-15 are the corresponding high-intensity colours.
311 325
312 I don't like the screen colors. How do I change them? 326 I don't like the screen colours. How do I change them?
313 You can change the screen colors at run-time using ~/.Xdefaults 327 You can change the screen colours at run-time using ~/.Xdefaults
314 resources (or as long-options). 328 resources (or as long-options).
315 329
316 Here are values that are supposed to resemble a VGA screen, including 330 Here are values that are supposed to resemble a VGA screen, including
317 the murky brown that passes for low-intensity yellow: 331 the murky brown that passes for low-intensity yellow:
318 332
332 URxvt.color12: #0000FF 346 URxvt.color12: #0000FF
333 URxvt.color13: #FF00FF 347 URxvt.color13: #FF00FF
334 URxvt.color14: #00FFFF 348 URxvt.color14: #00FFFF
335 URxvt.color15: #FFFFFF 349 URxvt.color15: #FFFFFF
336 350
337 And here is a more complete set of non-standard colors. 351 And here is a more complete set of non-standard colours.
338 352
339 URxvt.cursorColor: #dc74d1 353 URxvt.cursorColor: #dc74d1
340 URxvt.pointerColor: #dc74d1 354 URxvt.pointerColor: #dc74d1
341 URxvt.background: #0e0e0e 355 URxvt.background: #0e0e0e
342 URxvt.foreground: #4ad5e1 356 URxvt.foreground: #4ad5e1
409 has been designed yet). 423 has been designed yet).
410 424
411 Until then, you might get away with switching fonts at runtime (see "Can 425 Until then, you might get away with switching fonts at runtime (see "Can
412 I switch the fonts at runtime?" later in this document). 426 I switch the fonts at runtime?" later in this document).
413 427
428 How can I make mplayer display video correctly?
429 We are working on it, in the meantime, as a workaround, use something
430 like:
431
432 urxvt -b 600 -geometry 20x1 -e sh -c 'mplayer -wid $WINDOWID file...'
433
414 Keyboard, Mouse & User Interaction 434 Keyboard, Mouse & User Interaction
415 The new selection selects pieces that are too big, how can I select single words? 435 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 436 If you want to select e.g. alphanumeric words, you can use the following
417 setting: 437 setting:
418 438
424 To get a selection that is very similar to the old code, try this 444 To get a selection that is very similar to the old code, try this
425 pattern: 445 pattern:
426 446
427 URxvt.selection.pattern-0: ([^"&'()*,;<=>?@[\\\\]^`{|})]+) 447 URxvt.selection.pattern-0: ([^"&'()*,;<=>?@[\\\\]^`{|})]+)
428 448
429 Please also note that the *LeftClick Shift-LeftClik* combination also 449 Please also note that the *LeftClick Shift-LeftClick* combination also
430 selects words like the old code. 450 selects words like the old code.
431 451
432 I don't like the new selection/popups/hotkeys/perl, how do I change/disable it? 452 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 453 You can disable the perl extension completely by setting the
434 perl-ext-common resource to the empty string, which also keeps 454 perl-ext-common resource to the empty string, which also keeps
481 will continue without an input method. 501 will continue without an input method.
482 502
483 In this case either do not specify a preeditStyle or specify more than 503 In this case either do not specify a preeditStyle or specify more than
484 one pre-edit style, such as OverTheSpot,Root,None. 504 one pre-edit style, such as OverTheSpot,Root,None.
485 505
506 If it still doesn't work, then maybe your input method doesn't support
507 compose sequences - to fall back to the built-in one, make sure you
508 don't specify an input method via "-im" or "XMODIFIERS".
509
486 I cannot type "Ctrl-Shift-2" to get an ASCII NUL character due to ISO 14755 510 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 511 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 512 international keyboards) or simply use ISO 14755 support to your
489 advantage, typing <Ctrl-Shift-0> to get a ASCII NUL. This works for 513 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 514 other codes, too, such as "Ctrl-Shift-1-d" to type the default telnet
491 escape character and so on. 515 escape character and so on.
492 516
493 Mouse cut/paste suddenly no longer works. 517 Mouse cut/paste suddenly no longer works.
494 Make sure that mouse reporting is actually turned off since killing some 518 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 519 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 520 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 521 see if cut/paste works when the Alt or Shift keys are pressed.
498 depressed.
499 522
500 What's with the strange Backspace/Delete key behaviour? 523 What's with the strange Backspace/Delete key behaviour?
501 Assuming that the physical Backspace key corresponds to the Backspace 524 Assuming that the physical Backspace key corresponds to the Backspace
502 keysym (not likely for Linux ... see the following question) there are 525 keysym (not likely for Linux ... see the following question) there are
503 two standard values that can be used for Backspace: "^H" and "^?". 526 two standard values that can be used for Backspace: "^H" and "^?".
504 527
505 Historically, either value is correct, but rxvt-unicode adopts the 528 Historically, either value is correct, but rxvt-unicode adopts the
506 debian policy of using "^?" when unsure, because it's the one only only 529 debian policy of using "^?" when unsure, because it's the one and only
507 correct choice :). 530 correct choice :).
508 531
509 Rxvt-unicode tries to inherit the current stty settings and uses the 532 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 533 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 534
518 # use Backspace = ^H 535 # use Backspace = ^H
519 $ stty erase ^H 536 $ stty erase ^H
520 $ urxvt 537 $ printf "\e[?67h"
521 538
522 # use Backspace = ^? 539 # use Backspace = ^?
523 $ stty erase ^? 540 $ stty erase ^?
524 $ urxvt 541 $ 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 542
538 This helps satisfy some of the Backspace discrepancies that occur, but 543 This helps satisfy some of the Backspace discrepancies that occur, but
539 if you use Backspace = "^H", make sure that the termcap/terminfo value 544 if you use Backspace = "^H", make sure that the termcap/terminfo value
540 properly reflects that. 545 properly reflects that.
541 546
557 use the `keysym' resource to alter the keystrings associated with 562 use the `keysym' resource to alter the keystrings associated with
558 keysyms. 563 keysyms.
559 564
560 Here's an example for a URxvt session started using "urxvt -name URxvt" 565 Here's an example for a URxvt session started using "urxvt -name URxvt"
561 566
567 URxvt.keysym.Prior: \033[5~
568 URxvt.keysym.Next: \033[6~
562 URxvt.keysym.Home: \033[1~ 569 URxvt.keysym.Home: \033[7~
563 URxvt.keysym.End: \033[4~ 570 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> 571 URxvt.keysym.Up: \033[A
576 URxvt.keysym.M-Down: \033<M-Down> 572 URxvt.keysym.Down: \033[B
573 URxvt.keysym.Right: \033[C
577 URxvt.keysym.M-Left: \033<M-Left> 574 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 575
583 See some more examples in the documentation for the keysym resource. 576 See some more examples in the documentation for the keysym resource.
584 577
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 578 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 579 KP_Insert == Insert
629 develop for myself mostly, so I actually use most of the extensions I 622 develop for myself mostly, so I actually use most of the extensions I
630 write. 623 write.
631 624
632 The selection stuff mainly makes the selection perl-error-message aware 625 The selection stuff mainly makes the selection perl-error-message aware
633 and tells it to convert perl error messages into vi-commands to load the 626 and tells it to convert perl error messages into vi-commands to load the
634 relevant file and go tot he error line number. 627 relevant file and go to the error line number.
635 628
636 URxvt.scrollstyle: plain 629 URxvt.scrollstyle: plain
637 URxvt.secondaryScroll: true 630 URxvt.secondaryScroll: true
638 631
639 As the documentation says: plain is the preferred scrollbar for the 632 As the documentation says: plain is the preferred scrollbar for the
712 my purposes, it works, and gives a different look, as my normal 705 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 706 (Non-bold) font is already bold, and I want to see a difference between
714 bold and normal fonts. 707 bold and normal fonts.
715 708
716 Please note that I used the "urxvt" instance name and not the "URxvt" 709 Please note that I used the "urxvt" instance name and not the "URxvt"
717 class name. Thats because I use different configs for different 710 class name. That is because I use different configs for different
718 purposes, for example, my IRC window is started with "-name IRC", and 711 purposes, for example, my IRC window is started with "-name IRC", and
719 uses these defaults: 712 uses these defaults:
720 713
721 IRC*title: IRC 714 IRC*title: IRC
722 IRC*geometry: 87x12+535+542 715 IRC*geometry: 87x12+535+542
726 IRC*boldFont: suxuseuro 719 IRC*boldFont: suxuseuro
727 IRC*colorBD: white 720 IRC*colorBD: white
728 IRC*keysym.M-C-1: command:\033]710;suxuseuro\007\033]711;suxuseuro\007 721 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 722 IRC*keysym.M-C-2: command:\033]710;9x15bold\007\033]711;9x15bold\007
730 723
731 "Alt-Shift-1" and "Alt-Shift-2" switch between two different font sizes. 724 "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 725 "suxuseuro" allows me to keep an eye (and actually read) stuff while
733 keeping a very small window. If somebody pastes something complicated 726 keeping a very small window. If somebody pastes something complicated
734 (e.g. japanese), I temporarily switch to a larger font. 727 (e.g. japanese), I temporarily switch to a larger font.
735 728
736 The above is all in my ".Xdefaults" (I don't use ".Xresources" nor 729 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" 730 "xrdb"). I also have some resources in a separate ".Xdefaults-hostname"
738 file for different hosts, for example, on ym main desktop, I use: 731 file for different hosts, for example, on my main desktop, I use:
739 732
740 URxvt.keysym.C-M-q: command:\033[3;5;5t 733 URxvt.keysym.C-M-q: command:\033[3;5;5t
741 URxvt.keysym.C-M-y: command:\033[3;5;606t 734 URxvt.keysym.C-M-y: command:\033[3;5;606t
742 URxvt.keysym.C-M-e: command:\033[3;1605;5t 735 URxvt.keysym.C-M-e: command:\033[3;1605;5t
743 URxvt.keysym.C-M-c: command:\033[3;1605;606t 736 URxvt.keysym.C-M-c: command:\033[3;1605;606t
772 The terminal description used by rxvt-unicode is not as widely available 765 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 766 as that for xterm, or even rxvt (for which the same problem often
774 arises). 767 arises).
775 768
776 The correct solution for this problem is to install the terminfo, this 769 The correct solution for this problem is to install the terminfo, this
777 can be done like this (with ncurses' infocmp and works as user and 770 can be done by simply installing rxvt-unicode on the remote system as
778 admin): 771 well (in case you have a nice package manager ready), or you can install
772 the terminfo database manually like this (with ncurses infocmp. works as
773 user and root):
779 774
780 REMOTE=remotesystem.domain 775 REMOTE=remotesystem.domain
781 infocmp rxvt-unicode | ssh $REMOTE "mkdir -p .terminfo && cat >/tmp/ti && tic /tmp/ti" 776 infocmp rxvt-unicode | ssh $REMOTE "mkdir -p .terminfo && cat >/tmp/ti && tic /tmp/ti"
782 777
783 ... or by installing rxvt-unicode normally on the remote system,
784
785 One some systems you might need to set $TERMINFO to the full path of 778 One some systems you might need to set $TERMINFO to the full path of
786 $HOME/.terminfo for this to work. 779 $HOME/.terminfo for this to work. Debian systems have a broken tic which
780 will not be able to overwrite the existing rxvt-unicode terminfo entry -
781 you might have to manually delete all traces of rxvt-unicode* from
782 /etc/terminfo.
787 783
788 If you cannot or do not want to do this, then you can simply set 784 If you cannot or do not want to do this, then you can simply set
789 "TERM=rxvt" or even "TERM=xterm", and live with the small number of 785 "TERM=rxvt" or even "TERM=xterm", and live with the small number of
790 problems arising, which includes wrong keymapping, less and different 786 problems arising, which includes wrong keymapping, less and different
791 colours and some refresh errors in fullscreen applications. It's a nice 787 colours and some refresh errors in fullscreen applications. It's a nice
798 URxvt.termName: rxvt 794 URxvt.termName: rxvt
799 795
800 If you don't plan to use rxvt (quite common...) you could also replace 796 If you don't plan to use rxvt (quite common...) you could also replace
801 the rxvt terminfo file with the rxvt-unicode one and use "TERM=rxvt". 797 the rxvt terminfo file with the rxvt-unicode one and use "TERM=rxvt".
802 798
799 nano fails with "Error opening terminal: rxvt-unicode"
800 This exceptionally confusing and useless error message is printed by
801 nano when it can't find the terminfo database. Nothing is wrong with
802 your terminal, read the previous answer for a solution.
803
803 "tic" outputs some error when compiling the terminfo entry. 804 "tic" outputs some error when compiling the terminfo entry.
804 Most likely it's the empty definition for "enacs=". Just replace it by 805 Most likely it's the empty definition for "enacs=". Just replace it by
805 "enacs=\E[0@" and try again. 806 "enacs=\E[0@" and try again.
806 807
807 "bash"'s readline does not work correctly under urxvt. 808 "bash"'s readline does not work correctly under urxvt.
817 cases. You can also create a termcap entry by using terminfo's infocmp 818 cases. You can also create a termcap entry by using terminfo's infocmp
818 program like this: 819 program like this:
819 820
820 infocmp -C rxvt-unicode 821 infocmp -C rxvt-unicode
821 822
822 Or you could use this termcap entry, generated by the command above: 823 Or you could use the termcap entry in doc/etc/rxvt-unicode.termcap,
823 824 generated by the command above.
824 rxvt-unicode|rxvt-unicode terminal (X Window System):\
825 :am:bw:eo:km:mi:ms:xn:xo:\
826 :co#80:it#8:li#24:lm#0:\
827 :AL=\E[%dL:DC=\E[%dP:DL=\E[%dM:DO=\E[%dB:IC=\E[%d@:\
828 :K1=\EOw:K2=\EOu:K3=\EOy:K4=\EOq:K5=\EOs:LE=\E[%dD:\
829 :RI=\E[%dC:SF=\E[%dS:SR=\E[%dT:UP=\E[%dA:ae=\E(B:al=\E[L:\
830 :as=\E(0:bl=^G:cd=\E[J:ce=\E[K:cl=\E[H\E[2J:\
831 :cm=\E[%i%d;%dH:cr=^M:cs=\E[%i%d;%dr:ct=\E[3g:dc=\E[P:\
832 :dl=\E[M:do=^J:ec=\E[%dX:ei=\E[4l:ho=\E[H:\
833 :i1=\E[?47l\E=\E[?1l:ic=\E[@:im=\E[4h:\
834 :is=\E[r\E[m\E[2J\E[H\E[?7h\E[?1;3;4;6l\E[4l:\
835 :k1=\E[11~:k2=\E[12~:k3=\E[13~:k4=\E[14~:k5=\E[15~:\
836 :k6=\E[17~:k7=\E[18~:k8=\E[19~:k9=\E[20~:kD=\E[3~:\
837 :kI=\E[2~:kN=\E[6~:kP=\E[5~:kb=\177:kd=\EOB:ke=\E[?1l\E>:\
838 :kh=\E[7~:kl=\EOD:kr=\EOC:ks=\E[?1h\E=:ku=\EOA:le=^H:\
839 :mb=\E[5m:md=\E[1m:me=\E[m\017:mr=\E[7m:nd=\E[C:rc=\E8:\
840 :sc=\E7:se=\E[27m:sf=^J:so=\E[7m:sr=\EM:st=\EH:ta=^I:\
841 :te=\E[r\E[?1049l:ti=\E[?1049h:ue=\E[24m:up=\E[A:\
842 :us=\E[4m:vb=\E[?5h\E[?5l:ve=\E[?25h:vi=\E[?25l:\
843 :vs=\E[?25h:
844 825
845 Why does "ls" no longer have coloured output? 826 Why does "ls" no longer have coloured output?
846 The "ls" in the GNU coreutils unfortunately doesn't use terminfo to 827 The "ls" in the GNU coreutils unfortunately doesn't use terminfo to
847 decide whether a terminal has colour, but uses its own configuration 828 decide whether a terminal has colour, but uses its own configuration
848 file. Needless to say, "rxvt-unicode" is not in its default file (among 829 file. Needless to say, "rxvt-unicode" is not in its default file (among
880 If you encounter strange problems like typing an accented character but 861 If you encounter strange problems like typing an accented character but
881 getting two unrelated other characters or similar, or if program output 862 getting two unrelated other characters or similar, or if program output
882 is subtly garbled, then you should check your locale settings. 863 is subtly garbled, then you should check your locale settings.
883 864
884 Rxvt-unicode must be started with the same "LC_CTYPE" setting as the 865 Rxvt-unicode must be started with the same "LC_CTYPE" setting as the
885 programs. Often rxvt-unicode is started in the "C" locale, while the 866 programs running in it. Often rxvt-unicode is started in the "C" locale,
886 login script running within the rxvt-unicode window changes the locale 867 while the login script running within the rxvt-unicode window changes
887 to something else, e.g. "en_GB.UTF-8". Needless to say, this is not 868 the locale to something else, e.g. "en_GB.UTF-8". Needless to say, this
888 going to work. 869 is not going to work, and is the most common cause for problems.
889 870
890 The best thing is to fix your startup environment, as you will likely 871 The best thing is to fix your startup environment, as you will likely
891 run into other problems. If nothing works you can try this in your 872 run into other problems. If nothing works you can try this in your
892 .profile. 873 .profile.
893 874
894 printf '\33]701;%s\007' "$LC_CTYPE" 875 printf '\33]701;%s\007' "$LC_CTYPE" # $LANG or $LC_ALL are worth a try, too
895 876
896 If this doesn't work, then maybe you use a "LC_CTYPE" specification not 877 If this doesn't work, then maybe you use a "LC_CTYPE" specification not
897 supported on your systems. Some systems have a "locale" command which 878 supported on your systems. Some systems have a "locale" command which
898 displays this (also, "perl -e0" can be used to check locale settings, as 879 displays this (also, "perl -e0" can be used to check locale settings, as
899 it will complain loudly if it cannot set the locale). If it displays 880 it will complain loudly if it cannot set the locale). If it displays
985 For scim, use "@im=SCIM". You can see what input method servers are 966 For scim, use "@im=SCIM". You can see what input method servers are
986 running with this command: 967 running with this command:
987 968
988 xprop -root XIM_SERVERS 969 xprop -root XIM_SERVERS
989 970
990 *
991
992 My input method wants <some encoding> but I want UTF-8, what can I do? 971 My input method wants <some encoding> but I want UTF-8, what can I do?
993 You can specify separate locales for the input method and the rest of 972 You can specify separate locales for the input method and the rest of
994 the terminal, using the resource "imlocale": 973 the terminal, using the resource "imlocale":
995 974
996 URxvt.imlocale: ja_JP.EUC-JP 975 URxvt.imlocale: ja_JP.EUC-JP
1014 I am using Debian GNU/Linux and have a problem... 993 I am using Debian GNU/Linux and have a problem...
1015 The Debian GNU/Linux package of rxvt-unicode in sarge contains large 994 The Debian GNU/Linux package of rxvt-unicode in sarge contains large
1016 patches that considerably change the behaviour of rxvt-unicode (but 995 patches that considerably change the behaviour of rxvt-unicode (but
1017 unfortunately this notice has been removed). Before reporting a bug to 996 unfortunately this notice has been removed). Before reporting a bug to
1018 the original rxvt-unicode author please download and install the genuine 997 the original rxvt-unicode author please download and install the genuine
1019 version (<http://software.schmorp.de#rxvt-unicode>) and try to reproduce 998 version (<http://software.schmorp.de/pkg/rxvt-unicode.html>) and try to
1020 the problem. If you cannot, chances are that the problems are specific 999 reproduce the problem. If you cannot, chances are that the problems are
1021 to Debian GNU/Linux, in which case it should be reported via the Debian 1000 specific to Debian GNU/Linux, in which case it should be reported via
1022 Bug Tracking System (use "reportbug" to report the bug). 1001 the Debian Bug Tracking System (use "reportbug" to report the bug).
1023 1002
1024 For other problems that also affect the Debian package, you can and 1003 For other problems that also affect the Debian package, you can and
1025 probably should use the Debian BTS, too, because, after all, it's also a 1004 probably should use the Debian BTS, too, because, after all, it's also a
1026 bug in the Debian version and it serves as a reminder for other users 1005 bug in the Debian version and it serves as a reminder for other users
1027 that might encounter the same issue. 1006 that might encounter the same issue.
1032 runtime-switchable, too, so there is usually no drawback to enabling 1011 runtime-switchable, too, so there is usually no drawback to enabling
1033 them, except higher disk and possibly memory usage. The perl interpreter 1012 them, except higher disk and possibly memory usage. The perl interpreter
1034 should be enabled, as important functionality (menus, selection, likely 1013 should be enabled, as important functionality (menus, selection, likely
1035 more in the future) depends on it. 1014 more in the future) depends on it.
1036 1015
1037 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
1038 system-wide (except maybe with "defaults"). This will result in useful 1017 system-wide (except maybe with "defaults"). This will result in useful
1039 behaviour. If your distribution aims at low memory, add an empty 1018 behaviour. If your distribution aims at low memory, add an empty
1040 "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
1041 perl interpreter disabled until the user enables it. 1020 perl interpreter disabled until the user enables it.
1042 1021
1059 This forking is done as the very first within main(), which is very 1038 This forking is done as the very first within main(), which is very
1060 early and reduces possible bugs to initialisation code run before 1039 early and reduces possible bugs to initialisation code run before
1061 main(), or things like the dynamic loader of your system, which should 1040 main(), or things like the dynamic loader of your system, which should
1062 result in very little risk. 1041 result in very little risk.
1063 1042
1064 On Solaris 9, many line-drawing characters are too wide.
1065 Seems to be a known bug, read
1066 <http://nixdoc.net/files/forum/about34198.html>. Some people use the
1067 following ugly workaround to get non-double-wide-characters working:
1068
1069 #define wcwidth(x) wcwidth(x) > 1 ? 1 : wcwidth(x)
1070
1071 I am on FreeBSD and rxvt-unicode does not seem to work at all. 1043 I am on FreeBSD and rxvt-unicode does not seem to work at all.
1072 Rxvt-unicode requires the symbol "__STDC_ISO_10646__" to be defined in 1044 Rxvt-unicode requires the symbol "__STDC_ISO_10646__" to be defined in
1073 your compile environment, or an implementation that implements it, 1045 your compile environment, or an implementation that implements it,
1074 whether it defines the symbol or not. "__STDC_ISO_10646__" requires that 1046 whether it defines the symbol or not. "__STDC_ISO_10646__" requires that
1075 wchar_t is represented as unicode. 1047 wchar_t is represented as unicode.
1077 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
1078 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
1079 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.
1080 1052
1081 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
1082 "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).
1083 1055
1084 "__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
1085 in an OS, as using a locale-dependent (and non-standardized) 1057 in an OS, as using a locale-dependent (and non-standardized)
1086 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
1087 (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
1097 1069
1098 The rxvt-unicode author insists that the right way to fix this is in the 1070 The rxvt-unicode author insists that the right way to fix this is in the
1099 system libraries once and for all, instead of forcing every app to carry 1071 system libraries once and for all, instead of forcing every app to carry
1100 complete replacements for them :) 1072 complete replacements for them :)
1101 1073
1102 I use Solaris 9 and it doesn't compile/work/etc.
1103 Try the diff in doc/solaris9.patch as a base. It fixes the worst
1104 problems with "wcwidth" and a compile problem.
1105
1106 How can I use rxvt-unicode under cygwin? 1074 How can I use rxvt-unicode under cygwin?
1107 rxvt-unicode should compile and run out of the box on cygwin, using the 1075 rxvt-unicode should compile and run out of the box on cygwin, using the
1108 X11 libraries that come with cygwin. libW11 emulation is no longer 1076 X11 libraries that come with cygwin. libW11 emulation is no longer
1109 supported (and makes no sense, either, as it only supported a single 1077 supported (and makes no sense, either, as it only supported a single
1110 font). I recommend starting the X-server in "-multiwindow" or 1078 font). I recommend starting the X-server in "-multiwindow" or
1113 1081
1114 At the time of this writing, cygwin didn't seem to support any 1082 At the time of this writing, cygwin didn't seem to support any
1115 multi-byte encodings (you might try "LC_CTYPE=C-UTF-8"), so you are 1083 multi-byte encodings (you might try "LC_CTYPE=C-UTF-8"), so you are
1116 likely limited to 8-bit encodings. 1084 likely limited to 8-bit encodings.
1117 1085
1086 Character widths are not correct.
1087 urxvt uses the system wcwidth function to know the information about the
1088 width of characters, so on systems with incorrect locale data you will
1089 likely get bad results. Two notorious examples are Solaris 9, where
1090 single-width characters like U+2514 are reported as double-width, and
1091 Darwin 8, where combining chars are reported having width 1.
1092
1093 The solution is to upgrade your system or switch to a better one. A
1094 possibly working workaround is to use a wcwidth implementation like
1095
1096 http://www.cl.cam.ac.uk/~mgk25/ucs/wcwidth.c
1097

Diff Legend

Removed lines
+ Added lines
< Changed lines
> Changed lines