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.61 by root, Fri Oct 15 21:38:31 2010 UTC vs.
Revision 1.69 by root, Sat Apr 26 14:31:44 2014 UTC

91 91
92 # Bourne/Korn/POSIX family of shells: 92 # Bourne/Korn/POSIX family of shells:
93 [ ${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
94 if [ ${TERM:-foo} = xterm ]; then 94 if [ ${TERM:-foo} = xterm ]; then
95 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
96 echo -n '^[Z' 96 printf "\eZ"
97 read term_id 97 read term_id
98 stty icanon echo 98 stty icanon echo
99 if [ ""${term_id} = '^[[?1;2C' -a ${DISPLAY:-foo} = foo ]; then 99 if [ ""${term_id} = '^[[?1;2C' -a ${DISPLAY:-foo} = foo ]; then
100 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
101 read DISPLAY # set it in our local shell 101 read DISPLAY # set it in our local shell
102 fi 102 fi
103 fi 103 fi
104 104
105 How do I compile the manual pages on my own? 105 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, 106 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 158 the case of rxvt-unicode this hardly matters, as its portability limits
159 are defined by things like X11, pseudo terminals, locale support and 159 are defined by things like X11, pseudo terminals, locale support and
160 unix domain sockets, which are all less portable than C++ itself. 160 unix domain sockets, which are all less portable than C++ itself.
161 161
162 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
163 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
164 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
165 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
166 system with a minimal config: 166 my system with a minimal config:
167 167
168 libX11.so.6 => /usr/X11R6/lib/libX11.so.6 (0x00002aaaaabc3000) 168 libX11.so.6 => /usr/X11R6/lib/libX11.so.6 (0x00002aaaaabc3000)
169 libc.so.6 => /lib/libc.so.6 (0x00002aaaaadde000) 169 libc.so.6 => /lib/libc.so.6 (0x00002aaaaadde000)
170 libdl.so.2 => /lib/libdl.so.2 (0x00002aaaab01d000) 170 libdl.so.2 => /lib/libdl.so.2 (0x00002aaaab01d000)
171 /lib64/ld-linux-x86-64.so.2 (0x00002aaaaaaab000) 171 /lib64/ld-linux-x86-64.so.2 (0x00002aaaaaaab000)
195 195
196 Esetroot wallpaper.jpg 196 Esetroot wallpaper.jpg
197 urxvt -tr -tint red -sh 40 197 urxvt -tr -tint red -sh 40
198 198
199 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
200 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.
201 203
202 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
203 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
204 your picture with gimp or any other tool: 206 your picture with gimp or any other tool:
205 207
206 convert wallpaper.jpg -blur 20x20 -modulate 30 background.jpg 208 convert wallpaper.jpg -blur 20x20 -modulate 30 background.jpg
207 urxvt -pixmap "background.jpg;:root" 209 urxvt -pixmap "background.jpg;:root"
208 210
209 That works. If you think it doesn't, you lack libAfterImage or 211 That works. If you think it doesn't, you lack GDK-PixBuf support, or you
210 GDK-PixBuf support, or you are unable to read. 212 are unable to read.
211 213
212 3. Use an ARGB visual: 214 3. Use an ARGB visual:
213 215
214 urxvt -depth 32 -fg grey90 -bg rgba:0000/0000/4444/cccc 216 urxvt -depth 32 -fg grey90 -bg rgba:0000/0000/4444/cccc
215 217
490 compatible keymap. See the answer to the previous question, and please 492 compatible keymap. See the answer to the previous question, and please
491 report if that helped. 493 report if that helped.
492 494
493 My Compose (Multi_key) key is no longer working. 495 My Compose (Multi_key) key is no longer working.
494 The most common causes for this are that either your locale is not set 496 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 497 correctly, or you specified a preeditType that is not supported by your
496 input method. For example, if you specified OverTheSpot and your input 498 input method. For example, if you specified OverTheSpot and your input
497 method (e.g. the default input method handling Compose keys) does not 499 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 500 support this (for instance because it is not visual), then rxvt-unicode
499 will continue without an input method. 501 will continue without an input method.
500 502
501 In this case either do not specify a preeditStyle or specify more than 503 In this case either do not specify a preeditType or specify more than
502 one pre-edit style, such as OverTheSpot,Root,None. 504 one pre-edit style, such as OverTheSpot,Root,None.
503 505
504 If it still doesn't work, then maybe your input method doesn't support 506 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 507 compose sequences - to fall back to the built-in one, make sure you
506 don't specify an input method via "-im" or "XMODIFIERS". 508 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 514 other codes, too, such as "Ctrl-Shift-1-d" to type the default telnet
513 escape character and so on. 515 escape character and so on.
514 516
515 Mouse cut/paste suddenly no longer works. 517 Mouse cut/paste suddenly no longer works.
516 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
517 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
518 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
519 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.
520 depressed.
521 522
522 What's with the strange Backspace/Delete key behaviour? 523 What's with the strange Backspace/Delete key behaviour?
523 Assuming that the physical Backspace key corresponds to the Backspace 524 Assuming that the physical Backspace key corresponds to the Backspace
524 keysym (not likely for Linux ... see the following question) there are 525 keysym (not likely for Linux ... see the following question) there are
525 two standard values that can be used for Backspace: "^H" and "^?". 526 two standard values that can be used for Backspace: "^H" and "^?".
531 It is possible to toggle between "^H" and "^?" with the DECBKM private 532 It is possible to toggle between "^H" and "^?" with the DECBKM private
532 mode: 533 mode:
533 534
534 # use Backspace = ^H 535 # use Backspace = ^H
535 $ stty erase ^H 536 $ stty erase ^H
536 $ echo -n "^[[?67h" 537 $ printf "\e[?67h"
537 538
538 # use Backspace = ^? 539 # use Backspace = ^?
539 $ stty erase ^? 540 $ stty erase ^?
540 $ echo -n "^[[?67l" 541 $ printf "\e[?67l"
541 542
542 This helps satisfy some of the Backspace discrepancies that occur, but 543 This helps satisfy some of the Backspace discrepancies that occur, but
543 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
544 properly reflects that. 545 properly reflects that.
545 546
561 use the `keysym' resource to alter the keystrings associated with 562 use the `keysym' resource to alter the keystrings associated with
562 keysyms. 563 keysyms.
563 564
564 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"
565 566
567 URxvt.keysym.Prior: \033[5~
568 URxvt.keysym.Next: \033[6~
566 URxvt.keysym.Home: \033[1~ 569 URxvt.keysym.Home: \033[7~
567 URxvt.keysym.End: \033[4~ 570 URxvt.keysym.End: \033[8~
568 URxvt.keysym.C-apostrophe: \033<C-'>
569 URxvt.keysym.C-slash: \033<C-/>
570 URxvt.keysym.C-semicolon: \033<C-;>
571 URxvt.keysym.C-grave: \033<C-`>
572 URxvt.keysym.C-comma: \033<C-,>
573 URxvt.keysym.C-period: \033<C-.>
574 URxvt.keysym.C-0x60: \033<C-`>
575 URxvt.keysym.C-Tab: \033<C-Tab>
576 URxvt.keysym.C-Return: \033<C-Return>
577 URxvt.keysym.S-Return: \033<S-Return>
578 URxvt.keysym.S-space: \033<S-Space>
579 URxvt.keysym.M-Up: \033<M-Up> 571 URxvt.keysym.Up: \033[A
580 URxvt.keysym.M-Down: \033<M-Down> 572 URxvt.keysym.Down: \033[B
573 URxvt.keysym.Right: \033[C
581 URxvt.keysym.M-Left: \033<M-Left> 574 URxvt.keysym.Left: \033[D
582 URxvt.keysym.M-Right: \033<M-Right>
583 URxvt.keysym.M-C-0: list \033<M-C- 0123456789 >
584 URxvt.keysym.M-C-a: list \033<M-C- abcdefghijklmnopqrstuvwxyz >
585 URxvt.keysym.F12: command:\033]701;zh_CN.GBK\007
586 575
587 See some more examples in the documentation for the keysym resource. 576 See some more examples in the documentation for the keysym resource.
588 577
589 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
590 KP_Insert == Insert 579 KP_Insert == Insert
785 774
786 REMOTE=remotesystem.domain 775 REMOTE=remotesystem.domain
787 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"
788 777
789 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
790 $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.
791 783
792 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
793 "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
794 problems arising, which includes wrong keymapping, less and different 786 problems arising, which includes wrong keymapping, less and different
795 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
974 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
975 running with this command: 967 running with this command:
976 968
977 xprop -root XIM_SERVERS 969 xprop -root XIM_SERVERS
978 970
979
980
981 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?
982 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
983 the terminal, using the resource "imlocale": 973 the terminal, using the resource "imlocale":
984 974
985 URxvt.imlocale: ja_JP.EUC-JP 975 URxvt.imlocale: ja_JP.EUC-JP
1003 I am using Debian GNU/Linux and have a problem... 993 I am using Debian GNU/Linux and have a problem...
1004 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
1005 patches that considerably change the behaviour of rxvt-unicode (but 995 patches that considerably change the behaviour of rxvt-unicode (but
1006 unfortunately this notice has been removed). Before reporting a bug to 996 unfortunately this notice has been removed). Before reporting a bug to
1007 the original rxvt-unicode author please download and install the genuine 997 the original rxvt-unicode author please download and install the genuine
1008 version (<http://software.schmorp.de#rxvt-unicode>) and try to reproduce 998 version (<http://software.schmorp.de/pkg/rxvt-unicode.html>) and try to
1009 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
1010 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
1011 Bug Tracking System (use "reportbug" to report the bug). 1001 the Debian Bug Tracking System (use "reportbug" to report the bug).
1012 1002
1013 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
1014 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
1015 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
1016 that might encounter the same issue. 1006 that might encounter the same issue.

Diff Legend

Removed lines
+ Added lines
< Changed lines
> Changed lines