-.\" Automatically generated by Pod::Man v1.37, Pod::Parser v1.32
+.\" Automatically generated by Pod::Man v1.37, Pod::Parser v1.3
.\"
.\" Standard preamble:
.\" ========================================================================
.\" ========================================================================
.\"
.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"
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
.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
.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,
\&\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"
\&\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.
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
.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
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"
.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
.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
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-<nodename>
+\& 5. $XENVIRONMENT file OR $HOME/.Xdefaults\-<nodename>
.Ve
.PP
Note that when reading X resources, \fB@@RXVT_NAME@@\fR recognizes two class
[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
.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
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
.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
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 `/'
Its usage can be demonstrated by an example:
.Sp
.Vb 1
-\& URxvt.keysym.M-C-0x61: list|\e033<M-C-|abc|>
+\& URxvt.keysym.M\-C\-0x61: list|\e033<M\-C\-|abc|>
.Ve
.Sp
The above line is equivalent to the following three lines:
.Sp
.Vb 3
-\& URxvt.keysym.Meta-Control-0x61: \e033<M-C-a>
-\& URxvt.keysym.Meta-Control-0x62: \e033<M-C-b>
-\& URxvt.keysym.Meta-Control-0x63: \e033<M-C-c>
+\& URxvt.keysym.Meta\-Control\-0x61: \e033<M\-C\-a>
+\& URxvt.keysym.Meta\-Control\-0x62: \e033<M\-C\-b>
+\& URxvt.keysym.Meta\-Control\-0x63: \e033<M\-C\-c>
.Ve
.Sp
If \fIstring\fR takes the form of \f(CW\*(C`command:STRING\*(C'\fR, the specified \fB\s-1STRING\s0\fR
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
\&\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
.Sp
.Vb 2
\& URxvt.keysym.Insert: <my insert key sequence>
-\& 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
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"
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.
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
.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
\&\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
-.\" Automatically generated by Pod::Man v1.37, Pod::Parser v1.32
+.\" Automatically generated by Pod::Man v1.37, Pod::Parser v1.3
.\"
.\" Standard preamble:
.\" ========================================================================
.\" ========================================================================
.\"
.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"
.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
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
.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
.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
.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
.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
\& 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:
\& 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),
\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!
.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
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
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
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
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
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
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
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
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
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
.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
.Vb 20
\& URxvt.keysym.Home: \e033[1~
\& URxvt.keysym.End: \e033[4~
-\& URxvt.keysym.C-apostrophe: \e033<C-'>
-\& URxvt.keysym.C-slash: \e033<C-/>
-\& URxvt.keysym.C-semicolon: \e033<C-;>
-\& URxvt.keysym.C-grave: \e033<C-`>
-\& URxvt.keysym.C-comma: \e033<C-,>
-\& URxvt.keysym.C-period: \e033<C-.>
-\& URxvt.keysym.C-0x60: \e033<C-`>
-\& URxvt.keysym.C-Tab: \e033<C-Tab>
-\& URxvt.keysym.C-Return: \e033<C-Return>
-\& URxvt.keysym.S-Return: \e033<S-Return>
-\& URxvt.keysym.S-space: \e033<S-Space>
-\& URxvt.keysym.M-Up: \e033<M-Up>
-\& URxvt.keysym.M-Down: \e033<M-Down>
-\& URxvt.keysym.M-Left: \e033<M-Left>
-\& URxvt.keysym.M-Right: \e033<M-Right>
-\& URxvt.keysym.M-C-0: list \e033<M-C- 0123456789 >
-\& URxvt.keysym.M-C-a: list \e033<M-C- abcdefghijklmnopqrstuvwxyz >
+\& URxvt.keysym.C\-apostrophe: \e033<C\-'>
+\& URxvt.keysym.C\-slash: \e033<C\-/>
+\& URxvt.keysym.C\-semicolon: \e033<C\-;>
+\& URxvt.keysym.C\-grave: \e033<C\-`>
+\& URxvt.keysym.C\-comma: \e033<C\-,>
+\& URxvt.keysym.C\-period: \e033<C\-.>
+\& URxvt.keysym.C\-0x60: \e033<C\-`>
+\& URxvt.keysym.C\-Tab: \e033<C\-Tab>
+\& URxvt.keysym.C\-Return: \e033<C\-Return>
+\& URxvt.keysym.S\-Return: \e033<S\-Return>
+\& URxvt.keysym.S\-space: \e033<S\-Space>
+\& URxvt.keysym.M\-Up: \e033<M\-Up>
+\& URxvt.keysym.M\-Down: \e033<M\-Down>
+\& URxvt.keysym.M\-Left: \e033<M\-Left>
+\& URxvt.keysym.M\-Right: \e033<M\-Right>
+\& URxvt.keysym.M\-C\-0: list \e033<M\-C\- 0123456789 >
+\& URxvt.keysym.M\-C\-a: list \e033<M\-C\- abcdefghijklmnopqrstuvwxyz >
\& URxvt.keysym.F12: command:\e033]701;zh_CN.GBK\e007
.Ve
.PP
.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
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
.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
\& 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
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
.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,
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
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.
.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
method servers are running with this command:
.Sp
.Vb 1
-\& xprop -root XIM_SERVERS
+\& xprop \-root XIM_SERVERS
.Ve
.IP "*" 4
.PP
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
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)"
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.
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
\&\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
.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 <rxvt@schmorp.de>.
+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 <rxvt@schmorp.de>.
.PP
All
.IP "\-\-enable\-everything" 4
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
.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.
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
.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 <rxvt@schmorp.de> converted this document to pod and
projects / dana / urxvt.git / commitdiff