| … | |
… | |
| 17 | |
17 | |
| 18 | This document contains the FAQ, the RXVT TECHNICAL REFERENCE documenting |
18 | This document contains the FAQ, the RXVT TECHNICAL REFERENCE documenting |
| 19 | all escape sequences, and other background information. |
19 | all escape sequences, and other background information. |
| 20 | |
20 | |
| 21 | The newest version of this document is also available on the World Wide Web at |
21 | The newest version of this document is also available on the World Wide Web at |
| 22 | L<http://cvs.schmorp.de/browse/rxvt-unicode/doc/rxvt.7.html>. |
22 | L<http://pod.tst.eu/http://cvs.schmorp.de/rxvt-unicode/doc/rxvt.7.pod>. |
|
|
23 | |
|
|
24 | The main manual page for @@RXVT_NAME@@ itself is available at |
|
|
25 | L<http://pod.tst.eu/http://cvs.schmorp.de/rxvt-unicode/doc/rxvt.1.pod>. |
| 23 | |
26 | |
| 24 | =head1 RXVT-UNICODE/URXVT FREQUENTLY ASKED QUESTIONS |
27 | =head1 RXVT-UNICODE/URXVT FREQUENTLY ASKED QUESTIONS |
| 25 | |
28 | |
| 26 | |
29 | |
| 27 | =head2 Meta, Features & Commandline Issues |
30 | =head2 Meta, Features & Commandline Issues |
| … | |
… | |
| 29 | =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? |
| 30 | |
33 | |
| 31 | 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>, |
| 32 | 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 |
| 33 | 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. |
| 34 | |
49 | |
| 35 | =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? |
| 36 | |
51 | |
| 37 | 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 |
| 38 | 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 |
| … | |
… | |
| 481 | |
496 | |
| 482 | To get a selection that is very similar to the old code, try this pattern: |
497 | To get a selection that is very similar to the old code, try this pattern: |
| 483 | |
498 | |
| 484 | URxvt.selection.pattern-0: ([^"&'()*,;<=>?@[\\\\]^`{|})]+) |
499 | URxvt.selection.pattern-0: ([^"&'()*,;<=>?@[\\\\]^`{|})]+) |
| 485 | |
500 | |
| 486 | Please also note that the I<LeftClick Shift-LeftClik> combination also |
501 | Please also note that the I<LeftClick Shift-LeftClick> combination also |
| 487 | selects words like the old code. |
502 | selects words like the old code. |
| 488 | |
503 | |
| 489 | =head3 I don't like the new selection/popups/hotkeys/perl, how do I change/disable it? |
504 | =head3 I don't like the new selection/popups/hotkeys/perl, how do I change/disable it? |
| 490 | |
505 | |
| 491 | You can disable the perl extension completely by setting the |
506 | You can disable the perl extension completely by setting the |
| … | |
… | |
| 795 | IRC*boldFont: suxuseuro |
810 | IRC*boldFont: suxuseuro |
| 796 | IRC*colorBD: white |
811 | IRC*colorBD: white |
| 797 | 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 |
| 798 | 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 |
| 799 | |
814 | |
| 800 | 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 |
| 801 | 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) |
| 802 | stuff while keeping a very small window. If somebody pastes something |
817 | stuff while keeping a very small window. If somebody pastes something |
| 803 | complicated (e.g. japanese), I temporarily switch to a larger font. |
818 | complicated (e.g. japanese), I temporarily switch to a larger font. |
| 804 | |
819 | |
| 805 | 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 |
| … | |
… | |
| 842 | |
857 | |
| 843 | 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 |
| 844 | 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). |
| 845 | |
860 | |
| 846 | 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 |
| 847 | 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): |
| 848 | |
866 | |
| 849 | REMOTE=remotesystem.domain |
867 | REMOTE=remotesystem.domain |
| 850 | 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" |
| 851 | |
|
|
| 852 | ... or by installing rxvt-unicode normally on the remote system, |
|
|
| 853 | |
869 | |
| 854 | 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 |
| 855 | F<$HOME/.terminfo> for this to work. |
871 | F<$HOME/.terminfo> for this to work. |
| 856 | |
872 | |
| 857 | 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 |
| … | |
… | |
| 867 | URxvt.termName: rxvt |
883 | URxvt.termName: rxvt |
| 868 | |
884 | |
| 869 | 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 |
| 870 | 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>. |
| 871 | |
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 | |
| 872 | =head3 C<tic> outputs some error when compiling the terminfo entry. |
894 | =head3 C<tic> outputs some error when compiling the terminfo entry. |
| 873 | |
895 | |
| 874 | 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 |
| 875 | C<enacs=\E[0@> and try again. |
897 | C<enacs=\E[0@> and try again. |
| 876 | |
898 | |
| … | |
… | |
| 889 | 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 |
| 890 | like this: |
912 | like this: |
| 891 | |
913 | |
| 892 | infocmp -C rxvt-unicode |
914 | infocmp -C rxvt-unicode |
| 893 | |
915 | |
| 894 | 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, |
| 895 | |
917 | generated by the command above. |
| 896 | rxvt-unicode|rxvt-unicode terminal (X Window System):\ |
|
|
| 897 | :am:bw:eo:km:mi:ms:xn:xo:\ |
|
|
| 898 | :co#80:it#8:li#24:lm#0:\ |
|
|
| 899 | :AL=\E[%dL:DC=\E[%dP:DL=\E[%dM:DO=\E[%dB:IC=\E[%d@:\ |
|
|
| 900 | :K1=\EOw:K2=\EOu:K3=\EOy:K4=\EOq:K5=\EOs:LE=\E[%dD:\ |
|
|
| 901 | :RI=\E[%dC:SF=\E[%dS:SR=\E[%dT:UP=\E[%dA:ae=\E(B:al=\E[L:\ |
|
|
| 902 | :as=\E(0:bl=^G:cd=\E[J:ce=\E[K:cl=\E[H\E[2J:\ |
|
|
| 903 | :cm=\E[%i%d;%dH:cr=^M:cs=\E[%i%d;%dr:ct=\E[3g:dc=\E[P:\ |
|
|
| 904 | :dl=\E[M:do=^J:ec=\E[%dX:ei=\E[4l:ho=\E[H:\ |
|
|
| 905 | :i1=\E[?47l\E=\E[?1l:ic=\E[@:im=\E[4h:\ |
|
|
| 906 | :is=\E[r\E[m\E[2J\E[H\E[?7h\E[?1;3;4;6l\E[4l:\ |
|
|
| 907 | :k1=\E[11~:k2=\E[12~:k3=\E[13~:k4=\E[14~:k5=\E[15~:\ |
|
|
| 908 | :k6=\E[17~:k7=\E[18~:k8=\E[19~:k9=\E[20~:kD=\E[3~:\ |
|
|
| 909 | :kI=\E[2~:kN=\E[6~:kP=\E[5~:kb=\177:kd=\EOB:ke=\E[?1l\E>:\ |
|
|
| 910 | :kh=\E[7~:kl=\EOD:kr=\EOC:ks=\E[?1h\E=:ku=\EOA:le=^H:\ |
|
|
| 911 | :mb=\E[5m:md=\E[1m:me=\E[m\017:mr=\E[7m:nd=\E[C:rc=\E8:\ |
|
|
| 912 | :sc=\E7:se=\E[27m:sf=^J:so=\E[7m:sr=\EM:st=\EH:ta=^I:\ |
|
|
| 913 | :te=\E[r\E[?1049l:ti=\E[?1049h:ue=\E[24m:up=\E[A:\ |
|
|
| 914 | :us=\E[4m:vb=\E[?5h\E[?5l:ve=\E[?25h:vi=\E[?25l:\ |
|
|
| 915 | :vs=\E[?25h: |
|
|
| 916 | |
918 | |
| 917 | =head3 Why does C<ls> no longer have coloured output? |
919 | =head3 Why does C<ls> no longer have coloured output? |
| 918 | |
920 | |
| 919 | 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 |
| 920 | decide whether a terminal has colour, but uses its own configuration |
922 | decide whether a terminal has colour, but uses its own configuration |
| … | |
… | |
| 1167 | 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 |
| 1168 | 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 |
| 1169 | 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. |
| 1170 | |
1172 | |
| 1171 | 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 |
| 1172 | 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>). |
| 1173 | |
1175 | |
| 1174 | 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 |
| 1175 | 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) |
| 1176 | representation of B<wchar_t> makes it impossible to convert between |
1178 | representation of B<wchar_t> makes it impossible to convert between |
| 1177 | 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 |
| … | |
… | |
| 1213 | 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 |
| 1214 | possibly working workaround is to use a wcwidth implementation like |
1216 | possibly working workaround is to use a wcwidth implementation like |
| 1215 | |
1217 | |
| 1216 | http://www.cl.cam.ac.uk/~mgk25/ucs/wcwidth.c |
1218 | http://www.cl.cam.ac.uk/~mgk25/ucs/wcwidth.c |
| 1217 | |
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 | |
| 1218 | =head1 RXVT-UNICODE TECHNICAL REFERENCE |
1226 | =head1 RXVT-UNICODE TECHNICAL REFERENCE |
| 1219 | |
1227 | |
| 1220 | The rest of this document describes various technical aspects of |
1228 | The rest of this document describes various technical aspects of |
| 1221 | B<rxvt-unicode>. First the description of supported command sequences, |
1229 | B<rxvt-unicode>. First the description of supported command sequences, |
| 1222 | 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 |
| … | |
… | |
| 1474 | =begin table |
1482 | =begin table |
| 1475 | |
1483 | |
| 1476 | B<< C<Ps = 0> >> Clear to Right (default) |
1484 | B<< C<Ps = 0> >> Clear to Right (default) |
| 1477 | B<< C<Ps = 1> >> Clear to Left |
1485 | B<< C<Ps = 1> >> Clear to Left |
| 1478 | 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) |
| 1479 | |
1489 | |
| 1480 | =end table |
1490 | =end table |
| 1481 | |
1491 | |
| 1482 | =item B<< C<ESC [ Ps L> >> |
1492 | =item B<< C<ESC [ Ps L> >> |
| 1483 | |
1493 | |
| … | |
… | |
| 1809 | |
1819 | |
| 1810 | =item B<< C<Pm = 30> >> |
1820 | =item B<< C<Pm = 30> >> |
| 1811 | |
1821 | |
| 1812 | =begin table |
1822 | =begin table |
| 1813 | |
1823 | |
| 1814 | B<< C<h> >> scrollBar visisble |
1824 | B<< C<h> >> scrollBar visible |
| 1815 | B<< C<l> >> scrollBar invisisble |
1825 | B<< C<l> >> scrollBar invisible |
| 1816 | |
1826 | |
| 1817 | =end table |
1827 | =end table |
| 1818 | |
1828 | |
| 1819 | =item B<< C<Pm = 35> >> (B<rxvt>) |
1829 | =item B<< C<Pm = 35> >> (B<rxvt>) |
| 1820 | |
1830 | |
| … | |
… | |
| 1972 | |
1982 | |
| 1973 | =begin table |
1983 | =begin table |
| 1974 | |
1984 | |
| 1975 | B<< C<h> >> Use Alternate Screen Buffer - clear Alternate Screen Buffer if switching to it |
1985 | B<< C<h> >> Use Alternate Screen Buffer - clear Alternate Screen Buffer if switching to it |
| 1976 | B<< C<l> >> Use Normal Screen Buffer |
1986 | B<< C<l> >> Use Normal Screen Buffer |
|
|
1987 | |
|
|
1988 | =end table |
|
|
1989 | |
|
|
1990 | =item B<< C<Pm = 2004> >> |
|
|
1991 | |
|
|
1992 | =begin table |
|
|
1993 | |
|
|
1994 | B<< C<h> >> Enable bracketed paste mode - prepend / append to the pasted text the control sequences C<ESC [ 200 ~> / C<ESC [ 201 ~> |
|
|
1995 | B<< C<l> >> Disable bracketed paste mode |
| 1977 | |
1996 | |
| 1978 | =end table |
1997 | =end table |
| 1979 | |
1998 | |
| 1980 | =back |
1999 | =back |
| 1981 | |
2000 | |
| … | |
… | |
| 1998 | B<< C<Ps = 0> >> Change Icon Name and Window Title to B<< C<Pt> >> |
2017 | B<< C<Ps = 0> >> Change Icon Name and Window Title to B<< C<Pt> >> |
| 1999 | B<< C<Ps = 1> >> Change Icon Name to B<< C<Pt> >> |
2018 | B<< C<Ps = 1> >> Change Icon Name to B<< C<Pt> >> |
| 2000 | B<< C<Ps = 2> >> Change Window Title to B<< C<Pt> >> |
2019 | B<< C<Ps = 2> >> Change Window Title to B<< C<Pt> >> |
| 2001 | B<< C<Ps = 3> >> If B<< C<Pt> >> starts with a B<< C<?> >>, query the (STRING) property of the window and return it. If B<< C<Pt> >> contains a B<< C<=> >>, set the named property to the given value, else delete the specified property. |
2020 | B<< C<Ps = 3> >> If B<< C<Pt> >> starts with a B<< C<?> >>, query the (STRING) property of the window and return it. If B<< C<Pt> >> contains a B<< C<=> >>, set the named property to the given value, else delete the specified property. |
| 2002 | B<< C<Ps = 4> >> B<< C<Pt> >> is a semi-colon separated sequence of one or more semi-colon separated B<number>/B<name> pairs, where B<number> is an index to a colour and B<name> is the name of a colour. Each pair causes the B<number>ed colour to be changed to B<name>. Numbers 0-7 corresponds to low-intensity (normal) colours and 8-15 corresponds to high-intensity colours. 0=black, 1=red, 2=green, 3=yellow, 4=blue, 5=magenta, 6=cyan, 7=white |
2021 | B<< C<Ps = 4> >> B<< C<Pt> >> is a semi-colon separated sequence of one or more semi-colon separated B<number>/B<name> pairs, where B<number> is an index to a colour and B<name> is the name of a colour. Each pair causes the B<number>ed colour to be changed to B<name>. Numbers 0-7 corresponds to low-intensity (normal) colours and 8-15 corresponds to high-intensity colours. 0=black, 1=red, 2=green, 3=yellow, 4=blue, 5=magenta, 6=cyan, 7=white |
| 2003 | B<< C<Ps = 10> >> Change colour of text foreground to B<< C<Pt> >> B<(NB: may change in future)> |
2022 | B<< C<Ps = 10> >> Change colour of text foreground to B<< C<Pt> >> |
| 2004 | B<< C<Ps = 11> >> Change colour of text background to B<< C<Pt> >> B<(NB: may change in future)> |
2023 | B<< C<Ps = 11> >> Change colour of text background to B<< C<Pt> >> |
| 2005 | B<< C<Ps = 12> >> Change colour of text cursor foreground to B<< C<Pt> >> |
2024 | B<< C<Ps = 12> >> Change colour of text cursor foreground to B<< C<Pt> >> |
| 2006 | B<< C<Ps = 13> >> Change colour of mouse foreground to B<< C<Pt> >> |
2025 | B<< C<Ps = 13> >> Change colour of mouse foreground to B<< C<Pt> >> |
| 2007 | B<< C<Ps = 17> >> Change colour of highlight characters to B<< C<Pt> >> |
2026 | B<< C<Ps = 17> >> Change colour of highlight characters to B<< C<Pt> >> |
| 2008 | B<< C<Ps = 18> >> Change colour of bold characters to B<< C<Pt> >> [deprecated, see 706] |
2027 | B<< C<Ps = 18> >> Change colour of bold characters to B<< C<Pt> >> [deprecated, see 706] |
| 2009 | B<< C<Ps = 19> >> Change colour of underlined characters to B<< C<Pt> >> [deprecated, see 707] |
2028 | B<< C<Ps = 19> >> Change colour of underlined characters to B<< C<Pt> >> [deprecated, see 707] |
| 2010 | B<< C<Ps = 20> >> Change background pixmap parameters (see section BACKGROUND IMAGE) (Compile AfterImage). |
2029 | B<< C<Ps = 20> >> Change background pixmap parameters (see section BACKGROUND IMAGE) (Compile AfterImage). |
| 2011 | B<< C<Ps = 39> >> Change default foreground colour to B<< C<Pt> >>. |
2030 | B<< C<Ps = 39> >> Change default foreground colour to B<< C<Pt> >>. [deprecated, use 10] |
| 2012 | B<< C<Ps = 46> >> Change Log File to B<< C<Pt> >> I<unimplemented> |
2031 | B<< C<Ps = 46> >> Change Log File to B<< C<Pt> >> I<unimplemented> |
| 2013 | B<< C<Ps = 49> >> Change default background colour to B<< C<Pt> >>. |
2032 | B<< C<Ps = 49> >> Change default background colour to B<< C<Pt> >>. [deprecated, use 11] |
| 2014 | B<< C<Ps = 50> >> Set fontset to B<< C<Pt> >>, with the following special values of B<< C<Pt> >> (B<rxvt>) B<< C<#+n> >> change up B<< C<n> >> B<< C<#-n> >> change down B<< C<n> >> if B<< C<n> >> is missing of 0, a value of 1 is used I<empty> change to font0 B<< C<n> >> change to font B<< C<n> >> |
2033 | B<< C<Ps = 50> >> Set fontset to B<< C<Pt> >>, with the following special values of B<< C<Pt> >> (B<rxvt>) B<< C<#+n> >> change up B<< C<n> >> B<< C<#-n> >> change down B<< C<n> >> if B<< C<n> >> is missing of 0, a value of 1 is used I<empty> change to font0 B<< C<n> >> change to font B<< C<n> >> |
| 2015 | B<< C<Ps = 55> >> Log all scrollback buffer and all of screen to B<< C<Pt> >> |
2034 | B<< C<Ps = 55> >> Log all scrollback buffer and all of screen to B<< C<Pt> >> [disabled] |
| 2016 | B<< C<Ps = 701> >> Change current locale to B<< C<Pt> >>, or, if B<< C<Pt> >> is B<< C<?> >>, return the current locale (Compile frills). |
2035 | B<< C<Ps = 701> >> Change current locale to B<< C<Pt> >>, or, if B<< C<Pt> >> is B<< C<?> >>, return the current locale (Compile frills). |
| 2017 | 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>. |
| 2018 | 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> >> |
| 2019 | 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). |
| 2020 | 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> >> |
| 2021 | 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> >> |
| 2022 | 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>. |
| 2023 | 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). |
| 2024 | 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). |
| 2025 | 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). |
| 2026 | 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). |
| … | |
… | |
| 2031 | |
2051 | |
| 2032 | =back |
2052 | =back |
| 2033 | |
2053 | |
| 2034 | =head1 BACKGROUND IMAGE |
2054 | =head1 BACKGROUND IMAGE |
| 2035 | |
2055 | |
| 2036 | For the BACGROUND IMAGE XTerm escape sequence B<< C<ESC ] 20 ; Pt ST> >> then value |
2056 | For the BACKGROUND IMAGE XTerm escape sequence B<< C<ESC ] 20 ; Pt ST> >> the value |
| 2037 | of B<< C<Pt> >> can be the name of the background image file followed by a |
2057 | of B<< C<Pt> >> can be the name of the background image file followed by a |
| 2038 | sequence of scaling/positioning commands separated by semi-colons. The |
2058 | sequence of scaling/positioning commands separated by semi-colons. The |
| 2039 | scaling/positioning commands are as follows: |
2059 | scaling/positioning commands are as follows: |
| 2040 | |
2060 | |
| 2041 | =over 4 |
2061 | =over 4 |
| … | |
… | |
| 2094 | |
2114 | |
| 2095 | rescale the current pixmap to 200% and display the image geometry in |
2115 | rescale the current pixmap to 200% and display the image geometry in |
| 2096 | the title |
2116 | the title |
| 2097 | |
2117 | |
| 2098 | =back |
2118 | =back |
|
|
2119 | |
| 2099 | X<Mouse> |
2120 | X<Mouse> |
| 2100 | |
2121 | |
| 2101 | =head1 Mouse Reporting |
2122 | =head1 Mouse Reporting |
| 2102 | |
2123 | |
| 2103 | =over 4 |
2124 | =over 4 |
| … | |
… | |
| 2144 | Col = B<< C<< <x> - SPACE >> >> |
2165 | Col = B<< C<< <x> - SPACE >> >> |
| 2145 | |
2166 | |
| 2146 | Row = B<< C<< <y> - SPACE >> >> |
2167 | Row = B<< C<< <y> - SPACE >> >> |
| 2147 | |
2168 | |
| 2148 | =back |
2169 | =back |
|
|
2170 | |
|
|
2171 | =head1 Key Codes |
|
|
2172 | |
| 2149 | X<KeyCodes> |
2173 | X<KeyCodes> |
| 2150 | |
|
|
| 2151 | =head1 Key Codes |
|
|
| 2152 | |
2174 | |
| 2153 | Note: B<Shift> + B<F1>-B<F10> generates B<F11>-B<F20> |
2175 | Note: B<Shift> + B<F1>-B<F10> generates B<F11>-B<F20> |
| 2154 | |
2176 | |
| 2155 | For the keypad, use B<Shift> to temporarily override Application-Keypad |
2177 | For the keypad, use B<Shift> to temporarily override Application-Keypad |
| 2156 | setting use B<Num_Lock> to toggle Application-Keypad setting if |
2178 | setting use B<Num_Lock> to toggle Application-Keypad setting if |
| … | |
… | |
| 2324 | =item --with-res-name=NAME (default: urxvt) |
2346 | =item --with-res-name=NAME (default: urxvt) |
| 2325 | |
2347 | |
| 2326 | Use the given name as default application name when |
2348 | Use the given name as default application name when |
| 2327 | reading resources. Specify --with-res-name=rxvt to replace rxvt. |
2349 | reading resources. Specify --with-res-name=rxvt to replace rxvt. |
| 2328 | |
2350 | |
| 2329 | =item --with-res-class=CLASS /default: URxvt) |
2351 | =item --with-res-class=CLASS (default: URxvt) |
| 2330 | |
2352 | |
| 2331 | Use the given class as default application class |
2353 | Use the given class as default application class |
| 2332 | when reading resources. Specify --with-res-class=Rxvt to replace |
2354 | when reading resources. Specify --with-res-class=Rxvt to replace |
| 2333 | rxvt. |
2355 | rxvt. |
| 2334 | |
2356 | |
| … | |
… | |
| 2381 | Add support for a NeXT-like scrollbar. |
2403 | Add support for a NeXT-like scrollbar. |
| 2382 | |
2404 | |
| 2383 | =item --enable-xterm-scroll (default: on) |
2405 | =item --enable-xterm-scroll (default: on) |
| 2384 | |
2406 | |
| 2385 | Add support for an Xterm-like scrollbar. |
2407 | Add support for an Xterm-like scrollbar. |
| 2386 | |
|
|
| 2387 | =item --enable-plain-scroll (default: on) |
|
|
| 2388 | |
|
|
| 2389 | Add support for a very unobtrusive, plain-looking scrollbar that |
|
|
| 2390 | is the favourite of the rxvt-unicode author, having used it for |
|
|
| 2391 | many years. |
|
|
| 2392 | |
|
|
| 2393 | =item --enable-ttygid (default: off) |
|
|
| 2394 | |
|
|
| 2395 | Change tty device setting to group "tty" - only use this if |
|
|
| 2396 | your system uses this type of security. |
|
|
| 2397 | |
2408 | |
| 2398 | =item --disable-backspace-key |
2409 | =item --disable-backspace-key |
| 2399 | |
2410 | |
| 2400 | Removes any handling of the backspace key by us - let the X server do it. |
2411 | Removes any handling of the backspace key by us - let the X server do it. |
| 2401 | |
2412 | |
| … | |
… | |
| 2430 | settable extra linespacing /-lsp) |
2441 | settable extra linespacing /-lsp) |
| 2431 | iso-14755 5.1 (basic) support |
2442 | iso-14755 5.1 (basic) support |
| 2432 | tripleclickwords (-tcw) |
2443 | tripleclickwords (-tcw) |
| 2433 | settable insecure mode (-insecure) |
2444 | settable insecure mode (-insecure) |
| 2434 | keysym remapping support |
2445 | keysym remapping support |
| 2435 | cursor blinking and underline cursor (-cb, -uc) |
2446 | cursor blinking and underline cursor (-bc, -uc) |
| 2436 | XEmbed support (-embed) |
2447 | XEmbed support (-embed) |
| 2437 | user-pty (-pty-fd) |
2448 | user-pty (-pty-fd) |
| 2438 | hold on exit (-hold) |
2449 | hold on exit (-hold) |
|
|
2450 | compile in built-in block graphics |
| 2439 | skip builtin block graphics (-sbg) |
2451 | skip builtin block graphics (-sbg) |
| 2440 | separate highlightcolor support (-hc) |
2452 | separate highlightcolor support (-hc) |
| 2441 | |
2453 | |
| 2442 | It also enables some non-essential features otherwise disabled, such as: |
2454 | It also enables some non-essential features otherwise disabled, such as: |
| 2443 | |
2455 | |
| … | |
… | |
| 2453 | trailing space removal for selections |
2465 | trailing space removal for selections |
| 2454 | verbose X error handling |
2466 | verbose X error handling |
| 2455 | |
2467 | |
| 2456 | =item --enable-iso14755 (default: on) |
2468 | =item --enable-iso14755 (default: on) |
| 2457 | |
2469 | |
| 2458 | Enable extended ISO 14755 support (see @@RXVT_NAME@@(1), or |
2470 | Enable extended ISO 14755 support (see @@RXVT_NAME@@(1)). |
| 2459 | F<doc/rxvt.1.txt>). Basic support (section 5.1) is enabled by |
2471 | Basic support (section 5.1) is enabled by C<--enable-frills>, while |
| 2460 | C<--enable-frills>, while support for 5.2, 5.3 and 5.4 is enabled with |
2472 | support for 5.2, 5.3 and 5.4 is enabled with this switch. |
| 2461 | this switch. |
|
|
| 2462 | |
2473 | |
| 2463 | =item --enable-keepscrolling (default: on) |
2474 | =item --enable-keepscrolling (default: on) |
| 2464 | |
2475 | |
| 2465 | Add support for continual scrolling of the display when you hold |
2476 | Add support for continual scrolling of the display when you hold |
| 2466 | the mouse button down on a scrollbar arrow. |
2477 | the mouse button down on a scrollbar arrow. |
| … | |
… | |
| 2484 | |
2495 | |
| 2485 | Add smart growth/shrink behaviour when resizing. |
2496 | Add smart growth/shrink behaviour when resizing. |
| 2486 | This should keep the window corner which is closest to a corner of |
2497 | This should keep the window corner which is closest to a corner of |
| 2487 | the screen in a fixed position. |
2498 | the screen in a fixed position. |
| 2488 | |
2499 | |
|
|
2500 | =item --enable-text-blink (default: on) |
|
|
2501 | |
|
|
2502 | Add support for blinking text. |
|
|
2503 | |
| 2489 | =item --enable-pointer-blank (default: on) |
2504 | =item --enable-pointer-blank (default: on) |
| 2490 | |
2505 | |
| 2491 | Add support to have the pointer disappear when typing or inactive. |
2506 | Add support to have the pointer disappear when typing or inactive. |
| 2492 | |
2507 | |
| 2493 | =item --enable-perl (default: on) |
2508 | =item --enable-perl (default: on) |
| 2494 | |
2509 | |
| 2495 | Enable an embedded perl interpreter. See the B<@@RXVT_NAME@@perl(3)> |
2510 | Enable an embedded perl interpreter. See the B<@@RXVT_NAME@@perl(3)> |
| 2496 | manpage (F<doc/rxvtperl.txt>) for more info on this feature, or the |
2511 | manpage for more info on this feature, or the files in F<src/perl/> |
| 2497 | files in F<src/perl-ext/> for the extensions that are installed by |
2512 | for the extensions that are installed by default. |
| 2498 | default. The perl interpreter that is used can be specified via the |
2513 | The perl interpreter that is used can be specified via the C<PERL> |
| 2499 | C<PERL> environment variable when running configure. Even when compiled |
2514 | environment variable when running configure. Even when compiled in, |
| 2500 | in, perl will I<not> be initialised when all extensions have been disabled |
2515 | perl will I<not> be initialised when all extensions have been disabled |
| 2501 | C<-pe "" --perl-ext-common "">, so it should be safe to enable from a |
2516 | C<-pe "" --perl-ext-common "">, so it should be safe to enable from a |
| 2502 | resource standpoint. |
2517 | resource standpoint. |
| 2503 | |
2518 | |
| 2504 | =item --with-afterimage-config=DIR |
2519 | =item --with-afterimage-config=DIR |
| 2505 | |
2520 | |
