--- rxvt-unicode/doc/rxvt.1.man.in 2006/08/07 16:17:30 1.63 +++ rxvt-unicode/doc/rxvt.1.man.in 2007/12/15 19:15:41 1.77 @@ -1,4 +1,4 @@ -.\" Automatically generated by Pod::Man 2.09 (Pod::Simple 3.04) +.\" Automatically generated by Pod::Man v1.37, Pod::Parser v1.35 .\" .\" Standard preamble: .\" ======================================================================== @@ -129,7 +129,7 @@ .\" ======================================================================== .\" .IX Title "@@RXVT_NAME@@ 1" -.TH @@RXVT_NAME@@ 1 "2006-08-07" "7.9" "RXVT-UNICODE" +.TH @@RXVT_NAME@@ 1 "2007-12-15" "8.8" "RXVT-UNICODE" .SH "NAME" rxvt\-unicode (ouR XVT, unicode) \- (a VT102 emulator for the X window system) .SH "SYNOPSIS" @@ -142,12 +142,15 @@ require features such as Tektronix 4014 emulation and toolkit-style configurability. As a result, \fBrxvt-unicode\fR uses much less swap space \*(-- a significant advantage on a machine serving many X sessions. +.PP +This document is also available on the World-Wide-Web at +. .SH "FREQUENTLY ASKED QUESTIONS" .IX Header "FREQUENTLY ASKED QUESTIONS" See @@RXVT_NAME@@(7) (try \f(CW\*(C`man 7 @@RXVT_NAME@@\*(C'\fR) for a list of frequently asked questions and answer to them and some common problems. That document is also accessible on the World-Wide-Web at -. +. .SH "RXVT-UNICODE VS. RXVT" .IX Header "RXVT-UNICODE VS. RXVT" Unlike the original rxvt, \fBrxvt-unicode\fR stores all text in Unicode @@ -155,11 +158,11 @@ world. Being a terminal emulator, however, some things are very difficult, especially cursive scripts such as arabic, vertically written scripts like mongolian or scripts requiring extremely complex combining rules, -like tibetan or devenagari. Don't expect pretty output when using these +like tibetan or devanagari. Don't expect pretty output when using these scripts. Most other scripts, latin, cyrillic, kanji, thai etc. should work fine, though. A somewhat difficult case are right-to-left scripts, such as hebrew: \fBrxvt-unicode\fR adopts the view that bidirectional algorithms -belong into the application, not the terminal emulator (too many things \*(-- +belong in the application, not the terminal emulator (too many things \*(-- such as cursor-movement while editing \*(-- break otherwise), but that might change. .PP @@ -228,15 +231,19 @@ Turn on/off simulated reverse video; resource \fBreverseVideo\fR. .IP "\fB\-j\fR|\fB+j\fR" 4 .IX Item "-j|+j" -Turn on/off jump scrolling; resource \fBjumpScroll\fR. -.IP "\fB\-ip\fR|\fB+ip\fR | \fB\-tr\fR|\fB+tr\fR" 4 -.IX Item "-ip|+ip | -tr|+tr" -Turn on/off inheriting parent window's pixmap. Alternative form is -\&\fB\-tr\fR; resource \fBinheritPixmap\fR. +Turn on/off jump scrolling (allow multiple lines per refresh); resource \fBjumpScroll\fR. +.IP "\fB\-ss\fR|\fB+ss\fR" 4 +.IX Item "-ss|+ss" +Turn on/off skip scrolling (allow multiple screens per refresh); resource \fBskipScroll\fR. +.IP "\fB\-tr\fR|\fB+tr\fR" 4 +.IX Item "-tr|+tr" +Turn on/off illusion of a transparent window background; resource \fBtransparent\fR. .Sp -\&\fIPlease note that transparency of any kind if completely unsupported by -the author. Don't bug him with installation questions! Read the \s-1FAQ\s0 (man 7 -@@RXVT_NAME@@)!\fR +\&\fB\-ip\fR is still accepted as an obsolete alias but will be removed in +future versions. +.Sp +\&\fIPlease address all transparency related issues to Sasha Vasko at +sasha@aftercode.net. Read the \s-1FAQ\s0 (man 7 @@RXVT_NAME@@)!\fR .IP "\fB\-fade\fR \fInumber\fR" 4 .IX Item "-fade number" Fade the text by the given percentage when focus is lost. Small values @@ -249,31 +256,52 @@ .IP "\fB\-tint\fR \fIcolour\fR" 4 .IX Item "-tint colour" 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 +transparency is enabled with \fB\-tr\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. Also +pure black and pure white colors essentially mean no tinting; resource \&\fItintColor\fR. Example: .Sp .Vb 1 -\& @@RXVT_NAME@@ \-tr \-tint blue \-sh 40 +\& @@RXVT_NAME@@ -tr -tint blue -sh 40 .Ve -.IP "\fB\-sh\fR" 4 -.IX Item "-sh" -\&\fInumber\fR Darken (0 .. 100) or lighten (\-1 .. \-100) the transparent -background image in addition to tinting it (i.e. \fB\-tint\fR must be -specified, too, e.g. \f(CW\*(C`\-tint white\*(C'\fR). +.IP "\fB\-sh\fR \fInumber\fR" 4 +.IX Item "-sh number" +Darken (0 .. 100) or lighten (100 .. 200) the transparent +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 +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 +alpha\-blending. Compile \fIafterimage\fR; resource \fIblendType\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. Compile \fIafterimage\fR; +resource \fIblurRadius\fR. .IP "\fB\-bg\fR \fIcolour\fR" 4 .IX Item "-bg colour" Window background colour; resource \fBbackground\fR. .IP "\fB\-fg\fR \fIcolour\fR" 4 .IX Item "-fg colour" Window foreground colour; resource \fBforeground\fR. -.IP "\fB\-pixmap\fR \fIfile[;geom]\fR" 4 -.IX Item "-pixmap file[;geom]" -Compile \fI\s-1XPM\s0\fR: Specify \s-1XPM\s0 file for the background and also optionally -specify its scaling with a geometry string. Note you may need to +.IP "\fB\-pixmap\fR \fIfile[;geom[:op1][:op2][...]]\fR" 4 +.IX Item "-pixmap file[;geom[:op1][:op2][...]]" +Compile \fIafterimage\fR: Specify image file for the background and also +optionally specify its scaling with a geometry string. Note you may need to add quotes to avoid special shell interpretation of the \f(CW\*(C`;\*(C'\fR in the -command\-line; resource \fBbackgroundPixmap\fR. +command\-line; for more details see resource \fBbackgroundPixmap\fR. .IP "\fB\-cr\fR \fIcolour\fR" 4 .IX Item "-cr colour" The cursor colour; resource \fBcursorColor\fR. @@ -300,8 +328,8 @@ e.g.: .Sp .Vb 2 -\& @@RXVT_NAME@@ \-fn "xft:Bitstream Vera Sans Mono:pixelsize=15" -\& @@RXVT_NAME@@ \-fn "9x15bold,xft:Bitstream Vera Sans Mono" +\& @@RXVT_NAME@@ -fn "xft:Bitstream Vera Sans Mono:pixelsize=15" +\& @@RXVT_NAME@@ -fn "9x15bold,xft:Bitstream Vera Sans Mono" .Ve .Sp See also the question \*(L"How does rxvt-unicode choose fonts?\*(R" in the \s-1FAQ\s0 @@ -321,7 +349,7 @@ for details. .IP "\fB\-is\fR|\fB+is\fR" 4 .IX Item "-is|+is" -Compile \fIfont-styles\fR: Bold/Italic font styles imply high intensity +Compile \fIfont-styles\fR: Bold/Blink font styles imply high intensity foreground/background (default). See resource \fBintensityStyles\fR for details. .IP "\fB\-name\fR \fIname\fR" 4 @@ -409,7 +437,7 @@ .IX Item "-lsp number" Compile \fIfrills\fR: Lines (pixel height) to insert between each row of the display. Useful to work around font rendering problems; resource -\&\fBlinespace\fR. +\&\fBlineSpace\fR. .IP "\fB\-tn\fR \fItermname\fR" 4 .IX Item "-tn termname" This option specifies the name of the terminal type to be set in the @@ -430,7 +458,7 @@ run shell commands, you have to specify the shell, like this: .Sp .Vb 1 -\& @@RXVT_NAME@@ \-e sh \-c "shell commands" +\& @@RXVT_NAME@@ -e sh -c "shell commands" .Ve .IP "\fB\-title\fR \fItext\fR" 4 .IX Item "-title text" @@ -465,8 +493,9 @@ .IP "\fB\-tcw\fR" 4 .IX Item "-tcw" Change the meaning of triple-click selection with the left mouse -button. Instead of selecting a full line it will extend the selection the -end of the logical line only. resource \fBtripleclickwords\fR. +button. Only effective when the original (non\-perl) selection code is +in\-use. Instead of selecting a full line it will extend the selection to +the end of the logical line only. resource \fBtripleclickwords\fR. .IP "\fB\-insecure\fR" 4 .IX Item "-insecure" Enable \*(L"insecure\*(R" mode, which currently enables most of the escape @@ -491,6 +520,18 @@ will not immediately destroy its window when the program executed within it exits. Instead, it will wait till it is being killed or closed by the user; resource \fBhold\fR. +.IP "\fB\-xrm\fR \fIstring\fR" 4 +.IX Item "-xrm string" +Works like the X Toolkit option of the same name, by adding the \fIstring\fR +as if it were specified in a resource file. Resource values specified this +way take precedence over all other resource specifications. +.Sp +Note that you need to use the \fIsame\fR syntax as in the .Xdefaults file, +e.g. \f(CW\*(C`*.background: black\*(C'\fR. Also note that all @@RXVT_NAME@@\-specific +options can be specified as long-options on the commandline, so use +of \fB\-xrm\fR is mostly limited to cases where you want to specify other +resources (e.g. for input methods) or for compatibility with other +programs. .IP "\fB\-keysym.\fR\fIsym\fR \fIstring\fR" 4 .IX Item "-keysym.sym string" Remap a key symbol. See resource \fBkeysym\fR. @@ -517,9 +558,9 @@ .Sp .Vb 5 \& my $rxvt = new Gtk2::Socket; -\& $rxvt\->signal_connect_after (realize => sub { -\& my $xid = $_[0]\->window\->get_xid; -\& system "@@RXVT_NAME@@ \-embed $xid &"; +\& $rxvt->signal_connect_after (realize => sub { +\& my $xid = $_[0]->window->get_xid; +\& system "@@RXVT_NAME@@ -embed $xid &"; \& }); .Ve .IP "\fB\-pty\-fd\fR \fIfile descriptor\fR" 4 @@ -534,7 +575,8 @@ yourself if you want that. .Sp As an extremely special case, specifying \f(CW\*(C`\-1\*(C'\fR will completely suppress -pty/tty operations. +pty/tty operations, which is probably only useful in conjunction with some +perl extension that manages the terminal. .Sp Here is a example in perl that illustrates how this option can be used (a longer example is in \fIdoc/pty\-fd\fR): @@ -542,36 +584,42 @@ .Vb 2 \& use IO::Pty; \& use Fcntl; -\& +.Ve +.Sp +.Vb 4 \& my $pty = new IO::Pty; -\& fcntl $pty, F_SETFD, 0; # clear close\-on\-exec -\& system "@@RXVT_NAME@@ \-pty\-fd " . (fileno $pty) . "&"; +\& fcntl $pty, F_SETFD, 0; # clear close-on-exec +\& system "@@RXVT_NAME@@ -pty-fd " . (fileno $pty) . "&"; \& close $pty; -\& +.Ve +.Sp +.Vb 3 \& # now communicate with rxvt -\& my $slave = $pty\->slave; +\& my $slave = $pty->slave; \& while (<$slave>) { print $slave "got <$_>\en" } .Ve .IP "\fB\-pe\fR \fIstring\fR" 4 .IX Item "-pe string" Comma-separated list of perl extension scripts to use (or not to use) in this terminal instance. See resource \fBperl-ext\fR for details. -.SH "RESOURCES (available also as long\-options)" -.IX Header "RESOURCES (available also as long-options)" +.SH "RESOURCES" +.IX Header "RESOURCES" Note: `@@RXVT_NAME@@ \-\-help' gives a list of all resources (long -options) compiled into your version. +options) compiled into your version. All resources are also available as +long\-options. .PP You can set and change the resources using X11 tools like \fBxrdb\fR. Many distribution do also load settings from the \fB~/.Xresources\fR file when X starts. @@RXVT_NAME@@ will consult the following files/resources in order, with later settings overwriting earlier ones: .PP -.Vb 5 -\& 1. system\-wide app\-defaults file, either locale\-dependent OR global -\& 2. app\-defaults file in $XAPPLRESDIR -\& 3. RESOURCE_MANAGER property on root\-window OR $HOME/.Xdefaults +.Vb 6 +\& 1. system-wide app-defaults file, either locale-dependent OR global +\& 2. app-defaults file in $XAPPLRESDIR +\& 3. RESOURCE_MANAGER property on root-window OR $HOME/.Xdefaults \& 4. SCREEN_RESOURCES for the current screen -\& 5. $XENVIRONMENT file OR $HOME/.Xdefaults\- +\& 5. $XENVIRONMENT file OR $HOME/.Xdefaults- +\& 6. resources specified via -xrm on the commandline .Ve .PP Note that when reading X resources, \fB@@RXVT_NAME@@\fR recognizes two class @@ -629,8 +677,8 @@ foreground colour is the default. .IP "\fBcolorRV:\fR \fIcolour\fR" 4 .IX Item "colorRV: colour" -Use the specified colour as the background for reverse video -characters. +Use the specified colour as the background for reverse video characters +when \s-1OPTION_HC\s0 is disabled (\-\-disable\-frills). .IP "\fBunderlineColor:\fR \fIcolour\fR" 4 .IX Item "underlineColor: colour" If set, use the specified colour as the colour for the underline @@ -651,17 +699,33 @@ \&\fB+rv\fR. See note in \fB\s-1COLORS\s0 \s-1AND\s0 \s-1GRAPHICS\s0\fR section. .IP "\fBjumpScroll:\fR \fIboolean\fR" 4 .IX Item "jumpScroll: boolean" -\&\fBTrue\fR: specify that jump scrolling should be used. When scrolling -quickly, fewer screen updates are performed [default]; option \fB\-j\fR. -\&\fBFalse\fR: specify that smooth scrolling should be used; option \fB+j\fR. -.IP "\fBinheritPixmap:\fR \fIboolean\fR" 4 -.IX Item "inheritPixmap: boolean" -\&\fBTrue\fR: make the background inherit the parent windows' pixmap, giving -artificial transparency. \fBFalse\fR: do not inherit the parent windows' -pixmap. +\&\fBTrue\fR: specify that jump scrolling should be used. When receiving lots +of lines, @@RXVT_NAME@@ will only scroll once a whole screen height of lines +has been read, resulting in fewer updates while still displaying every +received line; option \fB\-j\fR. +.Sp +\&\fBFalse\fR: specify that smooth scrolling should be used. @@RXVT_NAME@@ will +force a screen refresh on each new line it received; option \fB+j\fR. +.IP "\fBskipScroll:\fR \fIboolean\fR" 4 +.IX Item "skipScroll: boolean" +\&\fBTrue\fR: (the default) specify that skip scrolling should be used. When +receiving lots of lines, @@RXVT_NAME@@ will only scroll once in a while +(around 60 times per second), resulting in far fewer updates. This can +result in @@RXVT_NAME@@ not ever displaying some of the lines it receives; +option \fB\-ss\fR. +.Sp +\&\fBFalse\fR: specify that everything is to be displayed, even +if the refresh is too fast for the human eye to read anything (or the +monitor to display anything); option \fB+ss\fR. +.IP "\fBtransparent:\fR \fIboolean\fR" 4 +.IX Item "transparent: boolean" +Turn on/off illusion of a transparent window background. .Sp -\&\fIPlease note that transparency of any kind if completely unsupported by -the author. Don't bug him with installation questions!\fR +\&\fBinheritPixmap\fR is still accepted as an obsolete alias but will be removed in +future versions. +.Sp +\&\fIPlease address all transparency related issues to Sasha Vasko at +sasha@aftercode.net. Read the \s-1FAQ\s0 (man 7 @@RXVT_NAME@@)!\fR .IP "\fBfading:\fR \fInumber\fR" 4 .IX Item "fading: number" Fade the text by the given percentage when focus is lost; option \fB\-fade\fR. @@ -675,8 +739,15 @@ \&\fB\-tint\fR. .IP "\fBshading:\fR \fInumber\fR" 4 .IX Item "shading: number" -Darken (0 .. 100) or lighten (\-1 .. \-100) the transparent background -image in addition to tinting it. +Darken (0 .. 100) or lighten (\-1 .. \-100) the transparent background image +in addition to tinting it; option \fB\-sh\fR. +.IP "\fBblendType:\fR \fIstring\fR" 4 +.IX Item "blendType: string" +Specify background blending type; option \fB\-blt\fR. +.IP "\fBblurRadius:\fR \fInumber\fR" 4 +.IX Item "blurRadius: number" +Apply Gaussian Blurr with the specified radius to the transparent +background image; option \fB\-blr\fR. .IP "\fBscrollColor:\fR \fIcolour\fR" 4 .IX Item "scrollColor: colour" Use the specified colour for the scrollbar [default #B2B2B2]. @@ -688,20 +759,36 @@ .IX Item "borderColor: colour" The colour of the border around the text area and between the scrollbar and the text. -.IP "\fBbackgroundPixmap:\fR \fIfile[;geom]\fR" 4 -.IX Item "backgroundPixmap: file[;geom]" -Use the specified \s-1XPM\s0 file (note the `.xpm' extension is optional) for -the background and also optionally specify its scaling with a geometry -string \fBWxH+X+Y\fR, in which \fB\*(L"W\*(R" / \*(L"H\*(R"\fR specify the -horizontal/vertical scale (percent) and \fB\*(L"X\*(R" / \*(L"Y\*(R"\fR locate the image -centre (percent). A scale of 0 displays the image with tiling. A scale -of 1 displays the image without any scaling. A scale of 2 to 9 -specifies an integer number of images in that direction. No image will -be magnified beyond 10 times its original size. The maximum permitted -scale is 1000. [default 0x0+50+50] +.IP "\fBbackgroundPixmap:\fR \fIfile[;geom[:op1][:op2][...]]\fR" 4 +.IX Item "backgroundPixmap: file[;geom[:op1][:op2][...]]" +Use the specified image file for the background and also +optionally specify its scaling with a geometry string \fBWxH+X+Y\fR, +(default \f(CW\*(C`0x0+50+50\*(C'\fR) in which \fB\*(L"W\*(R" / \*(L"H\*(R"\fR specify the +horizontal/vertical scale (percent), and \fB\*(L"X\*(R" / \*(L"Y\*(R"\fR locate the image +centre (percent). A scale of 0 displays the image with tiling. A scale +of 1 displays the image without any scaling. A scale of 2 to 9 specifies +an integer number of images in that direction. No image will be magnified +beyond 10 times its original size. The maximum permitted scale is 1000. +Additional operations can be specified after colon \fB:op1:op2...\fR. +Supported operations are: +.Sp +.Vb 8 +\& tile force background image to be tiled and not scaled. Equivalent to 0x0, +\& propscale will scale image keeping proportions, +\& auto will scale image to match window size. Equivalent to 100x100; +\& hscale will scale image horizontally to the window size; +\& vscale will scale image vertically to the window size; +\& scale will scale image to match window size; +\& root will tile image as if it was a root window background, auto-adjusting +\& whenever terminal window moves. +.Ve +.Sp +If used in conjunction with \fB\-tr\fR option, the specified pixmap will be +blended over transparency image using either alpha\-blending, or any +other blending type, specified with \fB\-blt \*(L"type\*(R"\fR option. .IP "\fBpath:\fR \fIpath\fR" 4 .IX Item "path: path" -Specify the colon-delimited search path for finding \s-1XPM\s0 files. +Specify the colon-delimited search path for finding background image files. .IP "\fBfont:\fR \fIfontlist\fR" 4 .IX Item "font: fontlist" Select the fonts to be used. This is a comma separated list of font names @@ -722,8 +809,8 @@ .Sp .Vb 5 \& URxvt.font: 9x15bold,\e -\& \-misc\-fixed\-bold\-r\-normal\-\-15\-140\-75\-75\-c\-90\-iso10646\-1,\e -\& \-misc\-fixed\-medium\-r\-normal\-\-15\-140\-75\-75\-c\-90\-iso10646\-1, \e +\& -misc-fixed-bold-r-normal--15-140-75-75-c-90-iso10646-1,\e +\& -misc-fixed-medium-r-normal--15-140-75-75-c-90-iso10646-1, \e \& [codeset=JISX0208]xft:Kochi Gothic:antialias=false, \e \& xft:Code2000:antialias=false .Ve @@ -769,15 +856,16 @@ .IP "\fBintensityStyles:\fR \fIboolean\fR" 4 .IX Item "intensityStyles: boolean" When font styles are not enabled, or this option is enabled (\fBTrue\fR, -option \fB\-is\fR, the default), bold and italic font styles imply high +option \fB\-is\fR, the default), bold/blink font styles imply high intensity foreground/background colours. Disabling this option (\fBFalse\fR, option \fB+is\fR) disables this behaviour, the high intensity colours are not reachable. .IP "\fBselectstyle:\fR \fImode\fR" 4 .IX Item "selectstyle: mode" -Set mouse selection style to \fBold\fR which is 2.20, \fBoldword\fR which is -xterm style with 2.20 old word selection, or anything else which gives -xterm style selection. +Set mouse selection style to \fBold\fR which is 2.20, \fBoldword\fR which +is xterm style with 2.20 old word selection, or anything else which +gives xterm style selection. Only effective when the original (non\-perl) +selection code is in use. .IP "\fBscrollstyle:\fR \fImode\fR" 4 .IX Item "scrollstyle: mode" Set scrollbar style to \fBrxvt\fR, \fBplain\fR, \fBnext\fR or \fBxterm\fR. \fBplain\fR is @@ -796,6 +884,10 @@ .IX Item "mapAlert: boolean" \&\fBTrue\fR: de-iconify (map) on receipt of a bell character. \fBFalse\fR: no de-iconify (map) on receipt of a bell character [default]. +.IP "\fBurgentOnBell:\fR \fIboolean\fR" 4 +.IX Item "urgentOnBell: boolean" +\&\fBTrue\fR: set the urgency hint for the wm on receipt of a bell character. +\&\fBFalse\fR: do not set the urgency hint [default]. .IP "\fBvisualBell:\fR \fIboolean\fR" 4 .IX Item "visualBell: boolean" \&\fBTrue\fR: use visual bell on receipt of a bell character; option \fB\-vb\fR. @@ -821,7 +913,7 @@ Example: .Sp .Vb 1 -\& URxvt.print\-pipe: cat > $(TMPDIR=$HOME mktemp urxvt.XXXXXX) +\& URxvt.print-pipe: cat > $(TMPDIR=$HOME mktemp urxvt.XXXXXX) .Ve .Sp This creates a new file in your home directory with the screen contents @@ -884,8 +976,8 @@ .IX Item "termName: termname" Specifies the terminal type name to be set in the \fB\s-1TERM\s0\fR environment variable; option \fB\-tn\fR. -.IP "\fBlinespace:\fR \fInumber\fR" 4 -.IX Item "linespace: number" +.IP "\fBlineSpace:\fR \fInumber\fR" 4 +.IX Item "lineSpace: number" Specifies number of lines (pixel height) to insert between each row of the display [default 0]; option \fB\-lsp\fR. .IP "\fBmeta8:\fR \fIboolean\fR" 4 @@ -935,15 +1027,15 @@ The characters used as delimiters for double-click word selection (whitespace delimiting is added automatically if resource is given). .Sp -When the selection extension is in use (the default if compiled in, see -the @@RXVT_NAME@@\fIperl\fR\|(3) manpage), a suitable regex using these characters -will be created (if the resource exists, otherwise, no regex will be -created). In this mode, characters outside \s-1ISO\-8859\-1\s0 can be used. +When the perl selection extension is in use (the default if compiled +in, see the @@RXVT_NAME@@\fIperl\fR\|(3) manpage), a suitable regex using these +characters will be created (if the resource exists, otherwise, no regex +will be created). In this mode, characters outside \s-1ISO\-8859\-1\s0 can be used. .Sp When the selection extension is not used, only \s-1ISO\-8859\-1\s0 characters can be used. If not specified, the built-in default is used: .Sp -\&\fB\s-1BACKSLASH\s0 `"'&()*,;<=>?@[]{|}\fR +\&\fB\s-1BACKSLASH\s0 `"'&()*,;<=>?@[]^{|}\fR .IP "\fBpreeditType:\fR \fIstyle\fR" 4 .IX Item "preeditType: style" \&\fBOverTheSpot\fR, \fBOffTheSpot\fR, \fBRoot\fR; option \fB\-pt\fR. @@ -997,7 +1089,7 @@ Turn on/off secondary screen (default enabled). .IP "\fBsecondaryScroll:\fR \fIboolean\fR" 4 .IX Item "secondaryScroll: boolean" -Turn on/off secondary screen scroll (default enabled). If the this +Turn on/off secondary screen scroll (default enabled). If this option is enabled, scrolls on the secondary screen will change the scrollback buffer and switching to/from the secondary screen will instead scroll the screen up. @@ -1029,16 +1121,8 @@ keysym value (\fB0x0000 \- 0xFFFF\fR). Note that the lookup of \fIsym\fRs is not performed in an exact manner; however, the closest match is assured. .Sp -\&\fIstring\fR may contain escape values (\f(CW\*(C`\ea\*(C'\fR: bell, \f(CW\*(C`\eb\*(C'\fR: backspace, -\&\f(CW\*(C`\ee\*(C'\fR, \f(CW\*(C`\eE\*(C'\fR: escape, \f(CW\*(C`\en\*(C'\fR: newline, \f(CW\*(C`\er\*(C'\fR: carriage return, \f(CW\*(C`\et\*(C'\fR: tab, -\&\f(CW\*(C`\e000\*(C'\fR: octal number) or verbatim control characters (\f(CW\*(C`^?\*(C'\fR: delete, -\&\f(CW\*(C`^@\*(C'\fR: null, \f(CW\*(C`^A\*(C'\fR ...) and may be enclosed with double quotes so that it -can start or end with whitespace. -.Sp -Please note that you need to double the \f(CW\*(C`\e\*(C'\fR in resource files, as -Xlib itself does its own de-escaping (you can use \f(CW\*(C`\e033\*(C'\fR instead of -\&\f(CW\*(C`\ee\*(C'\fR (and so on), which will work with both Xt and @@RXVT_NAME@@'s own -processing). +\&\fIstring\fR may contain escape values (\f(CW\*(C`\en\*(C'\fR: newline, \f(CW\*(C`\e000\*(C'\fR: octal +number), see \s-1RESOURCES\s0 in \f(CW\*(C`man 7 X\*(C'\fR for futher details. .Sp You can define a range of keysyms in one shot by providing a \fIstring\fR with pattern \fBlist/PREFIX/MIDDLE/SUFFIX\fR, where the delimiter `/' @@ -1047,15 +1131,15 @@ Its usage can be demonstrated by an example: .Sp .Vb 1 -\& URxvt.keysym.M\-C\-0x61: list|\e033 +\& URxvt.keysym.M-C-0x61: list|\e033 .Ve .Sp The above line is equivalent to the following three lines: .Sp .Vb 3 -\& URxvt.keysym.Meta\-Control\-0x61: \e033 -\& URxvt.keysym.Meta\-Control\-0x62: \e033 -\& URxvt.keysym.Meta\-Control\-0x63: \e033 +\& URxvt.keysym.Meta-Control-0x61: \e033 +\& URxvt.keysym.Meta-Control-0x62: \e033 +\& URxvt.keysym.Meta-Control-0x63: \e033 .Ve .Sp If \fIstring\fR takes the form of \f(CW\*(C`command:STRING\*(C'\fR, the specified \fB\s-1STRING\s0\fR @@ -1064,7 +1148,7 @@ when Control-Meta-c is being pressed": .Sp .Vb 1 -\& URxvt.keysym.M\-C\-c: command:\e033]701;zh_CN.GBK\e007 +\& URxvt.keysym.M-C-c: command:\e033]701;zh_CN.GBK\e007 .Ve .Sp If \fIstring\fR takes the form \f(CW\*(C`perl:STRING\*(C'\fR, then the specified \fB\s-1STRING\s0\fR @@ -1073,7 +1157,7 @@ \&\f(CW\*(C`@@RXVT_NAME@@ \-pe selection\*(C'\fR) listens for \f(CW\*(C`selection:rot13\*(C'\fR events: .Sp .Vb 1 -\& URxvt.keysym.M\-C\-c: perl:selection:rot13 +\& URxvt.keysym.M-C-c: perl:selection:rot13 .Ve .Sp Due the the large number of modifier combinations, a defined key mapping @@ -1090,7 +1174,7 @@ .Sp .Vb 2 \& URxvt.keysym.Insert: -\& URxvt.keysym.S\-Insert: builtin: +\& URxvt.keysym.S-Insert: builtin: .Ve .Sp The first line defines a mapping for \f(CW\*(C`Insert\*(C'\fR and \fIany\fR combination @@ -1102,16 +1186,16 @@ font-switching at runtime: .Sp .Vb 2 -\& URxvt.keysym.M\-C\-1: command:\e033]50;suxuseuro\e007 -\& URxvt.keysym.M\-C\-2: command:\e033]50;9x15bold\e007 +\& URxvt.keysym.M-C-1: command:\e033]50;suxuseuro\e007 +\& URxvt.keysym.M-C-2: command:\e033]50;9x15bold\e007 .Ve .Sp Other things are possible, e.g. resizing (see @@RXVT_NAME@@(7) for more info): .Sp .Vb 2 -\& URxvt.keysym.M\-C\-3: command:\e033[8;25;80t -\& URxvt.keysym.M\-C\-4: command:\e033[8;48;110t +\& URxvt.keysym.M-C-3: command:\e033[8;25;80t +\& URxvt.keysym.M-C-4: command:\e033[8;48;110t .Ve .IP "\fBperl-ext-common\fR: \fIstring\fR" 4 .IX Item "perl-ext-common: string" @@ -1170,7 +1254,7 @@ .IP "\fBurlLauncher\fR: \fIstring\fR" 4 .IX Item "urlLauncher: string" Specifies the program to be started with a \s-1URL\s0 argument. Used by the -\&\f(CW\*(C`selection\-popup\*(C'\fR and \f(CW\*(C`mark\-urls\*(C'\fR perl extensions. +\&\f(CW\*(C`selection\-popup\*(C'\fR and \f(CW\*(C`matcher\*(C'\fR perl extensions. .IP "\fBtransient-for\fR: \fIwindowid\fR" 4 .IX Item "transient-for: windowid" Compile \fIfrills\fR: Sets the \s-1WM_TRANSIENT_FOR\s0 property to the given window id. @@ -1178,6 +1262,9 @@ .IX Item "override-redirect: boolean" Compile \fIfrills\fR: Sets override-redirect for the terminal window, making it almost invisible to window managers; option \fB\-override\-redirect\fR. +.IP "\fBiso14755_52:\fR \fIboolean\fR" 4 +.IX Item "iso14755_52: boolean" +Turn on/off \s-1ISO\s0 14755 5.2 mode (default enabled). .SH "THE SCROLLBAR" .IX Header "THE SCROLLBAR" Lines of text that scroll off the top of the \fB@@RXVT_NAME@@\fR window @@ -1201,12 +1288,12 @@ (Next) and \fB\s-1ESC\s0 [ 5 ~\fR (Prior), respectively. Similarly, clicking on the up and down arrows sends \fB\s-1ESC\s0 [ A\fR (Up) and \fB\s-1ESC\s0 [ B\fR (Down), respectively. -.SH "TEXT SELECTION AND INSERTION" -.IX Header "TEXT SELECTION AND INSERTION" -The behaviour of text selection and insertion mechanism is similar to -\&\fIxterm\fR(1). -.IP "\fBSelection\fR:" 4 -.IX Item "Selection:" +.SH "THE SELECTION: SELECTING AND PASTING TEXT" +.IX Header "THE SELECTION: SELECTING AND PASTING TEXT" +The behaviour of text selection and insertion/pasting mechanism is similar +to \fIxterm\fR(1). +.IP "\fBSelecting\fR:" 4 +.IX Item "Selecting:" Left click at the beginning of the region, drag to the end of the region and release; Right click to extend the marked region; Left double-click to select a word; Left triple-click to select the entire logical line @@ -1218,11 +1305,11 @@ normal one. In this mode, every selected row becomes its own line in the selection, and trailing whitespace is visually underlined and removed from the selection. -.IP "\fBInsertion\fR:" 4 -.IX Item "Insertion:" +.IP "\fBPasting\fR:" 4 +.IX Item "Pasting:" Pressing and releasing the Middle mouse button in an \fB@@RXVT_NAME@@\fR window causes the value of the \s-1PRIMARY\s0 selection (or \s-1CLIPBOARD\s0 with the -Meta modifier) to be inserted as if it had been typed on the keyboard. +\&\fBMeta\fR modifier) to be inserted as if it had been typed on the keyboard. .Sp Pressing \fBShift-Insert\fR causes the value of the \s-1PRIMARY\s0 selection to be inserted too. @@ -1240,8 +1327,8 @@ You can use keyboard shortcuts, too: .PP .Vb 2 -\& URxvt.keysym.M\-C\-1: command:\e033]710;suxuseuro\e007\e033]711;suxuseuro\e007 -\& URxvt.keysym.M\-C\-2: command:\e033]710;9x15bold\e007\e033]711;9x15bold\e007 +\& URxvt.keysym.M-C-1: command:\e033]710;suxuseuro\e007\e033]711;suxuseuro\e007 +\& URxvt.keysym.M-C-2: command:\e033]710;9x15bold\e007\e033]711;9x15bold\e007 .Ve .PP rxvt-unicode will automatically re-apply these fonts to the output so far. @@ -1249,12 +1336,11 @@ .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 "\(bu" 4 -5.1: Basic method -.Sp +.IP "* 5.1: Basic method" 4 +.IX Item "5.1: Basic method" This allows you to enter unicode characters using their hexcode. .Sp Start by pressing and holding both \f(CW\*(C`Control\*(C'\fR and \f(CW\*(C`Shift\*(C'\fR, then enter @@ -1269,9 +1355,8 @@ address printed as hexcodes, e.g. \f(CW\*(C`671d 65e5\*(C'\fR. You can enter this easily by pressing \f(CW\*(C`Control\*(C'\fR and \f(CW\*(C`Shift\*(C'\fR, followed by \f(CW\*(C`6\-7\-1\-D\-SPACE\-6\-5\-E\-5\*(C'\fR, followed by releasing the modifier keys. -.IP "\(bu" 4 -5.2: Keyboard symbols entry method -.Sp +.IP "* 5.2: Keyboard symbols entry method" 4 +.IX Item "5.2: Keyboard symbols entry method" This mode lets you input characters representing the keycap symbols of your keyboard, if representable in the current locale encoding. .Sp @@ -1282,14 +1367,12 @@ released, otherwise pressing e.g. \f(CW\*(C`Shift\*(C'\fR would enter the symbol for \&\f(CW\*(C`ISO Level 2 Switch\*(C'\fR, although your intention might have been to enter a reverse tab (Shift\-Tab). -.IP "\(bu" 4 -5.3: Screen-selection entry method -.Sp +.IP "* 5.3: Screen-selection entry method" 4 +.IX Item "5.3: Screen-selection entry method" While this is implemented already (it's basically the selection mechanism), it could be extended by displaying a unicode character map. -.IP "\(bu" 4 -5.4: Feedback method for identifying displayed characters for later input -.Sp +.IP "* 5.4: Feedback method for identifying displayed characters for later input" 4 +.IX Item "5.4: Feedback method for identifying displayed characters for later input" This method lets you display the unicode character code associated with characters already displayed. .Sp @@ -1338,6 +1421,7 @@ foreground = Black background = White .TE + .PP It is also possible to specify the colour values of \fBforeground\fR, \&\fBbackground\fR, \fBcursorColor\fR, \fBcursorColor2\fR, \fBcolorBD\fR, \fBcolorUL\fR as @@ -1368,8 +1452,10 @@ (recommended, but \fB\s-1MUST\s0\fR have 4 digits/component) colour specifications, in addition to the ones provided by X, where the additional A component specifies opacity (alpha) values. The minimum value of \f(CW0\fR is completely -transparent). You can also prefix any color with \f(CW\*(C`[a]\*(C'\fR, where \f(CW\*(C`a\*(C'\fR is on -to four hex digits specifiying the opacity value. +transparent). You can also prefix any color with \f(CW\*(C`[percent]\*(C'\fR, where +\&\f(CW\*(C`percent\*(C'\fR is a decimal percentage (0\-100) that specifies the opacity of +the color, where \f(CW0\fR is completely transparent and \f(CW100\fR is completelxy +opaque. .PP You probably need to specify \fB\*(L"\-depth 32\*(R"\fR, too, and have the luck that your X\-server uses \s-1ARGB\s0 pixel layout, as X is far from just supporting @@ -1379,7 +1465,7 @@ background, and an almost opaque pink foreground: .PP .Vb 1 -\& @@RXVT_NAME@@ \-depth 32 \-bg rgba:0000/0000/0000/2222 \-fg "[e]pink" +\& @@RXVT_NAME@@ -depth 32 -bg rgba:0000/0000/0000/aaaa -fg "[80]pink" .Ve .PP \&\fIPlease note that transparency of any kind if completely unsupported by @@ -1394,8 +1480,9 @@ .IP "\fB\s-1COLORTERM\s0\fR" 4 .IX Item "COLORTERM" Either \f(CW\*(C`rxvt\*(C'\fR, \f(CW\*(C`rxvt\-xpm\*(C'\fR, depending on whether @@RXVT_NAME@@ was -compiled with \s-1XPM\s0 support, and optionally with the added extension -\&\f(CW\*(C`\-mono\*(C'\fR to indicate that rxvt-unicode runs on a monochrome screen. +compiled with background image support, and optionally with the added +extension \f(CW\*(C`\-mono\*(C'\fR to indicate that rxvt-unicode runs on a monochrome +screen. .IP "\fB\s-1COLORFGBG\s0\fR" 4 .IX Item "COLORFGBG" Set to a string of the form \f(CW\*(C`fg;bg\*(C'\fR or \f(CW\*(C`fg;xpm;bg\*(C'\fR, where \f(CW\*(C`fg\*(C'\fR is @@ -1403,8 +1490,8 @@ \&\f(CW\*(C`default\*(C'\fR to indicate that the default-colour escape sequence is to be used), \f(CW\*(C`bg\*(C'\fR is the colour code used as default background colour (or the string \f(CW\*(C`default\*(C'\fR), and \f(CW\*(C`xpm\*(C'\fR is the string \f(CW\*(C`default\*(C'\fR if @@RXVT_NAME@@ -was compiled with \s-1XPM\s0 support. Libraries like \f(CW\*(C`ncurses\*(C'\fR and \f(CW\*(C`slang\*(C'\fR can -(and do) use this information to optimize screen output. +was compiled with background image support. Libraries like \f(CW\*(C`ncurses\*(C'\fR +and \f(CW\*(C`slang\*(C'\fR can (and do) use this information to optimize screen output. .IP "\fB\s-1WINDOWID\s0\fR" 4 .IX Item "WINDOWID" Set to the (decimal) X Window \s-1ID\s0 of the @@RXVT_NAME@@ window (the toplevel @@ -1426,7 +1513,7 @@ The unix domain socket path used by @@RXVT_NAME@@c(1) and @@RXVT_NAME@@d(1). .Sp -Default \fI\f(CI$HOME\fI/.rxvt\-unicode\-\fI