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.55 by root, Mon Jan 30 22:49:30 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-30" "7.4" "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
200other combination either by setting the \fBsearchable-scrollback\fR resource: 200other combination either by setting the \fBsearchable-scrollback\fR resource:
201.Sp 201.Sp
202.Vb 1 202.Vb 1
203\& URxvt.searchable-scrollback: CM-s 203\& URxvt.searchable-scrollback: CM-s
204.Ve 204.Ve
205.IP "Why doesn't rxvt-unicode read my resources?" 4
206.IX Item "Why doesn't rxvt-unicode read my resources?"
207Well, why, indeed? It does, in a way very similar to other X
208applications. Most importantly, this means that if you or your \s-1OS\s0 loads
209resources into the X display (the right way to do it), rxvt-unicode will
210ignore any resource files in your home directory. It will only read
211\&\fI$HOME/.Xdefaults\fR when no resources are attached to the display.
212.Sp
213If you have or use an \fI$HOME/.Xresources\fR file, chances are that
214resources are loaded into your X\-server. In this case, you have to
215re-login after every change (or run \fIxrdb \-merge \f(CI$HOME\fI/.Xresources\fR).
216.Sp
217Also consider the form resources have to use:
218.Sp
219.Vb 1
220\& URxvt.resource: value
221.Ve
222.Sp
223If you want to use another form (there are lots of different ways of
224specifying resources), make sure you understand wether and why it
225works. If unsure, use the form above.
226.IP "I can't get transparency working, what am I doing wrong?" 4
227.IX Item "I can't get transparency working, what am I doing wrong?"
228First of all, transparency isn't officially supported in rxvt\-unicode, so
229you are mostly on your own. Do not bug the author about it (but you may
230bug everybody else). Also, if you can't get it working consider it a rite
231of passage, and you failed.
232.Sp
233Here are three ways to get transparency. \fBDo\fR read the manpage and option
234descriptions for the programs mentioned and rxvt\-unicode. Really, do it!
235.Sp
2361. Use inheritPixmap:
237.Sp
238.Vb 2
239\& Esetroot wallpaper.jpg
240\& @@RXVT_NAME@@ -ip -tint red -sh 40
241.Ve
242.Sp
243That works. If you think it doesn't, you lack transparency and tinting
244support, or you are unable to read.
245.Sp
2462. Use a simple pixmap and emulate pseudo\-transparency. This enables you
247to use effects other than tinting and shading: Just shade/tint/whatever
248your picture with gimp:
249.Sp
250.Vb 2
251\& convert wallpaper.jpg -blur 20x20 -modulate 30 background.xpm
252\& @@RXVT_NAME@@ -pixmap background.xpm -pe automove-background
253.Ve
254.Sp
255That works. If you think it doesn't, you lack \s-1XPM\s0 and Perl support, or you
256are unable to read.
257.Sp
2583. Use an \s-1ARGB\s0 visual:
259.Sp
260.Vb 1
261\& @@RXVT_NAME@@ -depth 432 -fg grey90 -bg rgba:0000/0000/0000/c000
262.Ve
263.Sp
264This requires \s-1XFT\s0 support, and support form your X\-server. If that doesn't
265work for you, blame Xorg and Keith Packard. \s-1ARGB\s0 visuals aren't there yet,
266no matter what they claim. Rxvt-Unicode contains the neccessary bugfixes
267and workarounds for Xft and Xlib to make it work.
205.IP "Isn't rxvt supposed to be small? Don't all those features bloat?" 4 268.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?" 269.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 270I 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 271bloat. 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 272that the urxvt binary is larger (due to some encoding tables always being
2165disable this. 2228disable this.
2166.Sp 2229.Sp
2167A non-exhaustive list of features enabled by \f(CW\*(C`\-\-enable\-frills\*(C'\fR (possibly 2230A non-exhaustive list of features enabled by \f(CW\*(C`\-\-enable\-frills\*(C'\fR (possibly
2168in combination with other switches) is: 2231in combination with other switches) is:
2169.Sp 2232.Sp
2170.Vb 18 2233.Vb 15
2171\& MWM-hints 2234\& MWM-hints
2172\& EWMH-hints (pid, utf8 names) and protocols (ping) 2235\& EWMH-hints (pid, utf8 names) and protocols (ping)
2173\& seperate underline colour (-underlineColor) 2236\& seperate underline colour (-underlineColor)
2174\& settable border widths and borderless switch (-w, -b, -bl) 2237\& settable border widths and borderless switch (-w, -b, -bl)
2175\& visual selection (-depth) 2238\& visual depth selection (-depth)
2176\& settable extra linespacing /-lsp) 2239\& settable extra linespacing /-lsp)
2177\& iso-14755-2 and -3, and visual feedback 2240\& 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) 2241\& tripleclickwords (-tcw)
2181\& settable insecure mode (-insecure) 2242\& settable insecure mode (-insecure)
2182\& keysym remapping support 2243\& keysym remapping support
2183\& cursor blinking and underline cursor (-cb, -uc) 2244\& cursor blinking and underline cursor (-cb, -uc)
2184\& XEmbed support (-embed) 2245\& XEmbed support (-embed)
2185\& user-pty (-pty-fd) 2246\& user-pty (-pty-fd)
2186\& hold on exit (-hold) 2247\& hold on exit (-hold)
2187\& skip builtin block graphics (-sbg) 2248\& skip builtin block graphics (-sbg)
2249.Ve
2250.Sp
2251It also enabled some non-essential features otherwise disabled, such as:
2252.Sp
2253.Vb 11
2254\& some round-trip time optimisations
2255\& nearest color allocation on pseudocolor screens
2256\& UTF8_STRING supporr for selection
2188\& sgr modes 90..97 and 100..107 2257\& sgr modes 90..97 and 100..107
2258\& backindex and forwardindex escape sequences
2259\& view change/zero scorllback esacpe sequences
2260\& locale switching escape sequence
2261\& window op and some xterm/OSC escape sequences
2262\& rectangular selections
2263\& trailing space removal for selections
2264\& verbose X error handling
2189.Ve 2265.Ve
2190.IP "\-\-enable\-iso14755 (default: on)" 4 2266.IP "\-\-enable\-iso14755 (default: on)" 4
2191.IX Item "--enable-iso14755 (default: on)" 2267.IX Item "--enable-iso14755 (default: on)"
2192Enable extended \s-1ISO\s0 14755 support (see @@RXVT_NAME@@(1), or 2268Enable 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 2269\&\fIdoc/rxvt.1.txt\fR). Basic support (section 5.1) is enabled by

Diff Legend

Removed lines
+ Added lines
< Changed lines
> Changed lines