… | |
… | |
32 | =head3 My question isn't answered here, can I ask a human? |
32 | =head3 My question isn't answered here, can I ask a human? |
33 | |
33 | |
34 | Before sending me mail, you could go to IRC: C<irc.freenode.net>, |
34 | Before sending me mail, you could go to IRC: C<irc.freenode.net>, |
35 | channel C<#rxvt-unicode> has some rxvt-unicode enthusiasts that might be |
35 | channel C<#rxvt-unicode> has some rxvt-unicode enthusiasts that might be |
36 | interested in learning about new and exciting problems (but not FAQs :). |
36 | interested in learning about new and exciting problems (but not FAQs :). |
|
|
37 | |
|
|
38 | =head3 I use Gentoo, and I have a problem... |
|
|
39 | |
|
|
40 | There are three big problems with Gentoo Linux: first of all, most if not |
|
|
41 | all Gentoo systems are completely broken (missing or mismatched header |
|
|
42 | files, broken compiler etc. are just the tip of the iceberg); secondly, |
|
|
43 | the Gentoo maintainer thinks it is a good idea to add broken patches to |
|
|
44 | the code; and lastly, it should be called Gentoo GNU/Linux. |
|
|
45 | |
|
|
46 | For these reasons, it is impossible to support rxvt-unicode on |
|
|
47 | Gentoo. Problems appearing on Gentoo systems will usually simply be |
|
|
48 | ignored unless they can be reproduced on non-Gentoo systems. |
37 | |
49 | |
38 | =head3 Does it support tabs, can I have a tabbed rxvt-unicode? |
50 | =head3 Does it support tabs, can I have a tabbed rxvt-unicode? |
39 | |
51 | |
40 | Beginning with version 7.3, there is a perl extension that implements a |
52 | Beginning with version 7.3, there is a perl extension that implements a |
41 | simple tabbed terminal. It is installed by default, so any of these should |
53 | simple tabbed terminal. It is installed by default, so any of these should |
… | |
… | |
798 | IRC*boldFont: suxuseuro |
810 | IRC*boldFont: suxuseuro |
799 | IRC*colorBD: white |
811 | IRC*colorBD: white |
800 | IRC*keysym.M-C-1: command:\033]710;suxuseuro\007\033]711;suxuseuro\007 |
812 | IRC*keysym.M-C-1: command:\033]710;suxuseuro\007\033]711;suxuseuro\007 |
801 | IRC*keysym.M-C-2: command:\033]710;9x15bold\007\033]711;9x15bold\007 |
813 | IRC*keysym.M-C-2: command:\033]710;9x15bold\007\033]711;9x15bold\007 |
802 | |
814 | |
803 | C<Alt-Shift-1> and C<Alt-Shift-2> switch between two different font |
815 | C<Alt-Ctrl-1> and C<Alt-Ctrl-2> switch between two different font |
804 | sizes. C<suxuseuro> allows me to keep an eye (and actually read) |
816 | sizes. C<suxuseuro> allows me to keep an eye (and actually read) |
805 | stuff while keeping a very small window. If somebody pastes something |
817 | stuff while keeping a very small window. If somebody pastes something |
806 | complicated (e.g. japanese), I temporarily switch to a larger font. |
818 | complicated (e.g. japanese), I temporarily switch to a larger font. |
807 | |
819 | |
808 | The above is all in my C<.Xdefaults> (I don't use C<.Xresources> nor |
820 | The above is all in my C<.Xdefaults> (I don't use C<.Xresources> nor |
… | |
… | |
845 | |
857 | |
846 | The terminal description used by rxvt-unicode is not as widely available |
858 | The terminal description used by rxvt-unicode is not as widely available |
847 | as that for xterm, or even rxvt (for which the same problem often arises). |
859 | as that for xterm, or even rxvt (for which the same problem often arises). |
848 | |
860 | |
849 | The correct solution for this problem is to install the terminfo, this can |
861 | The correct solution for this problem is to install the terminfo, this can |
850 | be done like this (with ncurses' infocmp and works as user and admin): |
862 | be done by simply installing rxvt-unicode on the remote system as well |
|
|
863 | (in case you have a nice package manager ready), or you can install the |
|
|
864 | terminfo database manually like this (with ncurses infocmp. works as |
|
|
865 | user and root): |
851 | |
866 | |
852 | REMOTE=remotesystem.domain |
867 | REMOTE=remotesystem.domain |
853 | infocmp rxvt-unicode | ssh $REMOTE "mkdir -p .terminfo && cat >/tmp/ti && tic /tmp/ti" |
868 | infocmp rxvt-unicode | ssh $REMOTE "mkdir -p .terminfo && cat >/tmp/ti && tic /tmp/ti" |
854 | |
|
|
855 | ... or by installing rxvt-unicode normally on the remote system, |
|
|
856 | |
869 | |
857 | One some systems you might need to set C<$TERMINFO> to the full path of |
870 | One some systems you might need to set C<$TERMINFO> to the full path of |
858 | F<$HOME/.terminfo> for this to work. |
871 | F<$HOME/.terminfo> for this to work. |
859 | |
872 | |
860 | If you cannot or do not want to do this, then you can simply set |
873 | If you cannot or do not want to do this, then you can simply set |
… | |
… | |
870 | URxvt.termName: rxvt |
883 | URxvt.termName: rxvt |
871 | |
884 | |
872 | If you don't plan to use B<rxvt> (quite common...) you could also replace |
885 | If you don't plan to use B<rxvt> (quite common...) you could also replace |
873 | the rxvt terminfo file with the rxvt-unicode one and use C<TERM=rxvt>. |
886 | the rxvt terminfo file with the rxvt-unicode one and use C<TERM=rxvt>. |
874 | |
887 | |
|
|
888 | =head3 nano fails with "Error opening terminal: rxvt-unicode" |
|
|
889 | |
|
|
890 | This exceptionally confusing and useless error message is printed by nano |
|
|
891 | when it can't find the terminfo database. Nothing is wrong with your |
|
|
892 | terminal, read the previous answer for a solution. |
|
|
893 | |
875 | =head3 C<tic> outputs some error when compiling the terminfo entry. |
894 | =head3 C<tic> outputs some error when compiling the terminfo entry. |
876 | |
895 | |
877 | Most likely it's the empty definition for C<enacs=>. Just replace it by |
896 | Most likely it's the empty definition for C<enacs=>. Just replace it by |
878 | C<enacs=\E[0@> and try again. |
897 | C<enacs=\E[0@> and try again. |
879 | |
898 | |
… | |
… | |
892 | You can also create a termcap entry by using terminfo's infocmp program |
911 | You can also create a termcap entry by using terminfo's infocmp program |
893 | like this: |
912 | like this: |
894 | |
913 | |
895 | infocmp -C rxvt-unicode |
914 | infocmp -C rxvt-unicode |
896 | |
915 | |
897 | Or you could use this termcap entry, generated by the command above: |
916 | Or you could use the termcap entry in doc/etc/rxvt-unicode.termcap, |
898 | |
917 | generated by the command above. |
899 | rxvt-unicode|rxvt-unicode terminal (X Window System):\ |
|
|
900 | :am:bw:eo:km:mi:ms:xn:xo:\ |
|
|
901 | :co#80:it#8:li#24:lm#0:\ |
|
|
902 | :AL=\E[%dL:DC=\E[%dP:DL=\E[%dM:DO=\E[%dB:IC=\E[%d@:\ |
|
|
903 | :K1=\EOw:K2=\EOu:K3=\EOy:K4=\EOq:K5=\EOs:LE=\E[%dD:\ |
|
|
904 | :RI=\E[%dC:SF=\E[%dS:SR=\E[%dT:UP=\E[%dA:ae=\E(B:al=\E[L:\ |
|
|
905 | :as=\E(0:bl=^G:cd=\E[J:ce=\E[K:cl=\E[H\E[2J:\ |
|
|
906 | :cm=\E[%i%d;%dH:cr=^M:cs=\E[%i%d;%dr:ct=\E[3g:dc=\E[P:\ |
|
|
907 | :dl=\E[M:do=^J:ec=\E[%dX:ei=\E[4l:ho=\E[H:\ |
|
|
908 | :i1=\E[?47l\E=\E[?1l:ic=\E[@:im=\E[4h:\ |
|
|
909 | :is=\E[r\E[m\E[2J\E[H\E[?7h\E[?1;3;4;6l\E[4l:\ |
|
|
910 | :k1=\E[11~:k2=\E[12~:k3=\E[13~:k4=\E[14~:k5=\E[15~:\ |
|
|
911 | :k6=\E[17~:k7=\E[18~:k8=\E[19~:k9=\E[20~:kD=\E[3~:\ |
|
|
912 | :kI=\E[2~:kN=\E[6~:kP=\E[5~:kb=\177:kd=\EOB:ke=\E[?1l\E>:\ |
|
|
913 | :kh=\E[7~:kl=\EOD:kr=\EOC:ks=\E[?1h\E=:ku=\EOA:le=^H:\ |
|
|
914 | :mb=\E[5m:md=\E[1m:me=\E[m\017:mr=\E[7m:nd=\E[C:rc=\E8:\ |
|
|
915 | :sc=\E7:se=\E[27m:sf=^J:so=\E[7m:sr=\EM:st=\EH:ta=^I:\ |
|
|
916 | :te=\E[r\E[?1049l:ti=\E[?1049h:ue=\E[24m:up=\E[A:\ |
|
|
917 | :us=\E[4m:vb=\E[?5h\E[?5l:ve=\E[?25h:vi=\E[?25l:\ |
|
|
918 | :vs=\E[?25h: |
|
|
919 | |
918 | |
920 | =head3 Why does C<ls> no longer have coloured output? |
919 | =head3 Why does C<ls> no longer have coloured output? |
921 | |
920 | |
922 | The C<ls> in the GNU coreutils unfortunately doesn't use terminfo to |
921 | The C<ls> in the GNU coreutils unfortunately doesn't use terminfo to |
923 | decide whether a terminal has colour, but uses its own configuration |
922 | decide whether a terminal has colour, but uses its own configuration |
… | |
… | |
1170 | As you might have guessed, FreeBSD does neither define this symbol nor |
1169 | As you might have guessed, FreeBSD does neither define this symbol nor |
1171 | does it support it. Instead, it uses its own internal representation of |
1170 | does it support it. Instead, it uses its own internal representation of |
1172 | B<wchar_t>. This is, of course, completely fine with respect to standards. |
1171 | B<wchar_t>. This is, of course, completely fine with respect to standards. |
1173 | |
1172 | |
1174 | However, that means rxvt-unicode only works in C<POSIX>, C<ISO-8859-1> and |
1173 | However, that means rxvt-unicode only works in C<POSIX>, C<ISO-8859-1> and |
1175 | C<UTF-8> locales under FreeBSD (which all use Unicode as B<wchar_t>. |
1174 | C<UTF-8> locales under FreeBSD (which all use Unicode as B<wchar_t>). |
1176 | |
1175 | |
1177 | C<__STDC_ISO_10646__> is the only sane way to support multi-language |
1176 | C<__STDC_ISO_10646__> is the only sane way to support multi-language |
1178 | apps in an OS, as using a locale-dependent (and non-standardized) |
1177 | apps in an OS, as using a locale-dependent (and non-standardized) |
1179 | representation of B<wchar_t> makes it impossible to convert between |
1178 | representation of B<wchar_t> makes it impossible to convert between |
1180 | B<wchar_t> (as used by X11 and your applications) and any other encoding |
1179 | B<wchar_t> (as used by X11 and your applications) and any other encoding |
… | |
… | |
1216 | The solution is to upgrade your system or switch to a better one. A |
1215 | The solution is to upgrade your system or switch to a better one. A |
1217 | possibly working workaround is to use a wcwidth implementation like |
1216 | possibly working workaround is to use a wcwidth implementation like |
1218 | |
1217 | |
1219 | http://www.cl.cam.ac.uk/~mgk25/ucs/wcwidth.c |
1218 | http://www.cl.cam.ac.uk/~mgk25/ucs/wcwidth.c |
1220 | |
1219 | |
|
|
1220 | =head3 I want 256 colors |
|
|
1221 | |
|
|
1222 | Are you sure you need 256 colors? 88 colors should be enough for most |
|
|
1223 | purposes. If you really need more, there is an unsupported patch for |
|
|
1224 | it in the doc directory, but please do not ask for it to be applied. |
|
|
1225 | |
1221 | =head1 RXVT-UNICODE TECHNICAL REFERENCE |
1226 | =head1 RXVT-UNICODE TECHNICAL REFERENCE |
1222 | |
1227 | |
1223 | The rest of this document describes various technical aspects of |
1228 | The rest of this document describes various technical aspects of |
1224 | B<rxvt-unicode>. First the description of supported command sequences, |
1229 | B<rxvt-unicode>. First the description of supported command sequences, |
1225 | followed by pixmap support and last by a description of all features |
1230 | followed by pixmap support and last by a description of all features |
… | |
… | |
1477 | =begin table |
1482 | =begin table |
1478 | |
1483 | |
1479 | B<< C<Ps = 0> >> Clear to Right (default) |
1484 | B<< C<Ps = 0> >> Clear to Right (default) |
1480 | B<< C<Ps = 1> >> Clear to Left |
1485 | B<< C<Ps = 1> >> Clear to Left |
1481 | B<< C<Ps = 2> >> Clear All |
1486 | B<< C<Ps = 2> >> Clear All |
|
|
1487 | B<< C<Ps = 3> >> Like Ps = 0, but is ignored when wrapped |
|
|
1488 | (@@RXVT_NAME@@ extension) |
1482 | |
1489 | |
1483 | =end table |
1490 | =end table |
1484 | |
1491 | |
1485 | =item B<< C<ESC [ Ps L> >> |
1492 | =item B<< C<ESC [ Ps L> >> |
1486 | |
1493 | |
… | |
… | |
2029 | B<< C<Ps = 702> >> Request version if B<< C<Pt> >> is B<< C<?> >>, returning C<rxvt-unicode>, the resource name, the major and minor version numbers, e.g. C<ESC ] 702 ; rxvt-unicode ; urxvt ; 7 ; 4 ST>. |
2036 | B<< C<Ps = 702> >> Request version if B<< C<Pt> >> is B<< C<?> >>, returning C<rxvt-unicode>, the resource name, the major and minor version numbers, e.g. C<ESC ] 702 ; rxvt-unicode ; urxvt ; 7 ; 4 ST>. |
2030 | B<< C<Ps = 704> >> Change colour of italic characters to B<< C<Pt> >> |
2037 | B<< C<Ps = 704> >> Change colour of italic characters to B<< C<Pt> >> |
2031 | B<< C<Ps = 705> >> Change background pixmap tint colour to B<< C<Pt> >> (Compile transparency). |
2038 | B<< C<Ps = 705> >> Change background pixmap tint colour to B<< C<Pt> >> (Compile transparency). |
2032 | B<< C<Ps = 706> >> Change colour of bold characters to B<< C<Pt> >> |
2039 | B<< C<Ps = 706> >> Change colour of bold characters to B<< C<Pt> >> |
2033 | B<< C<Ps = 707> >> Change colour of underlined characters to B<< C<Pt> >> |
2040 | B<< C<Ps = 707> >> Change colour of underlined characters to B<< C<Pt> >> |
|
|
2041 | B<< C<Ps = 708> >> Change colour of the border to B<< C<Pt> >> |
2034 | B<< C<Ps = 710> >> Set normal fontset to B<< C<Pt> >>. Same as C<Ps = 50>. |
2042 | B<< C<Ps = 710> >> Set normal fontset to B<< C<Pt> >>. Same as C<Ps = 50>. |
2035 | B<< C<Ps = 711> >> Set bold fontset to B<< C<Pt> >>. Similar to C<Ps = 50> (Compile styles). |
2043 | B<< C<Ps = 711> >> Set bold fontset to B<< C<Pt> >>. Similar to C<Ps = 50> (Compile styles). |
2036 | B<< C<Ps = 712> >> Set italic fontset to B<< C<Pt> >>. Similar to C<Ps = 50> (Compile styles). |
2044 | B<< C<Ps = 712> >> Set italic fontset to B<< C<Pt> >>. Similar to C<Ps = 50> (Compile styles). |
2037 | B<< C<Ps = 713> >> Set bold-italic fontset to B<< C<Pt> >>. Similar to C<Ps = 50> (Compile styles). |
2045 | B<< C<Ps = 713> >> Set bold-italic fontset to B<< C<Pt> >>. Similar to C<Ps = 50> (Compile styles). |
2038 | B<< C<Ps = 720> >> Move viewing window up by B<< C<Pt> >> lines, or clear scrollback buffer if C<Pt = 0> (Compile frills). |
2046 | B<< C<Ps = 720> >> Move viewing window up by B<< C<Pt> >> lines, or clear scrollback buffer if C<Pt = 0> (Compile frills). |
… | |
… | |
2433 | settable extra linespacing /-lsp) |
2441 | settable extra linespacing /-lsp) |
2434 | iso-14755 5.1 (basic) support |
2442 | iso-14755 5.1 (basic) support |
2435 | tripleclickwords (-tcw) |
2443 | tripleclickwords (-tcw) |
2436 | settable insecure mode (-insecure) |
2444 | settable insecure mode (-insecure) |
2437 | keysym remapping support |
2445 | keysym remapping support |
2438 | cursor blinking and underline cursor (-cb, -uc) |
2446 | cursor blinking and underline cursor (-bc, -uc) |
2439 | XEmbed support (-embed) |
2447 | XEmbed support (-embed) |
2440 | user-pty (-pty-fd) |
2448 | user-pty (-pty-fd) |
2441 | hold on exit (-hold) |
2449 | hold on exit (-hold) |
2442 | compile in built-in block graphics |
2450 | compile in built-in block graphics |
2443 | skip builtin block graphics (-sbg) |
2451 | skip builtin block graphics (-sbg) |