From: sasha Date: Fri, 26 Oct 2007 18:27:29 +0000 (+0000) Subject: updated documentation to change inheritPixmap resource to transparent X-Git-Url: http://git.openbox.org/?a=commitdiff_plain;h=bca542a5c089bbb7bd72ec3e6b8082f4562df422;p=dana%2Furxvt.git updated documentation to change inheritPixmap resource to transparent --- diff --git a/doc/rxvt.1.man.in b/doc/rxvt.1.man.in index 72d1ae0c..5535a8c7 100644 --- a/doc/rxvt.1.man.in +++ b/doc/rxvt.1.man.in @@ -1,4 +1,4 @@ -.\" Automatically generated by Pod::Man v1.37, Pod::Parser v1.32 +.\" Automatically generated by Pod::Man v1.37, Pod::Parser v1.3 .\" .\" Standard preamble: .\" ======================================================================== @@ -129,7 +129,7 @@ .\" ======================================================================== .\" .IX Title "@@RXVT_NAME@@ 1" -.TH @@RXVT_NAME@@ 1 "2007-08-01" "8.3" "RXVT-UNICODE" +.TH @@RXVT_NAME@@ 1 "2007-10-26" "8.3" "RXVT-UNICODE" .SH "NAME" rxvt\-unicode (ouR XVT, unicode) \- (a VT102 emulator for the X window system) .SH "SYNOPSIS" @@ -155,7 +155,7 @@ internally. That means it can store and display most scripts in the 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 @@ -232,14 +232,17 @@ Turn on/off jump scrolling (allow multiple lines per refresh); resource \fBjumpS .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\-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. +.IP "\fB\-tr\fR|\fB+tr\fR" 4 +.IX Item "-tr|+tr" +Turn on/off illusion of a transparent window background. Obsolete form of it is +\&\fB\-ip\fR and it should not be used anymore; 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 +\&\fIPlease note that old resource name of \f(BIinheritPixmap\fI is obsolete and should be +changed to \f(BItransparent\fI. Backwards compatibility support for \f(BIinheritPixmap\fI will +be phased out in future versions of rxvt!\fR +.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 @@ -252,7 +255,7 @@ is opaque black. resource \fBfadeColor\fR. .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. Please note that certain tint colours can be applied on the server\-side, @@ -261,7 +264,7 @@ blue, red, green, cyan, magenta, yellow, and those close to them; 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 \fInumber\fR" 4 .IX Item "-sh number" @@ -276,14 +279,15 @@ 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; resource \fIblendType\fR. +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; resource \fIblurRadius\fR. +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. @@ -322,8 +326,8 @@ with \f(CW\*(C`x:\*(C'\fR. To specify an XFT\-font, you need to prefix it with \ 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 @@ -431,7 +435,7 @@ resource \fBskipBuiltinGlyphs\fR. .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 @@ -452,7 +456,7 @@ Please note that you must specify a program with arguments. If you want to 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" @@ -540,9 +544,9 @@ used (a longer example is in \fIdoc/embed\fR): .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 @@ -569,14 +573,14 @@ longer example is in \fIdoc/pty\-fd\fR): .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 @@ -594,11 +598,11 @@ 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 +\& 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\- .Ve .PP Note that when reading X resources, \fB@@RXVT_NAME@@\fR recognizes two class @@ -755,7 +759,7 @@ other blending type, specified with \fB\-blt \*(L"type\*(R"\fR option. [default 0x0+50+50] .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 @@ -776,8 +780,8 @@ For example, this font resource .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 @@ -880,7 +884,7 @@ The string will be interpreted as if typed into the shell as\-is. 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 @@ -943,8 +947,8 @@ option \fB\-sbg\fR. .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 @@ -1088,17 +1092,8 @@ omitting the prefix \fB\s-1XK_\s0\fR. Alternatively you can specify \fIkey\fR by 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. \fBThis feature is deprecated and will -be removed\fR. -.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 `/' @@ -1107,15 +1102,15 @@ should be a character not used by the strings. 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 @@ -1124,7 +1119,7 @@ example the following means "change the current locale to \f(CW\*(C`zh_CN.GBK\*( 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 @@ -1133,7 +1128,7 @@ manpage. For example, the \fIselection\fR extension (activated via \&\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 @@ -1150,7 +1145,7 @@ user-defined keymap using the \f(CW\*(C`builtin:\*(C'\fR replacement: .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 @@ -1162,16 +1157,16 @@ the fonts \f(CW\*(C`suxuseuro\*(C'\fR and \f(CW\*(C`9x15bold\*(C'\fR, so you can 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" @@ -1303,8 +1298,8 @@ You can, however, switch fonts at runtime using escape sequences, e.g.: 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. @@ -1441,7 +1436,7 @@ For example, the following selects an almost completely transparent red background, and an almost opaque pink foreground: .PP .Vb 1 -\& @@RXVT_NAME@@ -depth 32 -bg rgba:0000/0000/0000/aaaa -fg "[80]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 @@ -1456,8 +1451,9 @@ resources or on the command line. .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 @@ -1465,8 +1461,8 @@ the colour code used as default foreground/text colour (or the string \&\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 diff --git a/doc/rxvt.1.pod b/doc/rxvt.1.pod index c3a0f189..d324efcd 100644 --- a/doc/rxvt.1.pod +++ b/doc/rxvt.1.pod @@ -116,10 +116,14 @@ Turn on/off jump scrolling (allow multiple lines per refresh); resource B. -=item B<-ip>|B<+ip> | B<-tr>|B<+tr> +=item B<-tr>|B<+tr> -Turn on/off inheriting parent window's pixmap. Alternative form is -B<-tr>; resource B. +Turn on/off illusion of a transparent window background. Obsolete form of it is +B<-ip> and it should not be used anymore; resource B. + +I is obsolete and should be +changed to B. Backwards compatibility support for B will +be phased out in future versions of rxvt!> I @@ -138,7 +142,7 @@ is opaque black. resource B. =item B<-tint> I Tint the transparent background pixmap with the given colour when -transparency is enabled with B<-tr> or B<-ip>. This only works for +transparency is enabled with B<-tr>. This only works for non-tiled backgrounds, currently. See also the B<-sh> option that can 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, @@ -162,7 +166,7 @@ transparency image, using method specified. Supported values are : B, B, B - color values averaging, B, B, B, B, B, B, B, B, B, B, B, B. The default is -alpha-blending; resource I. +alpha-blending. Compile I; resource I. =item B<-blr> I @@ -170,7 +174,8 @@ 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. +on some backgrounds. Maximum radius value is 128. Compile I; +resource I. =item B<-bg> I diff --git a/doc/rxvt.7.man.in b/doc/rxvt.7.man.in index 149e3608..26464840 100644 --- a/doc/rxvt.7.man.in +++ b/doc/rxvt.7.man.in @@ -1,4 +1,4 @@ -.\" Automatically generated by Pod::Man v1.37, Pod::Parser v1.32 +.\" Automatically generated by Pod::Man v1.37, Pod::Parser v1.3 .\" .\" Standard preamble: .\" ======================================================================== @@ -129,7 +129,7 @@ .\" ======================================================================== .\" .IX Title "@@RXVT_NAME@@ 7" -.TH @@RXVT_NAME@@ 7 "2007-08-01" "8.3" "RXVT-UNICODE" +.TH @@RXVT_NAME@@ 7 "2007-10-26" "8.3" "RXVT-UNICODE" .SH "NAME" RXVT REFERENCE \- FAQ, command sequences and other background information .SH "SYNOPSIS" @@ -140,8 +140,8 @@ RXVT REFERENCE \- FAQ, command sequences and other background information .Ve .PP .Vb 2 -\& # change the locale and tell rxvt-unicode about it -\& export LC_CTYPE=ja_JP.EUC-JP; printf "\e33]701;$LC_CTYPE\e007" +\& # change the locale and tell rxvt\-unicode about it +\& export LC_CTYPE=ja_JP.EUC\-JP; printf "\e33]701;$LC_CTYPE\e007" .Ve .PP .Vb 2 @@ -174,11 +174,11 @@ simple tabbed terminal. It is installed by default, so any of these should give you tabs: .PP .Vb 1 -\& @@URXVT_NAME@@ -pe tabbed +\& @@URXVT_NAME@@ \-pe tabbed .Ve .PP .Vb 1 -\& URxvt.perl-ext-common: default,tabbed +\& URxvt.perl\-ext\-common: default,tabbed .Ve .PP It will also work fine with tabbing functionality of many window managers @@ -226,8 +226,8 @@ If you want to start @@URXVT_NAME@@d automatically whenever you run .Vb 6 \& #!/bin/sh \& @@URXVT_NAME@@c "$@" -\& if [ $? -eq 2 ]; then -\& @@URXVT_NAME@@d -q -o -f +\& if [ $? \-eq 2 ]; then +\& @@URXVT_NAME@@d \-q \-o \-f \& @@URXVT_NAME@@c "$@" \& fi .Ve @@ -260,14 +260,14 @@ snippets: .PP .Vb 12 \& # Bourne/Korn/POSIX family of shells: -\& [ ${TERM:-foo} = foo ] && TERM=xterm # assume an xterm if we don't know -\& if [ ${TERM:-foo} = xterm ]; then -\& stty -icanon -echo min 0 time 15 # see if enhanced rxvt or not -\& echo -n '^[Z' +\& [ ${TERM:\-foo} = foo ] && TERM=xterm # assume an xterm if we don't know +\& if [ ${TERM:\-foo} = xterm ]; then +\& stty \-icanon \-echo min 0 time 15 # see if enhanced rxvt or not +\& echo \-n '^[Z' \& read term_id \& stty icanon echo -\& if [ ""${term_id} = '^[[?1;2C' -a ${DISPLAY:-foo} = foo ]; then -\& echo -n '^[[7n' # query the rxvt we are in for the DISPLAY string +\& if [ ""${term_id} = '^[[?1;2C' \-a ${DISPLAY:\-foo} = foo ]; then +\& echo \-n '^[[7n' # query the rxvt we are in for the DISPLAY string \& read DISPLAY # set it in our local shell \& fi \& fi @@ -293,8 +293,8 @@ already in use in this mode. .PP .Vb 3 \& text data bss drs rss filename -\& 98398 1664 24 15695 1824 rxvt --disable-everything -\& 188985 9048 66616 18222 1788 urxvt --disable-everything +\& 98398 1664 24 15695 1824 rxvt \-\-disable\-everything +\& 188985 9048 66616 18222 1788 urxvt \-\-disable\-everything .Ve .PP When you \f(CW\*(C`\-\-enable\-everything\*(C'\fR (which \fIis\fR unfair, as this involves xft @@ -303,8 +303,8 @@ libc), the two diverge, but not unreasonably so. .PP .Vb 3 \& text data bss drs rss filename -\& 163431 2152 24 20123 2060 rxvt --enable-everything -\& 1035683 49680 66648 29096 3680 urxvt --enable-everything +\& 163431 2152 24 20123 2060 rxvt \-\-enable\-everything +\& 1035683 49680 66648 29096 3680 urxvt \-\-enable\-everything .Ve .PP The very large size of the text section is explained by the east-asian @@ -350,7 +350,7 @@ system with a minimal config: \& libX11.so.6 => /usr/X11R6/lib/libX11.so.6 (0x00002aaaaabc3000) \& libc.so.6 => /lib/libc.so.6 (0x00002aaaaadde000) \& libdl.so.2 => /lib/libdl.so.2 (0x00002aaaab01d000) -\& /lib64/ld-linux-x86-64.so.2 (0x00002aaaaaaab000) +\& /lib64/ld\-linux\-x86\-64.so.2 (0x00002aaaaaaab000) .Ve .PP And here is rxvt\-unicode: @@ -360,7 +360,7 @@ And here is rxvt\-unicode: \& libgcc_s.so.1 => /lib/libgcc_s.so.1 (0x00002aaaaada2000) \& libc.so.6 => /lib/libc.so.6 (0x00002aaaaaeb0000) \& libdl.so.2 => /lib/libdl.so.2 (0x00002aaaab0ee000) -\& /lib64/ld-linux-x86-64.so.2 (0x00002aaaaaaab000) +\& /lib64/ld\-linux\-x86\-64.so.2 (0x00002aaaaaaab000) .Ve .PP No large bloated libraries (of course, none were linked in statically), @@ -370,10 +370,9 @@ except maybe libX11 :) \fII can't get transparency working, what am I doing wrong?\fR .IX Subsection "I can't get transparency working, what am I doing wrong?" .PP -First of all, transparency isn't officially supported in rxvt\-unicode, so -you are mostly on your own. Do not bug the author about it (but you may -bug everybody else). Also, if you can't get it working consider it a rite -of passage: ... and you failed. +First of all, please address all transparency related issues to Sasha Vasko at +sasha@aftercode.net and do not bug the author about it. Also, if you can't +get it working consider it a rite of passage: ... and you failed. .PP Here are four ways to get transparency. \fBDo\fR read the manpage and option descriptions for the programs mentioned and rxvt\-unicode. Really, do it! @@ -382,7 +381,7 @@ descriptions for the programs mentioned and rxvt\-unicode. Really, do it! .PP .Vb 2 \& Esetroot wallpaper.jpg -\& @@URXVT_NAME@@ -ip -tint red -sh 40 +\& @@URXVT_NAME@@ \-ip \-tint red \-sh 40 .Ve .PP That works. If you think it doesn't, you lack transparency and tinting @@ -393,17 +392,17 @@ to use effects other than tinting and shading: Just shade/tint/whatever your picture with gimp or any other tool: .PP .Vb 2 -\& convert wallpaper.jpg -blur 20x20 -modulate 30 background.xpm -\& @@URXVT_NAME@@ -pixmap background.xpm -pe automove-background +\& convert wallpaper.jpg \-blur 20x20 \-modulate 30 background.jpg +\& @@URXVT_NAME@@ \-pixmap background.jpg \-pe automove\-background .Ve .PP -That works. If you think it doesn't, you lack \s-1XPM\s0 and Perl support, or you +That works. If you think it doesn't, you lack AfterImage and Perl support, or you are unable to read. .PP 3. Use an \s-1ARGB\s0 visual: .PP .Vb 1 -\& @@URXVT_NAME@@ -depth 32 -fg grey90 -bg rgba:0000/0000/4444/cccc +\& @@URXVT_NAME@@ \-depth 32 \-fg grey90 \-bg rgba:0000/0000/4444/cccc .Ve .PP This requires \s-1XFT\s0 support, and the support of your X\-server. If that @@ -415,8 +414,8 @@ doesn't mean that your \s-1WM\s0 has the required kludges in place. 4. Use xcompmgr and let it do the job: .PP .Vb 2 -\& xprop -frame -f _NET_WM_WINDOW_OPACITY 32c \e -\& -set _NET_WM_WINDOW_OPACITY 0xc0000000 +\& xprop \-frame \-f _NET_WM_WINDOW_OPACITY 32c \e +\& \-set _NET_WM_WINDOW_OPACITY 0xc0000000 .Ve .PP Then click on a window you want to make transparent. Replace \f(CW0xc0000000\fR @@ -617,7 +616,7 @@ In that case, select a font of your taste and add it to the font list, e.g.: .PP .Vb 1 -\& @@URXVT_NAME@@ -fn basefont,font2,font3... +\& @@URXVT_NAME@@ \-fn basefont,font2,font3... .Ve .PP When rxvt-unicode sees a character, it will first look at the base @@ -653,6 +652,15 @@ fonts for the same character at the same time, but no interface for this has been designed yet). .PP Until then, you might get away with switching fonts at runtime (see \*(L"Can I switch the fonts at runtime?\*(R" later in this document). +.PP +\fIHow can I make mplayer display video correctly?\fR +.IX Subsection "How can I make mplayer display video correctly?" +.PP +We are working on it, in the meantime, as a workaround, use something like: +.PP +.Vb 1 +\& @@URXVT_NAME@@ \-b 600 \-geometry 20x1 \-e sh \-c 'mplayer \-wid $WINDOWID file...' +.Ve .Sh "Keyboard, Mouse & User Interaction" .IX Subsection "Keyboard, Mouse & User Interaction" \fIThe new selection selects pieces that are too big, how can I select single words?\fR @@ -662,7 +670,7 @@ If you want to select e.g. alphanumeric words, you can use the following setting: .PP .Vb 1 -\& URxvt.selection.pattern-0: ([[:word:]]+) +\& URxvt.selection.pattern\-0: ([[:word:]]+) .Ve .PP If you click more than twice, the selection will be extended @@ -671,7 +679,7 @@ more and more. To get a selection that is very similar to the old code, try this pattern: .PP .Vb 1 -\& URxvt.selection.pattern-0: ([^"&'()*,;<=>?@[\e\e\e\e]^`{|})]+) +\& URxvt.selection.pattern\-0: ([^"&'()*,;<=>?@[\e\e\e\e]^`{|})]+) .Ve .PP Please also note that the \fILeftClick Shift-LeftClik\fR combination also @@ -691,7 +699,7 @@ example, to disable the \fBselection-popup\fR and \fBoption-popup\fR, specify this \fBperl-ext-common\fR resource: .PP .Vb 1 -\& URxvt.perl-ext-common: default,-selection-popup,-option-popup +\& URxvt.perl\-ext\-common: default,\-selection\-popup,\-option\-popup .Ve .PP This will keep the default extensions, but disable the two popup @@ -700,7 +708,7 @@ scrollback search mode is triggered by \fBM\-s\fR. You can move it to any other combination either by setting the \fBsearchable-scrollback\fR resource: .PP .Vb 1 -\& URxvt.searchable-scrollback: CM-s +\& URxvt.searchable\-scrollback: CM\-s .Ve .PP \fIThe cursor moves when selecting text in the current input line, how do I switch this off?\fR @@ -721,7 +729,7 @@ You can permanently switch this feature off by disabling the \f(CW\*(C`readline\ extension: .PP .Vb 1 -\& URxvt.perl-ext-common: default,-readline +\& URxvt.perl\-ext\-common: default,\-readline .Ve .PP \fIMy numerical keypad acts weird and generates differing output?\fR @@ -804,13 +812,13 @@ For an existing rxvt\-unicode: .Vb 3 \& # use Backspace = ^H \& $ stty erase ^H -\& $ echo -n "^[[36h" +\& $ echo \-n "^[[36h" .Ve .PP .Vb 3 \& # use Backspace = ^? \& $ stty erase ^? -\& $ echo -n "^[[36l" +\& $ echo \-n "^[[36l" .Ve .PP This helps satisfy some of the Backspace discrepancies that occur, but @@ -842,23 +850,23 @@ Here's an example for a URxvt session started using \f(CW\*(C`@@URXVT_NAME@@ \-n .Vb 20 \& URxvt.keysym.Home: \e033[1~ \& URxvt.keysym.End: \e033[4~ -\& URxvt.keysym.C-apostrophe: \e033 -\& URxvt.keysym.C-slash: \e033 -\& URxvt.keysym.C-semicolon: \e033 -\& URxvt.keysym.C-grave: \e033 -\& URxvt.keysym.C-comma: \e033 -\& URxvt.keysym.C-period: \e033 -\& URxvt.keysym.C-0x60: \e033 -\& URxvt.keysym.C-Tab: \e033 -\& URxvt.keysym.C-Return: \e033 -\& URxvt.keysym.S-Return: \e033 -\& URxvt.keysym.S-space: \e033 -\& URxvt.keysym.M-Up: \e033 -\& URxvt.keysym.M-Down: \e033 -\& URxvt.keysym.M-Left: \e033 -\& URxvt.keysym.M-Right: \e033 -\& URxvt.keysym.M-C-0: list \e033 -\& URxvt.keysym.M-C-a: list \e033 +\& URxvt.keysym.C\-apostrophe: \e033 +\& URxvt.keysym.C\-slash: \e033 +\& URxvt.keysym.C\-semicolon: \e033 +\& URxvt.keysym.C\-grave: \e033 +\& URxvt.keysym.C\-comma: \e033 +\& URxvt.keysym.C\-period: \e033 +\& URxvt.keysym.C\-0x60: \e033 +\& URxvt.keysym.C\-Tab: \e033 +\& URxvt.keysym.C\-Return: \e033 +\& URxvt.keysym.S\-Return: \e033 +\& URxvt.keysym.S\-space: \e033 +\& URxvt.keysym.M\-Up: \e033 +\& URxvt.keysym.M\-Down: \e033 +\& URxvt.keysym.M\-Left: \e033 +\& URxvt.keysym.M\-Right: \e033 +\& URxvt.keysym.M\-C\-0: list \e033 +\& URxvt.keysym.M\-C\-a: list \e033 \& URxvt.keysym.F12: command:\e033]701;zh_CN.GBK\e007 .Ve .PP @@ -894,13 +902,13 @@ not \fItypical\fR, but what's typical... .PP .Vb 2 \& URxvt.cutchars: "()*,<>[]{}|' -\& URxvt.print-pipe: cat >/tmp/xxx +\& URxvt.print\-pipe: cat >/tmp/xxx .Ve .PP These are just for testing stuff. .PP .Vb 2 -\& URxvt.imLocale: ja_JP.UTF-8 +\& URxvt.imLocale: ja_JP.UTF\-8 \& URxvt.preeditType: OnTheSpot,None .Ve .PP @@ -910,12 +918,12 @@ type, which requires the \f(CW\*(C`xim\-onthespot\*(C'\fR perl extension but rew with correct-looking fonts. .PP .Vb 6 -\& URxvt.perl-lib: /root/lib/urxvt -\& URxvt.perl-ext-common: default,selection-autotransform,selection-pastebin,xim-onthespot,remote-clipboard -\& URxvt.selection.pattern-0: ( at .*? line \e\ed+) -\& URxvt.selection.pattern-1: ^(/[^:]+):\e -\& URxvt.selection-autotransform.0: s/^([^:[:space:]]+):(\e\ed+):?$/:e \e\eQ$1\e\eE\e\ex0d:$2\e\ex0d/ -\& URxvt.selection-autotransform.1: s/^ at (.*?) line (\e\ed+)$/:e \e\eQ$1\e\eE\e\ex0d:$2\e\ex0d/ +\& URxvt.perl\-lib: /root/lib/urxvt +\& URxvt.perl\-ext\-common: default,selection\-autotransform,selection\-pastebin,xim\-onthespot,remote\-clipboard +\& URxvt.selection.pattern\-0: ( at .*? line \e\ed+) +\& URxvt.selection.pattern\-1: ^(/[^:]+):\e +\& URxvt.selection\-autotransform.0: s/^([^:[:space:]]+):(\e\ed+):?$/:e \e\eQ$1\e\eE\e\ex0d:$2\e\ex0d/ +\& URxvt.selection\-autotransform.1: s/^ at (.*?) line (\e\ed+)$/:e \e\eQ$1\e\eE\e\ex0d:$2\e\ex0d/ .Ve .PP This is my perl configuration. The first two set the perl library @@ -1002,12 +1010,12 @@ I once thought this is a great idea. .PP .Vb 9 \& 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, \e \& xft:Bitstream Vera Sans Mono:autohint=true, \e \& xft:Code2000:antialias=false -\& urxvt.boldFont: -xos4-terminus-bold-r-normal--14-140-72-72-c-80-iso8859-15 +\& urxvt.boldFont: \-xos4\-terminus\-bold\-r\-normal\-\-14\-140\-72\-72\-c\-80\-iso8859\-15 \& urxvt.italicFont: xft:Bitstream Vera Sans Mono:italic:autohint=true \& urxvt.boldItalicFont: xft:Bitstream Vera Sans Mono:bold:italic:autohint=true .Ve @@ -1039,8 +1047,8 @@ defaults: \& IRC*font: suxuseuro \& IRC*boldFont: suxuseuro \& IRC*colorBD: white -\& IRC*keysym.M-C-1: command:\e033]710;suxuseuro\e007\e033]711;suxuseuro\e007 -\& IRC*keysym.M-C-2: command:\e033]710;9x15bold\e007\e033]711;9x15bold\e007 +\& IRC*keysym.M\-C\-1: command:\e033]710;suxuseuro\e007\e033]711;suxuseuro\e007 +\& IRC*keysym.M\-C\-2: command:\e033]710;9x15bold\e007\e033]711;9x15bold\e007 .Ve .PP \&\f(CW\*(C`Alt\-Shift\-1\*(C'\fR and \f(CW\*(C`Alt\-Shift\-2\*(C'\fR switch between two different font @@ -1053,11 +1061,11 @@ The above is all in my \f(CW\*(C`.Xdefaults\*(C'\fR (I don't use \f(CW\*(C`.Xres file for different hosts, for example, on ym main desktop, I use: .PP .Vb 5 -\& URxvt.keysym.C-M-q: command:\e033[3;5;5t -\& URxvt.keysym.C-M-y: command:\e033[3;5;606t -\& URxvt.keysym.C-M-e: command:\e033[3;1605;5t -\& URxvt.keysym.C-M-c: command:\e033[3;1605;606t -\& URxvt.keysym.C-M-p: perl:test +\& URxvt.keysym.C\-M\-q: command:\e033[3;5;5t +\& URxvt.keysym.C\-M\-y: command:\e033[3;5;606t +\& URxvt.keysym.C\-M\-e: command:\e033[3;1605;5t +\& URxvt.keysym.C\-M\-c: command:\e033[3;1605;606t +\& URxvt.keysym.C\-M\-p: perl:test .Ve .PP The first for keysym definitions allow me to quickly bring some windows @@ -1100,7 +1108,7 @@ be done like this (with ncurses' infocmp and works as user and admin): .PP .Vb 2 \& REMOTE=remotesystem.domain -\& infocmp rxvt-unicode | ssh $REMOTE "mkdir -p .terminfo && cat >/tmp/ti && tic /tmp/ti" +\& infocmp rxvt\-unicode | ssh $REMOTE "mkdir \-p .terminfo && cat >/tmp/ti && tic /tmp/ti" .Ve .PP \&... or by installing rxvt-unicode normally on the remote system, @@ -1149,13 +1157,13 @@ You can also create a termcap entry by using terminfo's infocmp program like this: .PP .Vb 1 -\& infocmp -C rxvt-unicode +\& infocmp \-C rxvt\-unicode .Ve .PP Or you could use this termcap entry, generated by the command above: .PP .Vb 20 -\& rxvt-unicode|rxvt-unicode terminal (X Window System):\e +\& rxvt\-unicode|rxvt\-unicode terminal (X Window System):\e \& :am:bw:eo:km:mi:ms:xn:xo:\e \& :co#80:it#8:li#24:lm#0:\e \& :AL=\eE[%dL:DC=\eE[%dP:DL=\eE[%dM:DO=\eE[%dB:IC=\eE[%d@:\e @@ -1186,13 +1194,13 @@ file. Needless to say, \f(CW\*(C`rxvt\-unicode\*(C'\fR is not in its default fil with most other terminals supporting colour). Either add: .PP .Vb 1 -\& TERM rxvt-unicode +\& TERM rxvt\-unicode .Ve .PP to \f(CW\*(C`/etc/DIR_COLORS\*(C'\fR or simply add: .PP .Vb 1 -\& alias ls='ls --color=auto' +\& alias ls='ls \-\-color=auto' .Ve .PP to your \f(CW\*(C`.profile\*(C'\fR or \f(CW\*(C`.bashrc\*(C'\fR. @@ -1321,8 +1329,8 @@ first switches to a locale supported by xjdic and back later: .PP .Vb 3 \& printf '\e33]701;%s\e007' ja_JP.SJIS -\& xjdic -js -\& printf '\e33]701;%s\e007' de_DE.UTF-8 +\& xjdic \-js +\& printf '\e33]701;%s\e007' de_DE.UTF\-8 .Ve .PP You can also use xterm's \f(CW\*(C`luit\*(C'\fR program, which usually works fine, except @@ -1354,7 +1362,7 @@ When you want to use e.g. \fBkinput2\fR, it must be set to method servers are running with this command: .Sp .Vb 1 -\& xprop -root XIM_SERVERS +\& xprop \-root XIM_SERVERS .Ve .IP "*" 4 .PP @@ -1365,7 +1373,7 @@ You can specify separate locales for the input method and the rest of the terminal, using the resource \f(CW\*(C`imlocale\*(C'\fR: .PP .Vb 1 -\& URxvt.imlocale: ja_JP.EUC-JP +\& URxvt.imlocale: ja_JP.EUC\-JP .Ve .PP Now you can start your terminal with \f(CW\*(C`LC_CTYPE=ja_JP.UTF\-8\*(C'\fR and still @@ -2176,6 +2184,24 @@ h Use Hilite Mouse Tracking. l No mouse reporting. .TE +.ie n .IP "\fB\fB""Pm = 1002""\fB\fR (X11 XTerm)" 4 +.el .IP "\fB\f(CBPm = 1002\fB\fR (X11 XTerm)" 4 +.IX Item "Pm = 1002 (X11 XTerm)" +.TS +l l . +h Send Mouse X & Y on button press and release, and motion with a button pressed. +l No mouse reporting. +.TE + +.ie n .IP "\fB\fB""Pm = 1003""\fB\fR (X11 XTerm)" 4 +.el .IP "\fB\f(CBPm = 1003\fB\fR (X11 XTerm)" 4 +.IX Item "Pm = 1003 (X11 XTerm)" +.TS +l l . +h Send Mouse X & Y on button press and release, and motion. +l No mouse reporting. +.TE + .ie n .IP "\fB\fB""Pm = 1010""\fB\fR (\fBrxvt\fR)" 4 .el .IP "\fB\f(CBPm = 1010\fB\fR (\fBrxvt\fR)" 4 .IX Item "Pm = 1010 (rxvt)" @@ -2259,7 +2285,7 @@ Ps = 13 Change colour of mouse foreground to Pt Ps = 17 Change colour of highlight characters to Pt Ps = 18 Change colour of bold characters to Pt [deprecated, see 706] Ps = 19 Change colour of underlined characters to Pt [deprecated, see 707] -Ps = 20 Change background pixmap parameters (see section XPM) (Compile XPM). +Ps = 20 Change background pixmap parameters (see section BACKGROUND IMAGE) (Compile AfterImage). Ps = 39 Change default foreground colour to Pt. Ps = 46 Change Log File to Pt unimplemented Ps = 49 Change default background colour to Pt. @@ -2280,10 +2306,10 @@ Ps = 721 Move viewing window down by Pt lines, or clear scrollback buffer if Pt Ps = 777 Call the perl extension with the given string, which should be of the form extension:parameters (Compile perl). .TE -.SH "XPM" -.IX Header "XPM" -For the \s-1XPM\s0 XTerm escape sequence \fB\f(CB\*(C`ESC ] 20 ; Pt ST\*(C'\fB\fR then value -of \fB\f(CB\*(C`Pt\*(C'\fB\fR can be the name of the background pixmap followed by a +.SH "BACKGROUND IMAGE" +.IX Header "BACKGROUND IMAGE" +For the \s-1BACGROUND\s0 \s-1IMAGE\s0 XTerm escape sequence \fB\f(CB\*(C`ESC ] 20 ; Pt ST\*(C'\fB\fR then value +of \fB\f(CB\*(C`Pt\*(C'\fB\fR can be the name of the background image file followed by a sequence of scaling/positioning commands separated by semi\-colons. The scaling/positioning commands are as follows: .IP "query scale/position" 4 @@ -2319,12 +2345,12 @@ scaling/positioning commands are as follows: \&\fB0xH\fR \-> \fBH *= (H/100)\fR .PP For example: -.IP "\fB\eE]20;funky\ea\fR" 4 -.IX Item "E]20;funkya" -load \fBfunky.xpm\fR as a tiled image -.IP "\fB\eE]20;mona;100\ea\fR" 4 -.IX Item "E]20;mona;100a" -load \fBmona.xpm\fR with a scaling of 100% +.IP "\fB\eE]20;funky.jpg\ea\fR" 4 +.IX Item "E]20;funky.jpga" +load \fBfunky.jpg\fR as a tiled image +.IP "\fB\eE]20;mona.jpg;100\ea\fR" 4 +.IX Item "E]20;mona.jpg;100a" +load \fBmona.jpg\fR with a scaling of 100% .IP "\fB\eE]20;;200;?\ea\fR" 4 .IX Item "E]20;;200;?a" rescale the current pixmap to 200% and display the image geometry in @@ -2440,9 +2466,9 @@ XK_KP_9 9 ESC O y .IX Header "CONFIGURE OPTIONS" General hint: if you get compile errors, then likely your configuration hasn't been tested well. Either try with \f(CW\*(C`\-\-enable\-everything\*(C'\fR or use -the default configuration (i.e. \f(CW\*(C`\-\-enable\-xxx\*(C'\fR or \f(CW\*(C`\-\-disable\-xxx\*(C'\fR). Of -course, you should always report when a combination doesn't work, so it -can be fixed. Marc Lehmann . +the default configuration (i.e. no \f(CW\*(C`\-\-enable\-xxx\*(C'\fR or \f(CW\*(C`\-\-disable\-xxx\*(C'\fR +switches). Of course, you should always report when a combination doesn't +work, so it can be fixed. Marc Lehmann . .PP All .IP "\-\-enable\-everything" 4 @@ -2547,9 +2573,6 @@ option requires \-\-enable\-utmp to also be specified. Write user and tty to lastlog file (used by programs like \&\fIlastlogin\fR) at start of rxvt execution. This option requires \&\-\-enable\-utmp to also be specified. -.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 @@ -2571,9 +2594,6 @@ 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. -.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). .IP "\-\-enable\-rxvt\-scroll (default: on)" 4 .IX Item "--enable-rxvt-scroll (default: on)" Add support for the original rxvt scrollbar. @@ -2615,29 +2635,29 @@ A non-exhaustive list of features enabled by \f(CW\*(C`\-\-enable\-frills\*(C'\f in combination with other switches) is: .Sp .Vb 17 -\& MWM-hints -\& EWMH-hints (pid, utf8 names) and protocols (ping) +\& MWM\-hints +\& EWMH\-hints (pid, utf8 names) and protocols (ping) \& urgency hint -\& seperate underline colour (-underlineColor) -\& settable border widths and borderless switch (-w, -b, -bl) -\& visual depth selection (-depth) -\& settable extra linespacing /-lsp) -\& iso-14755 5.1 (basic) support -\& tripleclickwords (-tcw) -\& settable insecure mode (-insecure) +\& seperate underline colour (\-underlineColor) +\& settable border widths and borderless switch (\-w, \-b, \-bl) +\& visual depth selection (\-depth) +\& settable extra linespacing /\-lsp) +\& iso\-14755 5.1 (basic) support +\& tripleclickwords (\-tcw) +\& settable insecure mode (\-insecure) \& keysym remapping support -\& cursor blinking and underline cursor (-cb, -uc) -\& XEmbed support (-embed) -\& user-pty (-pty-fd) -\& hold on exit (-hold) -\& skip builtin block graphics (-sbg) -\& separate highlightcolor support (-hc) +\& cursor blinking and underline cursor (\-cb, \-uc) +\& XEmbed support (\-embed) +\& user\-pty (\-pty\-fd) +\& hold on exit (\-hold) +\& skip builtin block graphics (\-sbg) +\& separate highlightcolor support (\-hc) .Ve .Sp It also enables some non-essential features otherwise disabled, such as: .Sp .Vb 11 -\& some round-trip time optimisations +\& some round\-trip time optimisations \& nearest color allocation on pseudocolor screens \& UTF8_STRING support for selection \& sgr modes 90..97 and 100..107 @@ -2707,15 +2727,6 @@ Change the environmental variable for the path to the terminfo tree to .IP "\-\-with\-x" 4 .IX Item "--with-x" Use the X Window System (pretty much default, eh?). -.IP "\-\-with\-xpm\-includes=DIR" 4 -.IX Item "--with-xpm-includes=DIR" -Look for the \s-1XPM\s0 includes in \s-1DIR\s0. -.IP "\-\-with\-xpm\-library=DIR" 4 -.IX Item "--with-xpm-library=DIR" -Look for the \s-1XPM\s0 library in \s-1DIR\s0. -.IP "\-\-with\-xpm" 4 -.IX Item "--with-xpm" -Not needed \- define via \-\-enable\-xpm\-background. .SH "AUTHORS" .IX Header "AUTHORS" Marc Lehmann converted this document to pod and