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.82 by root, Sun Jun 24 22:30:52 2007 UTC vs.
Revision 1.83 by root, Wed Aug 1 18:38:16 2007 UTC

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
1138RXVT-UNICODE TECHNICAL REFERENCE 1139RXVT-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)

Diff Legend

Removed lines
+ Added lines
< Changed lines
> Changed lines