--- rxvt-unicode/doc/rxvt.7.man.in 2006/01/19 19:26:31 1.50 +++ rxvt-unicode/doc/rxvt.7.man.in 2006/01/30 22:49:30 1.55 @@ -129,7 +129,7 @@ .\" ======================================================================== .\" .IX Title "rxvt 7" -.TH rxvt 7 "2006-01-19" "7.1" "RXVT-UNICODE" +.TH rxvt 7 "2006-01-30" "7.4" "RXVT-UNICODE" .SH "NAME" RXVT REFERENCE \- FAQ, command sequences and other background information .SH "SYNOPSIS" @@ -202,6 +202,69 @@ .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 three 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 432 -fg grey90 -bg rgba:0000/0000/0000/c000 +.Ve +.Sp +This requires \s-1XFT\s0 support, and support form 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. .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 @@ -286,12 +349,23 @@ except maybe libX11 :) .IP "Does it support tabs, can I have a tabbed rxvt\-unicode?" 4 .IX 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 \fIdoc/rxvt\-tabbed\fR or the upcoming \f(CW\*(C`Gtk2::URxvt\*(C'\fR 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: +.Sp +.Vb 1 +\& @@RXVT_NAME@@ -pe tabbed +.Ve +.Sp +.Vb 1 +\& URxvt.perl-ext-common: default,tabbed +.Ve +.Sp +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 \fIdoc/rxvt\-tabbed\fR or +the upcoming \f(CW\*(C`Gtk2::URxvt\*(C'\fR perl module, which features a tabbed urxvt +(murxvt) terminal as an example embedding application. .IP "How do I know which rxvt-unicode version I'm using?" 4 .IX Item "How do I know which rxvt-unicode version I'm using?" The version number is displayed with the usage (\-h). Also the escape @@ -1818,6 +1892,7 @@ Ps = 50 Set fontset to Pt, with the following special values of Pt (rxvt) #+n change up n #-n change down n if n is missing of 0, a value of 1 is used empty change to font0 n change to font n Ps = 55 Log all scrollback buffer and all of screen to Pt Ps = 701 Change current locale to Pt, or, if Pt is ?, return the current locale (Compile frills). +Ps = 702 Request version if Pt is ?, returning rxvt-unicode, the resource name, the major and minor version numbers, e.g. ESC ] 702 ; rxvt-unicode ; urxvt ; 7 ; 4 ST. Ps = 704 Change colour of italic characters to Pt Ps = 705 Change background pixmap tint colour to Pt (Compile transparency). Ps = 706 Change colour of bold characters to Pt @@ -2045,6 +2120,8 @@ set up the input for people using dead keys or compose keys. .IP "\-\-enable\-unicode3 (default: off)" 4 .IX Item "--enable-unicode3 (default: off)" +Recommended to stay off unless you really need non-BMP characters. +.Sp 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 @@ -2063,10 +2140,9 @@ done by using precomposited characters when available or creating new pseudo-characters when no precomposed form exists. .Sp -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. .Sp This option will also enable storage (but not display) of characters beyond plane 0 (>65535) when \-\-enable\-unicode3 was not specified. @@ -2076,7 +2152,8 @@ tell me how these are to be used...). .IP "\-\-enable\-fallback(=CLASS) (default: Rxvt)" 4 .IX Item "--enable-fallback(=CLASS) (default: Rxvt)" -When reading resource settings, also read settings for class \s-1CLASS\s0. To disable resource fallback use \-\-disable\-fallback. +When reading resource settings, also read settings for class \s-1CLASS\s0. To +disable resource fallback use \-\-disable\-fallback. .IP "\-\-with\-res\-name=NAME (default: urxvt)" 4 .IX Item "--with-res-name=NAME (default: urxvt)" Use the given name as default application name when @@ -2153,15 +2230,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 17 +.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 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 @@ -2170,7 +2246,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)" @@ -2214,8 +2305,8 @@ .IP "\-\-enable\-pointer\-blank (default: on)" 4 .IX Item "--enable-pointer-blank (default: on)" Add support to have the pointer disappear when typing or inactive. -.IP "\-\-enable\-perl (default: off)" 4 -.IX Item "--enable-perl (default: off)" +.IP "\-\-enable\-perl (default: on)" 4 +.IX Item "--enable-perl (default: on)" Enable an embedded perl interpreter. See the \fB@@RXVT_NAME@@\f(BIperl\fB\|(3)\fR manpage (\fIdoc/rxvtperl.txt\fR) for more info on this feature, or the files in \fIsrc/perl\-ext/\fR for the extensions that are installed by default. The