… | |
… | |
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, |
… | |
… | |
158 | 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 |
159 | are defined by things like X11, pseudo terminals, locale support and |
158 | are defined by things like X11, pseudo terminals, locale support and |
160 | unix domain sockets, which are all less portable than C++ itself. |
159 | unix domain sockets, which are all less portable than C++ itself. |
161 | |
160 | |
162 | 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 |
163 | 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 |
164 | 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 |
165 | 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 |
166 | system with a minimal config: |
165 | my system with a minimal config: |
167 | |
166 | |
168 | libX11.so.6 => /usr/X11R6/lib/libX11.so.6 (0x00002aaaaabc3000) |
167 | libX11.so.6 => /usr/X11R6/lib/libX11.so.6 (0x00002aaaaabc3000) |
169 | libc.so.6 => /lib/libc.so.6 (0x00002aaaaadde000) |
168 | libc.so.6 => /lib/libc.so.6 (0x00002aaaaadde000) |
170 | libdl.so.2 => /lib/libdl.so.2 (0x00002aaaab01d000) |
169 | libdl.so.2 => /lib/libdl.so.2 (0x00002aaaab01d000) |
171 | /lib64/ld-linux-x86-64.so.2 (0x00002aaaaaaab000) |
170 | /lib64/ld-linux-x86-64.so.2 (0x00002aaaaaaab000) |
… | |
… | |
181 | No large bloated libraries (of course, none were linked in statically), |
180 | No large bloated libraries (of course, none were linked in statically), |
182 | except maybe libX11 :) |
181 | except maybe libX11 :) |
183 | |
182 | |
184 | Rendering, Font & Look and Feel Issues |
183 | Rendering, Font & Look and Feel Issues |
185 | I can't get transparency working, what am I doing wrong? |
184 | I can't get transparency working, what am I doing wrong? |
186 | First of all, please address all transparency related issues to Sasha |
185 | First of all, transparency isn't officially supported in rxvt-unicode, |
187 | 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 |
188 | 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 |
189 | failed. |
188 | rite of passage: ... and you failed. |
190 | |
189 | |
191 | 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 |
192 | descriptions for the programs mentioned and rxvt-unicode. Really, do it! |
191 | descriptions for the programs mentioned and rxvt-unicode. Really, do it! |
193 | |
192 | |
194 | 1. Use transparent mode: |
193 | 1. Use transparent mode: |
195 | |
194 | |
196 | Esetroot wallpaper.jpg |
195 | Esetroot wallpaper.jpg |
197 | urxvt -tr -tint red -sh 40 |
196 | urxvt -tr -tint red -sh 40 |
198 | |
197 | |
199 | 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 |
200 | 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. |
201 | |
202 | |
202 | 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 |
203 | 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 |
204 | your picture with gimp or any other tool: |
205 | your picture with gimp or any other tool: |
205 | |
206 | |
206 | convert wallpaper.jpg -blur 20x20 -modulate 30 background.jpg |
207 | convert wallpaper.jpg -blur 20x20 -modulate 30 background.jpg |
207 | urxvt -pixmap "background.jpg;:root" |
208 | urxvt -pixmap "background.jpg;:root" |
208 | |
209 | |
209 | 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 |
210 | are unable to read. |
211 | are unable to read. |
211 | |
212 | |
212 | 3. Use an ARGB visual: |
213 | 3. Use an ARGB visual: |
213 | |
214 | |
214 | urxvt -depth 32 -fg grey90 -bg rgba:0000/0000/4444/cccc |
215 | urxvt -depth 32 -fg grey90 -bg rgba:0000/0000/4444/cccc |
… | |
… | |
480 | You can permanently switch this feature off by disabling the "readline" |
481 | You can permanently switch this feature off by disabling the "readline" |
481 | extension: |
482 | extension: |
482 | |
483 | |
483 | URxvt.perl-ext-common: default,-readline |
484 | URxvt.perl-ext-common: default,-readline |
484 | |
485 | |
485 | My numerical keypad acts weird and generates differing output? |
486 | My numeric keypad acts weird and generates differing output? |
486 | 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 |
487 | 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 |
488 | 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 |
489 | 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 |
490 | compatible keymap. See the answer to the previous question, and please |
491 | compatible keymap. See the answer to the previous question, and please |
491 | report if that helped. |
492 | report if that helped. |
492 | |
493 | |
493 | My Compose (Multi_key) key is no longer working. |
494 | My Compose (Multi_key) key is no longer working. |
494 | 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 |
495 | 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 |
496 | input method. For example, if you specified OverTheSpot and your input |
497 | input method. For example, if you specified OverTheSpot and your input |
497 | 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 |
498 | 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 |
499 | will continue without an input method. |
500 | will continue without an input method. |
500 | |
501 | |
501 | 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 |
502 | one pre-edit style, such as OverTheSpot,Root,None. |
503 | one pre-edit style, such as OverTheSpot,Root,None. |
503 | |
504 | |
504 | 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 |
505 | 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 |
506 | don't specify an input method via "-im" or "XMODIFIERS". |
507 | don't specify an input method via "-im" or "XMODIFIERS". |
… | |
… | |
512 | other codes, too, such as "Ctrl-Shift-1-d" to type the default telnet |
513 | other codes, too, such as "Ctrl-Shift-1-d" to type the default telnet |
513 | escape character and so on. |
514 | escape character and so on. |
514 | |
515 | |
515 | Mouse cut/paste suddenly no longer works. |
516 | Mouse cut/paste suddenly no longer works. |
516 | Make sure that mouse reporting is actually turned off since killing some |
517 | Make sure that mouse reporting is actually turned off since killing some |
517 | editors prematurely may leave the mouse in mouse report mode. I've heard |
518 | editors prematurely may leave it active. I've heard that tcsh may use |
518 | that tcsh may use mouse reporting unless it otherwise specified. A quick |
519 | mouse reporting unless it is otherwise specified. A quick check is to |
519 | check is to see if cut/paste works when the Alt or Shift keys are |
520 | see if cut/paste works when the Alt or Shift keys are pressed. |
520 | depressed. |
|
|
521 | |
521 | |
522 | What's with the strange Backspace/Delete key behaviour? |
522 | What's with the strange Backspace/Delete key behaviour? |
523 | Assuming that the physical Backspace key corresponds to the Backspace |
523 | Assuming that the physical Backspace key corresponds to the Backspace |
524 | keysym (not likely for Linux ... see the following question) there are |
524 | keysym (not likely for Linux ... see the following question) there are |
525 | two standard values that can be used for Backspace: "^H" and "^?". |
525 | two standard values that can be used for Backspace: "^H" and "^?". |
526 | |
526 | |
527 | Historically, either value is correct, but rxvt-unicode adopts the |
527 | Historically, either value is correct, but rxvt-unicode adopts the |
528 | debian policy of using "^?" when unsure, because it's the one and only |
528 | debian policy of using "^?" when unsure, because it's the one and only |
529 | correct choice :). |
529 | correct choice :). |
530 | |
530 | |
531 | Rxvt-unicode tries to inherit the current stty settings and uses the |
531 | It is possible to toggle between "^H" and "^?" with the DECBKM private |
532 | value of `erase' to guess the value for backspace. If rxvt-unicode |
532 | mode: |
533 | wasn't started from a terminal (say, from a menu or by remote shell), |
|
|
534 | then the system value of `erase', which corresponds to CERASE in |
|
|
535 | <termios.h>, will be used (which may not be the same as your stty |
|
|
536 | setting). |
|
|
537 | |
|
|
538 | For starting a new rxvt-unicode: |
|
|
539 | |
533 | |
540 | # use Backspace = ^H |
534 | # use Backspace = ^H |
541 | $ stty erase ^H |
535 | $ stty erase ^H |
542 | $ urxvt |
536 | $ printf "\e[?67h" |
543 | |
537 | |
544 | # use Backspace = ^? |
538 | # use Backspace = ^? |
545 | $ stty erase ^? |
539 | $ stty erase ^? |
546 | $ urxvt |
540 | $ printf "\e[?67l" |
547 | |
|
|
548 | Toggle with "ESC [ 36 h" / "ESC [ 36 l". |
|
|
549 | |
|
|
550 | For an existing rxvt-unicode: |
|
|
551 | |
|
|
552 | # use Backspace = ^H |
|
|
553 | $ stty erase ^H |
|
|
554 | $ echo -n "^[[36h" |
|
|
555 | |
|
|
556 | # use Backspace = ^? |
|
|
557 | $ stty erase ^? |
|
|
558 | $ echo -n "^[[36l" |
|
|
559 | |
541 | |
560 | This helps satisfy some of the Backspace discrepancies that occur, but |
542 | This helps satisfy some of the Backspace discrepancies that occur, but |
561 | 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 |
562 | properly reflects that. |
544 | properly reflects that. |
563 | |
545 | |
… | |
… | |
579 | use the `keysym' resource to alter the keystrings associated with |
561 | use the `keysym' resource to alter the keystrings associated with |
580 | keysyms. |
562 | keysyms. |
581 | |
563 | |
582 | Here's an example for a URxvt session started using "urxvt -name URxvt" |
564 | Here's an example for a URxvt session started using "urxvt -name URxvt" |
583 | |
565 | |
|
|
566 | URxvt.keysym.Prior: \033[5~ |
|
|
567 | URxvt.keysym.Next: \033[6~ |
584 | URxvt.keysym.Home: \033[1~ |
568 | URxvt.keysym.Home: \033[7~ |
585 | URxvt.keysym.End: \033[4~ |
569 | URxvt.keysym.End: \033[8~ |
586 | URxvt.keysym.C-apostrophe: \033<C-'> |
|
|
587 | URxvt.keysym.C-slash: \033<C-/> |
|
|
588 | URxvt.keysym.C-semicolon: \033<C-;> |
|
|
589 | URxvt.keysym.C-grave: \033<C-`> |
|
|
590 | URxvt.keysym.C-comma: \033<C-,> |
|
|
591 | URxvt.keysym.C-period: \033<C-.> |
|
|
592 | URxvt.keysym.C-0x60: \033<C-`> |
|
|
593 | URxvt.keysym.C-Tab: \033<C-Tab> |
|
|
594 | URxvt.keysym.C-Return: \033<C-Return> |
|
|
595 | URxvt.keysym.S-Return: \033<S-Return> |
|
|
596 | URxvt.keysym.S-space: \033<S-Space> |
|
|
597 | URxvt.keysym.M-Up: \033<M-Up> |
570 | URxvt.keysym.Up: \033[A |
598 | URxvt.keysym.M-Down: \033<M-Down> |
571 | URxvt.keysym.Down: \033[B |
|
|
572 | URxvt.keysym.Right: \033[C |
599 | URxvt.keysym.M-Left: \033<M-Left> |
573 | URxvt.keysym.Left: \033[D |
600 | URxvt.keysym.M-Right: \033<M-Right> |
|
|
601 | URxvt.keysym.M-C-0: list \033<M-C- 0123456789 > |
|
|
602 | URxvt.keysym.M-C-a: list \033<M-C- abcdefghijklmnopqrstuvwxyz > |
|
|
603 | URxvt.keysym.F12: command:\033]701;zh_CN.GBK\007 |
|
|
604 | |
574 | |
605 | See some more examples in the documentation for the keysym resource. |
575 | See some more examples in the documentation for the keysym resource. |
606 | |
576 | |
607 | 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 |
577 | 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 |
608 | KP_Insert == Insert |
578 | KP_Insert == Insert |
… | |
… | |
755 | keeping a very small window. If somebody pastes something complicated |
725 | keeping a very small window. If somebody pastes something complicated |
756 | (e.g. japanese), I temporarily switch to a larger font. |
726 | (e.g. japanese), I temporarily switch to a larger font. |
757 | |
727 | |
758 | The above is all in my ".Xdefaults" (I don't use ".Xresources" nor |
728 | The above is all in my ".Xdefaults" (I don't use ".Xresources" nor |
759 | "xrdb"). I also have some resources in a separate ".Xdefaults-hostname" |
729 | "xrdb"). I also have some resources in a separate ".Xdefaults-hostname" |
760 | file for different hosts, for example, on ym main desktop, I use: |
730 | file for different hosts, for example, on my main desktop, I use: |
761 | |
731 | |
762 | URxvt.keysym.C-M-q: command:\033[3;5;5t |
732 | URxvt.keysym.C-M-q: command:\033[3;5;5t |
763 | URxvt.keysym.C-M-y: command:\033[3;5;606t |
733 | URxvt.keysym.C-M-y: command:\033[3;5;606t |
764 | URxvt.keysym.C-M-e: command:\033[3;1605;5t |
734 | URxvt.keysym.C-M-e: command:\033[3;1605;5t |
765 | URxvt.keysym.C-M-c: command:\033[3;1605;606t |
735 | URxvt.keysym.C-M-c: command:\033[3;1605;606t |
… | |
… | |
869 | Why doesn't vim/emacs etc. make use of italic? |
839 | Why doesn't vim/emacs etc. make use of italic? |
870 | See next entry. |
840 | See next entry. |
871 | |
841 | |
872 | Why are the secondary screen-related options not working properly? |
842 | Why are the secondary screen-related options not working properly? |
873 | Make sure you are using "TERM=rxvt-unicode". Some pre-packaged |
843 | Make sure you are using "TERM=rxvt-unicode". Some pre-packaged |
874 | distributions (most notably Debian GNU/Linux) break rxvt-unicode by |
844 | distributions break rxvt-unicode by setting "TERM" to "rxvt", which |
875 | setting "TERM" to "rxvt", which doesn't have these extra features. |
845 | doesn't have these extra features. Unfortunately, some of these |
876 | Unfortunately, some of these (most notably, again, Debian GNU/Linux) |
|
|
877 | furthermore fail to even install the "rxvt-unicode" terminfo file, so |
846 | furthermore fail to even install the "rxvt-unicode" terminfo file, so |
878 | 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 |
879 | 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 |
880 | this). |
849 | this). |
881 | |
850 | |
… | |
… | |
992 | 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 |
993 | running with this command: |
962 | running with this command: |
994 | |
963 | |
995 | xprop -root XIM_SERVERS |
964 | xprop -root XIM_SERVERS |
996 | |
965 | |
997 | |
|
|
998 | |
|
|
999 | 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? |
1000 | 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 |
1001 | the terminal, using the resource "imlocale": |
968 | the terminal, using the resource "imlocale": |
1002 | |
969 | |
1003 | URxvt.imlocale: ja_JP.EUC-JP |
970 | URxvt.imlocale: ja_JP.EUC-JP |
… | |
… | |
1016 | cannot be completely avoided even if both sides cooperate. |
983 | cannot be completely avoided even if both sides cooperate. |
1017 | |
984 | |
1018 | 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. |
1019 | |
986 | |
1020 | Operating Systems / Package Maintaining |
987 | Operating Systems / Package Maintaining |
1021 | I am using Debian GNU/Linux and have a problem... |
|
|
1022 | The Debian GNU/Linux package of rxvt-unicode in sarge contains large |
|
|
1023 | patches that considerably change the behaviour of rxvt-unicode (but |
|
|
1024 | unfortunately this notice has been removed). Before reporting a bug to |
|
|
1025 | the original rxvt-unicode author please download and install the genuine |
|
|
1026 | version (<http://software.schmorp.de#rxvt-unicode>) and try to reproduce |
|
|
1027 | the problem. If you cannot, chances are that the problems are specific |
|
|
1028 | to Debian GNU/Linux, in which case it should be reported via the Debian |
|
|
1029 | Bug Tracking System (use "reportbug" to report the bug). |
|
|
1030 | |
|
|
1031 | For other problems that also affect the Debian package, you can and |
|
|
1032 | probably should use the Debian BTS, too, because, after all, it's also a |
|
|
1033 | bug in the Debian version and it serves as a reminder for other users |
|
|
1034 | that might encounter the same issue. |
|
|
1035 | |
|
|
1036 | I am maintaining rxvt-unicode for distribution/OS XXX, any recommendation? |
988 | I am maintaining rxvt-unicode for distribution/OS XXX, any recommendation? |
1037 | You should build one binary with the default options. configure now |
989 | You should build one binary with the default options. configure now |
1038 | enables most useful options, and the trend goes to making them |
990 | enables most useful options, and the trend goes to making them |
1039 | runtime-switchable, too, so there is usually no drawback to enabling |
991 | runtime-switchable, too, so there is usually no drawback to enabling |
1040 | them, except higher disk and possibly memory usage. The perl interpreter |
992 | them, except higher disk and possibly memory usage. The perl interpreter |