ViewVC Help
View File | Revision Log | Show Annotations | Download File
/cvs/rxvt-unicode/doc/rxvt.7.pod
(Generate patch)

Comparing rxvt-unicode/doc/rxvt.7.pod (file contents):
Revision 1.143 by ayin, Thu Aug 2 00:09:54 2007 UTC vs.
Revision 1.155 by ayin, Sun Dec 9 12:15:39 2007 UTC

… …
197 197
198And here is rxvt-unicode: 198And here is rxvt-unicode:
199 199
200 libX11.so.6 => /usr/X11R6/lib/libX11.so.6 (0x00002aaaaabc3000) 200 libX11.so.6 => /usr/X11R6/lib/libX11.so.6 (0x00002aaaaabc3000)
201 libgcc_s.so.1 => /lib/libgcc_s.so.1 (0x00002aaaaada2000) 201 libgcc_s.so.1 => /lib/libgcc_s.so.1 (0x00002aaaaada2000)
202 libc.so.6 => /lib/libc.so.6 (0x00002aaaaaeb0000) 202 libc.so.6 => /lib/libc.so.6 (0x00002aaaaaeb0000)
203 libdl.so.2 => /lib/libdl.so.2 (0x00002aaaab0ee000) 203 libdl.so.2 => /lib/libdl.so.2 (0x00002aaaab0ee000)
204 /lib64/ld-linux-x86-64.so.2 (0x00002aaaaaaab000) 204 /lib64/ld-linux-x86-64.so.2 (0x00002aaaaaaab000)
205 205
206No large bloated libraries (of course, none were linked in statically), 206No large bloated libraries (of course, none were linked in statically),
207except maybe libX11 :) 207except maybe libX11 :)
208 208
209 209
210=head2 Rendering, Font & Look and Feel Issues 210=head2 Rendering, Font & Look and Feel Issues
211 211
212=head3 I can't get transparency working, what am I doing wrong? 212=head3 I can't get transparency working, what am I doing wrong?
213 213
214First of all, transparency isn't officially supported in rxvt-unicode, so 214First of all, please address all transparency related issues to Sasha Vasko at
215you are mostly on your own. Do not bug the author about it (but you may 215sasha@aftercode.net and do not bug the author about it. Also, if you can't
216bug everybody else). Also, if you can't get it working consider it a rite 216get it working consider it a rite of passage: ... and you failed.
217of passage: ... and you failed.
218 217
219Here are four ways to get transparency. B<Do> read the manpage and option 218Here are four ways to get transparency. B<Do> read the manpage and option
220descriptions for the programs mentioned and rxvt-unicode. Really, do it! 219descriptions for the programs mentioned and rxvt-unicode. Really, do it!
221 220
2221. Use inheritPixmap: 2211. Use transparent mode:
223 222
224 Esetroot wallpaper.jpg 223 Esetroot wallpaper.jpg
225 @@URXVT_NAME@@ -ip -tint red -sh 40 224 @@URXVT_NAME@@ -tr -tint red -sh 40
226 225
227That works. If you think it doesn't, you lack transparency and tinting 226That works. If you think it doesn't, you lack transparency and tinting
228support, or you are unable to read. 227support, or you are unable to read.
229 228
2302. Use a simple pixmap and emulate pseudo-transparency. This enables you 2292. Use a simple pixmap and emulate pseudo-transparency. This enables you
231to use effects other than tinting and shading: Just shade/tint/whatever 230to use effects other than tinting and shading: Just shade/tint/whatever
232your picture with gimp or any other tool: 231your picture with gimp or any other tool:
233 232
234 convert wallpaper.jpg -blur 20x20 -modulate 30 background.xpm 233 convert wallpaper.jpg -blur 20x20 -modulate 30 background.jpg
235 @@URXVT_NAME@@ -pixmap background.xpm -pe automove-background 234 @@URXVT_NAME@@ -pixmap "background.jpg;:root"
236 235
237That works. If you think it doesn't, you lack XPM and Perl support, or you 236That works. If you think it doesn't, you lack AfterImage support, or you
238are unable to read. 237are unable to read.
239 238
2403. Use an ARGB visual: 2393. Use an ARGB visual:
241 240
242 @@URXVT_NAME@@ -depth 32 -fg grey90 -bg rgba:0000/0000/4444/cccc 241 @@URXVT_NAME@@ -depth 32 -fg grey90 -bg rgba:0000/0000/4444/cccc
… …
342=head3 What's with this bold/blink stuff? 341=head3 What's with this bold/blink stuff?
343 342
344If no bold colour is set via C<colorBD:>, bold will invert text using the 343If no bold colour is set via C<colorBD:>, bold will invert text using the
345standard foreground colour. 344standard foreground colour.
346 345
347For the standard background colour, blinking will actually make the 346For the standard background colour, blinking will actually make
348text blink when compiled with C<--enable-blinking>. with standard 347the text blink when compiled with C<--enable-text-blink>. Without
349colours. Without C<--enable-blinking>, the blink attribute will be 348C<--enable-text-blink>, the blink attribute will be ignored.
350ignored.
351 349
352On ANSI colours, bold/blink attributes are used to set high-intensity 350On ANSI colours, bold/blink attributes are used to set high-intensity
353foreground/background colors. 351foreground/background colors.
354 352
355color0-7 are the low-intensity colors. 353color0-7 are the low-intensity colors.
… …
460has been designed yet). 458has been designed yet).
461 459
462Until then, you might get away with switching fonts at runtime (see L<Can 460Until then, you might get away with switching fonts at runtime (see L<Can
463I switch the fonts at runtime?> later in this document). 461I switch the fonts at runtime?> later in this document).
464 462
463=head3 How can I make mplayer display video correctly?
464
465We are working on it, in the meantime, as a workaround, use something like:
466
467 @@URXVT_NAME@@ -b 600 -geometry 20x1 -e sh -c 'mplayer -wid $WINDOWID file...'
468
469
465=head2 Keyboard, Mouse & User Interaction 470=head2 Keyboard, Mouse & User Interaction
466 471
467=head3 The new selection selects pieces that are too big, how can I select single words? 472=head3 The new selection selects pieces that are too big, how can I select single words?
468 473
469If you want to select e.g. alphanumeric words, you can use the following 474If you want to select e.g. alphanumeric words, you can use the following
… …
604key has been assigned an escape sequence to match the vt100 for Execute 609key has been assigned an escape sequence to match the vt100 for Execute
605(C<ESC [ 3 ~>) and is in the supplied termcap/terminfo. 610(C<ESC [ 3 ~>) and is in the supplied termcap/terminfo.
606 611
607Some other Backspace problems: 612Some other Backspace problems:
608 613
609some editors use termcap/terminfo, 614some editors use termcap/terminfo,
610some editors (vim I'm told) expect Backspace = ^H, 615some editors (vim I'm told) expect Backspace = ^H,
611GNU Emacs (and Emacs-like editors) use ^H for help. 616GNU Emacs (and Emacs-like editors) use ^H for help.
612 617
613Perhaps someday this will all be resolved in a consistent manner. 618Perhaps someday this will all be resolved in a consistent manner.
614 619
… …
655Rather than have rxvt-unicode try to accommodate all the various possible 660Rather than have rxvt-unicode try to accommodate all the various possible
656keyboard mappings, it is better to use `xmodmap' to remap the keys as 661keyboard mappings, it is better to use `xmodmap' to remap the keys as
657required for your particular machine. 662required for your particular machine.
658 663
659 664
660
661=head2 Terminal Configuration 665=head2 Terminal Configuration
662 666
663=head3 Can I see a typical configuration? 667=head3 Can I see a typical configuration?
664 668
665The default configuration tries to be xterm-like, which I don't like that 669The default configuration tries to be xterm-like, which I don't like that
… …
1068C<@im=kinput2>. For B<scim>, use C<@im=SCIM>. You can see what input 1072C<@im=kinput2>. For B<scim>, use C<@im=SCIM>. You can see what input
1069method servers are running with this command: 1073method servers are running with this command:
1070 1074
1071 xprop -root XIM_SERVERS 1075 xprop -root XIM_SERVERS
1072 1076
1073=item 1077=item
1074 1078
1075=back 1079=back
1076 1080
1077=head3 My input method wants <some encoding> but I want UTF-8, what can I do? 1081=head3 My input method wants <some encoding> but I want UTF-8, what can I do?
1078 1082
… …
1899 B<< C<h> >> Use Hilite Mouse Tracking. 1903 B<< C<h> >> Use Hilite Mouse Tracking.
1900 B<< C<l> >> No mouse reporting. 1904 B<< C<l> >> No mouse reporting.
1901 1905
1902=end table 1906=end table
1903 1907
1908=item B<< C<Pm = 1002> >> (X11 XTerm)
1909
1910=begin table
1911
1912 B<< C<h> >> Send Mouse X & Y on button press and release, and motion with a button pressed.
1913 B<< C<l> >> No mouse reporting.
1914
1915=end table
1916
1917=item B<< C<Pm = 1003> >> (X11 XTerm)
1918
1919=begin table
1920
1921 B<< C<h> >> Send Mouse X & Y on button press and release, and motion.
1922 B<< C<l> >> No mouse reporting.
1923
1924=end table
1925
1904=item B<< C<Pm = 1010> >> (B<rxvt>) 1926=item B<< C<Pm = 1010> >> (B<rxvt>)
1905 1927
1906=begin table 1928=begin table
1907 1929
1908 B<< C<h> >> Don't scroll to bottom on TTY output 1930 B<< C<h> >> Don't scroll to bottom on TTY output
… …
1983 B<< C<Ps = 12> >> Change colour of text cursor foreground to B<< C<Pt> >> 2005 B<< C<Ps = 12> >> Change colour of text cursor foreground to B<< C<Pt> >>
1984 B<< C<Ps = 13> >> Change colour of mouse foreground to B<< C<Pt> >> 2006 B<< C<Ps = 13> >> Change colour of mouse foreground to B<< C<Pt> >>
1985 B<< C<Ps = 17> >> Change colour of highlight characters to B<< C<Pt> >> 2007 B<< C<Ps = 17> >> Change colour of highlight characters to B<< C<Pt> >>
1986 B<< C<Ps = 18> >> Change colour of bold characters to B<< C<Pt> >> [deprecated, see 706] 2008 B<< C<Ps = 18> >> Change colour of bold characters to B<< C<Pt> >> [deprecated, see 706]
1987 B<< C<Ps = 19> >> Change colour of underlined characters to B<< C<Pt> >> [deprecated, see 707] 2009 B<< C<Ps = 19> >> Change colour of underlined characters to B<< C<Pt> >> [deprecated, see 707]
1988 B<< C<Ps = 20> >> Change background pixmap parameters (see section XPM) (Compile XPM). 2010 B<< C<Ps = 20> >> Change background pixmap parameters (see section BACKGROUND IMAGE) (Compile AfterImage).
1989 B<< C<Ps = 39> >> Change default foreground colour to B<< C<Pt> >>. 2011 B<< C<Ps = 39> >> Change default foreground colour to B<< C<Pt> >>.
1990 B<< C<Ps = 46> >> Change Log File to B<< C<Pt> >> I<unimplemented> 2012 B<< C<Ps = 46> >> Change Log File to B<< C<Pt> >> I<unimplemented>
1991 B<< C<Ps = 49> >> Change default background colour to B<< C<Pt> >>. 2013 B<< C<Ps = 49> >> Change default background colour to B<< C<Pt> >>.
1992 B<< C<Ps = 50> >> Set fontset to B<< C<Pt> >>, with the following special values of B<< C<Pt> >> (B<rxvt>) B<< C<#+n> >> change up B<< C<n> >> B<< C<#-n> >> change down B<< C<n> >> if B<< C<n> >> is missing of 0, a value of 1 is used I<empty> change to font0 B<< C<n> >> change to font B<< C<n> >> 2014 B<< C<Ps = 50> >> Set fontset to B<< C<Pt> >>, with the following special values of B<< C<Pt> >> (B<rxvt>) B<< C<#+n> >> change up B<< C<n> >> B<< C<#-n> >> change down B<< C<n> >> if B<< C<n> >> is missing of 0, a value of 1 is used I<empty> change to font0 B<< C<n> >> change to font B<< C<n> >>
1993 B<< C<Ps = 55> >> Log all scrollback buffer and all of screen to B<< C<Pt> >> 2015 B<< C<Ps = 55> >> Log all scrollback buffer and all of screen to B<< C<Pt> >>
… …
2007 2029
2008=end table 2030=end table
2009 2031
2010=back 2032=back
2011 2033
2012=head1 XPM 2034=head1 BACKGROUND IMAGE
2013 2035
2014For the XPM XTerm escape sequence B<< C<ESC ] 20 ; Pt ST> >> then value 2036For the BACGROUND IMAGE XTerm escape sequence B<< C<ESC ] 20 ; Pt ST> >> then value
2015of B<< C<Pt> >> can be the name of the background pixmap followed by a 2037of B<< C<Pt> >> can be the name of the background image file followed by a
2016sequence of scaling/positioning commands separated by semi-colons. The 2038sequence of scaling/positioning commands separated by semi-colons. The
2017scaling/positioning commands are as follows: 2039scaling/positioning commands are as follows:
2018 2040
2019=over 4 2041=over 4
2020 2042
… …
2058 2080
2059For example: 2081For example:
2060 2082
2061=over 4 2083=over 4
2062 2084
2063=item B<\E]20;funky\a> 2085=item B<\E]20;funky.jpg\a>
2064 2086
2065load B<funky.xpm> as a tiled image 2087load B<funky.jpg> as a tiled image
2066 2088
2067=item B<\E]20;mona;100\a> 2089=item B<\E]20;mona.jpg;100\a>
2068 2090
2069load B<mona.xpm> with a scaling of 100% 2091load B<mona.jpg> with a scaling of 100%
2070 2092
2071=item B<\E]20;;200;?\a> 2093=item B<\E]20;;200;?\a>
2072 2094
2073rescale the current pixmap to 200% and display the image geometry in 2095rescale the current pixmap to 200% and display the image geometry in
2074the title 2096the title
… …
2201 2223
2202=head1 CONFIGURE OPTIONS 2224=head1 CONFIGURE OPTIONS
2203 2225
2204General hint: if you get compile errors, then likely your configuration 2226General hint: if you get compile errors, then likely your configuration
2205hasn't been tested well. Either try with C<--enable-everything> or use 2227hasn't been tested well. Either try with C<--enable-everything> or use
2206the default configuration (i.e. C<--enable-xxx> or C<--disable-xxx>). Of 2228the default configuration (i.e. no C<--enable-xxx> or C<--disable-xxx>
2207course, you should always report when a combination doesn't work, so it 2229switches). Of course, you should always report when a combination doesn't
2208can be fixed. Marc Lehmann <rxvt@schmorp.de>. 2230work, so it can be fixed. Marc Lehmann <rxvt@schmorp.de>.
2209 2231
2210All 2232All
2211 2233
2212=over 4 2234=over 4
2213 2235
… …
2302=item --with-res-name=NAME (default: urxvt) 2324=item --with-res-name=NAME (default: urxvt)
2303 2325
2304Use the given name as default application name when 2326Use the given name as default application name when
2305reading resources. Specify --with-res-name=rxvt to replace rxvt. 2327reading resources. Specify --with-res-name=rxvt to replace rxvt.
2306 2328
2307=item --with-res-class=CLASS /default: URxvt) 2329=item --with-res-class=CLASS (default: URxvt)
2308 2330
2309Use the given class as default application class 2331Use the given class as default application class
2310when reading resources. Specify --with-res-class=Rxvt to replace 2332when reading resources. Specify --with-res-class=Rxvt to replace
2311rxvt. 2333rxvt.
2312 2334
… …
2342to third-party libraries used by libAI). Memory footprint may somewhat be 2364to third-party libraries used by libAI). Memory footprint may somewhat be
2343lowered if libAfterImage is configured without support for SVG. 2365lowered if libAfterImage is configured without support for SVG.
2344 2366
2345=item --enable-transparency (default: on) 2367=item --enable-transparency (default: on)
2346 2368
2347Add support for inheriting parent backgrounds thus giving a fake 2369Add support for backgrounds, creating illusion of transparency in the term.
2348transparency to the term.
2349 2370
2350=item --enable-fading (default: on) 2371=item --enable-fading (default: on)
2351 2372
2352Add support for fading the text when focus is lost. 2373Add support for fading the text when focus is lost.
2353
2354=item --enable-tinting (default: on)
2355
2356Add support for tinting of transparent backgrounds (requires C<--enable-transparency>).
2357 2374
2358=item --enable-rxvt-scroll (default: on) 2375=item --enable-rxvt-scroll (default: on)
2359 2376
2360Add support for the original rxvt scrollbar. 2377Add support for the original rxvt scrollbar.
2361 2378
… …
2417 keysym remapping support 2434 keysym remapping support
2418 cursor blinking and underline cursor (-cb, -uc) 2435 cursor blinking and underline cursor (-cb, -uc)
2419 XEmbed support (-embed) 2436 XEmbed support (-embed)
2420 user-pty (-pty-fd) 2437 user-pty (-pty-fd)
2421 hold on exit (-hold) 2438 hold on exit (-hold)
2439 compile in built-in block graphics
2422 skip builtin block graphics (-sbg) 2440 skip builtin block graphics (-sbg)
2423 separate highlightcolor support (-hc) 2441 separate highlightcolor support (-hc)
2424 2442
2425It also enables some non-essential features otherwise disabled, such as: 2443It also enables some non-essential features otherwise disabled, such as:
2426 2444

Diff Legend

– Removed lines
+ Added lines
< Changed lines
> Changed lines