… | |
… | |
127 | .\} |
127 | .\} |
128 | .rm #[ #] #H #V #F C |
128 | .rm #[ #] #H #V #F C |
129 | .\" ======================================================================== |
129 | .\" ======================================================================== |
130 | .\" |
130 | .\" |
131 | .IX Title "rxvt 7" |
131 | .IX Title "rxvt 7" |
132 | .TH rxvt 7 "2006-01-31" "7.5" "RXVT-UNICODE" |
132 | .TH rxvt 7 "2006-02-22" "7.7" "RXVT-UNICODE" |
133 | .SH "NAME" |
133 | .SH "NAME" |
134 | RXVT REFERENCE \- FAQ, command sequences and other background information |
134 | RXVT REFERENCE \- FAQ, command sequences and other background information |
135 | .SH "SYNOPSIS" |
135 | .SH "SYNOPSIS" |
136 | .IX Header "SYNOPSIS" |
136 | .IX Header "SYNOPSIS" |
137 | .Vb 2 |
137 | .Vb 2 |
… | |
… | |
214 | \fIHow can I start @@URXVT_NAME@@d in a race-free way?\fR |
214 | \fIHow can I start @@URXVT_NAME@@d in a race-free way?\fR |
215 | .IX Subsection "How can I start @@URXVT_NAME@@d in a race-free way?" |
215 | .IX Subsection "How can I start @@URXVT_NAME@@d in a race-free way?" |
216 | .PP |
216 | .PP |
217 | Try \f(CW\*(C`@@URXVT_NAME@@d \-f \-o\*(C'\fR, which tells @@URXVT_NAME@@d to open the |
217 | Try \f(CW\*(C`@@URXVT_NAME@@d \-f \-o\*(C'\fR, which tells @@URXVT_NAME@@d to open the |
218 | display, create the listening socket and then fork. |
218 | display, create the listening socket and then fork. |
|
|
219 | .PP |
|
|
220 | \fIHow can I start @@URXVT_NAME@@d automatically when I run URXVT_NAME@@c?\fR |
|
|
221 | .IX Subsection "How can I start @@URXVT_NAME@@d automatically when I run URXVT_NAME@@c?" |
|
|
222 | .PP |
|
|
223 | If you want to start @@URXVT_NAME@@d automatically whenever you run |
|
|
224 | @@URXVT_NAME@@c and the daemon isn't running yet, use this script: |
|
|
225 | .PP |
|
|
226 | .Vb 6 |
|
|
227 | \& #!/bin/sh |
|
|
228 | \& @@URXVT_NAME@@c "$@" |
|
|
229 | \& if [ $? -eq 2 ]; then |
|
|
230 | \& @@URXVT_NAME@@d -q -o -f |
|
|
231 | \& @@URXVT_NAME@@c "$@" |
|
|
232 | \& fi |
|
|
233 | .Ve |
|
|
234 | .PP |
|
|
235 | This tries to create a new terminal, and if fails with exit status 2, |
|
|
236 | meaning it couldn't connect to the daemon, it will start the daemon and |
|
|
237 | re-run the command. Subsequent invocations of the script will re-use the |
|
|
238 | existing daemon. |
219 | .PP |
239 | .PP |
220 | \fIHow do I distinguish wether I'm running rxvt-unicode or a regular xterm? I need this to decide about setting colors etc.\fR |
240 | \fIHow do I distinguish wether I'm running rxvt-unicode or a regular xterm? I need this to decide about setting colors etc.\fR |
221 | .IX Subsection "How do I distinguish wether I'm running rxvt-unicode or a regular xterm? I need this to decide about setting colors etc." |
241 | .IX Subsection "How do I distinguish wether I'm running rxvt-unicode or a regular xterm? I need this to decide about setting colors etc." |
222 | .PP |
242 | .PP |
223 | The original rxvt and rxvt-unicode always export the variable \*(L"\s-1COLORTERM\s0\*(R", |
243 | The original rxvt and rxvt-unicode always export the variable \*(L"\s-1COLORTERM\s0\*(R", |
… | |
… | |
275 | \& text data bss drs rss filename |
295 | \& text data bss drs rss filename |
276 | \& 98398 1664 24 15695 1824 rxvt --disable-everything |
296 | \& 98398 1664 24 15695 1824 rxvt --disable-everything |
277 | \& 188985 9048 66616 18222 1788 urxvt --disable-everything |
297 | \& 188985 9048 66616 18222 1788 urxvt --disable-everything |
278 | .Ve |
298 | .Ve |
279 | .PP |
299 | .PP |
280 | When you \f(CW\*(C`\-\-enable\-everything\*(C'\fR (which _is_ unfair, as this involves xft |
300 | When you \f(CW\*(C`\-\-enable\-everything\*(C'\fR (which \fIis\fR unfair, as this involves xft |
281 | and full locale/XIM support which are quite bloaty inside libX11 and my |
301 | and full locale/XIM support which are quite bloaty inside libX11 and my |
282 | libc), the two diverge, but not unreasnobaly so. |
302 | libc), the two diverge, but not unreasnobaly so. |
283 | .PP |
303 | .PP |
284 | .Vb 3 |
304 | .Vb 3 |
285 | \& text data bss drs rss filename |
305 | \& text data bss drs rss filename |
… | |
… | |
401 | .PP |
421 | .PP |
402 | Then click on a window you want to make transparent. Replace \f(CW0xc0000000\fR |
422 | Then click on a window you want to make transparent. Replace \f(CW0xc0000000\fR |
403 | by other values to change the degree of opacity. If it doesn't work and |
423 | by other values to change the degree of opacity. If it doesn't work and |
404 | your server crashes, you got to keep the pieces. |
424 | your server crashes, you got to keep the pieces. |
405 | .PP |
425 | .PP |
406 | \fIWhy do some chinese characters look so different than others?\fR |
|
|
407 | .IX Subsection "Why do some chinese characters look so different than others?" |
|
|
408 | .PP |
|
|
409 | This is because there is a difference between script and language \*(-- |
|
|
410 | rxvt-unicode does not know which language the text that is output is, |
|
|
411 | as it only knows the unicode character codes. If rxvt-unicode first |
|
|
412 | sees a japanese/chinese character, it might choose a japanese font for |
|
|
413 | display. Subsequent japanese characters will use that font. Now, many |
|
|
414 | chinese characters aren't represented in japanese fonts, so when the first |
|
|
415 | non-japanese character comes up, rxvt-unicode will look for a chinese font |
|
|
416 | \&\*(-- unfortunately at this point, it will still use the japanese font for |
|
|
417 | chinese characters that are also in the japanese font. |
|
|
418 | .PP |
|
|
419 | The workaround is easy: just tag a chinese font at the end of your font |
|
|
420 | list (see the previous question). The key is to view the font list as |
|
|
421 | a preference list: If you expect more japanese, list a japanese font |
|
|
422 | first. If you expect more chinese, put a chinese font first. |
|
|
423 | .PP |
|
|
424 | In the future it might be possible to switch language preferences at |
|
|
425 | runtime (the internal data structure has no problem with using different |
|
|
426 | fonts for the same character at the same time, but no interface for this |
|
|
427 | has been designed yet). |
|
|
428 | .PP |
|
|
429 | Until then, you might get away with switching fonts at runtime (see \*(L"Can I switch the fonts at runtime?\*(R" later in this document). |
|
|
430 | .PP |
|
|
431 | \fIWhy does rxvt-unicode sometimes leave pixel droppings?\fR |
426 | \fIWhy does rxvt-unicode sometimes leave pixel droppings?\fR |
432 | .IX Subsection "Why does rxvt-unicode sometimes leave pixel droppings?" |
427 | .IX Subsection "Why does rxvt-unicode sometimes leave pixel droppings?" |
433 | .PP |
428 | .PP |
434 | Most fonts were not designed for terminal use, which means that character |
429 | Most fonts were not designed for terminal use, which means that character |
435 | size varies a lot. A font that is otherwise fine for terminal use might |
430 | size varies a lot. A font that is otherwise fine for terminal use might |
… | |
… | |
481 | .PP |
476 | .PP |
482 | Yes, using an escape sequence. Try something like this, which has the same |
477 | Yes, using an escape sequence. Try something like this, which has the same |
483 | effect as using the \f(CW\*(C`\-fn\*(C'\fR switch, and takes effect immediately: |
478 | effect as using the \f(CW\*(C`\-fn\*(C'\fR switch, and takes effect immediately: |
484 | .PP |
479 | .PP |
485 | .Vb 1 |
480 | .Vb 1 |
486 | \& printf '\ee]50;%s\e007' "9x15bold,xft:Kochi Gothic" |
481 | \& printf '\e33]50;%s\e007' "9x15bold,xft:Kochi Gothic" |
487 | .Ve |
482 | .Ve |
488 | .PP |
483 | .PP |
489 | This is useful if you e.g. work primarily with japanese (and prefer a |
484 | This is useful if you e.g. work primarily with japanese (and prefer a |
490 | japanese font), but you have to switch to chinese temporarily, where |
485 | japanese font), but you have to switch to chinese temporarily, where |
491 | japanese fonts would only be in your way. |
486 | japanese fonts would only be in your way. |
… | |
… | |
571 | \& URxvt.color13: #FF00FF |
566 | \& URxvt.color13: #FF00FF |
572 | \& URxvt.color14: #00FFFF |
567 | \& URxvt.color14: #00FFFF |
573 | \& URxvt.color15: #FFFFFF |
568 | \& URxvt.color15: #FFFFFF |
574 | .Ve |
569 | .Ve |
575 | .PP |
570 | .PP |
576 | And here is a more complete set of non-standard colors described (not by |
571 | And here is a more complete set of non-standard colors. |
577 | me) as \*(L"pretty girly\*(R". |
|
|
578 | .PP |
572 | .PP |
579 | .Vb 18 |
573 | .Vb 18 |
580 | \& URxvt.cursorColor: #dc74d1 |
574 | \& URxvt.cursorColor: #dc74d1 |
581 | \& URxvt.pointerColor: #dc74d1 |
575 | \& URxvt.pointerColor: #dc74d1 |
582 | \& URxvt.background: #0e0e0e |
576 | \& URxvt.background: #0e0e0e |
… | |
… | |
595 | \& URxvt.color14: #73f7ff |
589 | \& URxvt.color14: #73f7ff |
596 | \& URxvt.color7: #e1dddd |
590 | \& URxvt.color7: #e1dddd |
597 | \& URxvt.color15: #e1dddd |
591 | \& URxvt.color15: #e1dddd |
598 | .Ve |
592 | .Ve |
599 | .PP |
593 | .PP |
|
|
594 | They have been described (not by me) as \*(L"pretty girly\*(R". |
|
|
595 | .PP |
600 | \fIWhy do some characters look so much different than others?\fR |
596 | \fIWhy do some characters look so much different than others?\fR |
601 | .IX Subsection "Why do some characters look so much different than others?" |
597 | .IX Subsection "Why do some characters look so much different than others?" |
602 | .PP |
598 | .PP |
603 | See next entry. |
599 | See next entry. |
604 | .PP |
600 | .PP |
… | |
… | |
630 | search and use less resources within rxvt-unicode and the X\-server. |
626 | search and use less resources within rxvt-unicode and the X\-server. |
631 | .PP |
627 | .PP |
632 | The only limitation is that none of the fonts may be larger than the base |
628 | The only limitation is that none of the fonts may be larger than the base |
633 | font, as the base font defines the terminal character cell size, which |
629 | font, as the base font defines the terminal character cell size, which |
634 | must be the same due to the way terminals work. |
630 | must be the same due to the way terminals work. |
|
|
631 | .PP |
|
|
632 | \fIWhy do some chinese characters look so different than others?\fR |
|
|
633 | .IX Subsection "Why do some chinese characters look so different than others?" |
|
|
634 | .PP |
|
|
635 | This is because there is a difference between script and language \*(-- |
|
|
636 | rxvt-unicode does not know which language the text that is output is, |
|
|
637 | as it only knows the unicode character codes. If rxvt-unicode first |
|
|
638 | sees a japanese/chinese character, it might choose a japanese font for |
|
|
639 | display. Subsequent japanese characters will use that font. Now, many |
|
|
640 | chinese characters aren't represented in japanese fonts, so when the first |
|
|
641 | non-japanese character comes up, rxvt-unicode will look for a chinese font |
|
|
642 | \&\*(-- unfortunately at this point, it will still use the japanese font for |
|
|
643 | chinese characters that are also in the japanese font. |
|
|
644 | .PP |
|
|
645 | The workaround is easy: just tag a chinese font at the end of your font |
|
|
646 | list (see the previous question). The key is to view the font list as |
|
|
647 | a preference list: If you expect more japanese, list a japanese font |
|
|
648 | first. If you expect more chinese, put a chinese font first. |
|
|
649 | .PP |
|
|
650 | In the future it might be possible to switch language preferences at |
|
|
651 | runtime (the internal data structure has no problem with using different |
|
|
652 | fonts for the same character at the same time, but no interface for this |
|
|
653 | has been designed yet). |
|
|
654 | .PP |
|
|
655 | Until then, you might get away with switching fonts at runtime (see \*(L"Can I switch the fonts at runtime?\*(R" later in this document). |
635 | .Sh "Keyboard, Mouse & User Interaction" |
656 | .Sh "Keyboard, Mouse & User Interaction" |
636 | .IX Subsection "Keyboard, Mouse & User Interaction" |
657 | .IX Subsection "Keyboard, Mouse & User Interaction" |
637 | \fIThe new selection selects pieces that are too big, how can I select single words?\fR |
658 | \fIThe new selection selects pieces that are too big, how can I select single words?\fR |
638 | .IX Subsection "The new selection selects pieces that are too big, how can I select single words?" |
659 | .IX Subsection "The new selection selects pieces that are too big, how can I select single words?" |
639 | .PP |
660 | .PP |
… | |
… | |
858 | Rather than have rxvt-unicode try to accommodate all the various possible |
879 | Rather than have rxvt-unicode try to accommodate all the various possible |
859 | keyboard mappings, it is better to use `xmodmap' to remap the keys as |
880 | keyboard mappings, it is better to use `xmodmap' to remap the keys as |
860 | required for your particular machine. |
881 | required for your particular machine. |
861 | .Sh "Terminal Configuration" |
882 | .Sh "Terminal Configuration" |
862 | .IX Subsection "Terminal Configuration" |
883 | .IX Subsection "Terminal Configuration" |
|
|
884 | \fICan I see a typical configuration?\fR |
|
|
885 | .IX Subsection "Can I see a typical configuration?" |
|
|
886 | .PP |
|
|
887 | The default configuration tries to be xterm\-like, which I don't like that |
|
|
888 | much, but it's least surprise to regular users. |
|
|
889 | .PP |
|
|
890 | As a rxvt or rxvt-unicode user, you are practically supposed to invest |
|
|
891 | time into customising your terminal. To get you started, here is the |
|
|
892 | author's .Xdefaults entries, with comments on what they do. It's certainly |
|
|
893 | not \fItypical\fR, but what's typical... |
|
|
894 | .PP |
|
|
895 | .Vb 2 |
|
|
896 | \& URxvt.cutchars: "()*,<>[]{}|' |
|
|
897 | \& URxvt.print-pipe: cat >/tmp/xxx |
|
|
898 | .Ve |
|
|
899 | .PP |
|
|
900 | These are just for testing stuff. |
|
|
901 | .PP |
|
|
902 | .Vb 2 |
|
|
903 | \& URxvt.imLocale: ja_JP.UTF-8 |
|
|
904 | \& URxvt.preeditType: OnTheSpot,None |
|
|
905 | .Ve |
|
|
906 | .PP |
|
|
907 | This tells rxvt-unicode to use a special locale when communicating with |
|
|
908 | the X Input Method, and also tells it to only use the OnTheSpot pre-edit |
|
|
909 | type, which requires the \f(CW\*(C`xim\-onthespot\*(C'\fR perl extension but rewards me |
|
|
910 | with correct-looking fonts. |
|
|
911 | .PP |
|
|
912 | .Vb 6 |
|
|
913 | \& URxvt.perl-lib: /root/lib/urxvt |
|
|
914 | \& URxvt.perl-ext-common: default,selection-autotransform,selection-pastebin,xim-onthespot,remote-clipboard |
|
|
915 | \& URxvt.selection.pattern-0: ( at .*? line \e\ed+) |
|
|
916 | \& URxvt.selection.pattern-1: ^(/[^:]+):\e |
|
|
917 | \& URxvt.selection-autotransform.0: s/^([^:[:space:]]+):(\e\ed+):?$/:e \e\eQ$1\e\eE\e\ex0d:$2\e\ex0d/ |
|
|
918 | \& URxvt.selection-autotransform.1: s/^ at (.*?) line (\e\ed+)$/:e \e\eQ$1\e\eE\e\ex0d:$2\e\ex0d/ |
|
|
919 | .Ve |
|
|
920 | .PP |
|
|
921 | This is my perl configuration. The first two set the perl library |
|
|
922 | directory and also tells urxvt to use a large number of extensions. I |
|
|
923 | develop for myself mostly, so I actually use most of the extensions I |
|
|
924 | write. |
|
|
925 | .PP |
|
|
926 | The selection stuff mainly makes the selection perl-error-message aware |
|
|
927 | and tells it to convert pelr error mssages into vi-commands to load the |
|
|
928 | relevant file and go tot he error line number. |
|
|
929 | .PP |
|
|
930 | .Vb 2 |
|
|
931 | \& URxvt.scrollstyle: plain |
|
|
932 | \& URxvt.secondaryScroll: true |
|
|
933 | .Ve |
|
|
934 | .PP |
|
|
935 | As the documentation says: plain is the preferred scrollbar for the |
|
|
936 | author. The \f(CW\*(C`secondaryScroll\*(C'\fR confgiures urxvt to scroll in full-screen |
|
|
937 | apps, like screen, so lines scorlled out of screen end up in urxvt's |
|
|
938 | scrollback buffer. |
|
|
939 | .PP |
|
|
940 | .Vb 7 |
|
|
941 | \& URxvt.background: #000000 |
|
|
942 | \& URxvt.foreground: gray90 |
|
|
943 | \& URxvt.color7: gray90 |
|
|
944 | \& URxvt.colorBD: #ffffff |
|
|
945 | \& URxvt.cursorColor: #e0e080 |
|
|
946 | \& URxvt.throughColor: #8080f0 |
|
|
947 | \& URxvt.highlightColor: #f0f0f0 |
|
|
948 | .Ve |
|
|
949 | .PP |
|
|
950 | Some colours. Not sure which ones are being used or even non\-defaults, but |
|
|
951 | these are in my .Xdefaults. Most notably, they set foreground/background |
|
|
952 | to light gray/black, and also make sure that the colour 7 matches the |
|
|
953 | default foreground colour. |
|
|
954 | .PP |
|
|
955 | .Vb 1 |
|
|
956 | \& URxvt.underlineColor: yellow |
|
|
957 | .Ve |
|
|
958 | .PP |
|
|
959 | Another colour, makes underline lines look different. Sometimes hurts, but |
|
|
960 | is mostly a nice effect. |
|
|
961 | .PP |
|
|
962 | .Vb 4 |
|
|
963 | \& URxvt.geometry: 154x36 |
|
|
964 | \& URxvt.loginShell: false |
|
|
965 | \& URxvt.meta: ignore |
|
|
966 | \& URxvt.utmpInhibit: true |
|
|
967 | .Ve |
|
|
968 | .PP |
|
|
969 | Uh, well, should be mostly self\-explanatory. By specifying some defaults |
|
|
970 | manually, I can quickly switch them for testing. |
|
|
971 | .PP |
|
|
972 | .Vb 1 |
|
|
973 | \& URxvt.saveLines: 8192 |
|
|
974 | .Ve |
|
|
975 | .PP |
|
|
976 | A large scrollback buffer is essential. Really. |
|
|
977 | .PP |
|
|
978 | .Vb 1 |
|
|
979 | \& URxvt.mapAlert: true |
|
|
980 | .Ve |
|
|
981 | .PP |
|
|
982 | The only case I use it is for my \s-1IRC\s0 window, which I like to keep |
|
|
983 | iconified till people msg me (which beeps). |
|
|
984 | .PP |
|
|
985 | .Vb 1 |
|
|
986 | \& URxvt.visualBell: true |
|
|
987 | .Ve |
|
|
988 | .PP |
|
|
989 | The audible bell is often annoying, especially when in a crowd. |
|
|
990 | .PP |
|
|
991 | .Vb 1 |
|
|
992 | \& URxvt.insecure: true |
|
|
993 | .Ve |
|
|
994 | .PP |
|
|
995 | Please don't hack my mutt! Ooops... |
|
|
996 | .PP |
|
|
997 | .Vb 1 |
|
|
998 | \& URxvt.pastableTabs: false |
|
|
999 | .Ve |
|
|
1000 | .PP |
|
|
1001 | I once thought this is a great idea. |
|
|
1002 | .PP |
|
|
1003 | .Vb 9 |
|
|
1004 | \& urxvt.font: 9x15bold,\e |
|
|
1005 | \& -misc-fixed-bold-r-normal--15-140-75-75-c-90-iso10646-1,\e |
|
|
1006 | \& -misc-fixed-medium-r-normal--15-140-75-75-c-90-iso10646-1, \e |
|
|
1007 | \& [codeset=JISX0208]xft:Kochi Gothic, \e |
|
|
1008 | \& xft:Bitstream Vera Sans Mono:autohint=true, \e |
|
|
1009 | \& xft:Code2000:antialias=false |
|
|
1010 | \& urxvt.boldFont: -xos4-terminus-bold-r-normal--14-140-72-72-c-80-iso8859-15 |
|
|
1011 | \& urxvt.italicFont: xft:Bitstream Vera Sans Mono:italic:autohint=true |
|
|
1012 | \& urxvt.boldItalicFont: xft:Bitstream Vera Sans Mono:bold:italic:autohint=true |
|
|
1013 | .Ve |
|
|
1014 | .PP |
|
|
1015 | I wrote rxvt-unicode to be able to specify fonts exactly. So don't be |
|
|
1016 | overwhelmed. A special note: the \f(CW\*(C`9x15bold\*(C'\fR mentioend above is actually |
|
|
1017 | the version from XFree\-3.3, as XFree\-4 replaced it by a totally different |
|
|
1018 | font (different glyphs for \f(CW\*(C`;\*(C'\fR and many other harmless characters), |
|
|
1019 | while the second font is actually the \f(CW\*(C`9x15bold\*(C'\fR from XFree4/XOrg. The |
|
|
1020 | bold version has less chars than the medium version, so I use it for rare |
|
|
1021 | characters, too. Whene ditign sources with vim, I use italic for comments |
|
|
1022 | and other stuff, which looks quite good with Bitstream Vera anti\-aliased. |
|
|
1023 | .PP |
|
|
1024 | Terminus is a quite bad font (many very wrong glyphs), but for most of my |
|
|
1025 | purposes, it works, and gives a different look, as my normal (Non\-bold) |
|
|
1026 | font is already bold, and I want to see a difference between bold and |
|
|
1027 | normal fonts. |
|
|
1028 | .PP |
|
|
1029 | Please note that I used the \f(CW\*(C`urxvt\*(C'\fR instance name and not the \f(CW\*(C`URxvt\*(C'\fR |
|
|
1030 | class name. Thats because I use different configs for different purposes, |
|
|
1031 | for example, my \s-1IRC\s0 window is started with \f(CW\*(C`\-name IRC\*(C'\fR, and uses these |
|
|
1032 | defaults: |
|
|
1033 | .PP |
|
|
1034 | .Vb 9 |
|
|
1035 | \& IRC*title: IRC |
|
|
1036 | \& IRC*geometry: 87x12+535+542 |
|
|
1037 | \& IRC*saveLines: 0 |
|
|
1038 | \& IRC*mapAlert: true |
|
|
1039 | \& IRC*font: suxuseuro |
|
|
1040 | \& IRC*boldFont: suxuseuro |
|
|
1041 | \& IRC*colorBD: white |
|
|
1042 | \& IRC*keysym.M-C-1: command:\e033]710;suxuseuro\e007\e033]711;suxuseuro\e007 |
|
|
1043 | \& IRC*keysym.M-C-2: command:\e033]710;9x15bold\e007\e033]711;9x15bold\e007 |
|
|
1044 | .Ve |
|
|
1045 | .PP |
|
|
1046 | \&\f(CW\*(C`Alt\-Shift\-1\*(C'\fR and \f(CW\*(C`Alt\-Shift\-2\*(C'\fR switch between two different font |
|
|
1047 | sizes. \f(CW\*(C`suxuseuro\*(C'\fR allows me to keep an eye (and actually read) |
|
|
1048 | stuff while keeping a very small window. If somebody pastes something |
|
|
1049 | complicated (e.g. japanese), I temporarily switch to a larger font. |
|
|
1050 | .PP |
|
|
1051 | The above is all in my \f(CW\*(C`.Xdefaults\*(C'\fR (I don't use \f(CW\*(C`.Xresources\*(C'\fR nor |
|
|
1052 | \&\f(CW\*(C`xrdb\*(C'\fR). I also have some resources in a separate \f(CW\*(C`.Xdefaults\-hostname\*(C'\fR |
|
|
1053 | file for different hosts, for example, on ym main desktop, I use: |
|
|
1054 | .PP |
|
|
1055 | .Vb 5 |
|
|
1056 | \& URxvt.keysym.C-M-q: command:\e033[3;5;5t |
|
|
1057 | \& URxvt.keysym.C-M-y: command:\e033[3;5;606t |
|
|
1058 | \& URxvt.keysym.C-M-e: command:\e033[3;1605;5t |
|
|
1059 | \& URxvt.keysym.C-M-c: command:\e033[3;1605;606t |
|
|
1060 | \& URxvt.keysym.C-M-p: perl:test |
|
|
1061 | .Ve |
|
|
1062 | .PP |
|
|
1063 | The first for keysym definitions allow me to quickly bring some windows |
|
|
1064 | in the layout I like most. Ion users might start laughing but will stop |
|
|
1065 | immediately when I tell them that I use my own Fvwm2 module for much the |
|
|
1066 | same effect as Ion provides, and I only very rarely use the above key |
|
|
1067 | combinations :\-> |
|
|
1068 | .PP |
863 | \fIWhy doesn't rxvt-unicode read my resources?\fR |
1069 | \fIWhy doesn't rxvt-unicode read my resources?\fR |
864 | .IX Subsection "Why doesn't rxvt-unicode read my resources?" |
1070 | .IX Subsection "Why doesn't rxvt-unicode read my resources?" |
865 | .PP |
1071 | .PP |
866 | Well, why, indeed? It does, in a way very similar to other X |
1072 | Well, why, indeed? It does, in a way very similar to other X |
867 | applications. Most importantly, this means that if you or your \s-1OS\s0 loads |
1073 | applications. Most importantly, this means that if you or your \s-1OS\s0 loads |
… | |
… | |
1030 | .PP |
1236 | .PP |
1031 | The best thing is to fix your startup environment, as you will likely run |
1237 | The best thing is to fix your startup environment, as you will likely run |
1032 | into other problems. If nothing works you can try this in your .profile. |
1238 | into other problems. If nothing works you can try this in your .profile. |
1033 | .PP |
1239 | .PP |
1034 | .Vb 1 |
1240 | .Vb 1 |
1035 | \& printf '\ee]701;%s\e007' "$LC_CTYPE" |
1241 | \& printf '\e33]701;%s\e007' "$LC_CTYPE" |
1036 | .Ve |
1242 | .Ve |
1037 | .PP |
1243 | .PP |
1038 | If this doesn't work, then maybe you use a \f(CW\*(C`LC_CTYPE\*(C'\fR specification not |
1244 | If this doesn't work, then maybe you use a \f(CW\*(C`LC_CTYPE\*(C'\fR specification not |
1039 | supported on your systems. Some systems have a \f(CW\*(C`locale\*(C'\fR command which |
1245 | supported on your systems. Some systems have a \f(CW\*(C`locale\*(C'\fR command which |
1040 | displays this (also, \f(CW\*(C`perl \-e0\*(C'\fR can be used to check locale settings, as |
1246 | displays this (also, \f(CW\*(C`perl \-e0\*(C'\fR can be used to check locale settings, as |
… | |
… | |
1097 | .PP |
1303 | .PP |
1098 | Yes, using an escape sequence. Try something like this, which sets |
1304 | Yes, using an escape sequence. Try something like this, which sets |
1099 | rxvt\-unicode's idea of \f(CW\*(C`LC_CTYPE\*(C'\fR. |
1305 | rxvt\-unicode's idea of \f(CW\*(C`LC_CTYPE\*(C'\fR. |
1100 | .PP |
1306 | .PP |
1101 | .Vb 1 |
1307 | .Vb 1 |
1102 | \& printf '\ee]701;%s\e007' ja_JP.SJIS |
1308 | \& printf '\e33]701;%s\e007' ja_JP.SJIS |
1103 | .Ve |
1309 | .Ve |
1104 | .PP |
1310 | .PP |
1105 | See also the previous answer. |
1311 | See also the previous answer. |
1106 | .PP |
1312 | .PP |
1107 | Sometimes this capability is rather handy when you want to work in |
1313 | Sometimes this capability is rather handy when you want to work in |
1108 | one locale (e.g. \f(CW\*(C`de_DE.UTF\-8\*(C'\fR) but some programs don't support it |
1314 | one locale (e.g. \f(CW\*(C`de_DE.UTF\-8\*(C'\fR) but some programs don't support it |
1109 | (e.g. \s-1UTF\-8\s0). For example, I use this script to start \f(CW\*(C`xjdic\*(C'\fR, which |
1315 | (e.g. \s-1UTF\-8\s0). For example, I use this script to start \f(CW\*(C`xjdic\*(C'\fR, which |
1110 | first switches to a locale supported by xjdic and back later: |
1316 | first switches to a locale supported by xjdic and back later: |
1111 | .PP |
1317 | .PP |
1112 | .Vb 3 |
1318 | .Vb 3 |
1113 | \& printf '\ee]701;%s\e007' ja_JP.SJIS |
1319 | \& printf '\e33]701;%s\e007' ja_JP.SJIS |
1114 | \& xjdic -js |
1320 | \& xjdic -js |
1115 | \& printf '\ee]701;%s\e007' de_DE.UTF-8 |
1321 | \& printf '\e33]701;%s\e007' de_DE.UTF-8 |
1116 | .Ve |
1322 | .Ve |
1117 | .PP |
1323 | .PP |
1118 | You can also use xterm's \f(CW\*(C`luit\*(C'\fR program, which usually works fine, except |
1324 | You can also use xterm's \f(CW\*(C`luit\*(C'\fR program, which usually works fine, except |
1119 | for some locales where character width differs between program\- and |
1325 | for some locales where character width differs between program\- and |
1120 | rxvt\-unicode\-locales. |
1326 | rxvt\-unicode\-locales. |
1121 | .PP |
1327 | .PP |
|
|
1328 | \fII have problems getting my input method working.\fR |
|
|
1329 | .IX Subsection "I have problems getting my input method working." |
|
|
1330 | .PP |
|
|
1331 | Try a search engine, as this is slightly different for every input method server. |
|
|
1332 | .PP |
|
|
1333 | Here is a checklist: |
|
|
1334 | .IP "\- Make sure your locale \fIand\fR the imLocale are supported on your \s-1OS\s0." 4 |
|
|
1335 | .IX Item "- Make sure your locale and the imLocale are supported on your OS." |
|
|
1336 | Try \f(CW\*(C`locale \-a\*(C'\fR or check the documentation for your \s-1OS\s0. |
|
|
1337 | .IP "\- Make sure your locale or imLocale matches a locale supported by your \s-1XIM\s0." 4 |
|
|
1338 | .IX Item "- Make sure your locale or imLocale matches a locale supported by your XIM." |
|
|
1339 | For example, \fBkinput2\fR does not support \s-1UTF\-8\s0 locales, you should use |
|
|
1340 | \&\f(CW\*(C`ja_JP.EUC\-JP\*(C'\fR or equivalent. |
|
|
1341 | .IP "\- Make sure your \s-1XIM\s0 server is actually running." 4 |
|
|
1342 | .IX Item "- Make sure your XIM server is actually running." |
|
|
1343 | .PD 0 |
|
|
1344 | .ie n .IP "\- Make sure the ""XMODIFIERS""\fR environment variable is set correctly when \fIstarting rxvt\-unicode." 4 |
|
|
1345 | .el .IP "\- Make sure the \f(CWXMODIFIERS\fR environment variable is set correctly when \fIstarting\fR rxvt\-unicode." 4 |
|
|
1346 | .IX Item "- Make sure the XMODIFIERS environment variable is set correctly when starting rxvt-unicode." |
|
|
1347 | .PD |
|
|
1348 | When you want to use e.g. \fBkinput2\fR, it must be set to |
|
|
1349 | \&\f(CW\*(C`@im=kinput2\*(C'\fR. For \fBscim\fR, use \f(CW\*(C`@im=SCIM\*(C'\fR. Youc an see what input |
|
|
1350 | method servers are running with this command: |
|
|
1351 | .Sp |
|
|
1352 | .Vb 1 |
|
|
1353 | \& xprop -root XIM_SERVERS |
|
|
1354 | .Ve |
|
|
1355 | .IP "*" 4 |
|
|
1356 | .PP |
1122 | \fIMy input method wants <some encoding> but I want \s-1UTF\-8\s0, what can I do?\fR |
1357 | \fIMy input method wants <some encoding> but I want \s-1UTF\-8\s0, what can I do?\fR |
1123 | .IX Subsection "My input method wants <some encoding> but I want UTF-8, what can I do?" |
1358 | .IX Subsection "My input method wants <some encoding> but I want UTF-8, what can I do?" |
1124 | .PP |
1359 | .PP |
1125 | You can specify separate locales for the input method and the rest of the |
1360 | You can specify separate locales for the input method and the rest of the |
1126 | terminal, using the resource \f(CW\*(C`imlocale\*(C'\fR: |
1361 | terminal, using the resource \f(CW\*(C`imlocale\*(C'\fR: |
… | |
… | |
1128 | .Vb 1 |
1363 | .Vb 1 |
1129 | \& URxvt.imlocale: ja_JP.EUC-JP |
1364 | \& URxvt.imlocale: ja_JP.EUC-JP |
1130 | .Ve |
1365 | .Ve |
1131 | .PP |
1366 | .PP |
1132 | Now you can start your terminal with \f(CW\*(C`LC_CTYPE=ja_JP.UTF\-8\*(C'\fR and still |
1367 | Now you can start your terminal with \f(CW\*(C`LC_CTYPE=ja_JP.UTF\-8\*(C'\fR and still |
1133 | use your input method. Please note, however, that you will not be able to |
1368 | use your input method. Please note, however, that, depending on your Xlib |
1134 | input characters outside \f(CW\*(C`EUC\-JP\*(C'\fR in a normal way then, as your input |
1369 | version, you may not be able to input characters outside \f(CW\*(C`EUC\-JP\*(C'\fR in a |
1135 | method limits you. |
1370 | normal way then, as your input method limits you. |
1136 | .PP |
1371 | .PP |
1137 | \fIRxvt-unicode crashes when the X Input Method changes or exits.\fR |
1372 | \fIRxvt-unicode crashes when the X Input Method changes or exits.\fR |
1138 | .IX Subsection "Rxvt-unicode crashes when the X Input Method changes or exits." |
1373 | .IX Subsection "Rxvt-unicode crashes when the X Input Method changes or exits." |
1139 | .PP |
1374 | .PP |
1140 | Unfortunately, this is unavoidable, as the \s-1XIM\s0 protocol is racy by |
1375 | Unfortunately, this is unavoidable, as the \s-1XIM\s0 protocol is racy by |
… | |
… | |
1266 | At the time of this writing, cygwin didn't seem to support any multi-byte |
1501 | At the time of this writing, cygwin didn't seem to support any multi-byte |
1267 | encodings (you might try \f(CW\*(C`LC_CTYPE=C\-UTF\-8\*(C'\fR), so you are likely limited |
1502 | encodings (you might try \f(CW\*(C`LC_CTYPE=C\-UTF\-8\*(C'\fR), so you are likely limited |
1268 | to 8\-bit encodings. |
1503 | to 8\-bit encodings. |
1269 | .SH "RXVT-UNICODE TECHNICAL REFERENCE" |
1504 | .SH "RXVT-UNICODE TECHNICAL REFERENCE" |
1270 | .IX Header "RXVT-UNICODE TECHNICAL REFERENCE" |
1505 | .IX Header "RXVT-UNICODE TECHNICAL REFERENCE" |
1271 | .SH "DESCRIPTION" |
|
|
1272 | .IX Header "DESCRIPTION" |
|
|
1273 | The rest of this document describes various technical aspects of |
1506 | The rest of this document describes various technical aspects of |
1274 | \&\fBrxvt-unicode\fR. First the description of supported command sequences, |
1507 | \&\fBrxvt-unicode\fR. First the description of supported command sequences, |
1275 | followed by pixmap support and last by a description of all features |
1508 | followed by pixmap support and last by a description of all features |
1276 | selectable at \f(CW\*(C`configure\*(C'\fR time. |
1509 | selectable at \f(CW\*(C`configure\*(C'\fR time. |
1277 | .SH "Definitions" |
1510 | .Sh "Definitions" |
1278 | .IX Header "Definitions" |
1511 | .IX Subsection "Definitions" |
1279 | .ie n .IP "\fB\fB""c""\fB\fR" 4 |
1512 | .ie n .IP "\fB\fB""c""\fB\fR" 4 |
1280 | .el .IP "\fB\f(CBc\fB\fR" 4 |
1513 | .el .IP "\fB\f(CBc\fB\fR" 4 |
1281 | .IX Item "c" |
1514 | .IX Item "c" |
1282 | The literal character c. |
1515 | The literal character c. |
1283 | .ie n .IP "\fB\fB""C""\fB\fR" 4 |
1516 | .ie n .IP "\fB\fB""C""\fB\fR" 4 |
… | |
… | |
1296 | parameters, separated by \f(CW\*(C`;\*(C'\fR character(s). |
1529 | parameters, separated by \f(CW\*(C`;\*(C'\fR character(s). |
1297 | .ie n .IP "\fB\fB""Pt""\fB\fR" 4 |
1530 | .ie n .IP "\fB\fB""Pt""\fB\fR" 4 |
1298 | .el .IP "\fB\f(CBPt\fB\fR" 4 |
1531 | .el .IP "\fB\f(CBPt\fB\fR" 4 |
1299 | .IX Item "Pt" |
1532 | .IX Item "Pt" |
1300 | A text parameter composed of printable characters. |
1533 | A text parameter composed of printable characters. |
1301 | .SH "Values" |
1534 | .Sh "Values" |
1302 | .IX Header "Values" |
1535 | .IX Subsection "Values" |
1303 | .ie n .IP "\fB\fB""ENQ""\fB\fR" 4 |
1536 | .ie n .IP "\fB\fB""ENQ""\fB\fR" 4 |
1304 | .el .IP "\fB\f(CBENQ\fB\fR" 4 |
1537 | .el .IP "\fB\f(CBENQ\fB\fR" 4 |
1305 | .IX Item "ENQ" |
1538 | .IX Item "ENQ" |
1306 | Enquiry (Ctrl\-E) = Send Device Attributes (\s-1DA\s0) |
1539 | Enquiry (Ctrl\-E) = Send Device Attributes (\s-1DA\s0) |
1307 | request attributes from terminal. See \fB\f(CB\*(C`ESC [ Ps c\*(C'\fB\fR. |
1540 | request attributes from terminal. See \fB\f(CB\*(C`ESC [ Ps c\*(C'\fB\fR. |
… | |
… | |
1345 | Switch to Standard Character Set |
1578 | Switch to Standard Character Set |
1346 | .ie n .IP "\fB\fB""SPC""\fB\fR" 4 |
1579 | .ie n .IP "\fB\fB""SPC""\fB\fR" 4 |
1347 | .el .IP "\fB\f(CBSPC\fB\fR" 4 |
1580 | .el .IP "\fB\f(CBSPC\fB\fR" 4 |
1348 | .IX Item "SPC" |
1581 | .IX Item "SPC" |
1349 | Space Character |
1582 | Space Character |
1350 | .SH "Escape Sequences" |
1583 | .Sh "Escape Sequences" |
1351 | .IX Header "Escape Sequences" |
1584 | .IX Subsection "Escape Sequences" |
1352 | .ie n .IP "\fB\fB""ESC # 8""\fB\fR" 4 |
1585 | .ie n .IP "\fB\fB""ESC # 8""\fB\fR" 4 |
1353 | .el .IP "\fB\f(CBESC # 8\fB\fR" 4 |
1586 | .el .IP "\fB\f(CBESC # 8\fB\fR" 4 |
1354 | .IX Item "ESC # 8" |
1587 | .IX Item "ESC # 8" |
1355 | \&\s-1DEC\s0 Screen Alignment Test (\s-1DECALN\s0) |
1588 | \&\s-1DEC\s0 Screen Alignment Test (\s-1DECALN\s0) |
1356 | .ie n .IP "\fB\fB""ESC 7""\fB\fR" 4 |
1589 | .ie n .IP "\fB\fB""ESC 7""\fB\fR" 4 |
… | |
… | |
1449 | .TE |
1682 | .TE |
1450 | |
1683 | |
1451 | .PP |
1684 | .PP |
1452 | |
1685 | |
1453 | .IX Xref "CSI" |
1686 | .IX Xref "CSI" |
1454 | .SH "CSI (Command Sequence Introducer) Sequences" |
1687 | .Sh "\s-1CSI\s0 (Command Sequence Introducer) Sequences" |
1455 | .IX Header "CSI (Command Sequence Introducer) Sequences" |
1688 | .IX Subsection "CSI (Command Sequence Introducer) Sequences" |
1456 | .ie n .IP "\fB\fB""ESC [ Ps @""\fB\fR" 4 |
1689 | .ie n .IP "\fB\fB""ESC [ Ps @""\fB\fR" 4 |
1457 | .el .IP "\fB\f(CBESC [ Ps @\fB\fR" 4 |
1690 | .el .IP "\fB\f(CBESC [ Ps @\fB\fR" 4 |
1458 | .IX Item "ESC [ Ps @" |
1691 | .IX Item "ESC [ Ps @" |
1459 | Insert \fB\f(CB\*(C`Ps\*(C'\fB\fR (Blank) Character(s) [default: 1] (\s-1ICH\s0) |
1692 | Insert \fB\f(CB\*(C`Ps\*(C'\fB\fR (Blank) Character(s) [default: 1] (\s-1ICH\s0) |
1460 | .IX Xref "ESCOBPsA" |
1693 | .IX Xref "ESCOBPsA" |
… | |
… | |
1723 | .IX Item "ESC [ Ps x" |
1956 | .IX Item "ESC [ Ps x" |
1724 | Request Terminal Parameters (\s-1DECREQTPARM\s0) |
1957 | Request Terminal Parameters (\s-1DECREQTPARM\s0) |
1725 | .PP |
1958 | .PP |
1726 | |
1959 | |
1727 | .IX Xref "PrivateModes" |
1960 | .IX Xref "PrivateModes" |
1728 | .SH "DEC Private Modes" |
1961 | .Sh "\s-1DEC\s0 Private Modes" |
1729 | .IX Header "DEC Private Modes" |
1962 | .IX Subsection "DEC Private Modes" |
1730 | .ie n .IP "\fB\fB""ESC [ ? Pm h""\fB\fR" 4 |
1963 | .ie n .IP "\fB\fB""ESC [ ? Pm h""\fB\fR" 4 |
1731 | .el .IP "\fB\f(CBESC [ ? Pm h\fB\fR" 4 |
1964 | .el .IP "\fB\f(CBESC [ ? Pm h\fB\fR" 4 |
1732 | .IX Item "ESC [ ? Pm h" |
1965 | .IX Item "ESC [ ? Pm h" |
1733 | \&\s-1DEC\s0 Private Mode Set (\s-1DECSET\s0) |
1966 | \&\s-1DEC\s0 Private Mode Set (\s-1DECSET\s0) |
1734 | .ie n .IP "\fB\fB""ESC [ ? Pm l""\fB\fR" 4 |
1967 | .ie n .IP "\fB\fB""ESC [ ? Pm l""\fB\fR" 4 |
… | |
… | |
2001 | .RE |
2234 | .RE |
2002 | .PD |
2235 | .PD |
2003 | .PP |
2236 | .PP |
2004 | |
2237 | |
2005 | .IX Xref "XTerm" |
2238 | .IX Xref "XTerm" |
2006 | .SH "XTerm Operating System Commands" |
2239 | .Sh "XTerm Operating System Commands" |
2007 | .IX Header "XTerm Operating System Commands" |
2240 | .IX Subsection "XTerm Operating System Commands" |
2008 | .ie n .IP "\fB\fB""ESC ] Ps;Pt ST""\fB\fR" 4 |
2241 | .ie n .IP "\fB\fB""ESC ] Ps;Pt ST""\fB\fR" 4 |
2009 | .el .IP "\fB\f(CBESC ] Ps;Pt ST\fB\fR" 4 |
2242 | .el .IP "\fB\f(CBESC ] Ps;Pt ST\fB\fR" 4 |
2010 | .IX Item "ESC ] Ps;Pt ST" |
2243 | .IX Item "ESC ] Ps;Pt ST" |
2011 | Set XTerm Parameters. 8\-bit \s-1ST:\s0 0x9c, 7\-bit \s-1ST\s0 sequence: \s-1ESC\s0 \e (0x1b, |
2244 | Set XTerm Parameters. 8\-bit \s-1ST:\s0 0x9c, 7\-bit \s-1ST\s0 sequence: \s-1ESC\s0 \e (0x1b, |
2012 | 0x5c), backwards compatible terminator \s-1BEL\s0 (0x07) is also accepted. any |
2245 | 0x5c), backwards compatible terminator \s-1BEL\s0 (0x07) is also accepted. any |
… | |
… | |
2044 | Ps = 720 Move viewing window up by Pt lines, or clear scrollback buffer if Pt = 0 (Compile frills). |
2277 | Ps = 720 Move viewing window up by Pt lines, or clear scrollback buffer if Pt = 0 (Compile frills). |
2045 | Ps = 721 Move viewing window down by Pt lines, or clear scrollback buffer if Pt = 0 (Compile frills). |
2278 | Ps = 721 Move viewing window down by Pt lines, or clear scrollback buffer if Pt = 0 (Compile frills). |
2046 | Ps = 777 Call the perl extension with the given string, which should be of the form extension:parameters (Compile perl). |
2279 | Ps = 777 Call the perl extension with the given string, which should be of the form extension:parameters (Compile perl). |
2047 | .TE |
2280 | .TE |
2048 | |
2281 | |
2049 | .PP |
|
|
2050 | |
|
|
2051 | .IX Xref "XPM" |
|
|
2052 | .SH "XPM" |
2282 | .SH "XPM" |
2053 | .IX Header "XPM" |
2283 | .IX Header "XPM" |
2054 | For the \s-1XPM\s0 XTerm escape sequence \fB\f(CB\*(C`ESC ] 20 ; Pt ST\*(C'\fB\fR then value |
2284 | For the \s-1XPM\s0 XTerm escape sequence \fB\f(CB\*(C`ESC ] 20 ; Pt ST\*(C'\fB\fR then value |
2055 | of \fB\f(CB\*(C`Pt\*(C'\fB\fR can be the name of the background pixmap followed by a |
2285 | of \fB\f(CB\*(C`Pt\*(C'\fB\fR can be the name of the background pixmap followed by a |
2056 | sequence of scaling/positioning commands separated by semi\-colons. The |
2286 | sequence of scaling/positioning commands separated by semi\-colons. The |
… | |
… | |
2425 | .IX Item "--disable-new-selection" |
2655 | .IX Item "--disable-new-selection" |
2426 | Remove support for mouse selection style like that of xterm. |
2656 | Remove support for mouse selection style like that of xterm. |
2427 | .IP "\-\-enable\-dmalloc (default: off)" 4 |
2657 | .IP "\-\-enable\-dmalloc (default: off)" 4 |
2428 | .IX Item "--enable-dmalloc (default: off)" |
2658 | .IX Item "--enable-dmalloc (default: off)" |
2429 | Use Gray Watson's malloc \- which is good for debugging See |
2659 | Use Gray Watson's malloc \- which is good for debugging See |
2430 | http://www.letters.com/dmalloc/ for details If you use either this or the |
2660 | <http://www.letters.com/dmalloc/> for details If you use either this or the |
2431 | next option, you may need to edit src/Makefile after compiling to point |
2661 | next option, you may need to edit src/Makefile after compiling to point |
2432 | \&\s-1DINCLUDE\s0 and \s-1DLIB\s0 to the right places. |
2662 | \&\s-1DINCLUDE\s0 and \s-1DLIB\s0 to the right places. |
2433 | .Sp |
2663 | .Sp |
2434 | You can only use either this option and the following (should |
2664 | You can only use either this option and the following (should |
2435 | you use either) . |
2665 | you use either) . |