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.21 by root, Wed Jul 13 02:53:54 2005 UTC vs.
Revision 1.27 by root, Thu Dec 22 16:44:10 2005 UTC

… …
469 it gets worse, as rxvt-unicode then uses 8 bytes per screen cell. 469 it gets worse, as rxvt-unicode then uses 8 bytes per screen cell.
470 470
471 Can I speed up Xft rendering somehow? 471 Can I speed up Xft rendering somehow?
472 Yes, the most obvious way to speed it up is to avoid Xft entirely, 472 Yes, the most obvious way to speed it up is to avoid Xft entirely,
473 as it is simply slow. If you still want Xft fonts you might try to 473 as it is simply slow. If you still want Xft fonts you might try to
474 disable antialiasing (by appending ":antialiasing=false"), which 474 disable antialiasing (by appending ":antialias=false"), which saves
475 saves lots of memory and also speeds up rendering considerably. 475 lots of memory and also speeds up rendering considerably.
476 476
477 Rxvt-unicode doesn't seem to anti-alias its fonts, what is wrong? 477 Rxvt-unicode doesn't seem to anti-alias its fonts, what is wrong?
478 Rxvt-unicode will use whatever you specify as a font. If it needs to 478 Rxvt-unicode will use whatever you specify as a font. If it needs to
479 fall back to it's default font search list it will prefer X11 core 479 fall back to it's default font search list it will prefer X11 core
480 fonts, because they are small and fast, and then use Xft fonts. It 480 fonts, because they are small and fast, and then use Xft fonts. It
… …
552 URxvt.color14: #73f7ff 552 URxvt.color14: #73f7ff
553 URxvt.color7: #e1dddd 553 URxvt.color7: #e1dddd
554 URxvt.color15: #e1dddd 554 URxvt.color15: #e1dddd
555 555
556 How can I start rxvtd in a race-free way? 556 How can I start rxvtd in a race-free way?
557 Despite it's name, rxvtd is not a real daemon, but more like a 557 Try "rxvtd -f -o", which tells rxvtd to open the display, create the
558 server that answers rxvtc's requests, so it doesn't background 558 listening socket and then fork.
559 itself.
560
561 To ensure rxvtd is listening on it's socket, you can use the
562 following method to wait for the startup message before continuing:
563
564 { rxvtd & } | read
565 559
566 What's with the strange Backspace/Delete key behaviour? 560 What's with the strange Backspace/Delete key behaviour?
567 Assuming that the physical Backspace key corresponds to the 561 Assuming that the physical Backspace key corresponds to the
568 BackSpace keysym (not likely for Linux ... see the following 562 BackSpace keysym (not likely for Linux ... see the following
569 question) there are two standard values that can be used for 563 question) there are two standard values that can be used for
… …
1675 XK_KP_8 8 ESC O x 1669 XK_KP_8 8 ESC O x
1676 XK_KP_9 9 ESC O y 1670 XK_KP_9 9 ESC O y
1677 1671
1678CONFIGURE OPTIONS 1672CONFIGURE OPTIONS
1679 General hint: if you get compile errors, then likely your configuration 1673 General hint: if you get compile errors, then likely your configuration
1680 hasn't been tested well. Either try with --enable-everything or use the 1674 hasn't been tested well. Either try with "--enable-everything" or use
1681 ./reconf script as a base for experiments. ./reconf is used by myself, 1675 the ./reconf script as a base for experiments. ./reconf is used by
1682 so it should generally be a working config. Of course, you should always 1676 myself, so it should generally be a working config. Of course, you
1683 report when a combination doesn't work, so it can be fixed. Marc Lehmann 1677 should always report when a combination doesn't work, so it can be
1684 <rxvt@schmorp.de>. 1678 fixed. Marc Lehmann <rxvt@schmorp.de>.
1679
1680 All
1685 1681
1686 --enable-everything 1682 --enable-everything
1687 Add support for all non-multichoice options listed in "./configure 1683 Add (or remove) support for all non-multichoice options listed in
1688 --help". Note that unlike other enable options this is order 1684 "./configure --help".
1689 dependant. You can specify this and then disable options which this
1690 enables by *following* this with the appropriate commands.
1691 1685
1692 --enable-xft 1686 You can specify this and then disable options you do not like by
1687 *following* this with the appropriate "--disable-..." arguments, or
1688 you can start with a minimal configuration by specifying
1689 "--disable-everything" and than adding just the "--enable-..."
1690 arguments you want.
1691
1692 --enable-xft (default: enabled)
1693 Add support for Xft (anti-aliases, among others) fonts. Xft fonts 1693 Add support for Xft (anti-aliases, among others) fonts. Xft fonts
1694 are slower and require lots of memory, but as long as you don't use 1694 are slower and require lots of memory, but as long as you don't use
1695 them, you don't pay for them. 1695 them, you don't pay for them.
1696 1696
1697 --enable-font-styles 1697 --enable-font-styles (default: on)
1698 Add support for bold, *italic* and *bold italic* font styles. The 1698 Add support for bold, *italic* and *bold italic* font styles. The
1699 fonts can be set manually or automatically. 1699 fonts can be set manually or automatically.
1700 1700
1701 --with-codesets=NAME,... 1701 --with-codesets=NAME,... (default: all)
1702 Compile in support for additional codeset (encoding) groups ("eu", 1702 Compile in support for additional codeset (encoding) groups ("eu",
1703 "vn" are always compiled in, which includes most 8-bit character 1703 "vn" are always compiled in, which includes most 8-bit character
1704 sets). These codeset tables are used for driving X11 core fonts, 1704 sets). These codeset tables are used for driving X11 core fonts,
1705 they are not required for Xft fonts, although having them compiled 1705 they are not required for Xft fonts, although having them compiled
1706 in lets rxvt-unicode choose replacement fonts more intelligently. 1706 in lets rxvt-unicode choose replacement fonts more intelligently.
… …
1713 zh_ext rarely used but very big chinese encodigs 1713 zh_ext rarely used but very big chinese encodigs
1714 jp common japanese encodings 1714 jp common japanese encodings
1715 jp_ext rarely used but big japanese encodings 1715 jp_ext rarely used but big japanese encodings
1716 kr korean encodings 1716 kr korean encodings
1717 1717
1718 --enable-xim 1718 --enable-xim (default: on)
1719 Add support for XIM (X Input Method) protocol. This allows using 1719 Add support for XIM (X Input Method) protocol. This allows using
1720 alternative input methods (e.g. kinput2) and will also correctly set 1720 alternative input methods (e.g. kinput2) and will also correctly set
1721 up the input for people using dead keys or compose keys. 1721 up the input for people using dead keys or compose keys.
1722 1722
1723 --enable-unicode3 1723 --enable-unicode3 (default: off)
1724 Enable direct support for displaying unicode codepoints above 65535 1724 Enable direct support for displaying unicode codepoints above 65535
1725 (the basic multilingual page). This increases storage requirements 1725 (the basic multilingual page). This increases storage requirements
1726 per character from 2 to 4 bytes. X11 fonts do not yet support these 1726 per character from 2 to 4 bytes. X11 fonts do not yet support these
1727 extra characters, but Xft does. 1727 extra characters, but Xft does.
1728 1728
… …
1730 even without this flag, but the number of such characters is limited 1730 even without this flag, but the number of such characters is limited
1731 to a view thousand (shared with combining characters, see next 1731 to a view thousand (shared with combining characters, see next
1732 switch), and right now rxvt-unicode cannot display them 1732 switch), and right now rxvt-unicode cannot display them
1733 (input/output and cut&paste still work, though). 1733 (input/output and cut&paste still work, though).
1734 1734
1735 --enable-combining 1735 --enable-combining (default: on)
1736 Enable automatic composition of combining characters into composite 1736 Enable automatic composition of combining characters into composite
1737 characters. This is required for proper viewing of text where 1737 characters. This is required for proper viewing of text where
1738 accents are encoded as seperate unicode characters. This is done by 1738 accents are encoded as seperate unicode characters. This is done by
1739 using precomposited characters when available or creating new 1739 using precomposited characters when available or creating new
1740 pseudo-characters when no precomposed form exists. 1740 pseudo-characters when no precomposed form exists.
… …
1749 1749
1750 The combining table also contains entries for arabic presentation 1750 The combining table also contains entries for arabic presentation
1751 forms, but these are not currently used. Bug me if you want these to 1751 forms, but these are not currently used. Bug me if you want these to
1752 be used (and tell me how these are to be used...). 1752 be used (and tell me how these are to be used...).
1753 1753
1754 --enable-fallback(=CLASS) 1754 --enable-fallback(=CLASS) (default: Rxvt)
1755 When reading resource settings, also read settings for class CLASS 1755 When reading resource settings, also read settings for class CLASS.
1756 (default: Rxvt). To disable resource fallback use 1756 To disable resource fallback use --disable-fallback.
1757 --disable-fallback.
1758 1757
1759 --with-res-name=NAME 1758 --with-res-name=NAME (default: urxvt)
1760 Use the given name (default: urxvt) as default application name when 1759 Use the given name as default application name when reading
1761 reading resources. Specify --with-res-name=rxvt to replace rxvt. 1760 resources. Specify --with-res-name=rxvt to replace rxvt.
1762 1761
1763 --with-res-class=CLASS 1762 --with-res-class=CLASS /default: URxvt)
1764 Use the given class (default: URxvt) as default application class 1763 Use the given class as default application class when reading
1765 when reading resources. Specify --with-res-class=Rxvt to replace 1764 resources. Specify --with-res-class=Rxvt to replace rxvt.
1766 rxvt.
1767 1765
1768 --enable-utmp 1766 --enable-utmp (default: on)
1769 Write user and tty to utmp file (used by programs like w) at start 1767 Write user and tty to utmp file (used by programs like w) at start
1770 of rxvt execution and delete information when rxvt exits. 1768 of rxvt execution and delete information when rxvt exits.
1771 1769
1772 --enable-wtmp 1770 --enable-wtmp (default: on)
1773 Write user and tty to wtmp file (used by programs like last) at 1771 Write user and tty to wtmp file (used by programs like last) at
1774 start of rxvt execution and write logout when rxvt exits. This 1772 start of rxvt execution and write logout when rxvt exits. This
1775 option requires --enable-utmp to also be specified. 1773 option requires --enable-utmp to also be specified.
1776 1774
1777 --enable-lastlog 1775 --enable-lastlog (default: on)
1778 Write user and tty to lastlog file (used by programs like lastlogin) 1776 Write user and tty to lastlog file (used by programs like lastlogin)
1779 at start of rxvt execution. This option requires --enable-utmp to 1777 at start of rxvt execution. This option requires --enable-utmp to
1780 also be specified. 1778 also be specified.
1781 1779
1782 --enable-xpm-background 1780 --enable-xpm-background (default: off)
1783 Add support for XPM background pixmaps. 1781 Add support for XPM background pixmaps.
1784 1782
1785 --enable-transparency 1783 --enable-transparency (default: off)
1786 Add support for inheriting parent backgrounds thus giving a fake 1784 Add support for inheriting parent backgrounds thus giving a fake
1787 transparency to the term. 1785 transparency to the term.
1788 1786
1789 --enable-fading 1787 --enable-fading (default: on)
1790 Add support for fading the text when focus is lost. 1788 Add support for fading the text when focus is lost (requires
1789 "--enable-transparency").
1791 1790
1792 --enable-tinting 1791 --enable-tinting (default: on)
1793 Add support for tinting of transparent backgrounds. 1792 Add support for tinting of transparent backgrounds (requires
1793 "--enable-transparency").
1794 1794
1795 --enable-menubar 1795 --enable-menubar (default: off)
1796 Add support for our menu bar system (this interacts badly with 1796 Add support for our menu bar system (this interacts badly with
1797 dynamic locale switching currently). 1797 dynamic locale switching currently).
1798 1798
1799 --enable-rxvt-scroll 1799 --enable-rxvt-scroll (default: on)
1800 Add support for the original rxvt scrollbar. 1800 Add support for the original rxvt scrollbar.
1801 1801
1802 --enable-next-scroll 1802 --enable-next-scroll (default: on)
1803 Add support for a NeXT-like scrollbar. 1803 Add support for a NeXT-like scrollbar.
1804 1804
1805 --enable-xterm-scroll 1805 --enable-xterm-scroll (default: on)
1806 Add support for an Xterm-like scrollbar. 1806 Add support for an Xterm-like scrollbar.
1807 1807
1808 --enable-plain-scroll 1808 --enable-plain-scroll (default: on)
1809 Add support for a very unobtrusive, plain-looking scrollbar that is 1809 Add support for a very unobtrusive, plain-looking scrollbar that is
1810 the favourite of the rxvt-unicode author, having used it for many 1810 the favourite of the rxvt-unicode author, having used it for many
1811 years. 1811 years.
1812 1812
1813 --enable-half-shadow 1813 --enable-half-shadow (default: off)
1814 Make shadows on the scrollbar only half the normal width & height. 1814 Make shadows on the scrollbar only half the normal width & height.
1815 only applicable to rxvt scrollbars. 1815 only applicable to rxvt scrollbars.
1816 1816
1817 --enable-ttygid 1817 --enable-ttygid (default: off)
1818 Change tty device setting to group "tty" - only use this if your 1818 Change tty device setting to group "tty" - only use this if your
1819 system uses this type of security. 1819 system uses this type of security.
1820 1820
1821 --disable-backspace-key 1821 --disable-backspace-key
1822 Disable any handling of the backspace key by us - let the X server 1822 Removes any handling of the backspace key by us - let the X server
1823 do it. 1823 do it.
1824 1824
1825 --disable-delete-key 1825 --disable-delete-key
1826 Disable any handling of the delete key by us - let the X server do 1826 Removes any handling of the delete key by us - let the X server do
1827 it. 1827 it.
1828 1828
1829 --disable-resources 1829 --disable-resources
1830 Remove all resources checking. 1830 Removes any support for resource checking.
1831 1831
1832 --enable-xgetdefault 1832 --enable-xgetdefault
1833 Make resources checking via XGetDefault() instead of our small 1833 Make resources checking via XGetDefault() instead of our small
1834 version which only checks ~/.Xdefaults, or if that doesn't exist 1834 version which only checks ~/.Xdefaults, or if that doesn't exist
1835 then ~/.Xresources. 1835 then ~/.Xresources.
1836 1836
1837 Please note that nowadays, things like XIM will automatically pull 1837 Please note that nowadays, things like XIM will automatically pull
1838 in and use the full X resource manager, so the overhead of using it 1838 in and use the full X resource manager, so the overhead of using it
1839 might be very small, if nonexistant. 1839 might be very small, if nonexistant.
1840 1840
1841 --enable-strings 1841 --enable-strings (default: off)
1842 Add support for our possibly faster memset() function and other 1842 Add support for our possibly faster memset() function and other
1843 various routines, overriding your system's versions which may have 1843 various routines, overriding your system's versions which may have
1844 been hand-crafted in assembly or may require extra libraries to link 1844 been hand-crafted in assembly or may require extra libraries to link
1845 in. (this breaks ANSI-C rules and has problems on many GNU/Linux 1845 in. (this breaks ANSI-C rules and has problems on many GNU/Linux
1846 systems). 1846 systems).
1847 1847
1848 --disable-swapscreen 1848 --disable-swapscreen
1849 Remove support for swap screen. 1849 Remove support for secondary/swap screen.
1850 1850
1851 --enable-frills 1851 --enable-frills (default: on)
1852 Add support for many small features that are not essential but nice 1852 Add support for many small features that are not essential but nice
1853 to have. Normally you want this, but for very small binaries you may 1853 to have. Normally you want this, but for very small binaries you may
1854 want to disable this. 1854 want to disable this.
1855 1855
1856 A non-exhaustive list of features enabled by "--enable-frills" 1856 A non-exhaustive list of features enabled by "--enable-frills"
… …
1866 window op and some xterm/OSC escape sequences 1866 window op and some xterm/OSC escape sequences
1867 tripleclickwords 1867 tripleclickwords
1868 settable insecure mode 1868 settable insecure mode
1869 keysym remapping support 1869 keysym remapping support
1870 cursor blinking and underline cursor 1870 cursor blinking and underline cursor
1871 -embed and -pty-fd options 1871 -embed, -pty-fd and -hold options
1872 1872
1873 --enable-iso14755 1873 --enable-iso14755 (default: on)
1874 Enable extended ISO 14755 support (see rxvt(1), or doc/rxvt.1.txt). 1874 Enable extended ISO 14755 support (see rxvt(1), or doc/rxvt.1.txt).
1875 Basic support (section 5.1) is enabled by "--enable-frills", while 1875 Basic support (section 5.1) is enabled by "--enable-frills", while
1876 support for 5.2, 5.3 and 5.4 is enabled with this switch. 1876 support for 5.2, 5.3 and 5.4 is enabled with this switch.
1877 1877
1878 --enable-keepscrolling 1878 --enable-keepscrolling (default: on)
1879 Add support for continual scrolling of the display when you hold the 1879 Add support for continual scrolling of the display when you hold the
1880 mouse button down on a scrollbar arrow. 1880 mouse button down on a scrollbar arrow.
1881 1881
1882 --enable-mousewheel 1882 --enable-mousewheel (default: on)
1883 Add support for scrolling via mouse wheel or buttons 4 & 5. 1883 Add support for scrolling via mouse wheel or buttons 4 & 5.
1884 1884
1885 --enable-slipwheeling 1885 --enable-slipwheeling (default: on)
1886 Add support for continual scrolling (using the mouse wheel as an 1886 Add support for continual scrolling (using the mouse wheel as an
1887 accelerator) while the control key is held down. This option 1887 accelerator) while the control key is held down. This option
1888 requires --enable-mousewheel to also be specified. 1888 requires --enable-mousewheel to also be specified.
1889 1889
1890 --disable-new-selection 1890 --disable-new-selection
1891 Remove support for mouse selection style like that of xterm. 1891 Remove support for mouse selection style like that of xterm.
1892 1892
1893 --enable-dmalloc 1893 --enable-dmalloc (default: off)
1894 Use Gray Watson's malloc - which is good for debugging See 1894 Use Gray Watson's malloc - which is good for debugging See
1895 http://www.letters.com/dmalloc/ for details If you use either this 1895 http://www.letters.com/dmalloc/ for details If you use either this
1896 or the next option, you may need to edit src/Makefile after 1896 or the next option, you may need to edit src/Makefile after
1897 compiling to point DINCLUDE and DLIB to the right places. 1897 compiling to point DINCLUDE and DLIB to the right places.
1898 1898
1899 You can only use either this option and the following (should you 1899 You can only use either this option and the following (should you
1900 use either) . 1900 use either) .
1901 1901
1902 --enable-dlmalloc 1902 --enable-dlmalloc (default: off)
1903 Use Doug Lea's malloc - which is good for a production version See 1903 Use Doug Lea's malloc - which is good for a production version See
1904 <http://g.oswego.edu/dl/html/malloc.html> for details. 1904 <http://g.oswego.edu/dl/html/malloc.html> for details.
1905 1905
1906 --enable-smart-resize 1906 --enable-smart-resize (default: on)
1907 Add smart growth/shrink behaviour when changing font size via from 1907 Add smart growth/shrink behaviour when changing font size via hot
1908 hot keys. This should keep in a fixed position the rxvt corner which 1908 keys. This should keep the window corner which is closest to a
1909 is closest to a corner of the screen. 1909 corner of the screen in a fixed position.
1910 1910
1911 --enable-pointer-blank 1911 --enable-pointer-blank (default: on)
1912 Add support to have the pointer disappear when typing or inactive. 1912 Add support to have the pointer disappear when typing or inactive.
1913 1913
1914 --with-name=NAME 1914 --with-name=NAME (default: urxvt)
1915 Set the basename for the installed binaries (default: "urxvt", 1915 Set the basename for the installed binaries, resulting in "urxvt",
1916 resulting in "urxvt", "urxvtd" etc.). Specify "--with-name=rxvt" to 1916 "urxvtd" etc.). Specify "--with-name=rxvt" to replace with "rxvt".
1917 replace with "rxvt".
1918 1917
1919 --with-term=NAME 1918 --with-term=NAME (default: rxvt-unicode)
1920 Change the environmental variable for the terminal to NAME (default 1919 Change the environmental variable for the terminal to NAME.
1921 "rxvt-unicode")
1922 1920
1923 --with-terminfo=PATH 1921 --with-terminfo=PATH
1924 Change the environmental variable for the path to the terminfo tree 1922 Change the environmental variable for the path to the terminfo tree
1925 to PATH. 1923 to PATH.
1926 1924

Diff Legend

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