WISH: kick out xpm.C, replace by pixbuf
DUMB: support tex fonts
-8.
+8.3 Wed Aug 1 20:21:31 CEST 2007
- new option: skipScroll/-ss, enabled by default.
- go with the times and expect x11 library files in /usr/lib, not
/usr/X11R6/lib.
How do I compile the manual pages on my own?
You need to have a recent version of perl installed as /usr/bin/perl,
- one that comes with pod2man, pod2text and pod2xhtml (from Pod::XHTML).
+ one that comes with pod2man, pod2text and pod2xhtml (from Pod::Xhtml).
Then go to the doc subdirectory and enter "make alldoc".
Isn't rxvt-unicode supposed to be small? Don't all those features bloat?
main(), or things like the dynamic loader of your system, which should
result in very little risk.
- On Solaris 9, many line-drawing characters are too wide.
- Seems to be a known bug, read
- <http://nixdoc.net/files/forum/about34198.html>. Some people use the
- following ugly workaround to get non-double-wide-characters working:
-
- #define wcwidth(x) wcwidth(x) > 1 ? 1 : wcwidth(x)
-
I am on FreeBSD and rxvt-unicode does not seem to work at all.
Rxvt-unicode requires the symbol "__STDC_ISO_10646__" to be defined in
your compile environment, or an implementation that implements it,
system libraries once and for all, instead of forcing every app to carry
complete replacements for them :)
- I use Solaris 9 and it doesn't compile/work/etc.
- Try the diff in doc/solaris9.patch as a base. It fixes the worst
- problems with "wcwidth" and a compile problem.
-
How can I use rxvt-unicode under cygwin?
rxvt-unicode should compile and run out of the box on cygwin, using the
X11 libraries that come with cygwin. libW11 emulation is no longer
multi-byte encodings (you might try "LC_CTYPE=C-UTF-8"), so you are
likely limited to 8-bit encodings.
+ Character widths are not correct.
+ urxvt uses the system wcwidth function to know the information about the
+ width of characters, so on systems with incorrect locale data you will
+ likely get bad results. Two notorious examples are Solaris 9, where
+ single-width characters like U+2514 are reported as double-width, and
+ Darwin 8, where combining chars are reported having width 1.
+
+ The solution is to upgrade your system or switch to a better one. A
+ possibly working workaround is to use a wcwidth implementation like
+
+ http://www.cl.cam.ac.uk/~mgk25/ucs/wcwidth.c
+
--enable-xpm-background (default: on)
Add support for XPM background pixmaps.
+ --enable-afterimage (default: on)
+ Add support for libAfterImage to be used for transparency and
+ background images. It adds support for many file formats including
+ JPG, PNG, SVG, TIFF, GIF, XPM, BMP, ICO, XCF, TGA and AfterStep
+ image XML
+ (<http://www.afterstep.org/visualdoc.php?show=asimagexml>).
+
+ This option also adds such eye candy as blending an image over the
+ root background, as well as dynamic scaling and bluring of
+ background images.
+
+ Note that with this option enabled, rxvt's memory footprint might
+ increase by a few megabytes even if no extra features are used
+ (mostly due to third-party libraries used by libAI). Memory
+ footprint may somewhat be lowered if libAfterImage is configured
+ without support for SVG.
+
--enable-transparency (default: on)
Add support for inheriting parent backgrounds thus giving a fake
transparency to the term.
--enable-fading (default: on)
- Add support for fading the text when focus is lost (requires
- "--enable-transparency").
+ Add support for fading the text when focus is lost.
--enable-tinting (default: on)
Add support for tinting of transparent backgrounds (requires
Add support for continual scrolling of the display when you hold the
mouse button down on a scrollbar arrow.
+ --enable-selectionscrolling (default: on)
+ Add support for scrolling when the selection moves to the top or
+ bottom of the screen.
+
--enable-mousewheel (default: on)
Add support for scrolling via mouse wheel or buttons 4 & 5.
accelerator) while the control key is held down. This option
requires --enable-mousewheel to also be specified.
- --disable-new-selection
- Remove support for mouse selection style like that of xterm.
-
- --enable-dmalloc (default: off)
- Use Gray Watson's malloc - which is good for debugging See
- <http://www.letters.com/dmalloc/> for details If you use either this
- or the next option, you may need to edit src/Makefile after
- compiling to point DINCLUDE and DLIB to the right places.
-
- You can only use either this option and the following (should you
- use either) .
-
- --enable-dlmalloc (default: off)
- Use Doug Lea's malloc - which is good for a production version See
- <http://g.oswego.edu/dl/html/malloc.html> for details.
-
- --enable-smart-resize (default: on)
- Add smart growth/shrink behaviour when changing font size via hot
- keys. This should keep the window corner which is closest to a
- corner of the screen in a fixed position.
+ --enable-smart-resize (default: off)
+ Add smart growth/shrink behaviour when resizing. This should keep
+ the window corner which is closest to a corner of the screen in a
+ fixed position.
--enable-pointer-blank (default: on)
Add support to have the pointer disappear when typing or inactive.
disabled "-pe "" --perl-ext-common """, so it should be safe to
enable from a resource standpoint.
+ --with-afterimage-config=DIR
+ Look for the libAfterImage config script in DIR.
+
--with-name=NAME (default: urxvt)
Set the basename for the installed binaries, resulting in "urxvt",
"urxvtd" etc.). Specify "--with-name=rxvt" to replace with "rxvt".
/* config.h.in. Generated from configure.ac by autoheader. */
-/* Define if you want to integrate with AfterStep window manager */
-#undef AFTERSTEP_INTEGRATION
-
/* clone device filename */
#undef CLONE_DEVICE
--enable-font-styles enable bold and italic support
--enable-xpm-background enable background pixmaps
--enable-afterimage enable integration with libAfterImage for background images
- --enable-afterstep enable integration with AfterStep window manager
--enable-transparency enable transparent backgrounds
--enable-tinting enable tinting of transparent bg
--enable-fading enable colors fading when off focus
fi
-# Check whether --enable-afterstep was given.
-if test "${enable_afterstep+set}" = set; then
- enableval=$enable_afterstep; if test x$enableval = xyes -o x$enableval = xno; then
- support_afterstep=$enableval
- fi
-fi
-
# Check whether --enable-transparency was given.
if test "${enable_transparency+set}" = set; then
fi
- { echo "$as_me:$LINENO: checking for libAfterImage version >= 1.15" >&5
+ if test "x$afterimage_config" != "xno" ; then
+ { echo "$as_me:$LINENO: checking for libAfterImage version >= 1.15" >&5
echo $ECHO_N "checking for libAfterImage version >= 1.15... $ECHO_C" >&6; }
- AFTERIMAGE_VERSION=`$afterimage_config --version`
- if test -n $AFTERIMAGE_VERSION ; then
- AFTERIMAGE_CFLAGS=`$afterimage_config --cflags`
- AFTERIMAGE_LIBS=`$afterimage_config --libs`
- if test "x$AFTERIMAGE_LIBS" != "x"; then
- libai_ver_major=`echo $AFTERIMAGE_VERSION | cut -f 1 -d .`
- libai_ver_minor=`echo $AFTERIMAGE_VERSION | cut -f 2 -d .`
- if test $libai_ver_major -gt 1 -o \( $libai_ver_major -eq 1 -a $libai_ver_minor -ge 15 \); then
- support_afterimage=yes
+ xAFTERIMAGE_VERSION=`$afterimage_config --version`
+ if test -n "$xAFTERIMAGE_VERSION" ; then
+ xAFTERIMAGE_CFLAGS=`$afterimage_config --cflags`
+ xAFTERIMAGE_LIBS=`$afterimage_config --libs`
+ if test "x$xAFTERIMAGE_LIBS" != "x"; then
+ libai_ver_major=`echo $xAFTERIMAGE_VERSION | cut -f 1 -d .`
+ libai_ver_minor=`echo $xAFTERIMAGE_VERSION | cut -f 2 -d .`
+ if test $libai_ver_major -gt 1 -o \( $libai_ver_major -eq 1 -a $libai_ver_minor -ge 15 \); then
+ support_afterimage=yes
+ AFTERIMAGE_CFLAGS="$xAFTERIMAGE_CFLAGS"
+ AFTERIMAGE_LIBS="$xAFTERIMAGE_LIBS"
+ AFTERIMAGE_VERSION="$xAFTERIMAGE_VERSION"
+ fi
fi
fi
- fi
-
- if test "x$support_afterimage" = "xyes"; then
- { echo "$as_me:$LINENO: result: $AFTERIMAGE_LIBS" >&5
+ if test "x$support_afterimage" = "xyes"; then
+ { echo "$as_me:$LINENO: result: $AFTERIMAGE_LIBS" >&5
echo "${ECHO_T}$AFTERIMAGE_LIBS" >&6; }
- else
- { echo "$as_me:$LINENO: result: no" >&5
+ else
+ { echo "$as_me:$LINENO: result: no" >&5
echo "${ECHO_T}no" >&6; }
+ fi
fi
fi
fi
-if test x$support_afterstep = xyes; then
-
-cat >>confdefs.h <<\_ACEOF
-#define AFTERSTEP_INTEGRATION 1
-_ACEOF
-
-fi
if test x$support_scroll_rxvt = xyes; then
echo " AfterImage support: yes"
fi
-if test x$support_afterstep = xyes; then
- echo " AfterStep integration: yes"
-fi
if test x$term != x; then
echo " set TERM to: $term"
fi
echo
echo " embedded perl: $support_perl"
+echo " libafterimage: $support_afterimage"
echo
if test x$support_xpm = xneedsmanualspecification; then
echo ".----------------------------------------------------------------."
if test "x$afterimage_config" = "x" ; then
AC_PATH_PROG(afterimage_config, afterimage-config, no)
fi
- AC_MSG_CHECKING(for libAfterImage version >= 1.15)
- AFTERIMAGE_VERSION=`$afterimage_config --version`
- if test -n "$AFTERIMAGE_VERSION" ; then
- AFTERIMAGE_CFLAGS=`$afterimage_config --cflags`
- AFTERIMAGE_LIBS=`$afterimage_config --libs`
- if test "x$AFTERIMAGE_LIBS" != "x"; then
- libai_ver_major=`echo $AFTERIMAGE_VERSION | cut -f 1 -d .`
- libai_ver_minor=`echo $AFTERIMAGE_VERSION | cut -f 2 -d .`
- if test $libai_ver_major -gt 1 -o \( $libai_ver_major -eq 1 -a $libai_ver_minor -ge 15 \); then
- support_afterimage=yes
+ if test "x$afterimage_config" != "xno" ; then
+ AC_MSG_CHECKING(for libAfterImage version >= 1.15)
+ xAFTERIMAGE_VERSION=`$afterimage_config --version`
+ if test -n "$xAFTERIMAGE_VERSION" ; then
+ xAFTERIMAGE_CFLAGS=`$afterimage_config --cflags`
+ xAFTERIMAGE_LIBS=`$afterimage_config --libs`
+ if test "x$xAFTERIMAGE_LIBS" != "x"; then
+ libai_ver_major=`echo $xAFTERIMAGE_VERSION | cut -f 1 -d .`
+ libai_ver_minor=`echo $xAFTERIMAGE_VERSION | cut -f 2 -d .`
+ if test $libai_ver_major -gt 1 -o \( $libai_ver_major -eq 1 -a $libai_ver_minor -ge 15 \); then
+ support_afterimage=yes
+ AFTERIMAGE_CFLAGS="$xAFTERIMAGE_CFLAGS"
+ AFTERIMAGE_LIBS="$xAFTERIMAGE_LIBS"
+ AFTERIMAGE_VERSION="$xAFTERIMAGE_VERSION"
+ fi
fi
fi
- fi
-
- if test "x$support_afterimage" = "xyes"; then
- AC_MSG_RESULT($AFTERIMAGE_LIBS)
- else
- AC_MSG_RESULT(no)
+ if test "x$support_afterimage" = "xyes"; then
+ AC_MSG_RESULT($AFTERIMAGE_LIBS)
+ else
+ AC_MSG_RESULT(no)
+ fi
fi
fi
fi
echo
echo " embedded perl: $support_perl"
+echo " libafterimage: $support_afterimage"
echo
if test x$support_xpm = xneedsmanualspecification; then
echo ".----------------------------------------------------------------."
-e 's%@@URXVT_NAME@@%urxvt%g;'
all:
- sed $(SEDREPLACE) < $(srcdir)/rxvt.1.man.in >rxvt.1.man
+ sed $(SEDREPLACE) < $(srcdir)/rxvt.1.man.in >rxvt.1.man
sed $(SEDREPLACE) < $(srcdir)/rxvtc.1.man.in >rxvtc.1.man
sed $(SEDREPLACE) < $(srcdir)/rxvtd.1.man.in >rxvtd.1.man
- sed $(SEDREPLACE) < $(srcdir)/rxvt.7.man.in >rxvt.7.man
+ sed $(SEDREPLACE) < $(srcdir)/rxvt.7.man.in >rxvt.7.man
@IF_PERL@ sed $(SEDREPLACE) < $(srcdir)/rxvtperl.3.man.in >rxvtperl.3.man
rxvtperl.3.pod: ../src/urxvt.pm
install:
$(INSTALL) -d $(DESTDIR)$(man1dir)
- $(INSTALL_DATA) rxvt.1.man $(DESTDIR)$(man1dir)/$(RXVTNAME).$(man1ext)
+ $(INSTALL) -d $(DESTDIR)$(man7dir)
+ $(INSTALL_DATA) rxvt.1.man $(DESTDIR)$(man1dir)/$(RXVTNAME).$(man1ext)
$(INSTALL_DATA) rxvtc.1.man $(DESTDIR)$(man1dir)/$(RXVTNAME)c.$(man1ext)
$(INSTALL_DATA) rxvtd.1.man $(DESTDIR)$(man1dir)/$(RXVTNAME)d.$(man1ext)
- $(INSTALL) -d $(DESTDIR)$(man7dir)
- $(INSTALL_DATA) rxvt.7.man $(DESTDIR)$(man7dir)/$(RXVTNAME).$(man7ext)
+ $(INSTALL_DATA) rxvt.7.man $(DESTDIR)$(man7dir)/$(RXVTNAME).$(man7ext)
@IF_PERL@ $(INSTALL) -d $(DESTDIR)$(man3dir)
@IF_PERL@ $(INSTALL_DATA) rxvtperl.3.man $(DESTDIR)$(man3dir)/$(RXVTNAME)perl.$(man3ext)
if test -x "@TIC@"; then if test -n "@TIC@"; then @TIC@ $(srcdir)/etc/rxvt-unicode.terminfo; fi; fi
distdepend: alldoc
-# ------------------------------------------------------------------------
-# DO NOT DELETE: ugly dependency list follows
<meta name="description" content="Pod documentation for rxvt-unicode (ouR XVT, unicode)" />
<meta name="inputfile" content="<standard input>" />
<meta name="outputfile" content="<standard output>" />
- <meta name="created" content="Mon Jun 25 00:30:33 2007" />
+ <meta name="created" content="Wed Aug 1 20:30:03 2007" />
<meta name="generator" content="Pod::Xhtml 1.57" />
<link rel="stylesheet" href="http://res.tst.eu/pod.css"/></head>
<body>
</div>
<h1 id="DESCRIPTION">DESCRIPTION</h1><p><a href="#TOP" class="toplink">Top</a></p>
<div id="DESCRIPTION_CONTENT">
-<p><strong>rxvt-unicode</strong>, version <strong>8.2</strong>, is a colour vt102 terminal
+<p><strong>rxvt-unicode</strong>, version <strong>8.3</strong>, is a colour vt102 terminal
emulator intended as an <i>xterm</i>(1) replacement for users who do not
require features such as Tektronix 4014 emulation and toolkit-style
configurability. As a result, <strong>rxvt-unicode</strong> uses much less swap space --
<p>Tint the transparent background pixmap with the given colour when
transparency is enabled with <strong>-tr</strong> or <strong>-ip</strong>. This only works for
non-tiled backgrounds, currently. See also the <strong>-sh</strong> option that can be
-used to brighten or darken the image in addition to tinting it; resource
+used to brighten or darken the image in addition to tinting it.
+Please note that certain tint colours can be applied on the server-side,
+thus yielding performance gain of two orders of magnitude. These colours are:
+blue, red, green, cyan, magenta, yellow, and those close to them; resource
<i>tintColor</i>. Example:</p>
<pre> rxvt -tr -tint blue -sh 40
</pre>
</dd>
- <dt><strong>-sh</strong> <i>number</i> </dt>
+ <dt><strong>-sh</strong> <i>number</i></dt>
<dd>
<p>Darken (0 .. 100) or lighten (-1 .. -100) the transparent
-background image in addition to (or instead of) tinting it;
+background image in addition to (or instead of) tinting it;
resource <i>shading</i>.</p>
</dd>
<dt><strong>-blt</strong> <i>string</i></dt>
<dd>
- <p>Specify background blending type. If background pixmap is specified
-at the same time as transparency - such pixmap will be blended over
+ <p>Specify background blending type. If background pixmap is specified
+at the same time as transparency - such pixmap will be blended over
transparency image, using method specified. Supported values are :
-<strong>add</strong>, <strong>alphablend</strong>, <strong>allanon</strong> - color values averaging, <strong>colorize</strong>,
-<strong>darken</strong>, <strong>diff</strong>, <strong>dissipate</strong>, <strong>hue</strong>, <strong>lighten</strong>, <strong>overlay</strong>,
-<strong>saturate</strong>, <strong>screen</strong>, <strong>sub</strong>, <strong>tint</strong>, <strong>value</strong>. The default is
+<strong>add</strong>, <strong>alphablend</strong>, <strong>allanon</strong> - color values averaging, <strong>colorize</strong>,
+<strong>darken</strong>, <strong>diff</strong>, <strong>dissipate</strong>, <strong>hue</strong>, <strong>lighten</strong>, <strong>overlay</strong>,
+<strong>saturate</strong>, <strong>screen</strong>, <strong>sub</strong>, <strong>tint</strong>, <strong>value</strong>. The default is
alpha-blending; resource <i>blendType</i>.</p>
</dd>
- <dt><strong>-blr</strong> <i>number</i></dt>
+ <dt><strong>-blr</strong> <i>HxV</i></dt>
<dd>
- <p>Apply Gaussian Blur with the specified radius to the transparent
-background image; resource <i>blurRadius</i>.</p>
+ <p>Apply Gaussian Blur with the specified radii to the transparent
+background image. If single number is specified - both vertical and
+horizontal radii are considered to be the same. Setting one of the
+radii to 1 and another to a large number creates interesting effects
+on some backgrounds. Maximum radius value is 128; resource <i>blurRadius</i>.</p>
</dd>
<dt><strong>-bg</strong> <i>colour</i></dt>
<dd>
<div id="ISO_14755_SUPPORT_CONTENT">
<p>ISO 14755 is a standard for entering and viewing unicode characters
and character codes using the keyboard. It consists of 4 parts. The
-first part is available rxvt-unicode has been compiled with
+first part is available if rxvt-unicode has been compiled with
<code>--enable-frills</code>, the rest is available when rxvt-unicode was compiled
with <code>--enable-iso14755</code>.</p>
<dl>
.\" ========================================================================
.\"
.IX Title "@@RXVT_NAME@@ 1"
-.TH @@RXVT_NAME@@ 1 "2007-06-25" "8.2" "RXVT-UNICODE"
+.TH @@RXVT_NAME@@ 1 "2007-08-01" "8.3" "RXVT-UNICODE"
.SH "NAME"
rxvt\-unicode (ouR XVT, unicode) \- (a VT102 emulator for the X window system)
.SH "SYNOPSIS"
Tint the transparent background pixmap with the given colour when
transparency is enabled with \fB\-tr\fR or \fB\-ip\fR. This only works for
non-tiled backgrounds, currently. See also the \fB\-sh\fR option that can be
-used to brighten or darken the image in addition to tinting it; resource
+used to brighten or darken the image in addition to tinting it.
+Please note that certain tint colours can be applied on the server\-side,
+thus yielding performance gain of two orders of magnitude. These colours are:
+blue, red, green, cyan, magenta, yellow, and those close to them; resource
\&\fItintColor\fR. Example:
.Sp
.Vb 1
.IP "\fB\-sh\fR \fInumber\fR" 4
.IX Item "-sh number"
Darken (0 .. 100) or lighten (\-1 .. \-100) the transparent
-background image in addition to (or instead of) tinting it;
+background image in addition to (or instead of) tinting it;
resource \fIshading\fR.
.IP "\fB\-blt\fR \fIstring\fR" 4
.IX Item "-blt string"
-Specify background blending type. If background pixmap is specified
-at the same time as transparency \- such pixmap will be blended over
+Specify background blending type. If background pixmap is specified
+at the same time as transparency \- such pixmap will be blended over
transparency image, using method specified. Supported values are :
-\&\fBadd\fR, \fBalphablend\fR, \fBallanon\fR \- color values averaging, \fBcolorize\fR,
-\&\fBdarken\fR, \fBdiff\fR, \fBdissipate\fR, \fBhue\fR, \fBlighten\fR, \fBoverlay\fR,
-\&\fBsaturate\fR, \fBscreen\fR, \fBsub\fR, \fBtint\fR, \fBvalue\fR. The default is
+\&\fBadd\fR, \fBalphablend\fR, \fBallanon\fR \- color values averaging, \fBcolorize\fR,
+\&\fBdarken\fR, \fBdiff\fR, \fBdissipate\fR, \fBhue\fR, \fBlighten\fR, \fBoverlay\fR,
+\&\fBsaturate\fR, \fBscreen\fR, \fBsub\fR, \fBtint\fR, \fBvalue\fR. The default is
alpha\-blending; resource \fIblendType\fR.
-.IP "\fB\-blr\fR \fInumber\fR" 4
-.IX Item "-blr number"
-Apply Gaussian Blur with the specified radius to the transparent
-background image; resource \fIblurRadius\fR.
+.IP "\fB\-blr\fR \fIHxV\fR" 4
+.IX Item "-blr HxV"
+Apply Gaussian Blur with the specified radii to the transparent
+background image. If single number is specified \- both vertical and
+horizontal radii are considered to be the same. Setting one of the
+radii to 1 and another to a large number creates interesting effects
+on some backgrounds. Maximum radius value is 128; resource \fIblurRadius\fR.
.IP "\fB\-bg\fR \fIcolour\fR" 4
.IX Item "-bg colour"
Window background colour; resource \fBbackground\fR.
.IX Header "ISO 14755 SUPPORT"
\&\s-1ISO\s0 14755 is a standard for entering and viewing unicode characters
and character codes using the keyboard. It consists of 4 parts. The
-first part is available rxvt-unicode has been compiled with
+first part is available if rxvt-unicode has been compiled with
\&\f(CW\*(C`\-\-enable\-frills\*(C'\fR, the rest is available when rxvt-unicode was compiled
with \f(CW\*(C`\-\-enable\-iso14755\*(C'\fR.
.IP "* 5.1: Basic method" 4
rxvt [options] [-e command [ args ]]
DESCRIPTION
- rxvt-unicode, version 8.2, is a colour vt102 terminal emulator intended
+ rxvt-unicode, version 8.3, is a colour vt102 terminal emulator intended
as an *xterm*(1) replacement for users who do not require features such
as Tektronix 4014 emulation and toolkit-style configurability. As a
result, rxvt-unicode uses much less swap space -- a significant
Tint the transparent background pixmap with the given colour when
transparency is enabled with -tr or -ip. This only works for
non-tiled backgrounds, currently. See also the -sh option that can
- be used to brighten or darken the image in addition to tinting it;
- resource *tintColor*. Example:
+ be used to brighten or darken the image in addition to tinting it.
+ Please note that certain tint colours can be applied on the
+ server-side, thus yielding performance gain of two orders of
+ magnitude. These colours are: blue, red, green, cyan, magenta,
+ yellow, and those close to them; resource *tintColor*. Example:
rxvt -tr -tint blue -sh 40
diff, dissipate, hue, lighten, overlay, saturate, screen, sub, tint,
value. The default is alpha-blending; resource *blendType*.
- -blr *number*
- Apply Gaussian Blur with the specified radius to the transparent
- background image; resource *blurRadius*.
+ -blr *HxV*
+ Apply Gaussian Blur with the specified radii to the transparent
+ background image. If single number is specified - both vertical and
+ horizontal radii are considered to be the same. Setting one of the
+ radii to 1 and another to a large number creates interesting effects
+ on some backgrounds. Maximum radius value is 128; resource
+ *blurRadius*.
-bg *colour*
Window background colour; resource background.
ISO 14755 SUPPORT
ISO 14755 is a standard for entering and viewing unicode characters and
character codes using the keyboard. It consists of 4 parts. The first
- part is available rxvt-unicode has been compiled with "--enable-frills",
- the rest is available when rxvt-unicode was compiled with
- "--enable-iso14755".
+ part is available if rxvt-unicode has been compiled with
+ "--enable-frills", the rest is available when rxvt-unicode was compiled
+ with "--enable-iso14755".
* 5.1: Basic method
This allows you to enter unicode characters using their hexcode.
<meta name="description" content="Pod documentation for RXVT REFERENCE" />
<meta name="inputfile" content="<standard input>" />
<meta name="outputfile" content="<standard output>" />
- <meta name="created" content="Mon Jun 25 00:30:33 2007" />
+ <meta name="created" content="Wed Aug 1 20:30:03 2007" />
<meta name="generator" content="Pod::Xhtml 1.57" />
<link rel="stylesheet" href="http://res.tst.eu/pod.css"/></head>
<body>
<ul><li><a href="#I_am_using_Debian_GNU_Linux_and_have">I am using Debian GNU/Linux and have a problem...</a></li>
<li><a href="#I_am_maintaining_rxvt_unicode_for_di">I am maintaining rxvt-unicode for distribution/OS XXX, any recommendation?</a></li>
<li><a href="#I_need_to_make_it_setuid_setgid_to_s">I need to make it setuid/setgid to support utmp/ptys on my OS, is this safe?</a></li>
-<li><a href="#On_Solaris_9_many_line_drawing_chara">On Solaris 9, many line-drawing characters are too wide.</a></li>
<li><a href="#I_am_on_FreeBSD_and_rxvt_unicode_doe">I am on FreeBSD and rxvt-unicode does not seem to work at all.</a></li>
-<li><a href="#I_use_Solaris_9_and_it_doesn_t_compi">I use Solaris 9 and it doesn't compile/work/etc.</a></li>
<li><a href="#How_can_I_use_rxvt_unicode_under_cyg">How can I use rxvt-unicode under cygwin?</a></li>
+<li><a href="#Character_widths_are_not_correct">Character widths are not correct.</a></li>
</ul>
</li>
</ul>
<div id="How_do_I_compile_the_manual_pages_on-2">
<p>You need to have a recent version of perl installed as <cite>/usr/bin/perl</cite>,
one that comes with <cite>pod2man</cite>, <cite>pod2text</cite> and <cite>pod2xhtml</cite> (from
-<cite>Pod::XHTML</cite>). Then go to the doc subdirectory and enter <code>make alldoc</code>.</p>
+<cite>Pod::Xhtml</cite>). Then go to the doc subdirectory and enter <code>make alldoc</code>.</p>
</div>
<h3 id="Isn_t_rxvt_unicode_supposed_to_be_sm">Isn't rxvt-unicode supposed to be small? Don't all those features bloat?</h3>
little risk.</p>
</div>
-<h3 id="On_Solaris_9_many_line_drawing_chara">On Solaris 9, many line-drawing characters are too wide.</h3>
-<div id="On_Solaris_9_many_line_drawing_chara-2">
-<p>Seems to be a known bug, read
-<a href="http://nixdoc.net/files/forum/about34198.html">http://nixdoc.net/files/forum/about34198.html</a>. Some people use the
-following ugly workaround to get non-double-wide-characters working:</p>
-<pre> #define wcwidth(x) wcwidth(x) > 1 ? 1 : wcwidth(x)
-
-</pre>
-
-</div>
<h3 id="I_am_on_FreeBSD_and_rxvt_unicode_doe">I am on FreeBSD and rxvt-unicode does not seem to work at all.</h3>
<div id="I_am_on_FreeBSD_and_rxvt_unicode_doe-2">
<p>Rxvt-unicode requires the symbol <code>__STDC_ISO_10646__</code> to be defined
complete replacements for them :)</p>
</div>
-<h3 id="I_use_Solaris_9_and_it_doesn_t_compi">I use Solaris 9 and it doesn't compile/work/etc.</h3>
-<div id="I_use_Solaris_9_and_it_doesn_t_compi-2">
-<p>Try the diff in <cite>doc/solaris9.patch</cite> as a base. It fixes the worst
-problems with <code>wcwidth</code> and a compile problem.</p>
-
-</div>
<h3 id="How_can_I_use_rxvt_unicode_under_cyg">How can I use rxvt-unicode under cygwin?</h3>
<div id="How_can_I_use_rxvt_unicode_under_cyg-2">
<p>rxvt-unicode should compile and run out of the box on cygwin, using
to 8-bit encodings.</p>
</div>
+<h3 id="Character_widths_are_not_correct">Character widths are not correct.</h3>
+<div id="Character_widths_are_not_correct_CON">
+<p>urxvt uses the system wcwidth function to know the information about
+the width of characters, so on systems with incorrect locale data you
+will likely get bad results. Two notorious examples are Solaris 9,
+where single-width characters like U+2514 are reported as double-width,
+and Darwin 8, where combining chars are reported having width 1.</p>
+<p>The solution is to upgrade your system or switch to a better one. A
+possibly working workaround is to use a wcwidth implementation like</p>
+<p>http://www.cl.cam.ac.uk/~mgk25/ucs/wcwidth.c</p>
+
+</div>
<h1 id="RXVT_UNICODE_TECHNICAL_REFERENCE">RXVT-UNICODE TECHNICAL REFERENCE</h1><p><a href="#TOP" class="toplink">Top</a></p>
<div id="RXVT_UNICODE_TECHNICAL_REFERENCE_CON">
<p>The rest of this document describes various technical aspects of
<dd>
<p>Add support for XPM background pixmaps.</p>
</dd>
+ <dt>--enable-afterimage (default: on)</dt>
+ <dd>
+ <p>Add support for libAfterImage to be used for transparency and background
+images. It adds support for many file formats including JPG, PNG,
+SVG, TIFF, GIF, XPM, BMP, ICO, XCF, TGA and AfterStep image XML
+(<a href="http://www.afterstep.org/visualdoc.php?show=asimagexml">http://www.afterstep.org/visualdoc.php?show=asimagexml</a>).</p>
+ <p>This option also adds such eye candy as blending an image over the root
+background, as well as dynamic scaling and bluring of background images.</p>
+ <p>Note that with this option enabled, rxvt's memory footprint might
+increase by a few megabytes even if no extra features are used (mostly due
+to third-party libraries used by libAI). Memory footprint may somewhat be
+lowered if libAfterImage is configured without support for SVG.</p>
+ </dd>
<dt>--enable-transparency (default: on)</dt>
<dd>
<p>Add support for inheriting parent backgrounds thus giving a fake
</dd>
<dt>--enable-fading (default: on)</dt>
<dd>
- <p>Add support for fading the text when focus is lost (requires <code>--enable-transparency</code>).</p>
+ <p>Add support for fading the text when focus is lost.</p>
</dd>
<dt>--enable-tinting (default: on)</dt>
<dd>
<p>Add support for continual scrolling of the display when you hold
the mouse button down on a scrollbar arrow.</p>
</dd>
+ <dt>--enable-selectionscrolling (default: on)</dt>
+ <dd>
+ <p>Add support for scrolling when the selection moves to the top or
+bottom of the screen.</p>
+ </dd>
<dt>--enable-mousewheel (default: on)</dt>
<dd>
<p>Add support for scrolling via mouse wheel or buttons 4 & 5.</p>
accelerator) while the control key is held down. This option
requires --enable-mousewheel to also be specified.</p>
</dd>
- <dt>--disable-new-selection</dt>
- <dd>
- <p>Remove support for mouse selection style like that of xterm.</p>
- </dd>
- <dt>--enable-dmalloc (default: off)</dt>
- <dd>
- <p>Use Gray Watson's malloc - which is good for debugging See
-<a href="http://www.letters.com/dmalloc/">http://www.letters.com/dmalloc/</a> for details If you use either this or the
-next option, you may need to edit src/Makefile after compiling to point
-DINCLUDE and DLIB to the right places.</p>
- <p>You can only use either this option and the following (should
-you use either) .</p>
- </dd>
- <dt>--enable-dlmalloc (default: off)</dt>
- <dd>
- <p>Use Doug Lea's malloc - which is good for a production version
-See <a href="http://g.oswego.edu/dl/html/malloc.html">http://g.oswego.edu/dl/html/malloc.html</a> for details.</p>
- </dd>
- <dt>--enable-smart-resize (default: on)</dt>
+ <dt>--enable-smart-resize (default: off)</dt>
<dd>
- <p>Add smart growth/shrink behaviour when changing font size via hot
-keys. This should keep the window corner which is closest to a corner of
+ <p>Add smart growth/shrink behaviour when resizing.
+This should keep the window corner which is closest to a corner of
the screen in a fixed position.</p>
</dd>
<dt>--enable-pointer-blank (default: on)</dt>
<code>-pe "" --perl-ext-common ""</code>, so it should be safe to enable from a
resource standpoint.</p>
</dd>
+ <dt>--with-afterimage-config=DIR</dt>
+ <dd>
+ <p>Look for the libAfterImage config script in DIR.</p>
+ </dd>
<dt>--with-name=NAME (default: urxvt)</dt>
<dd>
<p>Set the basename for the installed binaries, resulting
.\" ========================================================================
.\"
.IX Title "@@RXVT_NAME@@ 7"
-.TH @@RXVT_NAME@@ 7 "2007-06-25" "8.2" "RXVT-UNICODE"
+.TH @@RXVT_NAME@@ 7 "2007-08-01" "8.3" "RXVT-UNICODE"
.SH "NAME"
RXVT REFERENCE \- FAQ, command sequences and other background information
.SH "SYNOPSIS"
.PP
You need to have a recent version of perl installed as \fI/usr/bin/perl\fR,
one that comes with \fIpod2man\fR, \fIpod2text\fR and \fIpod2xhtml\fR (from
-\&\fIPod::XHTML\fR). Then go to the doc subdirectory and enter \f(CW\*(C`make alldoc\*(C'\fR.
+\&\fIPod::Xhtml\fR). Then go to the doc subdirectory and enter \f(CW\*(C`make alldoc\*(C'\fR.
.PP
\fIIsn't rxvt-unicode supposed to be small? Don't all those features bloat?\fR
.IX Subsection "Isn't rxvt-unicode supposed to be small? Don't all those features bloat?"
things like the dynamic loader of your system, which should result in very
little risk.
.PP
-\fIOn Solaris 9, many line-drawing characters are too wide.\fR
-.IX Subsection "On Solaris 9, many line-drawing characters are too wide."
-.PP
-Seems to be a known bug, read
-<http://nixdoc.net/files/forum/about34198.html>. Some people use the
-following ugly workaround to get non-double-wide-characters working:
-.PP
-.Vb 1
-\& #define wcwidth(x) wcwidth(x) > 1 ? 1 : wcwidth(x)
-.Ve
-.PP
\fII am on FreeBSD and rxvt-unicode does not seem to work at all.\fR
.IX Subsection "I am on FreeBSD and rxvt-unicode does not seem to work at all."
.PP
system libraries once and for all, instead of forcing every app to carry
complete replacements for them :)
.PP
-\fII use Solaris 9 and it doesn't compile/work/etc.\fR
-.IX Subsection "I use Solaris 9 and it doesn't compile/work/etc."
-.PP
-Try the diff in \fIdoc/solaris9.patch\fR as a base. It fixes the worst
-problems with \f(CW\*(C`wcwidth\*(C'\fR and a compile problem.
-.PP
\fIHow can I use rxvt-unicode under cygwin?\fR
.IX Subsection "How can I use rxvt-unicode under cygwin?"
.PP
At the time of this writing, cygwin didn't seem to support any multi-byte
encodings (you might try \f(CW\*(C`LC_CTYPE=C\-UTF\-8\*(C'\fR), so you are likely limited
to 8\-bit encodings.
+.PP
+\fICharacter widths are not correct.\fR
+.IX Subsection "Character widths are not correct."
+.PP
+urxvt uses the system wcwidth function to know the information about
+the width of characters, so on systems with incorrect locale data you
+will likely get bad results. Two notorious examples are Solaris 9,
+where single-width characters like U+2514 are reported as double\-width,
+and Darwin 8, where combining chars are reported having width 1.
+.PP
+The solution is to upgrade your system or switch to a better one. A
+possibly working workaround is to use a wcwidth implementation like
+.PP
+http://www.cl.cam.ac.uk/~mgk25/ucs/wcwidth.c
.SH "RXVT-UNICODE TECHNICAL REFERENCE"
.IX Header "RXVT-UNICODE TECHNICAL REFERENCE"
The rest of this document describes various technical aspects of
.IP "\-\-enable\-xpm\-background (default: on)" 4
.IX Item "--enable-xpm-background (default: on)"
Add support for \s-1XPM\s0 background pixmaps.
+.IP "\-\-enable\-afterimage (default: on)" 4
+.IX Item "--enable-afterimage (default: on)"
+Add support for libAfterImage to be used for transparency and background
+images. It adds support for many file formats including \s-1JPG\s0, \s-1PNG\s0,
+\&\s-1SVG\s0, \s-1TIFF\s0, \s-1GIF\s0, \s-1XPM\s0, \s-1BMP\s0, \s-1ICO\s0, \s-1XCF\s0, \s-1TGA\s0 and AfterStep image \s-1XML\s0
+(<http://www.afterstep.org/visualdoc.php?show=asimagexml>).
+.Sp
+This option also adds such eye candy as blending an image over the root
+background, as well as dynamic scaling and bluring of background images.
+.Sp
+Note that with this option enabled, @@RXVT_NAME@@'s memory footprint might
+increase by a few megabytes even if no extra features are used (mostly due
+to third-party libraries used by libAI). Memory footprint may somewhat be
+lowered if libAfterImage is configured without support for \s-1SVG\s0.
.IP "\-\-enable\-transparency (default: on)" 4
.IX Item "--enable-transparency (default: on)"
Add support for inheriting parent backgrounds thus giving a fake
transparency to the term.
.IP "\-\-enable\-fading (default: on)" 4
.IX Item "--enable-fading (default: on)"
-Add support for fading the text when focus is lost (requires \f(CW\*(C`\-\-enable\-transparency\*(C'\fR).
+Add support for fading the text when focus is lost.
.IP "\-\-enable\-tinting (default: on)" 4
.IX Item "--enable-tinting (default: on)"
Add support for tinting of transparent backgrounds (requires \f(CW\*(C`\-\-enable\-transparency\*(C'\fR).
.IX Item "--enable-keepscrolling (default: on)"
Add support for continual scrolling of the display when you hold
the mouse button down on a scrollbar arrow.
+.IP "\-\-enable\-selectionscrolling (default: on)" 4
+.IX Item "--enable-selectionscrolling (default: on)"
+Add support for scrolling when the selection moves to the top or
+bottom of the screen.
.IP "\-\-enable\-mousewheel (default: on)" 4
.IX Item "--enable-mousewheel (default: on)"
Add support for scrolling via mouse wheel or buttons 4 & 5.
Add support for continual scrolling (using the mouse wheel as an
accelerator) while the control key is held down. This option
requires \-\-enable\-mousewheel to also be specified.
-.IP "\-\-disable\-new\-selection" 4
-.IX Item "--disable-new-selection"
-Remove support for mouse selection style like that of xterm.
-.IP "\-\-enable\-dmalloc (default: off)" 4
-.IX Item "--enable-dmalloc (default: off)"
-Use Gray Watson's malloc \- which is good for debugging See
-<http://www.letters.com/dmalloc/> for details If you use either this or the
-next option, you may need to edit src/Makefile after compiling to point
-\&\s-1DINCLUDE\s0 and \s-1DLIB\s0 to the right places.
-.Sp
-You can only use either this option and the following (should
-you use either) .
-.IP "\-\-enable\-dlmalloc (default: off)" 4
-.IX Item "--enable-dlmalloc (default: off)"
-Use Doug Lea's malloc \- which is good for a production version
-See <http://g.oswego.edu/dl/html/malloc.html> for details.
-.IP "\-\-enable\-smart\-resize (default: on)" 4
-.IX Item "--enable-smart-resize (default: on)"
-Add smart growth/shrink behaviour when changing font size via hot
-keys. This should keep the window corner which is closest to a corner of
+.IP "\-\-enable\-smart\-resize (default: off)" 4
+.IX Item "--enable-smart-resize (default: off)"
+Add smart growth/shrink behaviour when resizing.
+This should keep the window corner which is closest to a corner of
the screen in a fixed position.
.IP "\-\-enable\-pointer\-blank (default: on)" 4
.IX Item "--enable-pointer-blank (default: on)"
in, perl will \fInot\fR be initialised when all extensions have been disabled
\&\f(CW\*(C`\-pe "" \-\-perl\-ext\-common ""\*(C'\fR, so it should be safe to enable from a
resource standpoint.
+.IP "\-\-with\-afterimage\-config=DIR" 4
+.IX Item "--with-afterimage-config=DIR"
+Look for the libAfterImage config script in \s-1DIR\s0.
.IP "\-\-with\-name=NAME (default: urxvt)" 4
.IX Item "--with-name=NAME (default: urxvt)"
Set the basename for the installed binaries, resulting
How do I compile the manual pages on my own?
You need to have a recent version of perl installed as /usr/bin/perl,
- one that comes with pod2man, pod2text and pod2xhtml (from Pod::XHTML).
+ one that comes with pod2man, pod2text and pod2xhtml (from Pod::Xhtml).
Then go to the doc subdirectory and enter "make alldoc".
Isn't rxvt-unicode supposed to be small? Don't all those features bloat?
main(), or things like the dynamic loader of your system, which should
result in very little risk.
- On Solaris 9, many line-drawing characters are too wide.
- Seems to be a known bug, read
- <http://nixdoc.net/files/forum/about34198.html>. Some people use the
- following ugly workaround to get non-double-wide-characters working:
-
- #define wcwidth(x) wcwidth(x) > 1 ? 1 : wcwidth(x)
-
I am on FreeBSD and rxvt-unicode does not seem to work at all.
Rxvt-unicode requires the symbol "__STDC_ISO_10646__" to be defined in
your compile environment, or an implementation that implements it,
system libraries once and for all, instead of forcing every app to carry
complete replacements for them :)
- I use Solaris 9 and it doesn't compile/work/etc.
- Try the diff in doc/solaris9.patch as a base. It fixes the worst
- problems with "wcwidth" and a compile problem.
-
How can I use rxvt-unicode under cygwin?
rxvt-unicode should compile and run out of the box on cygwin, using the
X11 libraries that come with cygwin. libW11 emulation is no longer
multi-byte encodings (you might try "LC_CTYPE=C-UTF-8"), so you are
likely limited to 8-bit encodings.
+ Character widths are not correct.
+ urxvt uses the system wcwidth function to know the information about the
+ width of characters, so on systems with incorrect locale data you will
+ likely get bad results. Two notorious examples are Solaris 9, where
+ single-width characters like U+2514 are reported as double-width, and
+ Darwin 8, where combining chars are reported having width 1.
+
+ The solution is to upgrade your system or switch to a better one. A
+ possibly working workaround is to use a wcwidth implementation like
+
+ http://www.cl.cam.ac.uk/~mgk25/ucs/wcwidth.c
+
RXVT-UNICODE TECHNICAL REFERENCE
The rest of this document describes various technical aspects of
rxvt-unicode. First the description of supported command sequences,
--enable-xpm-background (default: on)
Add support for XPM background pixmaps.
+ --enable-afterimage (default: on)
+ Add support for libAfterImage to be used for transparency and
+ background images. It adds support for many file formats including
+ JPG, PNG, SVG, TIFF, GIF, XPM, BMP, ICO, XCF, TGA and AfterStep
+ image XML
+ (<http://www.afterstep.org/visualdoc.php?show=asimagexml>).
+
+ This option also adds such eye candy as blending an image over the
+ root background, as well as dynamic scaling and bluring of
+ background images.
+
+ Note that with this option enabled, rxvt's memory footprint might
+ increase by a few megabytes even if no extra features are used
+ (mostly due to third-party libraries used by libAI). Memory
+ footprint may somewhat be lowered if libAfterImage is configured
+ without support for SVG.
+
--enable-transparency (default: on)
Add support for inheriting parent backgrounds thus giving a fake
transparency to the term.
--enable-fading (default: on)
- Add support for fading the text when focus is lost (requires
- "--enable-transparency").
+ Add support for fading the text when focus is lost.
--enable-tinting (default: on)
Add support for tinting of transparent backgrounds (requires
Add support for continual scrolling of the display when you hold the
mouse button down on a scrollbar arrow.
+ --enable-selectionscrolling (default: on)
+ Add support for scrolling when the selection moves to the top or
+ bottom of the screen.
+
--enable-mousewheel (default: on)
Add support for scrolling via mouse wheel or buttons 4 & 5.
accelerator) while the control key is held down. This option
requires --enable-mousewheel to also be specified.
- --disable-new-selection
- Remove support for mouse selection style like that of xterm.
-
- --enable-dmalloc (default: off)
- Use Gray Watson's malloc - which is good for debugging See
- <http://www.letters.com/dmalloc/> for details If you use either this
- or the next option, you may need to edit src/Makefile after
- compiling to point DINCLUDE and DLIB to the right places.
-
- You can only use either this option and the following (should you
- use either) .
-
- --enable-dlmalloc (default: off)
- Use Doug Lea's malloc - which is good for a production version See
- <http://g.oswego.edu/dl/html/malloc.html> for details.
-
- --enable-smart-resize (default: on)
- Add smart growth/shrink behaviour when changing font size via hot
- keys. This should keep the window corner which is closest to a
- corner of the screen in a fixed position.
+ --enable-smart-resize (default: off)
+ Add smart growth/shrink behaviour when resizing. This should keep
+ the window corner which is closest to a corner of the screen in a
+ fixed position.
--enable-pointer-blank (default: on)
Add support to have the pointer disappear when typing or inactive.
disabled "-pe "" --perl-ext-common """, so it should be safe to
enable from a resource standpoint.
+ --with-afterimage-config=DIR
+ Look for the libAfterImage config script in DIR.
+
--with-name=NAME (default: urxvt)
Set the basename for the installed binaries, resulting in "urxvt",
"urxvtd" etc.). Specify "--with-name=rxvt" to replace with "rxvt".
<meta name="description" content="Pod documentation for rxvtperl" />
<meta name="inputfile" content="<standard input>" />
<meta name="outputfile" content="<standard output>" />
- <meta name="created" content="Mon Jun 25 00:30:34 2007" />
+ <meta name="created" content="Wed Aug 1 20:30:04 2007" />
<meta name="generator" content="Pod::Xhtml 1.57" />
<link rel="stylesheet" href="http://res.tst.eu/pod.css"/></head>
<body>
bottom. <code>Escape</code> leaves search mode and returns to the point where search
was started, while <code>Enter</code> or <code>Return</code> stay at the current position and
additionally stores the first match in the current line into the primary
-selection.</p>
+selection if the <code>Shift</code> modifier is active.</p>
<p>The regex defaults to "(?i)", resulting in a case-insensitive search. To
get a case-sensitive search you can delete this prefix using <code>BackSpace</code>
or simply use an uppercase character which removes the "(?i)" prefix.</p>
.\" ========================================================================
.\"
.IX Title "@@RXVT_NAME@@ 3"
-.TH @@RXVT_NAME@@ 3 "2007-06-25" "8.2" "RXVT-UNICODE"
+.TH @@RXVT_NAME@@ 3 "2007-08-01" "8.3" "RXVT-UNICODE"
.SH "NAME"
@@RXVT_NAME@@perl \- rxvt\-unicode's embedded perl interpreter
.SH "SYNOPSIS"
bottom. \f(CW\*(C`Escape\*(C'\fR leaves search mode and returns to the point where search
was started, while \f(CW\*(C`Enter\*(C'\fR or \f(CW\*(C`Return\*(C'\fR stay at the current position and
additionally stores the first match in the current line into the primary
-selection.
+selection if the \f(CW\*(C`Shift\*(C'\fR modifier is active.
.Sp
The regex defaults to \*(L"(?i)\*(R", resulting in a case-insensitive search. To
get a case-sensitive search you can delete this prefix using \f(CW\*(C`BackSpace\*(C'\fR
"End" jumps to the bottom. "Escape" leaves search mode and returns
to the point where search was started, while "Enter" or "Return"
stay at the current position and additionally stores the first match
- in the current line into the primary selection.
+ in the current line into the primary selection if the "Shift"
+ modifier is active.
The regex defaults to "(?i)", resulting in a case-insensitive
search. To get a case-sensitive search you can delete this prefix
// VERSION _must_ be \d.\d+
-#define VERSION "8.2"
-#define DATE "2007-02-17"
+#define VERSION "8.3"
+#define DATE "2007-08-01"