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.62 by root, Thu Dec 9 10:36:51 2010 UTC vs.
Revision 1.71 by root, Wed Dec 31 14:40:24 2014 UTC

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 7
8 I use Gentoo, and I have a problem... 8 I use Gentoo, and I have a problem...
9 There are three big problems with Gentoo Linux: first of all, most if 9 There are two big problems with Gentoo Linux: first, most if not all
10 not all Gentoo systems are completely broken (missing or mismatched 10 Gentoo systems are completely broken (missing or mismatched header
11 header files, broken compiler etc. are just the tip of the iceberg); 11 files, broken compiler etc. are just the tip of the iceberg); secondly,
12 secondly, the Gentoo maintainer thinks it is a good idea to add broken 12 it should be called Gentoo GNU/Linux.
13 patches to the code; and lastly, it should be called Gentoo GNU/Linux.
14 13
15 For these reasons, it is impossible to support rxvt-unicode on Gentoo. 14 For these reasons, it is impossible to support rxvt-unicode on Gentoo.
16 Problems appearing on Gentoo systems will usually simply be ignored 15 Problems appearing on Gentoo systems will usually simply be ignored
17 unless they can be reproduced on non-Gentoo systems. 16 unless they can be reproduced on non-Gentoo systems.
18 17
91 90
92 # Bourne/Korn/POSIX family of shells: 91 # Bourne/Korn/POSIX family of shells:
93 [ ${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
94 if [ ${TERM:-foo} = xterm ]; then 93 if [ ${TERM:-foo} = xterm ]; then
95 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
96 echo -n '^[Z' 95 printf "\eZ"
97 read term_id 96 read term_id
98 stty icanon echo 97 stty icanon echo
99 if [ ""${term_id} = '^[[?1;2C' -a ${DISPLAY:-foo} = foo ]; then 98 if [ ""${term_id} = '^[[?1;2C' -a ${DISPLAY:-foo} = foo ]; then
100 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
101 read DISPLAY # set it in our local shell 100 read DISPLAY # set it in our local shell
102 fi 101 fi
103 fi 102 fi
104 103
105 How do I compile the manual pages on my own? 104 How do I compile the manual pages on my own?
106 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,
206 your picture with gimp or any other tool: 205 your picture with gimp or any other tool:
207 206
208 convert wallpaper.jpg -blur 20x20 -modulate 30 background.jpg 207 convert wallpaper.jpg -blur 20x20 -modulate 30 background.jpg
209 urxvt -pixmap "background.jpg;:root" 208 urxvt -pixmap "background.jpg;:root"
210 209
211 That works. If you think it doesn't, you lack libAfterImage or 210 That works. If you think it doesn't, you lack GDK-PixBuf support, or you
212 GDK-PixBuf support, or you are unable to read. 211 are unable to read.
213 212
214 3. Use an ARGB visual: 213 3. Use an ARGB visual:
215 214
216 urxvt -depth 32 -fg grey90 -bg rgba:0000/0000/4444/cccc 215 urxvt -depth 32 -fg grey90 -bg rgba:0000/0000/4444/cccc
217 216
429 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
430 like: 429 like:
431 430
432 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...'
433 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
434 Keyboard, Mouse & User Interaction 453 Keyboard, Mouse & User Interaction
435 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?
436 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
437 setting: 456 setting:
438 457
482 You can permanently switch this feature off by disabling the "readline" 501 You can permanently switch this feature off by disabling the "readline"
483 extension: 502 extension:
484 503
485 URxvt.perl-ext-common: default,-readline 504 URxvt.perl-ext-common: default,-readline
486 505
487 My numerical keypad acts weird and generates differing output? 506 My numeric keypad acts weird and generates differing output?
488 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
489 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
490 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
491 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
492 compatible keymap. See the answer to the previous question, and please 511 compatible keymap. See the answer to the previous question, and please
493 report if that helped. 512 report if that helped.
494 513
495 My Compose (Multi_key) key is no longer working. 514 My Compose (Multi_key) key is no longer working.
496 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
497 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
498 input method. For example, if you specified OverTheSpot and your input 517 input method. For example, if you specified OverTheSpot and your input
499 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
500 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
501 will continue without an input method. 520 will continue without an input method.
502 521
503 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
504 one pre-edit style, such as OverTheSpot,Root,None. 523 one pre-edit style, such as OverTheSpot,Root,None.
505 524
506 If it still doesn't work, then maybe your input method doesn't support 525 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 526 compose sequences - to fall back to the built-in one, make sure you
508 don't specify an input method via "-im" or "XMODIFIERS". 527 don't specify an input method via "-im" or "XMODIFIERS".
514 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
515 escape character and so on. 534 escape character and so on.
516 535
517 Mouse cut/paste suddenly no longer works. 536 Mouse cut/paste suddenly no longer works.
518 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
519 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
520 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
521 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.
522 depressed.
523 541
524 What's with the strange Backspace/Delete key behaviour? 542 What's with the strange Backspace/Delete key behaviour?
525 Assuming that the physical Backspace key corresponds to the Backspace 543 Assuming that the physical Backspace key corresponds to the Backspace
526 keysym (not likely for Linux ... see the following question) there are 544 keysym (not likely for Linux ... see the following question) there are
527 two standard values that can be used for Backspace: "^H" and "^?". 545 two standard values that can be used for Backspace: "^H" and "^?".
533 It is possible to toggle between "^H" and "^?" with the DECBKM private 551 It is possible to toggle between "^H" and "^?" with the DECBKM private
534 mode: 552 mode:
535 553
536 # use Backspace = ^H 554 # use Backspace = ^H
537 $ stty erase ^H 555 $ stty erase ^H
538 $ echo -n "^[[?67h" 556 $ printf "\e[?67h"
539 557
540 # use Backspace = ^? 558 # use Backspace = ^?
541 $ stty erase ^? 559 $ stty erase ^?
542 $ echo -n "^[[?67l" 560 $ printf "\e[?67l"
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
853 Why doesn't vim/emacs etc. make use of italic? 859 Why doesn't vim/emacs etc. make use of italic?
854 See next entry. 860 See next entry.
855 861
856 Why are the secondary screen-related options not working properly? 862 Why are the secondary screen-related options not working properly?
857 Make sure you are using "TERM=rxvt-unicode". Some pre-packaged 863 Make sure you are using "TERM=rxvt-unicode". Some pre-packaged
858 distributions (most notably Debian GNU/Linux) break rxvt-unicode by 864 distributions break rxvt-unicode by setting "TERM" to "rxvt", which
859 setting "TERM" to "rxvt", which doesn't have these extra features. 865 doesn't have these extra features. Unfortunately, some of these
860 Unfortunately, some of these (most notably, again, Debian GNU/Linux)
861 furthermore fail to even install the "rxvt-unicode" terminfo file, so 866 furthermore fail to even install the "rxvt-unicode" terminfo file, so
862 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
863 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
864 this). 869 this).
865 870
976 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
977 running with this command: 982 running with this command:
978 983
979 xprop -root XIM_SERVERS 984 xprop -root XIM_SERVERS
980 985
981
982
983 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?
984 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
985 the terminal, using the resource "imlocale": 988 the terminal, using the resource "imlocale":
986 989
987 URxvt.imlocale: ja_JP.EUC-JP 990 URxvt.imlocale: ja_JP.EUC-JP
1000 cannot be completely avoided even if both sides cooperate. 1003 cannot be completely avoided even if both sides cooperate.
1001 1004
1002 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.
1003 1006
1004 Operating Systems / Package Maintaining 1007 Operating Systems / Package Maintaining
1005 I am using Debian GNU/Linux and have a problem...
1006 The Debian GNU/Linux package of rxvt-unicode in sarge contains large
1007 patches that considerably change the behaviour of rxvt-unicode (but
1008 unfortunately this notice has been removed). Before reporting a bug to
1009 the original rxvt-unicode author please download and install the genuine
1010 version (<http://software.schmorp.de#rxvt-unicode>) and try to reproduce
1011 the problem. If you cannot, chances are that the problems are specific
1012 to Debian GNU/Linux, in which case it should be reported via the Debian
1013 Bug Tracking System (use "reportbug" to report the bug).
1014
1015 For other problems that also affect the Debian package, you can and
1016 probably should use the Debian BTS, too, because, after all, it's also a
1017 bug in the Debian version and it serves as a reminder for other users
1018 that might encounter the same issue.
1019
1020 I am maintaining rxvt-unicode for distribution/OS XXX, any recommendation? 1008 I am maintaining rxvt-unicode for distribution/OS XXX, any recommendation?
1021 You should build one binary with the default options. configure now 1009 You should build one binary with the default options. configure now
1022 enables most useful options, and the trend goes to making them 1010 enables most useful options, and the trend goes to making them
1023 runtime-switchable, too, so there is usually no drawback to enabling 1011 runtime-switchable, too, so there is usually no drawback to enabling
1024 them, except higher disk and possibly memory usage. The perl interpreter 1012 them, except higher disk and possibly memory usage. The perl interpreter

Diff Legend

Removed lines
+ Added lines
< Changed lines
> Changed lines