rxvt-unicode, version 8.2, is a colour vt102 terminal +

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 -- @@ -178,32 +178,38 @@ is opaque black. resource fadeColor.

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 +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

-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 shading.

-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 : -add, alphablend, allanon - color values averaging, colorize, -darken, diff, dissipate, hue, lighten, overlay, -saturate, screen, sub, tint, value. The default is +add, alphablend, allanon - color values averaging, colorize, +darken, diff, dissipate, hue, lighten, overlay, +saturate, screen, sub, tint, value. The default is alpha-blending; resource blendType.

-blr number

-blr HxV

Apply Gaussian Blur with the specified radius to the transparent -background image; resource blurRadius.

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

@@ -1298,7 +1304,7 @@ supported in rxvt-unicode. Bug me if you need this.

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 --enable-frills, the rest is available when rxvt-unicode was compiled with --enable-iso14755.

diff --git a/doc/rxvt.1.man.in b/doc/rxvt.1.man.in index 09f93818..72d1ae0c 100644 --- a/doc/rxvt.1.man.in +++ b/doc/rxvt.1.man.in @@ -129,7 +129,7 @@ .\" ======================================================================== .\" .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" @@ -254,7 +254,10 @@ is opaque black. resource \fBfadeColor\fR. 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 @@ -263,21 +266,24 @@ used to brighten or darken the image in addition to tinting it; resource .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. @@ -1306,7 +1312,7 @@ rxvt-unicode will automatically re-apply these fonts to the output so far. .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 diff --git a/doc/rxvt.1.txt b/doc/rxvt.1.txt index 3c0d3576..d365fbdf 100644 --- a/doc/rxvt.1.txt +++ b/doc/rxvt.1.txt @@ -6,7 +6,7 @@ SYNOPSIS 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 @@ -125,8 +125,11 @@ OPTIONS 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 @@ -142,9 +145,13 @@ OPTIONS 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. @@ -1140,9 +1147,9 @@ CHANGING FONTS 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. diff --git a/doc/rxvt.7.html b/doc/rxvt.7.html index 5364ad09..535d1089 100644 --- a/doc/rxvt.7.html +++ b/doc/rxvt.7.html @@ -6,7 +6,7 @@ - + @@ -90,10 +90,9 @@

I am using Debian GNU/Linux and have a problem...
I am maintaining rxvt-unicode for distribution/OS XXX, any recommendation?
I need to make it setuid/setgid to support utmp/ptys on my OS, is this safe?
On Solaris 9, many line-drawing characters are too wide.
I am on FreeBSD and rxvt-unicode does not seem to work at all.
I use Solaris 9 and it doesn't compile/work/etc.
How can I use rxvt-unicode under cygwin?
Character widths are not correct.

@@ -279,7 +278,7 @@ snippets:

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). Then go to the doc subdirectory and enter make alldoc.

+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?

@@ -1309,16 +1308,6 @@ and reduces possible bugs to initialisation code run before 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.

@@ -1347,12 +1336,6 @@ encodings slightly different than the terminal emulator).

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?

@@ -1366,6 +1349,18 @@ old libW11 emulation.

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

Top

@@ -1987,6 +1982,19 @@ option requires --enable-utmp to also be specified.

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 @@ -1994,7 +2002,7 @@ 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)

@@ -2092,6 +2100,11 @@ this switch.

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)

@@ -2103,28 +2116,10 @@ the mouse button down on a scrollbar arrow.

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)

--enable-smart-resize (default: off)

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 +

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)

@@ -2142,6 +2137,10 @@ in, perl will not be initialised when all extensions have been 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 diff --git a/doc/rxvt.7.man.in b/doc/rxvt.7.man.in index 524de915..149e3608 100644 --- a/doc/rxvt.7.man.in +++ b/doc/rxvt.7.man.in @@ -129,7 +129,7 @@ .\" ======================================================================== .\" .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" @@ -278,7 +278,7 @@ snippets: .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?" @@ -1442,17 +1442,6 @@ and reduces possible bugs to initialisation code run before \fImain()\fR, or 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 -. 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 @@ -1486,12 +1475,6 @@ The rxvt-unicode author insists that the right way to fix this is in the 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 @@ -1505,6 +1488,20 @@ old libW11 emulation. 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 @@ -2553,13 +2550,27 @@ Write user and tty to lastlog file (used by programs like .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 +(). +.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). @@ -2648,6 +2659,10 @@ this switch. .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. @@ -2656,26 +2671,10 @@ 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 - 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 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)" @@ -2690,6 +2689,9 @@ default. The perl interpreter that is used can be specified via the 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 diff --git a/doc/rxvt.7.txt b/doc/rxvt.7.txt index 96062b2d..539e7ac1 100644 --- a/doc/rxvt.7.txt +++ b/doc/rxvt.7.txt @@ -112,7 +112,7 @@ RXVT-UNICODE/URXVT FREQUENTLY ASKED QUESTIONS 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? @@ -1081,13 +1081,6 @@ RXVT-UNICODE/URXVT FREQUENTLY ASKED QUESTIONS 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 - . 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, @@ -1119,10 +1112,6 @@ RXVT-UNICODE/URXVT FREQUENTLY ASKED QUESTIONS 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 @@ -1135,6 +1124,18 @@ RXVT-UNICODE/URXVT FREQUENTLY ASKED QUESTIONS 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, @@ -1885,13 +1886,29 @@ CONFIGURE OPTIONS --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 + (). + + 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 @@ -1979,6 +1996,10 @@ CONFIGURE OPTIONS 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. @@ -1987,26 +2008,10 @@ CONFIGURE OPTIONS 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 - 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 - 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. @@ -2021,6 +2026,9 @@ CONFIGURE OPTIONS 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". diff --git a/doc/rxvtperl.3.html b/doc/rxvtperl.3.html index 5406f6ae..6d2f845e 100644 --- a/doc/rxvtperl.3.html +++ b/doc/rxvtperl.3.html @@ -6,7 +6,7 @@ - + @@ -190,7 +190,7 @@ search upwards/downwards in the scrollback buffer, 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.

+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 using BackSpace or simply use an uppercase character which removes the "(?i)" prefix.

diff --git a/doc/rxvtperl.3.man.in b/doc/rxvtperl.3.man.in index 11ae7687..2123c816 100644 --- a/doc/rxvtperl.3.man.in +++ b/doc/rxvtperl.3.man.in @@ -129,7 +129,7 @@ .\" ======================================================================== .\" .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" @@ -297,7 +297,7 @@ search upwards/downwards in the scrollback buffer, \f(CW\*(C`End\*(C'\fR jumps t 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 diff --git a/doc/rxvtperl.3.txt b/doc/rxvtperl.3.txt index e05db6cb..3ddd92c3 100644 --- a/doc/rxvtperl.3.txt +++ b/doc/rxvtperl.3.txt @@ -139,7 +139,8 @@ PREPACKAGED EXTENSIONS "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 diff --git a/src/version.h b/src/version.h index 8daeba7f..f7658c42 100644 --- a/src/version.h +++ b/src/version.h @@ -1,3 +1,3 @@ // VERSION _must_ be \d.\d+ -#define VERSION "8.2" -#define DATE "2007-02-17" +#define VERSION "8.3" +#define DATE "2007-08-01"