| … | |
… | |
| 1669 | XK_KP_8 8 ESC O x |
1669 | XK_KP_8 8 ESC O x |
| 1670 | XK_KP_9 9 ESC O y |
1670 | XK_KP_9 9 ESC O y |
| 1671 | |
1671 | |
| 1672 | CONFIGURE OPTIONS |
1672 | CONFIGURE OPTIONS |
| 1673 | General hint: if you get compile errors, then likely your configuration |
1673 | General hint: if you get compile errors, then likely your configuration |
| 1674 | 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 |
| 1675 | ./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 |
| 1676 | 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 |
| 1677 | 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 |
| 1678 | <rxvt@schmorp.de>. |
1678 | fixed. Marc Lehmann <rxvt@schmorp.de>. |
|
|
1679 | |
|
|
1680 | All |
| 1679 | |
1681 | |
| 1680 | --enable-everything |
1682 | --enable-everything |
| 1681 | Add support for all non-multichoice options listed in "./configure |
1683 | Add (or remove) support for all non-multichoice options listed in |
| 1682 | --help". Note that unlike other enable options this is order |
1684 | "./configure --help". |
| 1683 | dependant. You can specify this and then disable options which this |
|
|
| 1684 | enables by *following* this with the appropriate commands. |
|
|
| 1685 | |
1685 | |
| 1686 | --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) |
| 1687 | Add support for Xft (anti-aliases, among others) fonts. Xft fonts |
1693 | Add support for Xft (anti-aliases, among others) fonts. Xft fonts |
| 1688 | 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 |
| 1689 | them, you don't pay for them. |
1695 | them, you don't pay for them. |
| 1690 | |
1696 | |
| 1691 | --enable-font-styles |
1697 | --enable-font-styles (default: on) |
| 1692 | Add support for bold, *italic* and *bold italic* font styles. The |
1698 | Add support for bold, *italic* and *bold italic* font styles. The |
| 1693 | fonts can be set manually or automatically. |
1699 | fonts can be set manually or automatically. |
| 1694 | |
1700 | |
| 1695 | --with-codesets=NAME,... |
1701 | --with-codesets=NAME,... (default: all) |
| 1696 | Compile in support for additional codeset (encoding) groups ("eu", |
1702 | Compile in support for additional codeset (encoding) groups ("eu", |
| 1697 | "vn" are always compiled in, which includes most 8-bit character |
1703 | "vn" are always compiled in, which includes most 8-bit character |
| 1698 | sets). These codeset tables are used for driving X11 core fonts, |
1704 | sets). These codeset tables are used for driving X11 core fonts, |
| 1699 | they are not required for Xft fonts, although having them compiled |
1705 | they are not required for Xft fonts, although having them compiled |
| 1700 | in lets rxvt-unicode choose replacement fonts more intelligently. |
1706 | in lets rxvt-unicode choose replacement fonts more intelligently. |
| … | |
… | |
| 1707 | zh_ext rarely used but very big chinese encodigs |
1713 | zh_ext rarely used but very big chinese encodigs |
| 1708 | jp common japanese encodings |
1714 | jp common japanese encodings |
| 1709 | jp_ext rarely used but big japanese encodings |
1715 | jp_ext rarely used but big japanese encodings |
| 1710 | kr korean encodings |
1716 | kr korean encodings |
| 1711 | |
1717 | |
| 1712 | --enable-xim |
1718 | --enable-xim (default: on) |
| 1713 | Add support for XIM (X Input Method) protocol. This allows using |
1719 | Add support for XIM (X Input Method) protocol. This allows using |
| 1714 | alternative input methods (e.g. kinput2) and will also correctly set |
1720 | alternative input methods (e.g. kinput2) and will also correctly set |
| 1715 | up the input for people using dead keys or compose keys. |
1721 | up the input for people using dead keys or compose keys. |
| 1716 | |
1722 | |
| 1717 | --enable-unicode3 |
1723 | --enable-unicode3 (default: off) |
| 1718 | Enable direct support for displaying unicode codepoints above 65535 |
1724 | Enable direct support for displaying unicode codepoints above 65535 |
| 1719 | (the basic multilingual page). This increases storage requirements |
1725 | (the basic multilingual page). This increases storage requirements |
| 1720 | 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 |
| 1721 | extra characters, but Xft does. |
1727 | extra characters, but Xft does. |
| 1722 | |
1728 | |
| … | |
… | |
| 1724 | 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 |
| 1725 | to a view thousand (shared with combining characters, see next |
1731 | to a view thousand (shared with combining characters, see next |
| 1726 | switch), and right now rxvt-unicode cannot display them |
1732 | switch), and right now rxvt-unicode cannot display them |
| 1727 | (input/output and cut&paste still work, though). |
1733 | (input/output and cut&paste still work, though). |
| 1728 | |
1734 | |
| 1729 | --enable-combining |
1735 | --enable-combining (default: on) |
| 1730 | Enable automatic composition of combining characters into composite |
1736 | Enable automatic composition of combining characters into composite |
| 1731 | characters. This is required for proper viewing of text where |
1737 | characters. This is required for proper viewing of text where |
| 1732 | accents are encoded as seperate unicode characters. This is done by |
1738 | accents are encoded as seperate unicode characters. This is done by |
| 1733 | using precomposited characters when available or creating new |
1739 | using precomposited characters when available or creating new |
| 1734 | pseudo-characters when no precomposed form exists. |
1740 | pseudo-characters when no precomposed form exists. |
| … | |
… | |
| 1743 | |
1749 | |
| 1744 | The combining table also contains entries for arabic presentation |
1750 | The combining table also contains entries for arabic presentation |
| 1745 | 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 |
| 1746 | be used (and tell me how these are to be used...). |
1752 | be used (and tell me how these are to be used...). |
| 1747 | |
1753 | |
| 1748 | --enable-fallback(=CLASS) |
1754 | --enable-fallback(=CLASS) (default: Rxvt) |
| 1749 | When reading resource settings, also read settings for class CLASS |
1755 | When reading resource settings, also read settings for class CLASS. |
| 1750 | (default: Rxvt). To disable resource fallback use |
1756 | To disable resource fallback use --disable-fallback. |
| 1751 | --disable-fallback. |
|
|
| 1752 | |
1757 | |
| 1753 | --with-res-name=NAME |
1758 | --with-res-name=NAME (default: urxvt) |
| 1754 | Use the given name (default: urxvt) as default application name when |
1759 | Use the given name as default application name when reading |
| 1755 | reading resources. Specify --with-res-name=rxvt to replace rxvt. |
1760 | resources. Specify --with-res-name=rxvt to replace rxvt. |
| 1756 | |
1761 | |
| 1757 | --with-res-class=CLASS |
1762 | --with-res-class=CLASS /default: URxvt) |
| 1758 | Use the given class (default: URxvt) as default application class |
1763 | Use the given class as default application class when reading |
| 1759 | when reading resources. Specify --with-res-class=Rxvt to replace |
1764 | resources. Specify --with-res-class=Rxvt to replace rxvt. |
| 1760 | rxvt. |
|
|
| 1761 | |
1765 | |
| 1762 | --enable-utmp |
1766 | --enable-utmp (default: on) |
| 1763 | 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 |
| 1764 | of rxvt execution and delete information when rxvt exits. |
1768 | of rxvt execution and delete information when rxvt exits. |
| 1765 | |
1769 | |
| 1766 | --enable-wtmp |
1770 | --enable-wtmp (default: on) |
| 1767 | 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 |
| 1768 | start of rxvt execution and write logout when rxvt exits. This |
1772 | start of rxvt execution and write logout when rxvt exits. This |
| 1769 | option requires --enable-utmp to also be specified. |
1773 | option requires --enable-utmp to also be specified. |
| 1770 | |
1774 | |
| 1771 | --enable-lastlog |
1775 | --enable-lastlog (default: on) |
| 1772 | 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) |
| 1773 | at start of rxvt execution. This option requires --enable-utmp to |
1777 | at start of rxvt execution. This option requires --enable-utmp to |
| 1774 | also be specified. |
1778 | also be specified. |
| 1775 | |
1779 | |
| 1776 | --enable-xpm-background |
1780 | --enable-xpm-background (default: off) |
| 1777 | Add support for XPM background pixmaps. |
1781 | Add support for XPM background pixmaps. |
| 1778 | |
1782 | |
| 1779 | --enable-transparency |
1783 | --enable-transparency (default: off) |
| 1780 | Add support for inheriting parent backgrounds thus giving a fake |
1784 | Add support for inheriting parent backgrounds thus giving a fake |
| 1781 | transparency to the term. |
1785 | transparency to the term. |
| 1782 | |
1786 | |
| 1783 | --enable-fading |
1787 | --enable-fading (default: on) |
| 1784 | 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"). |
| 1785 | |
1790 | |
| 1786 | --enable-tinting |
1791 | --enable-tinting (default: on) |
| 1787 | Add support for tinting of transparent backgrounds. |
1792 | Add support for tinting of transparent backgrounds (requires |
|
|
1793 | "--enable-transparency"). |
| 1788 | |
1794 | |
| 1789 | --enable-menubar |
1795 | --enable-menubar (default: off) |
| 1790 | Add support for our menu bar system (this interacts badly with |
1796 | Add support for our menu bar system (this interacts badly with |
| 1791 | dynamic locale switching currently). |
1797 | dynamic locale switching currently). |
| 1792 | |
1798 | |
| 1793 | --enable-rxvt-scroll |
1799 | --enable-rxvt-scroll (default: on) |
| 1794 | Add support for the original rxvt scrollbar. |
1800 | Add support for the original rxvt scrollbar. |
| 1795 | |
1801 | |
| 1796 | --enable-next-scroll |
1802 | --enable-next-scroll (default: on) |
| 1797 | Add support for a NeXT-like scrollbar. |
1803 | Add support for a NeXT-like scrollbar. |
| 1798 | |
1804 | |
| 1799 | --enable-xterm-scroll |
1805 | --enable-xterm-scroll (default: on) |
| 1800 | Add support for an Xterm-like scrollbar. |
1806 | Add support for an Xterm-like scrollbar. |
| 1801 | |
1807 | |
| 1802 | --enable-plain-scroll |
1808 | --enable-plain-scroll (default: on) |
| 1803 | Add support for a very unobtrusive, plain-looking scrollbar that is |
1809 | Add support for a very unobtrusive, plain-looking scrollbar that is |
| 1804 | 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 |
| 1805 | years. |
1811 | years. |
| 1806 | |
1812 | |
| 1807 | --enable-half-shadow |
1813 | --enable-half-shadow (default: off) |
| 1808 | Make shadows on the scrollbar only half the normal width & height. |
1814 | Make shadows on the scrollbar only half the normal width & height. |
| 1809 | only applicable to rxvt scrollbars. |
1815 | only applicable to rxvt scrollbars. |
| 1810 | |
1816 | |
| 1811 | --enable-ttygid |
1817 | --enable-ttygid (default: off) |
| 1812 | 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 |
| 1813 | system uses this type of security. |
1819 | system uses this type of security. |
| 1814 | |
1820 | |
| 1815 | --disable-backspace-key |
1821 | --disable-backspace-key |
| 1816 | 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 |
| 1817 | do it. |
1823 | do it. |
| 1818 | |
1824 | |
| 1819 | --disable-delete-key |
1825 | --disable-delete-key |
| 1820 | 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 |
| 1821 | it. |
1827 | it. |
| 1822 | |
1828 | |
| 1823 | --disable-resources |
1829 | --disable-resources |
| 1824 | Remove all resources checking. |
1830 | Removes any support for resource checking. |
| 1825 | |
1831 | |
| 1826 | --enable-xgetdefault |
1832 | --enable-xgetdefault |
| 1827 | Make resources checking via XGetDefault() instead of our small |
1833 | Make resources checking via XGetDefault() instead of our small |
| 1828 | version which only checks ~/.Xdefaults, or if that doesn't exist |
1834 | version which only checks ~/.Xdefaults, or if that doesn't exist |
| 1829 | then ~/.Xresources. |
1835 | then ~/.Xresources. |
| 1830 | |
1836 | |
| 1831 | Please note that nowadays, things like XIM will automatically pull |
1837 | Please note that nowadays, things like XIM will automatically pull |
| 1832 | 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 |
| 1833 | might be very small, if nonexistant. |
1839 | might be very small, if nonexistant. |
| 1834 | |
1840 | |
| 1835 | --enable-strings |
1841 | --enable-strings (default: off) |
| 1836 | Add support for our possibly faster memset() function and other |
1842 | Add support for our possibly faster memset() function and other |
| 1837 | various routines, overriding your system's versions which may have |
1843 | various routines, overriding your system's versions which may have |
| 1838 | 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 |
| 1839 | 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 |
| 1840 | systems). |
1846 | systems). |
| 1841 | |
1847 | |
| 1842 | --disable-swapscreen |
1848 | --disable-swapscreen |
| 1843 | Remove support for swap screen. |
1849 | Remove support for secondary/swap screen. |
| 1844 | |
1850 | |
| 1845 | --enable-frills |
1851 | --enable-frills (default: on) |
| 1846 | 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 |
| 1847 | 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 |
| 1848 | want to disable this. |
1854 | want to disable this. |
| 1849 | |
1855 | |
| 1850 | A non-exhaustive list of features enabled by "--enable-frills" |
1856 | A non-exhaustive list of features enabled by "--enable-frills" |
| … | |
… | |
| 1862 | settable insecure mode |
1868 | settable insecure mode |
| 1863 | keysym remapping support |
1869 | keysym remapping support |
| 1864 | cursor blinking and underline cursor |
1870 | cursor blinking and underline cursor |
| 1865 | -embed and -pty-fd options |
1871 | -embed and -pty-fd options |
| 1866 | |
1872 | |
| 1867 | --enable-iso14755 |
1873 | --enable-iso14755 (default: on) |
| 1868 | 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). |
| 1869 | Basic support (section 5.1) is enabled by "--enable-frills", while |
1875 | Basic support (section 5.1) is enabled by "--enable-frills", while |
| 1870 | 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. |
| 1871 | |
1877 | |
| 1872 | --enable-keepscrolling |
1878 | --enable-keepscrolling (default: on) |
| 1873 | 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 |
| 1874 | mouse button down on a scrollbar arrow. |
1880 | mouse button down on a scrollbar arrow. |
| 1875 | |
1881 | |
| 1876 | --enable-mousewheel |
1882 | --enable-mousewheel (default: on) |
| 1877 | Add support for scrolling via mouse wheel or buttons 4 & 5. |
1883 | Add support for scrolling via mouse wheel or buttons 4 & 5. |
| 1878 | |
1884 | |
| 1879 | --enable-slipwheeling |
1885 | --enable-slipwheeling (default: on) |
| 1880 | Add support for continual scrolling (using the mouse wheel as an |
1886 | Add support for continual scrolling (using the mouse wheel as an |
| 1881 | accelerator) while the control key is held down. This option |
1887 | accelerator) while the control key is held down. This option |
| 1882 | requires --enable-mousewheel to also be specified. |
1888 | requires --enable-mousewheel to also be specified. |
| 1883 | |
1889 | |
| 1884 | --disable-new-selection |
1890 | --disable-new-selection |
| 1885 | Remove support for mouse selection style like that of xterm. |
1891 | Remove support for mouse selection style like that of xterm. |
| 1886 | |
1892 | |
| 1887 | --enable-dmalloc |
1893 | --enable-dmalloc (default: off) |
| 1888 | Use Gray Watson's malloc - which is good for debugging See |
1894 | Use Gray Watson's malloc - which is good for debugging See |
| 1889 | 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 |
| 1890 | 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 |
| 1891 | compiling to point DINCLUDE and DLIB to the right places. |
1897 | compiling to point DINCLUDE and DLIB to the right places. |
| 1892 | |
1898 | |
| 1893 | 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 |
| 1894 | use either) . |
1900 | use either) . |
| 1895 | |
1901 | |
| 1896 | --enable-dlmalloc |
1902 | --enable-dlmalloc (default: off) |
| 1897 | 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 |
| 1898 | <http://g.oswego.edu/dl/html/malloc.html> for details. |
1904 | <http://g.oswego.edu/dl/html/malloc.html> for details. |
| 1899 | |
1905 | |
| 1900 | --enable-smart-resize |
1906 | --enable-smart-resize (default: on) |
| 1901 | Add smart growth/shrink behaviour when changing font size via from |
1907 | Add smart growth/shrink behaviour when changing font size via from |
| 1902 | hot keys. This should keep in a fixed position the rxvt corner which |
1908 | hot keys. This should keep in a fixed position the rxvt corner which |
| 1903 | is closest to a corner of the screen. |
1909 | is closest to a corner of the screen. |
| 1904 | |
1910 | |
| 1905 | --enable-pointer-blank |
1911 | --enable-pointer-blank (default: on) |
| 1906 | Add support to have the pointer disappear when typing or inactive. |
1912 | Add support to have the pointer disappear when typing or inactive. |
| 1907 | |
1913 | |
| 1908 | --with-name=NAME |
1914 | --with-name=NAME (default: urxvt) |
| 1909 | Set the basename for the installed binaries (default: "urxvt", |
1915 | Set the basename for the installed binaries, resulting in "urxvt", |
| 1910 | resulting in "urxvt", "urxvtd" etc.). Specify "--with-name=rxvt" to |
1916 | "urxvtd" etc.). Specify "--with-name=rxvt" to replace with "rxvt". |
| 1911 | replace with "rxvt". |
|
|
| 1912 | |
1917 | |
| 1913 | --with-term=NAME |
1918 | --with-term=NAME (default: rxvt-unicode) |
| 1914 | Change the environmental variable for the terminal to NAME (default |
1919 | Change the environmental variable for the terminal to NAME. |
| 1915 | "rxvt-unicode") |
|
|
| 1916 | |
1920 | |
| 1917 | --with-terminfo=PATH |
1921 | --with-terminfo=PATH |
| 1918 | Change the environmental variable for the path to the terminfo tree |
1922 | Change the environmental variable for the path to the terminfo tree |
| 1919 | to PATH. |
1923 | to PATH. |
| 1920 | |
1924 | |
