--- rxvt-unicode/doc/rxvt.7.pod 2007/08/02 00:09:54 1.143 +++ rxvt-unicode/doc/rxvt.7.pod 2008/01/19 12:13:32 1.161 @@ -19,7 +19,10 @@ all escape sequences, and other background information. The newest version of this document is also available on the World Wide Web at -L. +L. + +The main manual page for @@RXVT_NAME@@ itself is available at +L. =head1 RXVT-UNICODE/URXVT FREQUENTLY ASKED QUESTIONS @@ -199,9 +202,9 @@ libX11.so.6 => /usr/X11R6/lib/libX11.so.6 (0x00002aaaaabc3000) libgcc_s.so.1 => /lib/libgcc_s.so.1 (0x00002aaaaada2000) - libc.so.6 => /lib/libc.so.6 (0x00002aaaaaeb0000) - libdl.so.2 => /lib/libdl.so.2 (0x00002aaaab0ee000) - /lib64/ld-linux-x86-64.so.2 (0x00002aaaaaaab000) + libc.so.6 => /lib/libc.so.6 (0x00002aaaaaeb0000) + libdl.so.2 => /lib/libdl.so.2 (0x00002aaaab0ee000) + /lib64/ld-linux-x86-64.so.2 (0x00002aaaaaaab000) No large bloated libraries (of course, none were linked in statically), except maybe libX11 :) @@ -211,18 +214,17 @@ =head3 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. +First of all, please address all transparency related issues to Sasha Vasko at +sasha@aftercode.net and do not bug the author about it. Also, if you can't +get it working consider it a rite of passage: ... and you failed. Here are four ways to get transparency. B read the manpage and option descriptions for the programs mentioned and rxvt-unicode. Really, do it! -1. Use inheritPixmap: +1. Use transparent mode: Esetroot wallpaper.jpg - @@URXVT_NAME@@ -ip -tint red -sh 40 + @@URXVT_NAME@@ -tr -tint red -sh 40 That works. If you think it doesn't, you lack transparency and tinting support, or you are unable to read. @@ -231,10 +233,10 @@ to use effects other than tinting and shading: Just shade/tint/whatever your picture with gimp or any other tool: - convert wallpaper.jpg -blur 20x20 -modulate 30 background.xpm - @@URXVT_NAME@@ -pixmap background.xpm -pe automove-background + convert wallpaper.jpg -blur 20x20 -modulate 30 background.jpg + @@URXVT_NAME@@ -pixmap "background.jpg;:root" -That works. If you think it doesn't, you lack XPM and Perl support, or you +That works. If you think it doesn't, you lack AfterImage support, or you are unable to read. 3. Use an ARGB visual: @@ -344,10 +346,9 @@ If no bold colour is set via C, bold will invert text using the standard foreground colour. -For the standard background colour, blinking will actually make the -text blink when compiled with C<--enable-blinking>. with standard -colours. Without C<--enable-blinking>, the blink attribute will be -ignored. +For the standard background colour, blinking will actually make +the text blink when compiled with C<--enable-text-blink>. Without +C<--enable-text-blink>, the blink attribute will be ignored. On ANSI colours, bold/blink attributes are used to set high-intensity foreground/background colors. @@ -462,6 +463,13 @@ Until then, you might get away with switching fonts at runtime (see L later in this document). +=head3 How can I make mplayer display video correctly? + +We are working on it, in the meantime, as a workaround, use something like: + + @@URXVT_NAME@@ -b 600 -geometry 20x1 -e sh -c 'mplayer -wid $WINDOWID file...' + + =head2 Keyboard, Mouse & User Interaction =head3 The new selection selects pieces that are too big, how can I select single words? @@ -478,7 +486,7 @@ URxvt.selection.pattern-0: ([^"&'()*,;<=>?@[\\\\]^`{|})]+) -Please also note that the I combination also +Please also note that the I combination also selects words like the old code. =head3 I don't like the new selection/popups/hotkeys/perl, how do I change/disable it? @@ -606,7 +614,7 @@ Some other Backspace problems: -some editors use termcap/terminfo, +some editors use termcap/terminfo, some editors (vim I'm told) expect Backspace = ^H, GNU Emacs (and Emacs-like editors) use ^H for help. @@ -657,7 +665,6 @@ required for your particular machine. - =head2 Terminal Configuration =head3 Can I see a typical configuration? @@ -1070,7 +1077,7 @@ xprop -root XIM_SERVERS -=item +=item =back @@ -1807,8 +1814,8 @@ =begin table - B<< C >> scrollBar visisble - B<< C >> scrollBar invisisble + B<< C >> scrollBar visible + B<< C >> scrollBar invisible =end table @@ -1901,6 +1908,24 @@ =end table +=item B<< C >> (X11 XTerm) + +=begin table + + B<< C >> Send Mouse X & Y on button press and release, and motion with a button pressed. + B<< C >> No mouse reporting. + +=end table + +=item B<< C >> (X11 XTerm) + +=begin table + + B<< C >> Send Mouse X & Y on button press and release, and motion. + B<< C >> No mouse reporting. + +=end table + =item B<< C >> (B) =begin table @@ -1985,7 +2010,7 @@ B<< C >> Change colour of highlight characters to B<< C >> B<< C >> Change colour of bold characters to B<< C >> [deprecated, see 706] B<< C >> Change colour of underlined characters to B<< C >> [deprecated, see 707] - B<< C >> Change background pixmap parameters (see section XPM) (Compile XPM). + B<< C >> Change background pixmap parameters (see section BACKGROUND IMAGE) (Compile AfterImage). B<< C >> Change default foreground colour to B<< C >>. B<< C >> Change Log File to B<< C >> I B<< C >> Change default background colour to B<< C >>. @@ -2009,10 +2034,10 @@ =back -=head1 XPM +=head1 BACKGROUND IMAGE -For the XPM XTerm escape sequence B<< C >> then value -of B<< C >> can be the name of the background pixmap followed by a +For the BACKGROUND IMAGE XTerm escape sequence B<< C >> the value +of B<< C >> can be the name of the background image file followed by a sequence of scaling/positioning commands separated by semi-colons. The scaling/positioning commands are as follows: @@ -2060,13 +2085,13 @@ =over 4 -=item B<\E]20;funky\a> +=item B<\E]20;funky.jpg\a> -load B as a tiled image +load B as a tiled image -=item B<\E]20;mona;100\a> +=item B<\E]20;mona.jpg;100\a> -load B with a scaling of 100% +load B with a scaling of 100% =item B<\E]20;;200;?\a> @@ -2203,9 +2228,9 @@ General hint: if you get compile errors, then likely your configuration hasn't been tested well. Either try with C<--enable-everything> or use -the default configuration (i.e. C<--enable-xxx> or C<--disable-xxx>). Of -course, you should always report when a combination doesn't work, so it -can be fixed. Marc Lehmann . +the default configuration (i.e. no C<--enable-xxx> or C<--disable-xxx> +switches). Of course, you should always report when a combination doesn't +work, so it can be fixed. Marc Lehmann . All @@ -2304,7 +2329,7 @@ Use the given name as default application name when reading resources. Specify --with-res-name=rxvt to replace rxvt. -=item --with-res-class=CLASS /default: URxvt) +=item --with-res-class=CLASS (default: URxvt) Use the given class as default application class when reading resources. Specify --with-res-class=Rxvt to replace @@ -2344,17 +2369,12 @@ =item --enable-transparency (default: on) -Add support for inheriting parent backgrounds thus giving a fake -transparency to the term. +Add support for backgrounds, creating illusion of transparency in the term. =item --enable-fading (default: on) Add support for fading the text when focus is lost. -=item --enable-tinting (default: on) - -Add support for tinting of transparent backgrounds (requires C<--enable-transparency>). - =item --enable-rxvt-scroll (default: on) Add support for the original rxvt scrollbar. @@ -2373,11 +2393,6 @@ is the favourite of the rxvt-unicode author, having used it for many years. -=item --enable-ttygid (default: off) - -Change tty device setting to group "tty" - only use this if -your system uses this type of security. - =item --disable-backspace-key Removes any handling of the backspace key by us - let the X server do it. @@ -2419,6 +2434,7 @@ XEmbed support (-embed) user-pty (-pty-fd) hold on exit (-hold) + compile in built-in block graphics skip builtin block graphics (-sbg) separate highlightcolor support (-hc) @@ -2469,6 +2485,10 @@ This should keep the window corner which is closest to a corner of the screen in a fixed position. +=item --enable-text-blink (default: on) + +Add support for blinking text. + =item --enable-pointer-blank (default: on) Add support to have the pointer disappear when typing or inactive.