--- rxvt-unicode/doc/rxvt.7.man.in 2006/01/28 22:16:58 1.54 +++ rxvt-unicode/doc/rxvt.7.man.in 2006/01/31 00:25:16 1.56 @@ -129,7 +129,7 @@ .\" ======================================================================== .\" .IX Title "rxvt 7" -.TH rxvt 7 "2006-01-28" "7.4" "RXVT-UNICODE" +.TH rxvt 7 "2006-01-31" "7.5" "RXVT-UNICODE" .SH "NAME" RXVT REFERENCE \- FAQ, command sequences and other background information .SH "SYNOPSIS" @@ -153,8 +153,7 @@ This document contains the \s-1FAQ\s0, the \s-1RXVT\s0 \s-1TECHNICAL\s0 \s-1REFERENCE\s0 documenting all escape sequences, and other background information. .PP -The newest version of this document is -also available on the World Wide Web at +The newest version of this document is also available on the World Wide Web at . .SH "FREQUENTLY ASKED QUESTIONS" .IX Header "FREQUENTLY ASKED QUESTIONS" @@ -202,6 +201,81 @@ .Vb 1 \& URxvt.searchable-scrollback: CM-s .Ve +.IP "Why doesn't rxvt-unicode read my resources?" 4 +.IX Item "Why doesn't rxvt-unicode read my resources?" +Well, why, indeed? It does, in a way very similar to other X +applications. Most importantly, this means that if you or your \s-1OS\s0 loads +resources into the X display (the right way to do it), rxvt-unicode will +ignore any resource files in your home directory. It will only read +\&\fI$HOME/.Xdefaults\fR when no resources are attached to the display. +.Sp +If you have or use an \fI$HOME/.Xresources\fR file, chances are that +resources are loaded into your X\-server. In this case, you have to +re-login after every change (or run \fIxrdb \-merge \f(CI$HOME\fI/.Xresources\fR). +.Sp +Also consider the form resources have to use: +.Sp +.Vb 1 +\& URxvt.resource: value +.Ve +.Sp +If you want to use another form (there are lots of different ways of +specifying resources), make sure you understand wether and why it +works. If unsure, use the form above. +.IP "I can't get transparency working, what am I doing wrong?" 4 +.IX Item "I can't get transparency working, what am I doing wrong?" +First of all, transparency isn't officially supported in rxvt\-unicode, so +you are mostly on your own. Do not bug the author about it (but you may +bug everybody else). Also, if you can't get it working consider it a rite +of passage: ... and you failed. +.Sp +Here are four ways to get transparency. \fBDo\fR read the manpage and option +descriptions for the programs mentioned and rxvt\-unicode. Really, do it! +.Sp +1. Use inheritPixmap: +.Sp +.Vb 2 +\& Esetroot wallpaper.jpg +\& @@RXVT_NAME@@ -ip -tint red -sh 40 +.Ve +.Sp +That works. If you think it doesn't, you lack transparency and tinting +support, or you are unable to read. +.Sp +2. Use a simple pixmap and emulate pseudo\-transparency. This enables you +to use effects other than tinting and shading: Just shade/tint/whatever +your picture with gimp: +.Sp +.Vb 2 +\& convert wallpaper.jpg -blur 20x20 -modulate 30 background.xpm +\& @@RXVT_NAME@@ -pixmap background.xpm -pe automove-background +.Ve +.Sp +That works. If you think it doesn't, you lack \s-1XPM\s0 and Perl support, or you +are unable to read. +.Sp +3. Use an \s-1ARGB\s0 visual: +.Sp +.Vb 1 +\& @@RXVT_NAME@@ -depth 32 -fg grey90 -bg rgba:0000/0000/4444/cccc +.Ve +.Sp +This requires \s-1XFT\s0 support, and the support of your X\-server. If that +doesn't work for you, blame Xorg and Keith Packard. \s-1ARGB\s0 visuals aren't +there yet, no matter what they claim. Rxvt-Unicode contains the neccessary +bugfixes and workarounds for Xft and Xlib to make it work, but that +doesn't mean that your \s-1WM\s0 has the required kludges in place. +.Sp +4. Use xcompmgr and let it do the job: +.Sp +.Vb 2 +\& xprop -frame -f _NET_WM_WINDOW_OPACITY 32c \e +\& -set _NET_WM_WINDOW_OPACITY 0xc0000000 +.Ve +.Sp +Then click on a window you want to make transparent. Replace \f(CW0xc0000000\fR +by other values to change the degree of opacity. If it doesn't work and +your server crashes, you got to keep the pieces. .IP "Isn't rxvt supposed to be small? Don't all those features bloat?" 4 .IX Item "Isn't rxvt supposed to be small? Don't all those features bloat?" I often get asked about this, and I think, no, they didn't cause extra @@ -2167,16 +2241,14 @@ A non-exhaustive list of features enabled by \f(CW\*(C`\-\-enable\-frills\*(C'\fR (possibly in combination with other switches) is: .Sp -.Vb 18 +.Vb 15 \& MWM-hints \& EWMH-hints (pid, utf8 names) and protocols (ping) \& seperate underline colour (-underlineColor) \& settable border widths and borderless switch (-w, -b, -bl) -\& visual selection (-depth) +\& visual depth selection (-depth) \& settable extra linespacing /-lsp) \& iso-14755-2 and -3, and visual feedback -\& backindex and forwardindex escape sequence -\& window op and some xterm/OSC escape sequences \& tripleclickwords (-tcw) \& settable insecure mode (-insecure) \& keysym remapping support @@ -2185,7 +2257,22 @@ \& user-pty (-pty-fd) \& hold on exit (-hold) \& skip builtin block graphics (-sbg) +.Ve +.Sp +It also enabled some non-essential features otherwise disabled, such as: +.Sp +.Vb 11 +\& some round-trip time optimisations +\& nearest color allocation on pseudocolor screens +\& UTF8_STRING supporr for selection \& sgr modes 90..97 and 100..107 +\& backindex and forwardindex escape sequences +\& view change/zero scorllback esacpe sequences +\& locale switching escape sequence +\& window op and some xterm/OSC escape sequences +\& rectangular selections +\& trailing space removal for selections +\& verbose X error handling .Ve .IP "\-\-enable\-iso14755 (default: on)" 4 .IX Item "--enable-iso14755 (default: on)"