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

Comparing rxvt-unicode/doc/rxvt.7.txt (file contents):
Revision 1.83 by root, Wed Aug 1 18:38:16 2007 UTC vs.
Revision 1.84 by root, Sat Oct 27 12:09:02 2007 UTC

… …
189 No large bloated libraries (of course, none were linked in statically), 189 No large bloated libraries (of course, none were linked in statically),
190 except maybe libX11 :) 190 except maybe libX11 :)
191 191
192 Rendering, Font & Look and Feel Issues 192 Rendering, Font & Look and Feel Issues
193 I can't get transparency working, what am I doing wrong? 193 I can't get transparency working, what am I doing wrong?
194 First of all, transparency isn't officially supported in rxvt-unicode, 194 First of all, please address all transparency related issues to Sasha
195 so you are mostly on your own. Do not bug the author about it (but you 195 Vasko at sasha@aftercode.net and do not bug the author about it. Also,
196 may bug everybody else). Also, if you can't get it working consider it a 196 if you can't get it working consider it a rite of passage: ... and you
197 rite of passage: ... and you failed. 197 failed.
198 198
199 Here are four ways to get transparency. Do read the manpage and option 199 Here are four ways to get transparency. Do read the manpage and option
200 descriptions for the programs mentioned and rxvt-unicode. Really, do it! 200 descriptions for the programs mentioned and rxvt-unicode. Really, do it!
201 201
202 1. Use inheritPixmap: 202 1. Use inheritPixmap:
… …
209 209
210 2. Use a simple pixmap and emulate pseudo-transparency. This enables you 210 2. Use a simple pixmap and emulate pseudo-transparency. This enables you
211 to use effects other than tinting and shading: Just shade/tint/whatever 211 to use effects other than tinting and shading: Just shade/tint/whatever
212 your picture with gimp or any other tool: 212 your picture with gimp or any other tool:
213 213
214 convert wallpaper.jpg -blur 20x20 -modulate 30 background.xpm 214 convert wallpaper.jpg -blur 20x20 -modulate 30 background.jpg
215 urxvt -pixmap background.xpm -pe automove-background 215 urxvt -pixmap background.jpg -pe automove-background
216 216
217 That works. If you think it doesn't, you lack XPM and Perl support, or 217 That works. If you think it doesn't, you lack AfterImage and Perl
218 you are unable to read. 218 support, or you are unable to read.
219 219
220 3. Use an ARGB visual: 220 3. Use an ARGB visual:
221 221
222 urxvt -depth 32 -fg grey90 -bg rgba:0000/0000/4444/cccc 222 urxvt -depth 32 -fg grey90 -bg rgba:0000/0000/4444/cccc
223 223
… …
428 fonts for the same character at the same time, but no interface for this 428 fonts for the same character at the same time, but no interface for this
429 has been designed yet). 429 has been designed yet).
430 430
431 Until then, you might get away with switching fonts at runtime (see "Can 431 Until then, you might get away with switching fonts at runtime (see "Can
432 I switch the fonts at runtime?" later in this document). 432 I switch the fonts at runtime?" later in this document).
433
434 How can I make mplayer display video correctly?
435 We are working on it, in the meantime, as a workaround, use something
436 like:
437
438 urxvt -b 600 -geometry 20x1 -e sh -c 'mplayer -wid $WINDOWID file...'
433 439
434 Keyboard, Mouse & User Interaction 440 Keyboard, Mouse & User Interaction
435 The new selection selects pieces that are too big, how can I select single words? 441 The new selection selects pieces that are too big, how can I select single words?
436 If you want to select e.g. alphanumeric words, you can use the following 442 If you want to select e.g. alphanumeric words, you can use the following
437 setting: 443 setting:
… …
1567 1573
1568 "Pm = 1001" (X11 XTerm) *unimplemented* 1574 "Pm = 1001" (X11 XTerm) *unimplemented*
1569 h Use Hilite Mouse Tracking. 1575 h Use Hilite Mouse Tracking.
1570 l No mouse reporting. 1576 l No mouse reporting.
1571 1577
1578 "Pm = 1002" (X11 XTerm)
1579 h Send Mouse X & Y on button press and release, and motion with a button pressed.
1580 l No mouse reporting.
1581
1582 "Pm = 1003" (X11 XTerm)
1583 h Send Mouse X & Y on button press and release, and motion.
1584 l No mouse reporting.
1585
1572 "Pm = 1010" (rxvt) 1586 "Pm = 1010" (rxvt)
1573 h Don't scroll to bottom on TTY output 1587 h Don't scroll to bottom on TTY output
1574 l Scroll to bottom on TTY output 1588 l Scroll to bottom on TTY output
1575 1589
1576 "Pm = 1011" (rxvt) 1590 "Pm = 1011" (rxvt)
… …
1612 Ps = 12 Change colour of text cursor foreground to Pt 1626 Ps = 12 Change colour of text cursor foreground to Pt
1613 Ps = 13 Change colour of mouse foreground to Pt 1627 Ps = 13 Change colour of mouse foreground to Pt
1614 Ps = 17 Change colour of highlight characters to Pt 1628 Ps = 17 Change colour of highlight characters to Pt
1615 Ps = 18 Change colour of bold characters to Pt [deprecated, see 706] 1629 Ps = 18 Change colour of bold characters to Pt [deprecated, see 706]
1616 Ps = 19 Change colour of underlined characters to Pt [deprecated, see 707] 1630 Ps = 19 Change colour of underlined characters to Pt [deprecated, see 707]
1617 Ps = 20 Change background pixmap parameters (see section XPM) (Compile XPM). 1631 Ps = 20 Change background pixmap parameters (see section BACKGROUND IMAGE) (Compile AfterImage).
1618 Ps = 39 Change default foreground colour to Pt. 1632 Ps = 39 Change default foreground colour to Pt.
1619 Ps = 46 Change Log File to Pt unimplemented 1633 Ps = 46 Change Log File to Pt unimplemented
1620 Ps = 49 Change default background colour to Pt. 1634 Ps = 49 Change default background colour to Pt.
1621 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 1635 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
1622 Ps = 55 Log all scrollback buffer and all of screen to Pt 1636 Ps = 55 Log all scrollback buffer and all of screen to Pt
… …
1632 Ps = 713 Set bold-italic fontset to Pt. Similar to Ps = 50 (Compile styles). 1646 Ps = 713 Set bold-italic fontset to Pt. Similar to Ps = 50 (Compile styles).
1633 Ps = 720 Move viewing window up by Pt lines, or clear scrollback buffer if Pt = 0 (Compile frills). 1647 Ps = 720 Move viewing window up by Pt lines, or clear scrollback buffer if Pt = 0 (Compile frills).
1634 Ps = 721 Move viewing window down by Pt lines, or clear scrollback buffer if Pt = 0 (Compile frills). 1648 Ps = 721 Move viewing window down by Pt lines, or clear scrollback buffer if Pt = 0 (Compile frills).
1635 Ps = 777 Call the perl extension with the given string, which should be of the form extension:parameters (Compile perl). 1649 Ps = 777 Call the perl extension with the given string, which should be of the form extension:parameters (Compile perl).
1636 1650
1637XPM 1651BACKGROUND IMAGE
1638 For the XPM XTerm escape sequence "ESC ] 20 ; Pt ST" then value of "Pt" 1652 For the BACGROUND IMAGE XTerm escape sequence "ESC ] 20 ; Pt ST" then
1639 can be the name of the background pixmap followed by a sequence of 1653 value of "Pt" can be the name of the background image file followed by a
1640 scaling/positioning commands separated by semi-colons. The 1654 sequence of scaling/positioning commands separated by semi-colons. The
1641 scaling/positioning commands are as follows: 1655 scaling/positioning commands are as follows:
1642 1656
1643 query scale/position 1657 query scale/position
1644 ? 1658 ?
1645 1659
… …
1671 1685
1672 0xH -> H *= (H/100) 1686 0xH -> H *= (H/100)
1673 1687
1674 For example: 1688 For example:
1675 1689
1676 \E]20;funky\a 1690 \E]20;funky.jpg\a
1677 load funky.xpm as a tiled image 1691 load funky.jpg as a tiled image
1678 1692
1679 \E]20;mona;100\a 1693 \E]20;mona.jpg;100\a
1680 load mona.xpm with a scaling of 100% 1694 load mona.jpg with a scaling of 100%
1681 1695
1682 \E]20;;200;?\a 1696 \E]20;;200;?\a
1683 rescale the current pixmap to 200% and display the image geometry in 1697 rescale the current pixmap to 200% and display the image geometry in
1684 the title 1698 the title
1685 1699
… …
1776 XK_KP_9 9 ESC O y 1790 XK_KP_9 9 ESC O y
1777 1791
1778CONFIGURE OPTIONS 1792CONFIGURE OPTIONS
1779 General hint: if you get compile errors, then likely your configuration 1793 General hint: if you get compile errors, then likely your configuration
1780 hasn't been tested well. Either try with "--enable-everything" or use 1794 hasn't been tested well. Either try with "--enable-everything" or use
1781 the default configuration (i.e. "--enable-xxx" or "--disable-xxx"). Of 1795 the default configuration (i.e. no "--enable-xxx" or "--disable-xxx"
1782 course, you should always report when a combination doesn't work, so it 1796 switches). Of course, you should always report when a combination
1783 can be fixed. Marc Lehmann <rxvt@schmorp.de>. 1797 doesn't work, so it can be fixed. Marc Lehmann <rxvt@schmorp.de>.
1784 1798
1785 All 1799 All
1786 1800
1787 --enable-everything 1801 --enable-everything
1788 Add (or remove) support for all non-multichoice options listed in 1802 Add (or remove) support for all non-multichoice options listed in
… …
1881 --enable-lastlog (default: on) 1895 --enable-lastlog (default: on)
1882 Write user and tty to lastlog file (used by programs like lastlogin) 1896 Write user and tty to lastlog file (used by programs like lastlogin)
1883 at start of rxvt execution. This option requires --enable-utmp to 1897 at start of rxvt execution. This option requires --enable-utmp to
1884 also be specified. 1898 also be specified.
1885 1899
1886 --enable-xpm-background (default: on)
1887 Add support for XPM background pixmaps.
1888
1889 --enable-afterimage (default: on) 1900 --enable-afterimage (default: on)
1890 Add support for libAfterImage to be used for transparency and 1901 Add support for libAfterImage to be used for transparency and
1891 background images. It adds support for many file formats including 1902 background images. It adds support for many file formats including
1892 JPG, PNG, SVG, TIFF, GIF, XPM, BMP, ICO, XCF, TGA and AfterStep 1903 JPG, PNG, SVG, TIFF, GIF, XPM, BMP, ICO, XCF, TGA and AfterStep
1893 image XML 1904 image XML
… …
1895 1906
1896 This option also adds such eye candy as blending an image over the 1907 This option also adds such eye candy as blending an image over the
1897 root background, as well as dynamic scaling and bluring of 1908 root background, as well as dynamic scaling and bluring of
1898 background images. 1909 background images.
1899 1910
1900 Note that with this option enabled, rxvt's memory footprint might 1911 Note that with this option enabled, urxvt's memory footprint might
1901 increase by a few megabytes even if no extra features are used 1912 increase by a few megabytes even if no extra features are used
1902 (mostly due to third-party libraries used by libAI). Memory 1913 (mostly due to third-party libraries used by libAI). Memory
1903 footprint may somewhat be lowered if libAfterImage is configured 1914 footprint may somewhat be lowered if libAfterImage is configured
1904 without support for SVG. 1915 without support for SVG.
1905 1916
… …
1907 Add support for inheriting parent backgrounds thus giving a fake 1918 Add support for inheriting parent backgrounds thus giving a fake
1908 transparency to the term. 1919 transparency to the term.
1909 1920
1910 --enable-fading (default: on) 1921 --enable-fading (default: on)
1911 Add support for fading the text when focus is lost. 1922 Add support for fading the text when focus is lost.
1912
1913 --enable-tinting (default: on)
1914 Add support for tinting of transparent backgrounds (requires
1915 "--enable-transparency").
1916 1923
1917 --enable-rxvt-scroll (default: on) 1924 --enable-rxvt-scroll (default: on)
1918 Add support for the original rxvt scrollbar. 1925 Add support for the original rxvt scrollbar.
1919 1926
1920 --enable-next-scroll (default: on) 1927 --enable-next-scroll (default: on)
… …
1986 rectangular selections 1993 rectangular selections
1987 trailing space removal for selections 1994 trailing space removal for selections
1988 verbose X error handling 1995 verbose X error handling
1989 1996
1990 --enable-iso14755 (default: on) 1997 --enable-iso14755 (default: on)
1991 Enable extended ISO 14755 support (see rxvt(1), or doc/rxvt.1.txt). 1998 Enable extended ISO 14755 support (see urxvt(1), or doc/rxvt.1.txt).
1992 Basic support (section 5.1) is enabled by "--enable-frills", while 1999 Basic support (section 5.1) is enabled by "--enable-frills", while
1993 support for 5.2, 5.3 and 5.4 is enabled with this switch. 2000 support for 5.2, 5.3 and 5.4 is enabled with this switch.
1994 2001
1995 --enable-keepscrolling (default: on) 2002 --enable-keepscrolling (default: on)
1996 Add support for continual scrolling of the display when you hold the 2003 Add support for continual scrolling of the display when you hold the
… …
2015 2022
2016 --enable-pointer-blank (default: on) 2023 --enable-pointer-blank (default: on)
2017 Add support to have the pointer disappear when typing or inactive. 2024 Add support to have the pointer disappear when typing or inactive.
2018 2025
2019 --enable-perl (default: on) 2026 --enable-perl (default: on)
2020 Enable an embedded perl interpreter. See the rxvtperl(3) manpage 2027 Enable an embedded perl interpreter. See the urxvtperl(3) manpage
2021 (doc/rxvtperl.txt) for more info on this feature, or the files in 2028 (doc/rxvtperl.txt) for more info on this feature, or the files in
2022 src/perl-ext/ for the extensions that are installed by default. The 2029 src/perl-ext/ for the extensions that are installed by default. The
2023 perl interpreter that is used can be specified via the "PERL" 2030 perl interpreter that is used can be specified via the "PERL"
2024 environment variable when running configure. Even when compiled in, 2031 environment variable when running configure. Even when compiled in,
2025 perl will *not* be initialised when all extensions have been 2032 perl will *not* be initialised when all extensions have been
… …
2041 to PATH. 2048 to PATH.
2042 2049
2043 --with-x 2050 --with-x
2044 Use the X Window System (pretty much default, eh?). 2051 Use the X Window System (pretty much default, eh?).
2045 2052
2046 --with-xpm-includes=DIR
2047 Look for the XPM includes in DIR.
2048
2049 --with-xpm-library=DIR
2050 Look for the XPM library in DIR.
2051
2052 --with-xpm
2053 Not needed - define via --enable-xpm-background.
2054
2055AUTHORS 2053AUTHORS
2056 Marc Lehmann <rxvt@schmorp.de> converted this document to pod and 2054 Marc Lehmann <rxvt@schmorp.de> converted this document to pod and
2057 reworked it from the original Rxvt documentation, which was done by 2055 reworked it from the original Rxvt documentation, which was done by
2058 Geoff Wing <gcw@pobox.com>, who in turn used the XTerm documentation and 2056 Geoff Wing <gcw@pobox.com>, who in turn used the XTerm documentation and
2059 other sources. 2057 other sources.

Diff Legend

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