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

Comparing rxvt-unicode/doc/rxvt.7.man.in (file contents):
Revision 1.54 by root, Sat Jan 28 22:16:58 2006 UTC vs.
Revision 1.56 by root, Tue Jan 31 00:25:16 2006 UTC

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-28" "7.4" "RXVT-UNICODE" 132.TH rxvt 7 "2006-01-31" "7.5" "RXVT-UNICODE"
133.SH "NAME" 133.SH "NAME"
134RXVT REFERENCE \- FAQ, command sequences and other background information 134RXVT 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
151.SH "DESCRIPTION" 151.SH "DESCRIPTION"
152.IX Header "DESCRIPTION" 152.IX Header "DESCRIPTION"
153This document contains the \s-1FAQ\s0, the \s-1RXVT\s0 \s-1TECHNICAL\s0 \s-1REFERENCE\s0 documenting 153This document contains the \s-1FAQ\s0, the \s-1RXVT\s0 \s-1TECHNICAL\s0 \s-1REFERENCE\s0 documenting
154all escape sequences, and other background information. 154all escape sequences, and other background information.
155.PP 155.PP
156The newest version of this document is 156The newest version of this document is also available on the World Wide Web at
157also available on the World Wide Web at
158<http://cvs.schmorp.de/browse/*checkout*/rxvt\-unicode/doc/rxvt.7.html>. 157<http://cvs.schmorp.de/browse/*checkout*/rxvt\-unicode/doc/rxvt.7.html>.
159.SH "FREQUENTLY ASKED QUESTIONS" 158.SH "FREQUENTLY ASKED QUESTIONS"
160.IX Header "FREQUENTLY ASKED QUESTIONS" 159.IX Header "FREQUENTLY ASKED QUESTIONS"
161.IP "The new selection selects pieces that are too big, how can I select single words?" 4 160.IP "The new selection selects pieces that are too big, how can I select single words?" 4
162.IX Item "The new selection selects pieces that are too big, how can I select single words?" 161.IX Item "The new selection selects pieces that are too big, how can I select single words?"
200other combination either by setting the \fBsearchable-scrollback\fR resource: 199other combination either by setting the \fBsearchable-scrollback\fR resource:
201.Sp 200.Sp
202.Vb 1 201.Vb 1
203\& URxvt.searchable-scrollback: CM-s 202\& URxvt.searchable-scrollback: CM-s
204.Ve 203.Ve
204.IP "Why doesn't rxvt-unicode read my resources?" 4
205.IX Item "Why doesn't rxvt-unicode read my resources?"
206Well, why, indeed? It does, in a way very similar to other X
207applications. Most importantly, this means that if you or your \s-1OS\s0 loads
208resources into the X display (the right way to do it), rxvt-unicode will
209ignore any resource files in your home directory. It will only read
210\&\fI$HOME/.Xdefaults\fR when no resources are attached to the display.
211.Sp
212If you have or use an \fI$HOME/.Xresources\fR file, chances are that
213resources are loaded into your X\-server. In this case, you have to
214re-login after every change (or run \fIxrdb \-merge \f(CI$HOME\fI/.Xresources\fR).
215.Sp
216Also consider the form resources have to use:
217.Sp
218.Vb 1
219\& URxvt.resource: value
220.Ve
221.Sp
222If you want to use another form (there are lots of different ways of
223specifying resources), make sure you understand wether and why it
224works. If unsure, use the form above.
225.IP "I can't get transparency working, what am I doing wrong?" 4
226.IX Item "I can't get transparency working, what am I doing wrong?"
227First of all, transparency isn't officially supported in rxvt\-unicode, so
228you are mostly on your own. Do not bug the author about it (but you may
229bug everybody else). Also, if you can't get it working consider it a rite
230of passage: ... and you failed.
231.Sp
232Here are four ways to get transparency. \fBDo\fR read the manpage and option
233descriptions for the programs mentioned and rxvt\-unicode. Really, do it!
234.Sp
2351. Use inheritPixmap:
236.Sp
237.Vb 2
238\& Esetroot wallpaper.jpg
239\& @@RXVT_NAME@@ -ip -tint red -sh 40
240.Ve
241.Sp
242That works. If you think it doesn't, you lack transparency and tinting
243support, or you are unable to read.
244.Sp
2452. Use a simple pixmap and emulate pseudo\-transparency. This enables you
246to use effects other than tinting and shading: Just shade/tint/whatever
247your picture with gimp:
248.Sp
249.Vb 2
250\& convert wallpaper.jpg -blur 20x20 -modulate 30 background.xpm
251\& @@RXVT_NAME@@ -pixmap background.xpm -pe automove-background
252.Ve
253.Sp
254That works. If you think it doesn't, you lack \s-1XPM\s0 and Perl support, or you
255are unable to read.
256.Sp
2573. Use an \s-1ARGB\s0 visual:
258.Sp
259.Vb 1
260\& @@RXVT_NAME@@ -depth 32 -fg grey90 -bg rgba:0000/0000/4444/cccc
261.Ve
262.Sp
263This requires \s-1XFT\s0 support, and the support of your X\-server. If that
264doesn't work for you, blame Xorg and Keith Packard. \s-1ARGB\s0 visuals aren't
265there yet, no matter what they claim. Rxvt-Unicode contains the neccessary
266bugfixes and workarounds for Xft and Xlib to make it work, but that
267doesn't mean that your \s-1WM\s0 has the required kludges in place.
268.Sp
2694. Use xcompmgr and let it do the job:
270.Sp
271.Vb 2
272\& xprop -frame -f _NET_WM_WINDOW_OPACITY 32c \e
273\& -set _NET_WM_WINDOW_OPACITY 0xc0000000
274.Ve
275.Sp
276Then click on a window you want to make transparent. Replace \f(CW0xc0000000\fR
277by other values to change the degree of opacity. If it doesn't work and
278your server crashes, you got to keep the pieces.
205.IP "Isn't rxvt supposed to be small? Don't all those features bloat?" 4 279.IP "Isn't rxvt supposed to be small? Don't all those features bloat?" 4
206.IX Item "Isn't rxvt supposed to be small? Don't all those features bloat?" 280.IX Item "Isn't rxvt supposed to be small? Don't all those features bloat?"
207I often get asked about this, and I think, no, they didn't cause extra 281I often get asked about this, and I think, no, they didn't cause extra
208bloat. If you compare a minimal rxvt and a minimal urxvt, you can see 282bloat. If you compare a minimal rxvt and a minimal urxvt, you can see
209that the urxvt binary is larger (due to some encoding tables always being 283that the urxvt binary is larger (due to some encoding tables always being
2165disable this. 2239disable this.
2166.Sp 2240.Sp
2167A non-exhaustive list of features enabled by \f(CW\*(C`\-\-enable\-frills\*(C'\fR (possibly 2241A non-exhaustive list of features enabled by \f(CW\*(C`\-\-enable\-frills\*(C'\fR (possibly
2168in combination with other switches) is: 2242in combination with other switches) is:
2169.Sp 2243.Sp
2170.Vb 18 2244.Vb 15
2171\& MWM-hints 2245\& MWM-hints
2172\& EWMH-hints (pid, utf8 names) and protocols (ping) 2246\& EWMH-hints (pid, utf8 names) and protocols (ping)
2173\& seperate underline colour (-underlineColor) 2247\& seperate underline colour (-underlineColor)
2174\& settable border widths and borderless switch (-w, -b, -bl) 2248\& settable border widths and borderless switch (-w, -b, -bl)
2175\& visual selection (-depth) 2249\& visual depth selection (-depth)
2176\& settable extra linespacing /-lsp) 2250\& settable extra linespacing /-lsp)
2177\& iso-14755-2 and -3, and visual feedback 2251\& iso-14755-2 and -3, and visual feedback
2178\& backindex and forwardindex escape sequence
2179\& window op and some xterm/OSC escape sequences
2180\& tripleclickwords (-tcw) 2252\& tripleclickwords (-tcw)
2181\& settable insecure mode (-insecure) 2253\& settable insecure mode (-insecure)
2182\& keysym remapping support 2254\& keysym remapping support
2183\& cursor blinking and underline cursor (-cb, -uc) 2255\& cursor blinking and underline cursor (-cb, -uc)
2184\& XEmbed support (-embed) 2256\& XEmbed support (-embed)
2185\& user-pty (-pty-fd) 2257\& user-pty (-pty-fd)
2186\& hold on exit (-hold) 2258\& hold on exit (-hold)
2187\& skip builtin block graphics (-sbg) 2259\& skip builtin block graphics (-sbg)
2260.Ve
2261.Sp
2262It also enabled some non-essential features otherwise disabled, such as:
2263.Sp
2264.Vb 11
2265\& some round-trip time optimisations
2266\& nearest color allocation on pseudocolor screens
2267\& UTF8_STRING supporr for selection
2188\& sgr modes 90..97 and 100..107 2268\& sgr modes 90..97 and 100..107
2269\& backindex and forwardindex escape sequences
2270\& view change/zero scorllback esacpe sequences
2271\& locale switching escape sequence
2272\& window op and some xterm/OSC escape sequences
2273\& rectangular selections
2274\& trailing space removal for selections
2275\& verbose X error handling
2189.Ve 2276.Ve
2190.IP "\-\-enable\-iso14755 (default: on)" 4 2277.IP "\-\-enable\-iso14755 (default: on)" 4
2191.IX Item "--enable-iso14755 (default: on)" 2278.IX Item "--enable-iso14755 (default: on)"
2192Enable extended \s-1ISO\s0 14755 support (see @@RXVT_NAME@@(1), or 2279Enable extended \s-1ISO\s0 14755 support (see @@RXVT_NAME@@(1), or
2193\&\fIdoc/rxvt.1.txt\fR). Basic support (section 5.1) is enabled by 2280\&\fIdoc/rxvt.1.txt\fR). Basic support (section 5.1) is enabled by

Diff Legend

Removed lines
+ Added lines
< Changed lines
> Changed lines