ViewVC Help
View File | Revision Log | Show Annotations | Download File
/cvs/rxvt-unicode/doc/rxvt.7.txt
(Generate patch)

Comparing rxvt-unicode/doc/rxvt.7.txt (file contents):
Revision 1.11 by root, Fri Feb 11 18:06:44 2005 UTC vs.
Revision 1.19 by root, Sun Apr 17 22:36:13 2005 UTC

70 70
71 "bash"'s readline does not work correctly under rxvt. 71 "bash"'s readline does not work correctly under rxvt.
72 I need a termcap file entry. 72 I need a termcap file entry.
73 One reason you might want this is that some distributions or 73 One reason you might want this is that some distributions or
74 operating systems still compile some programs using the 74 operating systems still compile some programs using the
75 long-obsoleted termcap (Fedora Core's bash is one example) and rely 75 long-obsoleted termcap library (Fedora Core's bash is one example)
76 on a termcap entry for "rxvt-unicode". 76 and rely on a termcap entry for "rxvt-unicode".
77 77
78 You could use rxvt's termcap entry with resonable results in many 78 You could use rxvt's termcap entry with resonable results in many
79 cases. You can also create a termcap entry by using terminfo's 79 cases. You can also create a termcap entry by using terminfo's
80 infocmp program like this: 80 infocmp program like this:
81 81
83 83
84 Or you could use this termcap entry, generated by the command above: 84 Or you could use this termcap entry, generated by the command above:
85 85
86 rxvt-unicode|rxvt-unicode terminal (X Window System):\ 86 rxvt-unicode|rxvt-unicode terminal (X Window System):\
87 :am:bw:eo:km:mi:ms:xn:xo:\ 87 :am:bw:eo:km:mi:ms:xn:xo:\
88 :co#80:it#8:li#24:\ 88 :co#80:it#8:li#24:lm#0:\
89 :AL=\E[%dL:DC=\E[%dP:DL=\E[%dM:DO=\E[%dB:IC=\E[%d@:\ 89 :AL=\E[%dL:DC=\E[%dP:DL=\E[%dM:DO=\E[%dB:IC=\E[%d@:\
90 :K1=\EOw:K2=\EOu:K3=\EOy:K4=\EOq:K5=\EOs:LE=\E[%dD:\ 90 :K1=\EOw:K2=\EOu:K3=\EOy:K4=\EOq:K5=\EOs:LE=\E[%dD:\
91 :RI=\E[%dC:SF=\E[%dS:SR=\E[%dT:UP=\E[%dA:ae=^O:al=\E[L:\ 91 :RI=\E[%dC:SF=\E[%dS:SR=\E[%dT:UP=\E[%dA:ae=\E(B:al=\E[L:\
92 :as=^N:bl=^G:cd=\E[J:ce=\E[K:cl=\E[H\E[2J:cm=\E[%i%d;%dH:\ 92 :as=\E(0:bl=^G:cd=\E[J:ce=\E[K:cl=\E[H\E[2J:\
93 :cr=^M:cs=\E[%i%d;%dr:ct=\E[3g:dc=\E[P:dl=\E[M:do=^J:\ 93 :cm=\E[%i%d;%dH:cr=^M:cs=\E[%i%d;%dr:ct=\E[3g:dc=\E[P:\
94 :ec=\E[%dX:ei=\E[4l:ho=\E[H:i1=\E[?47l\E=\E[?1l:ic=\E[@:\ 94 :dl=\E[M:do=^J:ec=\E[%dX:ei=\E[4l:ho=\E[H:\
95 :i1=\E[?47l\E=\E[?1l:ic=\E[@:im=\E[4h:\
95 :im=\E[4h:is=\E[r\E[m\E[2J\E[H\E[?7h\E[?1;3;4;6l\E[4l:\ 96 :is=\E[r\E[m\E[2J\E[H\E[?7h\E[?1;3;4;6l\E[4l:\
96 :k0=\E[21~:k1=\E[11~:k2=\E[12~:k3=\E[13~:k4=\E[14~:\ 97 :k1=\E[11~:k2=\E[12~:k3=\E[13~:k4=\E[14~:k5=\E[15~:\
97 :k5=\E[15~:k6=\E[17~:k7=\E[18~:k8=\E[19~:k9=\E[20~:\ 98 :k6=\E[17~:k7=\E[18~:k8=\E[19~:k9=\E[20~:kD=\E[3~:\
98 :kD=\E[3~:kI=\E[2~:kN=\E[6~:kP=\E[5~:kb=\177:kd=\EOB:\ 99 :kI=\E[2~:kN=\E[6~:kP=\E[5~:kb=\177:kd=\EOB:ke=\E[?1l\E>:\
99 :ke=\E[?1l\E>:kh=\E[7~:kl=\EOD:kr=\EOC:ks=\E[?1h\E=:\ 100 :kh=\E[7~:kl=\EOD:kr=\EOC:ks=\E[?1h\E=:ku=\EOA:le=^H:\
100 :ku=\EOA:le=^H:mb=\E[5m:md=\E[1m:me=\E[m\017:mr=\E[7m:\ 101 :mb=\E[5m:md=\E[1m:me=\E[m\017:mr=\E[7m:nd=\E[C:rc=\E8:\
101 :nd=\E[C:rc=\E8:sc=\E7:se=\E[27m:sf=^J:so=\E[7m:sr=\EM:\ 102 :sc=\E7:se=\E[27m:sf=^J:so=\E[7m:sr=\EM:st=\EH:ta=^I:\
102 :st=\EH:ta=^I:te=\E[r\E[?1049l:ti=\E[?1049h:ue=\E[24m:\ 103 :te=\E[r\E[?1049l:ti=\E[?1049h:ue=\E[24m:up=\E[A:\
103 :up=\E[A:us=\E[4m:vb=\E[?5h\E[?5l:ve=\E[?25h:vi=\E[?25l:\ 104 :us=\E[4m:vb=\E[?5h\E[?5l:ve=\E[?25h:vi=\E[?25l:\
104 :vs=\E[?25h: 105 :vs=\E[?25h:
105 106
106 Why does "ls" no longer have coloured output? 107 Why does "ls" no longer have coloured output?
107 The "ls" in the GNU coreutils unfortunately doesn't use terminfo to 108 The "ls" in the GNU coreutils unfortunately doesn't use terminfo to
108 decide wether a terminal has colour, but uses it's own configuration 109 decide wether a terminal has colour, but uses it's own configuration
299 As you might have guessed, FreeBSD does neither define this symobl 300 As you might have guessed, FreeBSD does neither define this symobl
300 nor does it support it. Instead, it uses it's own internal 301 nor does it support it. Instead, it uses it's own internal
301 representation of wchar_t. This is, of course, completely fine with 302 representation of wchar_t. This is, of course, completely fine with
302 respect to standards. 303 respect to standards.
303 304
305 However, that means rxvt-unicode only works in "POSIX", "ISO-8859-1"
306 and "UTF-8" locales under FreeBSD (which all use Unicode as wchar_t.
307
304 However, "__STDC_ISO_10646__" is the only sane way to support 308 "__STDC_ISO_10646__" is the only sane way to support multi-language
305 multi-language apps in an OS, as using a locale-dependent (and 309 apps in an OS, as using a locale-dependent (and non-standardized)
306 non-standardized) representation of wchar_t makes it impossible to 310 representation of wchar_t makes it impossible to convert between
307 convert between wchar_t (as used by X11 and your applications) and 311 wchar_t (as used by X11 and your applications) and any other
308 any other encoding without implementing OS-specific-wrappers for 312 encoding without implementing OS-specific-wrappers for each and
309 each and every locale. There simply are no APIs to convert wchar_t 313 every locale. There simply are no APIs to convert wchar_t into
310 into anything except the current locale encoding. 314 anything except the current locale encoding.
311 315
312 Some applications (such as the formidable mlterm) work around this 316 Some applications (such as the formidable mlterm) work around this
313 by carrying their own replacement functions for character set 317 by carrying their own replacement functions for character set
314 handling with them, and either implementing OS-dependent hacks or 318 handling with them, and either implementing OS-dependent hacks or
315 doing multiple conversions (which is slow and unreliable in case the 319 doing multiple conversions (which is slow and unreliable in case the
408 412
409 Now you can start your terminal with "LC_CTYPE=ja_JP.UTF-8" and 413 Now you can start your terminal with "LC_CTYPE=ja_JP.UTF-8" and
410 still use your input method. Please note, however, that you will not 414 still use your input method. Please note, however, that you will not
411 be able to input characters outside "EUC-JP" in a normal way then, 415 be able to input characters outside "EUC-JP" in a normal way then,
412 as your input method limits you. 416 as your input method limits you.
417
418 Rxvt-unicode crashes when the X Input Method changes or exits.
419 Unfortunately, this is unavoidable, as the XIM protocol is racy by
420 design. Applications can avoid some crashes at the expense of memory
421 leaks, and Input Methods can avoid some crashes by careful ordering
422 at exit time. kinput2 (and derived input methods) generally
423 succeeds, while SCIM (or similar input methods) fails. In the end,
424 however, crashes cannot be completely avoided even if both sides
425 cooperate.
426
427 So the only workaround is not to kill your Input Method Servers.
413 428
414 Rxvt-unicode uses gobs of memory, how can I reduce that? 429 Rxvt-unicode uses gobs of memory, how can I reduce that?
415 Rxvt-unicode tries to obey the rule of not charging you for 430 Rxvt-unicode tries to obey the rule of not charging you for
416 something you don't use. One thing you should try is to configure 431 something you don't use. One thing you should try is to configure
417 out all settings that you don't need, for example, Xft support is a 432 out all settings that you don't need, for example, Xft support is a
1144 Ps = 13 Change colour of mouse foreground to Pt 1159 Ps = 13 Change colour of mouse foreground to Pt
1145 Ps = 17 Change colour of highlight characters to Pt 1160 Ps = 17 Change colour of highlight characters to Pt
1146 Ps = 18 Change colour of bold characters to Pt 1161 Ps = 18 Change colour of bold characters to Pt
1147 Ps = 19 Change colour of underlined characters to Pt 1162 Ps = 19 Change colour of underlined characters to Pt
1148 Ps = 20 Change default background to Pt 1163 Ps = 20 Change default background to Pt
1149 Ps = 39 Change default foreground colour to Pt rxvt compile-time option 1164 Ps = 39 Change default foreground colour to Pt.
1150 Ps = 46 Change Log File to Pt unimplemented 1165 Ps = 46 Change Log File to Pt unimplemented
1151 Ps = 49 Change default background colour to Pt rxvt compile-time option 1166 Ps = 49 Change default background colour to Pt.
1152 Ps = 50 Set fontset to Pt, with the following special values of Pt (rxvt) #+n change up n #-n change down n if n is missing of 0, a value of 1 is used empty change to font0 n change to font n 1167 Ps = 50 Set fontset to Pt, with the following special values of Pt (rxvt) #+n change up n #-n change down n if n is missing of 0, a value of 1 is used empty change to font0 n change to font n
1153 Ps = 55 Log all scrollback buffer and all of screen to Pt 1168 Ps = 55 Log all scrollback buffer and all of screen to Pt
1154 Ps = 701 Change current locale to Pt, or, if Pt is ?, return the current locale (rxvt extension) 1169 Ps = 701 Change current locale to Pt, or, if Pt is ?, return the current locale (Compile frills).
1155 Ps = 703 Menubar command Pt rxvt compile-time option (rxvt-unicode extension) 1170 Ps = 703 Menubar command Pt (Compile menubar).
1156 Ps = 704 Change colour of italic characters to Pt 1171 Ps = 704 Change colour of italic characters to Pt
1157 Ps = 705 Change background pixmap tint colour to Pt 1172 Ps = 705 Change background pixmap tint colour to Pt (Compile transparency).
1158 Ps = 710 Set normal fontset to Pt. Same as Ps = 50. 1173 Ps = 710 Set normal fontset to Pt. Same as Ps = 50.
1159 Ps = 711 Set bold fontset to Pt. Similar to Ps = 50. 1174 Ps = 711 Set bold fontset to Pt. Similar to Ps = 50 (Compile styles).
1160 Ps = 712 Set italic fontset to Pt. Similar to Ps = 50. 1175 Ps = 712 Set italic fontset to Pt. Similar to Ps = 50 (Compile styles).
1161 Ps = 713 Set bold-italic fontset to Pt. Similar to Ps = 50. 1176 Ps = 713 Set bold-italic fontset to Pt. Similar to Ps = 50 (Compile styles).
1177 Ps = 720 Move viewing window up by Pt lines, or clear scrollback buffer if Pt = 0 (Compile frills).
1178 Ps = 721 Move viewing window down by Pt lines, or clear scrollback buffer if Pt = 0 (Compile frills).
1162 1179
1163 1180
1164 1181
1165menuBar 1182menuBar
1166 The exact syntax used is *almost* solidified. In the menus, DON'T try to 1183 The exact syntax used is *almost* solidified. In the menus, DON'T try to
1203 [menu] 1220 [menu]
1204 access the current menuBar for alteration 1221 access the current menuBar for alteration
1205 1222
1206 [title:+*string*] 1223 [title:+*string*]
1207 set the current menuBar's title to *string*, which may contain the 1224 set the current menuBar's title to *string*, which may contain the
1208 following format specifiers: %% : literal % character %n : rxvt name 1225 following format specifiers:
1209 (as per the -name command-line option) %v : rxvt version 1226
1227 B<%n> rxvt name (as per the B<-name> command-line option)
1228 B<%v> rxvt version
1229 B<%%> literal B<%> character
1210 1230
1211 [done] 1231 [done]
1212 set menuBar access as readonly. End-of-file tag for [read:+*file*] 1232 set menuBar access as readonly. End-of-file tag for [read:+*file*]
1213 operations. 1233 operations.
1214 1234
1650 --enable-font-styles 1670 --enable-font-styles
1651 Add support for bold, *italic* and *bold italic* font styles. The 1671 Add support for bold, *italic* and *bold italic* font styles. The
1652 fonts can be set manually or automatically. 1672 fonts can be set manually or automatically.
1653 1673
1654 --with-codesets=NAME,... 1674 --with-codesets=NAME,...
1655 Compile in support for additional codeset (encoding) groups (eu, vn 1675 Compile in support for additional codeset (encoding) groups ("eu",
1656 are always compiled in, which includes most 8-bit character sets). 1676 "vn" are always compiled in, which includes most 8-bit character
1657 These codeset tables are currently only used for driving X11 core 1677 sets). These codeset tables are used for driving X11 core fonts,
1658 fonts, they are not required for Xft fonts. Compiling them in will 1678 they are not required for Xft fonts, although having them compiled
1659 make your binary bigger (together about 700kB), but it doesn't 1679 in lets rxvt-unicode choose replacement fonts more intelligently.
1660 increase memory usage unless you use an X11 font requiring one of 1680 Compiling them in will make your binary bigger (all of together cost
1661 these encodings. 1681 about 700kB), but it doesn't increase memory usage unless you use a
1682 font requiring one of these encodings.
1662 1683
1663 all all available codeset groups 1684 all all available codeset groups
1664 zh common chinese encodings 1685 zh common chinese encodings
1665 zh_ext rarely used but very big chinese encodigs 1686 zh_ext rarely used but very big chinese encodigs
1666 jp common japanese encodings 1687 jp common japanese encodings
1690 accents are encoded as seperate unicode characters. This is done by 1711 accents are encoded as seperate unicode characters. This is done by
1691 using precomposited characters when available or creating new 1712 using precomposited characters when available or creating new
1692 pseudo-characters when no precomposed form exists. 1713 pseudo-characters when no precomposed form exists.
1693 1714
1694 Without --enable-unicode3, the number of additional precomposed 1715 Without --enable-unicode3, the number of additional precomposed
1695 characters is rather limited (2048, if this is full, rxvt will use 1716 characters is rather limited (2048, if this is full, rxvt-unicode
1696 the private use area, extending the number of combinations to 8448). 1717 will use the private use area, extending the number of combinations
1697 With --enable-unicode3, no practical limit exists. This will also 1718 to 8448). With --enable-unicode3, no practical limit exists.
1698 enable storage of characters >65535. 1719
1720 This option will also enable storage (but not display) of characters
1721 beyond plane 0 (>65535) when --enable-unicode3 was not specified.
1699 1722
1700 The combining table also contains entries for arabic presentation 1723 The combining table also contains entries for arabic presentation
1701 forms, but these are not currently used. Bug me if you want these to 1724 forms, but these are not currently used. Bug me if you want these to
1702 be used. 1725 be used (and tell me how these are to be used...).
1703 1726
1704 --enable-fallback(=CLASS) 1727 --enable-fallback(=CLASS)
1705 When reading resource settings, also read settings for class CLASS 1728 When reading resource settings, also read settings for class CLASS
1706 (default: Rxvt). To disable resource fallback use 1729 (default: Rxvt). To disable resource fallback use
1707 --disable-fallback. 1730 --disable-fallback.
1805 1828
1806 A non-exhaustive list of features enabled by "--enable-frills" 1829 A non-exhaustive list of features enabled by "--enable-frills"
1807 (possibly in combination with other switches) is: 1830 (possibly in combination with other switches) is:
1808 1831
1809 MWM-hints 1832 MWM-hints
1833 EWMH-hints (pid, utf8 names) and protocols (ping)
1810 seperate underline colour 1834 seperate underline colour
1811 settable border widths and borderless switch 1835 settable border widths and borderless switch
1812 settable extra linespacing 1836 settable extra linespacing
1813 extra window properties (e.g. UTF-8 window names and PID)
1814 iso-14755-2 and -3, and visual feedback 1837 iso-14755-2 and -3, and visual feedback
1815 backindex and forwardindex escape sequence 1838 backindex and forwardindex escape sequence
1816 window op and locale change escape sequences 1839 window op and some xterm/OSC escape sequences
1817 tripleclickwords 1840 tripleclickwords
1818 settable insecure mode 1841 settable insecure mode
1819 keysym remapping support 1842 keysym remapping support
1843 cursor blinking and underline cursor
1844 -embed and -pty-fd options
1820 1845
1821 --enable-iso14755 1846 --enable-iso14755
1822 Enable extended ISO 14755 support (see rxvt(1), or doc/rxvt.1.txt). 1847 Enable extended ISO 14755 support (see rxvt(1), or doc/rxvt.1.txt).
1823 Basic support (section 5.1) is enabled by "--enable-frills", while 1848 Basic support (section 5.1) is enabled by "--enable-frills", while
1824 support for 5.2, 5.3 and 5.4 is enabled with this switch. 1849 support for 5.2, 5.3 and 5.4 is enabled with this switch.
1854 --enable-smart-resize 1879 --enable-smart-resize
1855 Add smart growth/shrink behaviour when changing font size via from 1880 Add smart growth/shrink behaviour when changing font size via from
1856 hot keys. This should keep in a fixed position the rxvt corner which 1881 hot keys. This should keep in a fixed position the rxvt corner which
1857 is closest to a corner of the screen. 1882 is closest to a corner of the screen.
1858 1883
1859 --enable-cursor-blink
1860 Add support for a blinking cursor.
1861
1862 --enable-pointer-blank 1884 --enable-pointer-blank
1863 Add support to have the pointer disappear when typing or inactive. 1885 Add support to have the pointer disappear when typing or inactive.
1864 1886
1865 --with-name=NAME 1887 --with-name=NAME
1866 Set the basename for the installed binaries (default: "urxvt", 1888 Set the basename for the installed binaries (default: "urxvt",

Diff Legend

Removed lines
+ Added lines
< Changed lines
> Changed lines