--- rxvt-unicode/doc/rxvt.7.pod 2006/01/18 21:00:39 1.89 +++ rxvt-unicode/doc/rxvt.7.pod 2006/01/30 22:49:30 1.95 @@ -66,6 +66,63 @@ URxvt.searchable-scrollback: CM-s +=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 OS 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 +F<$HOME/.Xdefaults> when no resources are attached to the display. + +If you have or use an F<$HOME/.Xresources> file, chances are that +resources are loaded into your X-server. In this case, you have to +re-login after every change (or run F). + +Also consider the form resources have to use: + + URxvt.resource: value + +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. + +=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. + +Here are three ways to get transparency. B read the manpage and option +descriptions for the programs mentioned and rxvt-unicode. Really, do it! + +1. Use inheritPixmap: + + Esetroot wallpaper.jpg + @@RXVT_NAME@@ -ip -tint red -sh 40 + +That works. If you think it doesn't, you lack transparency and tinting +support, or you are unable to read. + +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: + + convert wallpaper.jpg -blur 20x20 -modulate 30 background.xpm + @@RXVT_NAME@@ -pixmap background.xpm -pe automove-background + +That works. If you think it doesn't, you lack XPM and Perl support, or you +are unable to read. + +3. Use an ARGB visual: + + @@RXVT_NAME@@ -depth 432 -fg grey90 -bg rgba:0000/0000/0000/c000 + +This requires XFT support, and support form your X-server. If that doesn't +work for you, blame Xorg and Keith Packard. ARGB 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. + =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 @@ -144,12 +201,19 @@ =item Does it support tabs, can I have a tabbed rxvt-unicode? -rxvt-unicode does not directly support tabs. It will work fine with -tabbing functionality of many window managers or similar tabbing programs, -and its embedding-features allow it to be embedded into other programs, -as witnessed by F or the upcoming C perl -module, which features a tabbed urxvt (murxvt) terminal as an example -embedding application. +Beginning with version 7.3, there is a perl extension that implements a +simple tabbed terminal. It is installed by default, so any of these should +give you tabs: + + @@RXVT_NAME@@ -pe tabbed + + URxvt.perl-ext-common: default,tabbed + +It will also work fine with tabbing functionality of many window managers +or similar tabbing programs, and its embedding-features allow it to be +embedded into other programs, as witnessed by F or +the upcoming C perl module, which features a tabbed urxvt +(murxvt) terminal as an example embedding application. =item How do I know which rxvt-unicode version I'm using? @@ -1677,6 +1741,7 @@ B<< C >> Set fontset to B<< C >>, with the following special values of B<< C >> (B) B<< C<#+n> >> change up B<< C >> B<< C<#-n> >> change down B<< C >> if B<< C >> is missing of 0, a value of 1 is used I change to font0 B<< C >> change to font B<< C >> B<< C >> Log all scrollback buffer and all of screen to B<< C >> B<< C >> Change current locale to B<< C >>, or, if B<< C >> is B<< C >>, return the current locale (Compile frills). + B<< C >> Request version if B<< C >> is B<< C >>, returning C, the resource name, the major and minor version numbers, e.g. C. B<< C >> Change colour of italic characters to B<< C >> B<< C >> Change background pixmap tint colour to B<< C >> (Compile transparency). B<< C >> Change colour of bold characters to B<< C >> @@ -1949,6 +2014,8 @@ =item --enable-unicode3 (default: off) +Recommended to stay off unless you really need non-BMP characters. + Enable direct support for displaying unicode codepoints above 65535 (the basic multilingual page). This increases storage requirements per character from 2 to 4 bytes. X11 fonts do not yet @@ -1968,10 +2035,9 @@ done by using precomposited characters when available or creating new pseudo-characters when no precomposed form exists. -Without --enable-unicode3, the number of additional precomposed characters -is rather limited (2048, if this is full, rxvt-unicode will use the -private use area, extending the number of combinations to 8448). With ---enable-unicode3, no practical limit exists. +Without --enable-unicode3, the number of additional precomposed +characters is somewhat limited (the 6400 private use characters will be +(ab-)used). With --enable-unicode3, no practical limit exists. This option will also enable storage (but not display) of characters beyond plane 0 (>65535) when --enable-unicode3 was not specified. @@ -1982,7 +2048,8 @@ =item --enable-fallback(=CLASS) (default: Rxvt) -When reading resource settings, also read settings for class CLASS. To disable resource fallback use --disable-fallback. +When reading resource settings, also read settings for class CLASS. To +disable resource fallback use --disable-fallback. =item --with-res-name=NAME (default: urxvt) @@ -2082,10 +2149,9 @@ EWMH-hints (pid, utf8 names) and protocols (ping) seperate underline colour (-underlineColor) settable border widths and borderless switch (-w, -b, -bl) + 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 @@ -2094,7 +2160,20 @@ user-pty (-pty-fd) hold on exit (-hold) skip builtin block graphics (-sbg) + +It also enabled some non-essential features otherwise disabled, such as: + + 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 =item --enable-iso14755 (default: on) @@ -2147,7 +2226,7 @@ Add support to have the pointer disappear when typing or inactive. -=item --enable-perl (default: off) +=item --enable-perl (default: on) Enable an embedded perl interpreter. See the B<@@RXVT_NAME@@perl(3)> manpage (F) for more info on this feature, or the files