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

Comparing rxvt-unicode/doc/rxvt.7.pod (file contents):
Revision 1.89 by root, Wed Jan 18 21:00:39 2006 UTC vs.
Revision 1.97 by root, Tue Jan 31 00:53:49 2006 UTC

… …
16=head1 DESCRIPTION 16=head1 DESCRIPTION
17 17
18This document contains the FAQ, the RXVT TECHNICAL REFERENCE documenting 18This document contains the FAQ, the RXVT TECHNICAL REFERENCE documenting
19all escape sequences, and other background information. 19all escape sequences, and other background information.
20 20
21The newest version of this document is 21The newest version of this document is also available on the World Wide Web at
22also available on the World Wide Web at
23L<http://cvs.schmorp.de/browse/*checkout*/rxvt-unicode/doc/rxvt.7.html>. 22L<http://cvs.schmorp.de/browse/*checkout*/rxvt-unicode/doc/rxvt.7.html>.
24 23
25=head1 FREQUENTLY ASKED QUESTIONS 24=head1 FREQUENTLY ASKED QUESTIONS
26 25
27=over 4 26=over 4
… …
63extensions. Some extensions can also be configured, for example, 62extensions. Some extensions can also be configured, for example,
64scrollback search mode is triggered by B<M-s>. You can move it to any 63scrollback search mode is triggered by B<M-s>. You can move it to any
65other combination either by setting the B<searchable-scrollback> resource: 64other combination either by setting the B<searchable-scrollback> resource:
66 65
67 URxvt.searchable-scrollback: CM-s 66 URxvt.searchable-scrollback: CM-s
67
68=item The cursor moves when selecting text in the current input line, how
69do I switch this off?
70
71=item During rlogin/ssh/telnet/etc. sessions, clicking near the cursor
72outputs strange escape sequences, how do I fix this?
73
74These are caused by the C<readline> perl extension. Under normal
75circumstances, it will move your cursor around when you click into the
76line that contains it. It tries hard not to do this at the wrong moment,
77but when running a program that doesn't parse cursor movements or in some
78cases during rlogin sessions, it fails to detect this properly.
79
80You can permamently switch this feature off by disabling the C<readline>
81extension:
82
83 URxvt.perl-ext-common: default,-readline
84
85=item Why doesn't rxvt-unicode read my resources?
86
87Well, why, indeed? It does, in a way very similar to other X
88applications. Most importantly, this means that if you or your OS loads
89resources into the X display (the right way to do it), rxvt-unicode will
90ignore any resource files in your home directory. It will only read
91F<$HOME/.Xdefaults> when no resources are attached to the display.
92
93If you have or use an F<$HOME/.Xresources> file, chances are that
94resources are loaded into your X-server. In this case, you have to
95re-login after every change (or run F<xrdb -merge $HOME/.Xresources>).
96
97Also consider the form resources have to use:
98
99 URxvt.resource: value
100
101If you want to use another form (there are lots of different ways of
102specifying resources), make sure you understand wether and why it
103works. If unsure, use the form above.
104
105=item I can't get transparency working, what am I doing wrong?
106
107First of all, transparency isn't officially supported in rxvt-unicode, so
108you are mostly on your own. Do not bug the author about it (but you may
109bug everybody else). Also, if you can't get it working consider it a rite
110of passage: ... and you failed.
111
112Here are four ways to get transparency. B<Do> read the manpage and option
113descriptions for the programs mentioned and rxvt-unicode. Really, do it!
114
1151. Use inheritPixmap:
116
117 Esetroot wallpaper.jpg
118 @@RXVT_NAME@@ -ip -tint red -sh 40
119
120That works. If you think it doesn't, you lack transparency and tinting
121support, or you are unable to read.
122
1232. Use a simple pixmap and emulate pseudo-transparency. This enables you
124to use effects other than tinting and shading: Just shade/tint/whatever
125your picture with gimp:
126
127 convert wallpaper.jpg -blur 20x20 -modulate 30 background.xpm
128 @@RXVT_NAME@@ -pixmap background.xpm -pe automove-background
129
130That works. If you think it doesn't, you lack XPM and Perl support, or you
131are unable to read.
132
1333. Use an ARGB visual:
134
135 @@RXVT_NAME@@ -depth 32 -fg grey90 -bg rgba:0000/0000/4444/cccc
136
137This requires XFT support, and the support of your X-server. If that
138doesn't work for you, blame Xorg and Keith Packard. ARGB visuals aren't
139there yet, no matter what they claim. Rxvt-Unicode contains the neccessary
140bugfixes and workarounds for Xft and Xlib to make it work, but that
141doesn't mean that your WM has the required kludges in place.
142
1434. Use xcompmgr and let it do the job:
144
145 xprop -frame -f _NET_WM_WINDOW_OPACITY 32c \
146 -set _NET_WM_WINDOW_OPACITY 0xc0000000
147
148Then click on a window you want to make transparent. Replace C<0xc0000000>
149by other values to change the degree of opacity. If it doesn't work and
150your server crashes, you got to keep the pieces.
68 151
69=item Isn't rxvt supposed to be small? Don't all those features bloat? 152=item Isn't rxvt supposed to be small? Don't all those features bloat?
70 153
71I often get asked about this, and I think, no, they didn't cause extra 154I often get asked about this, and I think, no, they didn't cause extra
72bloat. If you compare a minimal rxvt and a minimal urxvt, you can see 155bloat. If you compare a minimal rxvt and a minimal urxvt, you can see
… …
142No large bloated libraries (of course, none were linked in statically), 225No large bloated libraries (of course, none were linked in statically),
143except maybe libX11 :) 226except maybe libX11 :)
144 227
145=item Does it support tabs, can I have a tabbed rxvt-unicode? 228=item Does it support tabs, can I have a tabbed rxvt-unicode?
146 229
147rxvt-unicode does not directly support tabs. It will work fine with 230Beginning with version 7.3, there is a perl extension that implements a
148tabbing functionality of many window managers or similar tabbing programs, 231simple tabbed terminal. It is installed by default, so any of these should
149and its embedding-features allow it to be embedded into other programs, 232give you tabs:
150as witnessed by F<doc/rxvt-tabbed> or the upcoming C<Gtk2::URxvt> perl 233
151module, which features a tabbed urxvt (murxvt) terminal as an example 234 @@RXVT_NAME@@ -pe tabbed
152embedding application. 235
236 URxvt.perl-ext-common: default,tabbed
237
238It will also work fine with tabbing functionality of many window managers
239or similar tabbing programs, and its embedding-features allow it to be
240embedded into other programs, as witnessed by F<doc/rxvt-tabbed> or
241the upcoming C<Gtk2::URxvt> perl module, which features a tabbed urxvt
242(murxvt) terminal as an example embedding application.
153 243
154=item How do I know which rxvt-unicode version I'm using? 244=item How do I know which rxvt-unicode version I'm using?
155 245
156The version number is displayed with the usage (-h). Also the escape 246The version number is displayed with the usage (-h). Also the escape
157sequence C<ESC [ 8 n> sets the window title to the version number. When 247sequence C<ESC [ 8 n> sets the window title to the version number. When
… …
1675 B<< C<Ps = 46> >> Change Log File to B<< C<Pt> >> I<unimplemented> 1765 B<< C<Ps = 46> >> Change Log File to B<< C<Pt> >> I<unimplemented>
1676 B<< C<Ps = 49> >> Change default background colour to B<< C<Pt> >>. 1766 B<< C<Ps = 49> >> Change default background colour to B<< C<Pt> >>.
1677 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> >> 1767 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> >>
1678 B<< C<Ps = 55> >> Log all scrollback buffer and all of screen to B<< C<Pt> >> 1768 B<< C<Ps = 55> >> Log all scrollback buffer and all of screen to B<< C<Pt> >>
1679 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). 1769 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).
1770 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>.
1680 B<< C<Ps = 704> >> Change colour of italic characters to B<< C<Pt> >> 1771 B<< C<Ps = 704> >> Change colour of italic characters to B<< C<Pt> >>
1681 B<< C<Ps = 705> >> Change background pixmap tint colour to B<< C<Pt> >> (Compile transparency). 1772 B<< C<Ps = 705> >> Change background pixmap tint colour to B<< C<Pt> >> (Compile transparency).
1682 B<< C<Ps = 706> >> Change colour of bold characters to B<< C<Pt> >> 1773 B<< C<Ps = 706> >> Change colour of bold characters to B<< C<Pt> >>
1683 B<< C<Ps = 707> >> Change colour of underlined characters to B<< C<Pt> >> 1774 B<< C<Ps = 707> >> Change colour of underlined characters to B<< C<Pt> >>
1684 B<< C<Ps = 710> >> Set normal fontset to B<< C<Pt> >>. Same as C<Ps = 50>. 1775 B<< C<Ps = 710> >> Set normal fontset to B<< C<Pt> >>. Same as C<Ps = 50>.
… …
1947alternative input methods (e.g. kinput2) and will also correctly 2038alternative input methods (e.g. kinput2) and will also correctly
1948set up the input for people using dead keys or compose keys. 2039set up the input for people using dead keys or compose keys.
1949 2040
1950=item --enable-unicode3 (default: off) 2041=item --enable-unicode3 (default: off)
1951 2042
2043Recommended to stay off unless you really need non-BMP characters.
2044
1952Enable direct support for displaying unicode codepoints above 2045Enable direct support for displaying unicode codepoints above
195365535 (the basic multilingual page). This increases storage 204665535 (the basic multilingual page). This increases storage
1954requirements per character from 2 to 4 bytes. X11 fonts do not yet 2047requirements per character from 2 to 4 bytes. X11 fonts do not yet
1955support these extra characters, but Xft does. 2048support these extra characters, but Xft does.
1956 2049
… …
1966composite characters. This is required for proper viewing of text 2059composite characters. This is required for proper viewing of text
1967where accents are encoded as seperate unicode characters. This is 2060where accents are encoded as seperate unicode characters. This is
1968done by using precomposited characters when available or creating 2061done by using precomposited characters when available or creating
1969new pseudo-characters when no precomposed form exists. 2062new pseudo-characters when no precomposed form exists.
1970 2063
1971Without --enable-unicode3, the number of additional precomposed characters 2064Without --enable-unicode3, the number of additional precomposed
1972is rather limited (2048, if this is full, rxvt-unicode will use the 2065characters is somewhat limited (the 6400 private use characters will be
1973private use area, extending the number of combinations to 8448). With
1974--enable-unicode3, no practical limit exists. 2066(ab-)used). With --enable-unicode3, no practical limit exists.
1975 2067
1976This option will also enable storage (but not display) of characters 2068This option will also enable storage (but not display) of characters
1977beyond plane 0 (>65535) when --enable-unicode3 was not specified. 2069beyond plane 0 (>65535) when --enable-unicode3 was not specified.
1978 2070
1979The combining table also contains entries for arabic presentation forms, 2071The combining table also contains entries for arabic presentation forms,
1980but these are not currently used. Bug me if you want these to be used (and 2072but these are not currently used. Bug me if you want these to be used (and
1981tell me how these are to be used...). 2073tell me how these are to be used...).
1982 2074
1983=item --enable-fallback(=CLASS) (default: Rxvt) 2075=item --enable-fallback(=CLASS) (default: Rxvt)
1984 2076
1985When reading resource settings, also read settings for class CLASS. To disable resource fallback use --disable-fallback. 2077When reading resource settings, also read settings for class CLASS. To
2078disable resource fallback use --disable-fallback.
1986 2079
1987=item --with-res-name=NAME (default: urxvt) 2080=item --with-res-name=NAME (default: urxvt)
1988 2081
1989Use the given name as default application name when 2082Use the given name as default application name when
1990reading resources. Specify --with-res-name=rxvt to replace rxvt. 2083reading resources. Specify --with-res-name=rxvt to replace rxvt.
… …
2080 2173
2081 MWM-hints 2174 MWM-hints
2082 EWMH-hints (pid, utf8 names) and protocols (ping) 2175 EWMH-hints (pid, utf8 names) and protocols (ping)
2083 seperate underline colour (-underlineColor) 2176 seperate underline colour (-underlineColor)
2084 settable border widths and borderless switch (-w, -b, -bl) 2177 settable border widths and borderless switch (-w, -b, -bl)
2178 visual depth selection (-depth)
2085 settable extra linespacing /-lsp) 2179 settable extra linespacing /-lsp)
2086 iso-14755-2 and -3, and visual feedback 2180 iso-14755-2 and -3, and visual feedback
2087 backindex and forwardindex escape sequence
2088 window op and some xterm/OSC escape sequences
2089 tripleclickwords (-tcw) 2181 tripleclickwords (-tcw)
2090 settable insecure mode (-insecure) 2182 settable insecure mode (-insecure)
2091 keysym remapping support 2183 keysym remapping support
2092 cursor blinking and underline cursor (-cb, -uc) 2184 cursor blinking and underline cursor (-cb, -uc)
2093 XEmbed support (-embed) 2185 XEmbed support (-embed)
2094 user-pty (-pty-fd) 2186 user-pty (-pty-fd)
2095 hold on exit (-hold) 2187 hold on exit (-hold)
2096 skip builtin block graphics (-sbg) 2188 skip builtin block graphics (-sbg)
2189
2190It also enabled some non-essential features otherwise disabled, such as:
2191
2192 some round-trip time optimisations
2193 nearest color allocation on pseudocolor screens
2194 UTF8_STRING supporr for selection
2097 sgr modes 90..97 and 100..107 2195 sgr modes 90..97 and 100..107
2196 backindex and forwardindex escape sequences
2197 view change/zero scorllback esacpe sequences
2198 locale switching escape sequence
2199 window op and some xterm/OSC escape sequences
2200 rectangular selections
2201 trailing space removal for selections
2202 verbose X error handling
2098 2203
2099=item --enable-iso14755 (default: on) 2204=item --enable-iso14755 (default: on)
2100 2205
2101Enable extended ISO 14755 support (see @@RXVT_NAME@@(1), or 2206Enable extended ISO 14755 support (see @@RXVT_NAME@@(1), or
2102F<doc/rxvt.1.txt>). Basic support (section 5.1) is enabled by 2207F<doc/rxvt.1.txt>). Basic support (section 5.1) is enabled by
… …
2145 2250
2146=item --enable-pointer-blank (default: on) 2251=item --enable-pointer-blank (default: on)
2147 2252
2148Add support to have the pointer disappear when typing or inactive. 2253Add support to have the pointer disappear when typing or inactive.
2149 2254
2150=item --enable-perl (default: off) 2255=item --enable-perl (default: on)
2151 2256
2152Enable an embedded perl interpreter. See the B<@@RXVT_NAME@@perl(3)> 2257Enable an embedded perl interpreter. See the B<@@RXVT_NAME@@perl(3)>
2153manpage (F<doc/rxvtperl.txt>) for more info on this feature, or the files 2258manpage (F<doc/rxvtperl.txt>) for more info on this feature, or the files
2154in F<src/perl-ext/> for the extensions that are installed by default. The 2259in F<src/perl-ext/> for the extensions that are installed by default. The
2155perl interpreter that is used can be specified via the C<PERL> environment 2260perl interpreter that is used can be specified via the C<PERL> environment

Diff Legend

– Removed lines
+ Added lines
< Changed lines
> Changed lines