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.65 by root, Thu Jan 19 13:04:12 2012 UTC vs.
Revision 1.70 by root, Fri Dec 26 22:52:22 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
482 You can permanently switch this feature off by disabling the "readline" 481 You can permanently switch this feature off by disabling the "readline"
483 extension: 482 extension:
484 483
485 URxvt.perl-ext-common: default,-readline 484 URxvt.perl-ext-common: default,-readline
486 485
487 My numerical keypad acts weird and generates differing output? 486 My numeric keypad acts weird and generates differing output?
488 Some Debian GNUL/Linux users seem to have this problem, although no 487 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 488 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 489 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 490 how this can happen are unknown, as "TERM=rxvt" should offer a
492 compatible keymap. See the answer to the previous question, and please 491 compatible keymap. See the answer to the previous question, and please
493 report if that helped. 492 report if that helped.
494 493
495 My Compose (Multi_key) key is no longer working. 494 My Compose (Multi_key) key is no longer working.
496 The most common causes for this are that either your locale is not set 495 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 496 correctly, or you specified a preeditType that is not supported by your
498 input method. For example, if you specified OverTheSpot and your input 497 input method. For example, if you specified OverTheSpot and your input
499 method (e.g. the default input method handling Compose keys) does not 498 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 499 support this (for instance because it is not visual), then rxvt-unicode
501 will continue without an input method. 500 will continue without an input method.
502 501
503 In this case either do not specify a preeditStyle or specify more than 502 In this case either do not specify a preeditType or specify more than
504 one pre-edit style, such as OverTheSpot,Root,None. 503 one pre-edit style, such as OverTheSpot,Root,None.
505 504
506 If it still doesn't work, then maybe your input method doesn't support 505 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 506 compose sequences - to fall back to the built-in one, make sure you
508 don't specify an input method via "-im" or "XMODIFIERS". 507 don't specify an input method via "-im" or "XMODIFIERS".
532 It is possible to toggle between "^H" and "^?" with the DECBKM private 531 It is possible to toggle between "^H" and "^?" with the DECBKM private
533 mode: 532 mode:
534 533
535 # use Backspace = ^H 534 # use Backspace = ^H
536 $ stty erase ^H 535 $ stty erase ^H
537 $ echo -n "^[[?67h" 536 $ printf "\e[?67h"
538 537
539 # use Backspace = ^? 538 # use Backspace = ^?
540 $ stty erase ^? 539 $ stty erase ^?
541 $ echo -n "^[[?67l" 540 $ printf "\e[?67l"
542 541
543 This helps satisfy some of the Backspace discrepancies that occur, but 542 This helps satisfy some of the Backspace discrepancies that occur, but
544 if you use Backspace = "^H", make sure that the termcap/terminfo value 543 if you use Backspace = "^H", make sure that the termcap/terminfo value
545 properly reflects that. 544 properly reflects that.
546 545
774 773
775 REMOTE=remotesystem.domain 774 REMOTE=remotesystem.domain
776 infocmp rxvt-unicode | ssh $REMOTE "mkdir -p .terminfo && cat >/tmp/ti && tic /tmp/ti" 775 infocmp rxvt-unicode | ssh $REMOTE "mkdir -p .terminfo && cat >/tmp/ti && tic /tmp/ti"
777 776
778 One some systems you might need to set $TERMINFO to the full path of 777 One some systems you might need to set $TERMINFO to the full path of
779 $HOME/.terminfo for this to work. Debian systems have a broken tic which 778 $HOME/.terminfo for this to work.
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.
783 779
784 If you cannot or do not want to do this, then you can simply set 780 If you cannot or do not want to do this, then you can simply set
785 "TERM=rxvt" or even "TERM=xterm", and live with the small number of 781 "TERM=rxvt" or even "TERM=xterm", and live with the small number of
786 problems arising, which includes wrong keymapping, less and different 782 problems arising, which includes wrong keymapping, less and different
787 colours and some refresh errors in fullscreen applications. It's a nice 783 colours and some refresh errors in fullscreen applications. It's a nice
843 Why doesn't vim/emacs etc. make use of italic? 839 Why doesn't vim/emacs etc. make use of italic?
844 See next entry. 840 See next entry.
845 841
846 Why are the secondary screen-related options not working properly? 842 Why are the secondary screen-related options not working properly?
847 Make sure you are using "TERM=rxvt-unicode". Some pre-packaged 843 Make sure you are using "TERM=rxvt-unicode". Some pre-packaged
848 distributions (most notably Debian GNU/Linux) break rxvt-unicode by 844 distributions break rxvt-unicode by setting "TERM" to "rxvt", which
849 setting "TERM" to "rxvt", which doesn't have these extra features. 845 doesn't have these extra features. Unfortunately, some of these
850 Unfortunately, some of these (most notably, again, Debian GNU/Linux)
851 furthermore fail to even install the "rxvt-unicode" terminfo file, so 846 furthermore fail to even install the "rxvt-unicode" terminfo file, so
852 you will need to install it on your own (See the question When I log-in 847 you will need to install it on your own (See the question When I log-in
853 to another system it tells me about missing terminfo data? on how to do 848 to another system it tells me about missing terminfo data? on how to do
854 this). 849 this).
855 850
966 For scim, use "@im=SCIM". You can see what input method servers are 961 For scim, use "@im=SCIM". You can see what input method servers are
967 running with this command: 962 running with this command:
968 963
969 xprop -root XIM_SERVERS 964 xprop -root XIM_SERVERS
970 965
971
972
973 My input method wants <some encoding> but I want UTF-8, what can I do? 966 My input method wants <some encoding> but I want UTF-8, what can I do?
974 You can specify separate locales for the input method and the rest of 967 You can specify separate locales for the input method and the rest of
975 the terminal, using the resource "imlocale": 968 the terminal, using the resource "imlocale":
976 969
977 URxvt.imlocale: ja_JP.EUC-JP 970 URxvt.imlocale: ja_JP.EUC-JP
990 cannot be completely avoided even if both sides cooperate. 983 cannot be completely avoided even if both sides cooperate.
991 984
992 So the only workaround is not to kill your Input Method Servers. 985 So the only workaround is not to kill your Input Method Servers.
993 986
994 Operating Systems / Package Maintaining 987 Operating Systems / Package Maintaining
995 I am using Debian GNU/Linux and have a problem...
996 The Debian GNU/Linux package of rxvt-unicode in sarge contains large
997 patches that considerably change the behaviour of rxvt-unicode (but
998 unfortunately this notice has been removed). Before reporting a bug to
999 the original rxvt-unicode author please download and install the genuine
1000 version (<http://software.schmorp.de/pkg/rxvt-unicode.html>) and try to
1001 reproduce the problem. If you cannot, chances are that the problems are
1002 specific to Debian GNU/Linux, in which case it should be reported via
1003 the Debian Bug Tracking System (use "reportbug" to report the bug).
1004
1005 For other problems that also affect the Debian package, you can and
1006 probably should use the Debian BTS, too, because, after all, it's also a
1007 bug in the Debian version and it serves as a reminder for other users
1008 that might encounter the same issue.
1009
1010 I am maintaining rxvt-unicode for distribution/OS XXX, any recommendation? 988 I am maintaining rxvt-unicode for distribution/OS XXX, any recommendation?
1011 You should build one binary with the default options. configure now 989 You should build one binary with the default options. configure now
1012 enables most useful options, and the trend goes to making them 990 enables most useful options, and the trend goes to making them
1013 runtime-switchable, too, so there is usually no drawback to enabling 991 runtime-switchable, too, so there is usually no drawback to enabling
1014 them, except higher disk and possibly memory usage. The perl interpreter 992 them, except higher disk and possibly memory usage. The perl interpreter

Diff Legend

Removed lines
+ Added lines
< Changed lines
> Changed lines