… | |
… | |
110 | fi |
110 | fi |
111 | fi |
111 | fi |
112 | |
112 | |
113 | How do I compile the manual pages on my own? |
113 | How do I compile the manual pages on my own? |
114 | You need to have a recent version of perl installed as /usr/bin/perl, |
114 | You need to have a recent version of perl installed as /usr/bin/perl, |
115 | one that comes with pod2man, pod2text and pod2xhtml (from Pod::XHTML). |
115 | one that comes with pod2man, pod2text and pod2xhtml (from Pod::Xhtml). |
116 | Then go to the doc subdirectory and enter "make alldoc". |
116 | Then go to the doc subdirectory and enter "make alldoc". |
117 | |
117 | |
118 | Isn't rxvt-unicode supposed to be small? Don't all those features bloat? |
118 | Isn't rxvt-unicode supposed to be small? Don't all those features bloat? |
119 | I often get asked about this, and I think, no, they didn't cause extra |
119 | I often get asked about this, and I think, no, they didn't cause extra |
120 | bloat. If you compare a minimal rxvt and a minimal urxvt, you can see |
120 | bloat. If you compare a minimal rxvt and a minimal urxvt, you can see |
… | |
… | |
1079 | This forking is done as the very first within main(), which is very |
1079 | This forking is done as the very first within main(), which is very |
1080 | early and reduces possible bugs to initialisation code run before |
1080 | early and reduces possible bugs to initialisation code run before |
1081 | main(), or things like the dynamic loader of your system, which should |
1081 | main(), or things like the dynamic loader of your system, which should |
1082 | result in very little risk. |
1082 | result in very little risk. |
1083 | |
1083 | |
1084 | On Solaris 9, many line-drawing characters are too wide. |
|
|
1085 | Seems to be a known bug, read |
|
|
1086 | <http://nixdoc.net/files/forum/about34198.html>. Some people use the |
|
|
1087 | following ugly workaround to get non-double-wide-characters working: |
|
|
1088 | |
|
|
1089 | #define wcwidth(x) wcwidth(x) > 1 ? 1 : wcwidth(x) |
|
|
1090 | |
|
|
1091 | I am on FreeBSD and rxvt-unicode does not seem to work at all. |
1084 | I am on FreeBSD and rxvt-unicode does not seem to work at all. |
1092 | Rxvt-unicode requires the symbol "__STDC_ISO_10646__" to be defined in |
1085 | Rxvt-unicode requires the symbol "__STDC_ISO_10646__" to be defined in |
1093 | your compile environment, or an implementation that implements it, |
1086 | your compile environment, or an implementation that implements it, |
1094 | whether it defines the symbol or not. "__STDC_ISO_10646__" requires that |
1087 | whether it defines the symbol or not. "__STDC_ISO_10646__" requires that |
1095 | wchar_t is represented as unicode. |
1088 | wchar_t is represented as unicode. |
… | |
… | |
1117 | |
1110 | |
1118 | The rxvt-unicode author insists that the right way to fix this is in the |
1111 | The rxvt-unicode author insists that the right way to fix this is in the |
1119 | system libraries once and for all, instead of forcing every app to carry |
1112 | system libraries once and for all, instead of forcing every app to carry |
1120 | complete replacements for them :) |
1113 | complete replacements for them :) |
1121 | |
1114 | |
1122 | I use Solaris 9 and it doesn't compile/work/etc. |
|
|
1123 | Try the diff in doc/solaris9.patch as a base. It fixes the worst |
|
|
1124 | problems with "wcwidth" and a compile problem. |
|
|
1125 | |
|
|
1126 | How can I use rxvt-unicode under cygwin? |
1115 | How can I use rxvt-unicode under cygwin? |
1127 | rxvt-unicode should compile and run out of the box on cygwin, using the |
1116 | rxvt-unicode should compile and run out of the box on cygwin, using the |
1128 | X11 libraries that come with cygwin. libW11 emulation is no longer |
1117 | X11 libraries that come with cygwin. libW11 emulation is no longer |
1129 | supported (and makes no sense, either, as it only supported a single |
1118 | supported (and makes no sense, either, as it only supported a single |
1130 | font). I recommend starting the X-server in "-multiwindow" or |
1119 | font). I recommend starting the X-server in "-multiwindow" or |
… | |
… | |
1132 | old libW11 emulation. |
1121 | old libW11 emulation. |
1133 | |
1122 | |
1134 | At the time of this writing, cygwin didn't seem to support any |
1123 | At the time of this writing, cygwin didn't seem to support any |
1135 | multi-byte encodings (you might try "LC_CTYPE=C-UTF-8"), so you are |
1124 | multi-byte encodings (you might try "LC_CTYPE=C-UTF-8"), so you are |
1136 | likely limited to 8-bit encodings. |
1125 | likely limited to 8-bit encodings. |
|
|
1126 | |
|
|
1127 | Character widths are not correct. |
|
|
1128 | urxvt uses the system wcwidth function to know the information about the |
|
|
1129 | width of characters, so on systems with incorrect locale data you will |
|
|
1130 | likely get bad results. Two notorious examples are Solaris 9, where |
|
|
1131 | single-width characters like U+2514 are reported as double-width, and |
|
|
1132 | Darwin 8, where combining chars are reported having width 1. |
|
|
1133 | |
|
|
1134 | The solution is to upgrade your system or switch to a better one. A |
|
|
1135 | possibly working workaround is to use a wcwidth implementation like |
|
|
1136 | |
|
|
1137 | http://www.cl.cam.ac.uk/~mgk25/ucs/wcwidth.c |
1137 | |
1138 | |
1138 | RXVT-UNICODE TECHNICAL REFERENCE |
1139 | RXVT-UNICODE TECHNICAL REFERENCE |
1139 | The rest of this document describes various technical aspects of |
1140 | The rest of this document describes various technical aspects of |
1140 | rxvt-unicode. First the description of supported command sequences, |
1141 | rxvt-unicode. First the description of supported command sequences, |
1141 | followed by pixmap support and last by a description of all features |
1142 | followed by pixmap support and last by a description of all features |
… | |
… | |
1883 | also be specified. |
1884 | also be specified. |
1884 | |
1885 | |
1885 | --enable-xpm-background (default: on) |
1886 | --enable-xpm-background (default: on) |
1886 | Add support for XPM background pixmaps. |
1887 | Add support for XPM background pixmaps. |
1887 | |
1888 | |
|
|
1889 | --enable-afterimage (default: on) |
|
|
1890 | Add support for libAfterImage to be used for transparency and |
|
|
1891 | background images. It adds support for many file formats including |
|
|
1892 | JPG, PNG, SVG, TIFF, GIF, XPM, BMP, ICO, XCF, TGA and AfterStep |
|
|
1893 | image XML |
|
|
1894 | (<http://www.afterstep.org/visualdoc.php?show=asimagexml>). |
|
|
1895 | |
|
|
1896 | This option also adds such eye candy as blending an image over the |
|
|
1897 | root background, as well as dynamic scaling and bluring of |
|
|
1898 | background images. |
|
|
1899 | |
|
|
1900 | Note that with this option enabled, rxvt's memory footprint might |
|
|
1901 | increase by a few megabytes even if no extra features are used |
|
|
1902 | (mostly due to third-party libraries used by libAI). Memory |
|
|
1903 | footprint may somewhat be lowered if libAfterImage is configured |
|
|
1904 | without support for SVG. |
|
|
1905 | |
1888 | --enable-transparency (default: on) |
1906 | --enable-transparency (default: on) |
1889 | Add support for inheriting parent backgrounds thus giving a fake |
1907 | Add support for inheriting parent backgrounds thus giving a fake |
1890 | transparency to the term. |
1908 | transparency to the term. |
1891 | |
1909 | |
1892 | --enable-fading (default: on) |
1910 | --enable-fading (default: on) |
1893 | Add support for fading the text when focus is lost (requires |
1911 | Add support for fading the text when focus is lost. |
1894 | "--enable-transparency"). |
|
|
1895 | |
1912 | |
1896 | --enable-tinting (default: on) |
1913 | --enable-tinting (default: on) |
1897 | Add support for tinting of transparent backgrounds (requires |
1914 | Add support for tinting of transparent backgrounds (requires |
1898 | "--enable-transparency"). |
1915 | "--enable-transparency"). |
1899 | |
1916 | |
… | |
… | |
1977 | |
1994 | |
1978 | --enable-keepscrolling (default: on) |
1995 | --enable-keepscrolling (default: on) |
1979 | Add support for continual scrolling of the display when you hold the |
1996 | Add support for continual scrolling of the display when you hold the |
1980 | mouse button down on a scrollbar arrow. |
1997 | mouse button down on a scrollbar arrow. |
1981 | |
1998 | |
|
|
1999 | --enable-selectionscrolling (default: on) |
|
|
2000 | Add support for scrolling when the selection moves to the top or |
|
|
2001 | bottom of the screen. |
|
|
2002 | |
1982 | --enable-mousewheel (default: on) |
2003 | --enable-mousewheel (default: on) |
1983 | Add support for scrolling via mouse wheel or buttons 4 & 5. |
2004 | Add support for scrolling via mouse wheel or buttons 4 & 5. |
1984 | |
2005 | |
1985 | --enable-slipwheeling (default: on) |
2006 | --enable-slipwheeling (default: on) |
1986 | Add support for continual scrolling (using the mouse wheel as an |
2007 | Add support for continual scrolling (using the mouse wheel as an |
1987 | accelerator) while the control key is held down. This option |
2008 | accelerator) while the control key is held down. This option |
1988 | requires --enable-mousewheel to also be specified. |
2009 | requires --enable-mousewheel to also be specified. |
1989 | |
2010 | |
1990 | --disable-new-selection |
|
|
1991 | Remove support for mouse selection style like that of xterm. |
|
|
1992 | |
|
|
1993 | --enable-dmalloc (default: off) |
|
|
1994 | Use Gray Watson's malloc - which is good for debugging See |
|
|
1995 | <http://www.letters.com/dmalloc/> for details If you use either this |
|
|
1996 | or the next option, you may need to edit src/Makefile after |
|
|
1997 | compiling to point DINCLUDE and DLIB to the right places. |
|
|
1998 | |
|
|
1999 | You can only use either this option and the following (should you |
|
|
2000 | use either) . |
|
|
2001 | |
|
|
2002 | --enable-dlmalloc (default: off) |
|
|
2003 | Use Doug Lea's malloc - which is good for a production version See |
|
|
2004 | <http://g.oswego.edu/dl/html/malloc.html> for details. |
|
|
2005 | |
|
|
2006 | --enable-smart-resize (default: on) |
2011 | --enable-smart-resize (default: off) |
2007 | Add smart growth/shrink behaviour when changing font size via hot |
2012 | Add smart growth/shrink behaviour when resizing. This should keep |
2008 | keys. This should keep the window corner which is closest to a |
2013 | the window corner which is closest to a corner of the screen in a |
2009 | corner of the screen in a fixed position. |
2014 | fixed position. |
2010 | |
2015 | |
2011 | --enable-pointer-blank (default: on) |
2016 | --enable-pointer-blank (default: on) |
2012 | Add support to have the pointer disappear when typing or inactive. |
2017 | Add support to have the pointer disappear when typing or inactive. |
2013 | |
2018 | |
2014 | --enable-perl (default: on) |
2019 | --enable-perl (default: on) |
… | |
… | |
2019 | environment variable when running configure. Even when compiled in, |
2024 | environment variable when running configure. Even when compiled in, |
2020 | perl will *not* be initialised when all extensions have been |
2025 | perl will *not* be initialised when all extensions have been |
2021 | disabled "-pe "" --perl-ext-common """, so it should be safe to |
2026 | disabled "-pe "" --perl-ext-common """, so it should be safe to |
2022 | enable from a resource standpoint. |
2027 | enable from a resource standpoint. |
2023 | |
2028 | |
|
|
2029 | --with-afterimage-config=DIR |
|
|
2030 | Look for the libAfterImage config script in DIR. |
|
|
2031 | |
2024 | --with-name=NAME (default: urxvt) |
2032 | --with-name=NAME (default: urxvt) |
2025 | Set the basename for the installed binaries, resulting in "urxvt", |
2033 | Set the basename for the installed binaries, resulting in "urxvt", |
2026 | "urxvtd" etc.). Specify "--with-name=rxvt" to replace with "rxvt". |
2034 | "urxvtd" etc.). Specify "--with-name=rxvt" to replace with "rxvt". |
2027 | |
2035 | |
2028 | --with-term=NAME (default: rxvt-unicode) |
2036 | --with-term=NAME (default: rxvt-unicode) |