WISH: kick out xpm.C, replace by pixbuf
DUMB: support tex fonts
-8.0
+8.0 Thu Nov 2 18:35:19 CET 2006
- combining characters cleared the area instead of creating an overlay,
thus losing the ability to draw combining characters properly in most
circumstances (reported by exg).
src/perl/selection-pastebin
src/perl/searchable-scrollback
src/perl/automove-background
-src/perl/mark-urls
+src/perl/matcher
src/perl/tabbed
src/perl/xim-onthespot
src/perl/readline
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)
No large bloated libraries (of course, none were linked in statically),
except maybe libX11 :)
arises).
The correct solution for this problem is to install the terminfo, this
- can be done like this (with ncurses' infocmp):
+ can be done like this (with ncurses' infocmp and works as user and
+ admin):
REMOTE=remotesystem.domain
- infocmp rxvt-unicode | ssh $REMOTE "cat >/tmp/ti && tic /tmp/ti"
+ infocmp rxvt-unicode | ssh $REMOTE "mkdir -p .terminfo && cat >/tmp/ti && tic /tmp/ti"
... or by installing rxvt-unicode normally on the remote system,
+ One some systems you might need to set $TERMINFO to the full path of
+ $HOME/.terminfo for this to work.
+
If you cannot or do not want to do this, then you can simply set
"TERM=rxvt" or even "TERM=xterm", and live with the small number of
problems arising, which includes wrong keymapping, less and different
xprop -root XIM_SERVERS
-
+ *
My input method wants <some encoding> but I want UTF-8, what can I do?
You can specify separate locales for the input method and the rest of
about 700kB), but it doesn't increase memory usage unless you use a
font requiring one of these encodings.
- all all available codeset groups
- zh common chinese encodings
- zh_ext rarely used but very big chinese encodigs
- jp common japanese encodings
- jp_ext rarely used but big japanese encodings
- kr korean encodings
+ all all available codeset groups
+ zh common chinese encodings
+ zh_ext rarely used but very big chinese encodigs
+ jp common japanese encodings
+ jp_ext rarely used but big japanese encodings
+ kr korean encodings
+
--enable-xim (default: on)
Add support for XIM (X Input Method) protocol. This allows using
alternative input methods (e.g. kinput2) and will also correctly set
</p>
<hr />
<h1><a name="description">DESCRIPTION</a></h1>
-<p><strong>rxvt-unicode</strong>, version <strong>7.9</strong>, is a colour vt102 terminal
+<p><strong>rxvt-unicode</strong>, version <strong>8.0</strong>, is a colour vt102 terminal
emulator intended as an <em>xterm</em>(1) replacement for users who do not
require features such as Tektronix 4014 emulation and toolkit-style
configurability. As a result, <strong>rxvt-unicode</strong> uses much less swap space --
<p>See <code>rxvt(7)</code> (try <code>man 7 rxvt</code>) 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
-<a href="http://cvs.schmorp.de/browse/*checkout*/rxvt-unicode/doc/rxvt.7.html">http://cvs.schmorp.de/browse/*checkout*/rxvt-unicode/doc/rxvt.7.html</a>.</p>
+<a href="http://cvs.schmorp.de/browse/rxvt-unicode/doc/rxvt.7.html">http://cvs.schmorp.de/browse/rxvt-unicode/doc/rxvt.7.html</a>.</p>
<p>
</p>
<hr />
<code>\e</code>, <code>\E</code>: escape, <code>\n</code>: newline, <code>\r</code>: carriage return, <code>\t</code>: tab,
<code>\000</code>: octal number) or verbatim control characters (<code>^?</code>: delete,
<code>^@</code>: null, <code>^A</code> ...) and may be enclosed with double quotes so that it
-can start or end with whitespace.</p>
+can start or end with whitespace. <strong>This feature is deprecated and will
+be removed</strong>.</p>
</dd>
<dd>
<p>Please note that you need to double the <code>\</code> in resource files, as
-.\" Automatically generated by Pod::Man 2.09 (Pod::Simple 3.04)
+.\" Automatically generated by Pod::Man v1.37, Pod::Parser v1.32
.\"
.\" Standard preamble:
.\" ========================================================================
.\" ========================================================================
.\"
.IX Title "@@RXVT_NAME@@ 1"
-.TH @@RXVT_NAME@@ 1 "2006-08-07" "7.9" "RXVT-UNICODE"
+.TH @@RXVT_NAME@@ 1 "2006-11-02" "8.0" "RXVT-UNICODE"
.SH "NAME"
rxvt\-unicode (ouR XVT, unicode) \- (a VT102 emulator for the X window system)
.SH "SYNOPSIS"
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
-<http://cvs.schmorp.de/browse/*checkout*/rxvt\-unicode/doc/rxvt.7.html>.
+<http://cvs.schmorp.de/browse/rxvt\-unicode/doc/rxvt.7.html>.
.SH "RXVT-UNICODE VS. RXVT"
.IX Header "RXVT-UNICODE VS. RXVT"
Unlike the original rxvt, \fBrxvt-unicode\fR stores all text in Unicode
\&\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"
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
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
.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
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
.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
\&\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.
+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
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.
first part is available 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
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
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
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
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/2222 -fg "[e]pink"
.Ve
.PP
\&\fIPlease note that transparency of any kind if completely unsupported by
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<nodename\fI\fR.
+Default \fI$HOME/.rxvt\-unicode\-\fI<nodename\fI\fR.
.IP "\fB\s-1HOME\s0\fR" 4
.IX Item "HOME"
Used to locate the default directory for the unix domain socket for
rxvt [options] [-e command [ args ]]
DESCRIPTION
- rxvt-unicode, version 7.9, is a colour vt102 terminal emulator intended
+ rxvt-unicode, version 8.0, is a colour vt102 terminal emulator intended
as an *xterm*(1) replacement for users who do not require features such
as Tektronix 4014 emulation and toolkit-style configurability. As a
result, rxvt-unicode uses much less swap space -- a significant
See rxvt(7) (try "man 7 rxvt") 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
- <http://cvs.schmorp.de/browse/*checkout*/rxvt-unicode/doc/rxvt.7.html>.
+ <http://cvs.schmorp.de/browse/rxvt-unicode/doc/rxvt.7.html>.
RXVT-UNICODE VS. RXVT
Unlike the original rxvt, rxvt-unicode stores all text in Unicode
"\e", "\E": escape, "\n": newline, "\r": carriage return, "\t": tab,
"\000": octal number) or verbatim control characters ("^?": delete,
"^@": null, "^A" ...) and may be enclosed with double quotes so that
- it can start or end with whitespace.
+ it can start or end with whitespace. This feature is deprecated and
+ will be removed.
Please note that you need to double the "\" in resource files, as
Xlib itself does its own de-escaping (you can use "\033" instead of
the rest is available when rxvt-unicode was compiled with
"--enable-iso14755".
- * 5.1: Basic method
-
+ * 5.1: Basic method
This allows you to enter unicode characters using their hexcode.
Start by pressing and holding both "Control" and "Shift", then enter
easily by pressing "Control" and "Shift", followed by
"6-7-1-D-SPACE-6-5-E-5", followed by releasing the modifier keys.
- * 5.2: Keyboard symbols entry method
-
+ * 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.
enter the symbol for "ISO Level 2 Switch", although your intention
might have been to enter a reverse tab (Shift-Tab).
- * 5.3: Screen-selection entry method
-
+ * 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.
- * 5.4: Feedback method for identifying displayed characters for later
- input
-
+ * 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.
display up to 16 colours (8 ANSI colours plus high-intensity bold/blink
versions of the same). Here is a list of the colours with their names.
- color0 (black) = Black
- color1 (red) = Red3
- color2 (green) = Green3
- color3 (yellow) = Yellow3
- color4 (blue) = Blue3
- color5 (magenta) = Magenta3
- color6 (cyan) = Cyan3
- color7 (white) = AntiqueWhite
- color8 (bright black) = Grey25
- color9 (bright red) = Red
- color10 (bright green) = Green
- color11 (bright yellow) = Yellow
- color12 (bright blue) = Blue
- color13 (bright magenta) = Magenta
- color14 (bright cyan) = Cyan
- color15 (bright white) = White
- foreground = Black
- background = White
+ color0 (black) = Black
+ color1 (red) = Red3
+ color2 (green) = Green3
+ color3 (yellow) = Yellow3
+ color4 (blue) = Blue3
+ color5 (magenta) = Magenta3
+ color6 (cyan) = Cyan3
+ color7 (white) = AntiqueWhite
+ color8 (bright black) = Grey25
+ color9 (bright red) = Red
+ color10 (bright green) = Green
+ color11 (bright yellow) = Yellow
+ color12 (bright blue) = Blue
+ color13 (bright magenta) = Magenta
+ color14 (bright cyan) = Cyan
+ color15 (bright white) = White
+ foreground = Black
+ background = White
+
It is also possible to specify the colour values of foreground,
background, cursorColor, cursorColor2, colorBD, colorUL as a number
0-15, as a convenient shorthand to reference the colour name of
<p>This document contains the FAQ, the RXVT TECHNICAL REFERENCE documenting
all escape sequences, and other background information.</p>
<p>The newest version of this document is also available on the World Wide Web at
-<a href="http://cvs.schmorp.de/browse/*checkout*/rxvt-unicode/doc/rxvt.7.html">http://cvs.schmorp.de/browse/*checkout*/rxvt-unicode/doc/rxvt.7.html</a>.</p>
+<a href="http://cvs.schmorp.de/browse/rxvt-unicode/doc/rxvt.7.html">http://cvs.schmorp.de/browse/rxvt-unicode/doc/rxvt.7.html</a>.</p>
<p>
</p>
<hr />
<p>The terminal description used by rxvt-unicode is not as widely available
as that for xterm, or even rxvt (for which the same problem often arises).</p>
<p>The correct solution for this problem is to install the terminfo, this can
-be done like this (with ncurses' infocmp):</p>
+be done like this (with ncurses' infocmp and works as user and admin):</p>
<pre>
REMOTE=remotesystem.domain
- infocmp rxvt-unicode | ssh $REMOTE "cat >/tmp/ti && tic /tmp/ti"</pre>
+ infocmp rxvt-unicode | ssh $REMOTE "mkdir -p .terminfo && cat >/tmp/ti && tic /tmp/ti"</pre>
<p>... or by installing rxvt-unicode normally on the remote system,</p>
+<p>One some systems you might need to set <code>$TERMINFO</code> to the full path of
+<em>$HOME/.terminfo</em> for this to work.</p>
<p>If you cannot or do not want to do this, then you can simply set
<code>TERM=rxvt</code> or even <code>TERM=xterm</code>, and live with the small number of
problems arising, which includes wrong keymapping, less and different
-.\" Automatically generated by Pod::Man 2.09 (Pod::Simple 3.04)
+.\" Automatically generated by Pod::Man v1.37, Pod::Parser v1.32
.\"
.\" Standard preamble:
.\" ========================================================================
.\" ========================================================================
.\"
.IX Title "@@RXVT_NAME@@ 7"
-.TH @@RXVT_NAME@@ 7 "2006-08-07" "7.9" "RXVT-UNICODE"
+.TH @@RXVT_NAME@@ 7 "2006-11-02" "8.0" "RXVT-UNICODE"
.SH "NAME"
RXVT REFERENCE \- FAQ, command sequences and other background information
.SH "SYNOPSIS"
.Vb 2
\& # set a new font set
\& printf '\e33]50;%s\e007' 9x15,xft:Kochi" Mincho"
-\&
-\& # 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
+\& # 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
\& # set window title
\& printf '\e33]2;%s\e007' "new window title"
.Ve
all escape sequences, and other background information.
.PP
The newest version of this document is also available on the World Wide Web at
-<http://cvs.schmorp.de/browse/*checkout*/rxvt\-unicode/doc/rxvt.7.html>.
+<http://cvs.schmorp.de/browse/rxvt\-unicode/doc/rxvt.7.html>.
.SH "RXVT\-UNICODE/URXVT FREQUENTLY ASKED QUESTIONS"
.IX Header "RXVT-UNICODE/URXVT FREQUENTLY ASKED QUESTIONS"
.Sh "Meta, Features & Commandline Issues"
give you tabs:
.PP
.Vb 1
-\& @@URXVT_NAME@@ \-pe tabbed
-\&
-\& URxvt.perl\-ext\-common: default,tabbed
+\& @@URXVT_NAME@@ -pe tabbed
+.Ve
+.PP
+.Vb 1
+\& 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),
.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.xpm
+\& @@URXVT_NAME@@ -pixmap background.xpm -pe automove-background
.Ve
.PP
That works. If you think it doesn't, you lack \s-1XPM\s0 and Perl support, or you
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
\& URxvt.color5: #A800A8
\& URxvt.color6: #00A8A8
\& URxvt.color7: #A8A8A8
-\&
+.Ve
+.PP
+.Vb 8
\& URxvt.color8: #000054
\& URxvt.color9: #FF0054
\& URxvt.color10: #00FF54
.PP
And here is a more complete set of non-standard colors.
.PP
-.Vb 10
+.Vb 18
\& URxvt.cursorColor: #dc74d1
\& URxvt.pointerColor: #dc74d1
\& URxvt.background: #0e0e0e
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
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).
+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).
.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
\& # use Backspace = ^H
\& $ stty erase ^H
\& $ @@URXVT_NAME@@
-\&
+.Ve
+.PP
+.Vb 3
\& # use Backspace = ^?
\& $ stty erase ^?
\& $ @@URXVT_NAME@@
.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
.PP
Here's an example for a URxvt session started using \f(CW\*(C`@@URXVT_NAME@@ \-name URxvt\*(C'\fR
.PP
-.Vb 10
+.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
applications. Most importantly, this means that if you or your \s-1OS\s0 loads
resources into the X display (the right way to do it), rxvt-unicode will
ignore any resource files in your home directory. It will only read
-\&\fI\f(CI$HOME\fI/.Xdefaults\fR when no resources are attached to the display.
+\&\fI$HOME/.Xdefaults\fR when no resources are attached to the display.
.PP
-If you have or use an \fI\f(CI$HOME\fI/.Xresources\fR file, chances are that
+If you have or use an \fI$HOME/.Xresources\fR file, chances are that
resources are loaded into your X\-server. In this case, you have to
re-login after every change (or run \fIxrdb \-merge \f(CI$HOME\fI/.Xresources\fR).
.PP
as that for xterm, or even rxvt (for which the same problem often arises).
.PP
The correct solution for this problem is to install the terminfo, this can
-be done like this (with ncurses' infocmp):
+be done like this (with ncurses' infocmp and works as user and admin):
.PP
.Vb 2
\& REMOTE=remotesystem.domain
-\& infocmp rxvt\-unicode | ssh $REMOTE "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,
.PP
+One some systems you might need to set \f(CW$TERMINFO\fR to the full path of
+\&\fI$HOME/.terminfo\fR for this to work.
+.PP
If you cannot or do not want to do this, then you can simply set
\&\f(CW\*(C`TERM=rxvt\*(C'\fR or even \f(CW\*(C`TERM=xterm\*(C'\fR, and live with the small number of
problems arising, which includes wrong keymapping, less and different
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 10
-\& rxvt\-unicode|rxvt\-unicode terminal (X Window System):\e
+.Vb 20
+\& 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
+.IP "*" 4
.PP
\fIMy input method wants <some encoding> but I want \s-1UTF\-8\s0, what can I do?\fR
.IX Subsection "My input method wants <some encoding> but I want UTF-8, what can I do?"
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
C = C Finnish character set unimplemented
C = K German character set unimplemented
.TE
+
.PP
.IX Xref "CSI"
Ps = 1 Clear Above
Ps = 2 Clear All
.TE
+
.ie n .IP "\fB\fB""ESC [ Ps K""\fB\fR" 4
.el .IP "\fB\f(CBESC [ Ps K\fB\fR" 4
.IX Item "ESC [ Ps K"
Ps = 1 Clear to Left
Ps = 2 Clear All
.TE
+
.ie n .IP "\fB\fB""ESC [ Ps L""\fB\fR" 4
.el .IP "\fB\f(CBESC [ Ps L\fB\fR" 4
.IX Item "ESC [ Ps L"
Ps = 2 Tab Clear (TBC), Clear Current Column (default)
Ps = 5 Tab Clear (TBC), Clear All
.TE
+
.ie n .IP "\fB\fB""ESC [ Ps X""\fB\fR" 4
.el .IP "\fB\f(CBESC [ Ps X\fB\fR" 4
.IX Item "ESC [ Ps X"
Ps = 0 Clear Current Column (default)
Ps = 3 Clear All (TBC)
.TE
+
.ie n .IP "\fB\fB""ESC [ Pm h""\fB\fR" 4
.el .IP "\fB\f(CBESC [ Pm h\fB\fR" 4
.IX Item "ESC [ Pm h"
Ps = 4 disable transparent print mode (MC4)
Ps = 5 enable transparent print mode (MC5)
.TE
+
.ie n .IP "\fB\fB""ESC [ Pm l""\fB\fR" 4
.el .IP "\fB\f(CBESC [ Pm l\fB\fR" 4
.IX Item "ESC [ Pm l"
h Insert Mode (SMIR)
l Replace Mode (RMIR)
.TE
+
.PD 0
.ie n .IP "\fB\fB""Ps = 20""\fB\fR (partially implemented)" 4
.el .IP "\fB\f(CBPs = 20\fB\fR (partially implemented)" 4
h Automatic Newline (LNM)
l Normal Linefeed (LNM)
.TE
+
.RE
.RS 4
.RE
Ps = 97 / 107 fg/bg Bright White
Ps = 99 / 109 fg/bg Bright Default
.TE
+
.ie n .IP "\fB\fB""ESC [ Ps n""\fB\fR" 4
.el .IP "\fB\f(CBESC [ Ps n\fB\fR" 4
.IX Item "ESC [ Ps n"
Ps = 7 Request Display Name
Ps = 8 Request Version Number (place in window title)
.TE
+
.ie n .IP "\fB\fB""ESC [ Ps;Ps r""\fB\fR" 4
.el .IP "\fB\f(CBESC [ Ps;Ps r\fB\fR" 4
.IX Item "ESC [ Ps;Ps r"
Ps = 21 Reports window title (ESC ] l NAME \234)
Ps = 24.. Set window height to Ps rows
.TE
+
.ie n .IP "\fB\fB""ESC [ u""\fB\fR" 4
.el .IP "\fB\f(CBESC [ u\fB\fR" 4
.IX Item "ESC [ u"
h Application Cursor Keys
l Normal Cursor Keys
.TE
+
.PD 0
.ie n .IP "\fB\fB""Pm = 2""\fB\fR (\s-1ANSI/VT52\s0 mode)" 4
.el .IP "\fB\f(CBPm = 2\fB\fR (\s-1ANSI/VT52\s0 mode)" 4
h Enter VT52 mode
l Enter VT52 mode
.TE
+
.ie n .IP "\fB\fB""Pm = 3""\fB\fR" 4
.el .IP "\fB\f(CBPm = 3\fB\fR" 4
.IX Item "Pm = 3"
h 132 Column Mode (DECCOLM)
l 80 Column Mode (DECCOLM)
.TE
+
.ie n .IP "\fB\fB""Pm = 4""\fB\fR" 4
.el .IP "\fB\f(CBPm = 4\fB\fR" 4
.IX Item "Pm = 4"
h Smooth (Slow) Scroll (DECSCLM)
l Jump (Fast) Scroll (DECSCLM)
.TE
+
.ie n .IP "\fB\fB""Pm = 5""\fB\fR" 4
.el .IP "\fB\f(CBPm = 5\fB\fR" 4
.IX Item "Pm = 5"
h Reverse Video (DECSCNM)
l Normal Video (DECSCNM)
.TE
+
.ie n .IP "\fB\fB""Pm = 6""\fB\fR" 4
.el .IP "\fB\f(CBPm = 6\fB\fR" 4
.IX Item "Pm = 6"
h Origin Mode (DECOM)
l Normal Cursor Mode (DECOM)
.TE
+
.ie n .IP "\fB\fB""Pm = 7""\fB\fR" 4
.el .IP "\fB\f(CBPm = 7\fB\fR" 4
.IX Item "Pm = 7"
h Wraparound Mode (DECAWM)
l No Wraparound Mode (DECAWM)
.TE
+
.ie n .IP "\fB\fB""Pm = 8""\fB\fR \fIunimplemented\fR" 4
.el .IP "\fB\f(CBPm = 8\fB\fR \fIunimplemented\fR" 4
.IX Item "Pm = 8 unimplemented"
h Auto-repeat Keys (DECARM)
l No Auto-repeat Keys (DECARM)
.TE
+
.ie n .IP "\fB\fB""Pm = 9""\fB\fR X10 XTerm" 4
.el .IP "\fB\f(CBPm = 9\fB\fR X10 XTerm" 4
.IX Item "Pm = 9 X10 XTerm"
h Send Mouse X & Y on button press.
l No mouse reporting.
.TE
+
.ie n .IP "\fB\fB""Pm = 25""\fB\fR" 4
.el .IP "\fB\f(CBPm = 25\fB\fR" 4
.IX Item "Pm = 25"
h Visible cursor {cnorm/cvvis}
l Invisible cursor {civis}
.TE
+
.ie n .IP "\fB\fB""Pm = 30""\fB\fR" 4
.el .IP "\fB\f(CBPm = 30\fB\fR" 4
.IX Item "Pm = 30"
h scrollBar visisble
l scrollBar invisisble
.TE
+
.ie n .IP "\fB\fB""Pm = 35""\fB\fR (\fBrxvt\fR)" 4
.el .IP "\fB\f(CBPm = 35\fB\fR (\fBrxvt\fR)" 4
.IX Item "Pm = 35 (rxvt)"
h Allow XTerm Shift+key sequences
l Disallow XTerm Shift+key sequences
.TE
+
.ie n .IP "\fB\fB""Pm = 38""\fB\fR \fIunimplemented\fR" 4
.el .IP "\fB\f(CBPm = 38\fB\fR \fIunimplemented\fR" 4
.IX Item "Pm = 38 unimplemented"
h Allow 80/132 Mode
l Disallow 80/132 Mode
.TE
+
.PD 0
.ie n .IP "\fB\fB""Pm = 44""\fB\fR \fIunimplemented\fR" 4
.el .IP "\fB\f(CBPm = 44\fB\fR \fIunimplemented\fR" 4
h Turn On Margin Bell
l Turn Off Margin Bell
.TE
+
.ie n .IP "\fB\fB""Pm = 45""\fB\fR \fIunimplemented\fR" 4
.el .IP "\fB\f(CBPm = 45\fB\fR \fIunimplemented\fR" 4
.IX Item "Pm = 45 unimplemented"
h Reverse-wraparound Mode
l No Reverse-wraparound Mode
.TE
+
.ie n .IP "\fB\fB""Pm = 46""\fB\fR \fIunimplemented\fR" 4
.el .IP "\fB\f(CBPm = 46\fB\fR \fIunimplemented\fR" 4
.IX Item "Pm = 46 unimplemented"
h Use Alternate Screen Buffer
l Use Normal Screen Buffer
.TE
+
.PD
.IX Xref "Priv66"
h Application Keypad (DECPAM) == ESC =
l Normal Keypad (DECPNM) == ESC >
.TE
+
.PD 0
.ie n .IP "\fB\fB""Pm = 67""\fB\fR" 4
.el .IP "\fB\f(CBPm = 67\fB\fR" 4
h Backspace key sends BS (DECBKM)
l Backspace key sends DEL
.TE
+
.ie n .IP "\fB\fB""Pm = 1000""\fB\fR (X11 XTerm)" 4
.el .IP "\fB\f(CBPm = 1000\fB\fR (X11 XTerm)" 4
.IX Item "Pm = 1000 (X11 XTerm)"
h Send Mouse X & Y on button press and release.
l No mouse reporting.
.TE
+
.ie n .IP "\fB\fB""Pm = 1001""\fB\fR (X11 XTerm) \fIunimplemented\fR" 4
.el .IP "\fB\f(CBPm = 1001\fB\fR (X11 XTerm) \fIunimplemented\fR" 4
.IX Item "Pm = 1001 (X11 XTerm) unimplemented"
h Use Hilite Mouse Tracking.
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)"
h Don't scroll to bottom on TTY output
l Scroll to bottom on TTY output
.TE
+
.ie n .IP "\fB\fB""Pm = 1011""\fB\fR (\fBrxvt\fR)" 4
.el .IP "\fB\f(CBPm = 1011\fB\fR (\fBrxvt\fR)" 4
.IX Item "Pm = 1011 (rxvt)"
h Scroll to bottom when a key is pressed
l Don't scroll to bottom when a key is pressed
.TE
+
.ie n .IP "\fB\fB""Pm = 1021""\fB\fR (\fBrxvt\fR)" 4
.el .IP "\fB\f(CBPm = 1021\fB\fR (\fBrxvt\fR)" 4
.IX Item "Pm = 1021 (rxvt)"
h Bold/italic implies high intensity (see option -is)
l Font styles have no effect on intensity (Compile styles)
.TE
+
.ie n .IP "\fB\fB""Pm = 1047""\fB\fR" 4
.el .IP "\fB\f(CBPm = 1047\fB\fR" 4
.IX Item "Pm = 1047"
h Use Alternate Screen Buffer
l Use Normal Screen Buffer - clear Alternate Screen Buffer if returning from it
.TE
+
.ie n .IP "\fB\fB""Pm = 1048""\fB\fR" 4
.el .IP "\fB\f(CBPm = 1048\fB\fR" 4
.IX Item "Pm = 1048"
h Save cursor position
l Restore cursor position
.TE
+
.ie n .IP "\fB\fB""Pm = 1049""\fB\fR" 4
.el .IP "\fB\f(CBPm = 1049\fB\fR" 4
.IX Item "Pm = 1049"
h Use Alternate Screen Buffer - clear Alternate Screen Buffer if switching to it
l Use Normal Screen Buffer
.TE
+
.RE
.RS 4
.RE
Ps = 721 Move viewing window down by Pt lines, or clear scrollback buffer if Pt = 0 (Compile frills).
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
2 Button3 pressed
3 button released (X11 mouse report)
.TE
+
.PP
The upper bits of \fB\f(CB\*(C`<b>\*(C'\fB\fR indicate the modifiers when the
button was pressed and are added together (X11 mouse report only):
16 Control
32 Double Click (rxvt extension)
.TE
+
Col = \fB\f(CB\*(C`<x> \- SPACE\*(C'\fB\fR
.Sp
Row = \fB\f(CB\*(C`<y> \- SPACE\*(C'\fB\fR
XK_KP_8 8 ESC O x
XK_KP_9 9 ESC O y
.TE
+
.SH "CONFIGURE OPTIONS"
.IX Header "CONFIGURE OPTIONS"
General hint: if you get compile errors, then likely your configuration
jp_ext rarely used but big japanese encodings
kr korean encodings
.TE
+
.IP "\-\-enable\-xim (default: on)" 4
.IX Item "--enable-xim (default: on)"
Add support for \s-1XIM\s0 (X Input Method) protocol. This allows using
A non-exhaustive list of features enabled by \f(CW\*(C`\-\-enable\-frills\*(C'\fR (possibly
in combination with other switches) is:
.Sp
-.Vb 10
-\& MWM\-hints
-\& EWMH\-hints (pid, utf8 names) and protocols (ping)
-\& seperate underline colour (\-underlineColor)
-\& settable border widths and borderless switch (\-w, \-b, \-bl)
-\& visual depth selection (\-depth)
-\& settable extra linespacing /\-lsp)
-\& iso\-14755\-2 and \-3, and visual feedback
-\& tripleclickwords (\-tcw)
-\& settable insecure mode (\-insecure)
+.Vb 16
+\& MWM-hints
+\& EWMH-hints (pid, utf8 names) and protocols (ping)
+\& seperate underline colour (-underlineColor)
+\& settable border widths and borderless switch (-w, -b, -bl)
+\& visual depth selection (-depth)
+\& settable extra linespacing /-lsp)
+\& iso-14755-2 and -3, and visual feedback
+\& 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 supporr for selection
\& sgr modes 90..97 and 100..107
reworked it from the original Rxvt documentation, which was done by Geoff
Wing <gcw@pobox.com>, who in turn used the XTerm documentation and other
sources.
-.SH "POD ERRORS"
-.IX Header "POD ERRORS"
-Hey! \fBThe above document had some coding errors, which are explained below:\fR
-.IP "Around line 2952:" 4
-.IX Item "Around line 2952:"
-=back doesn't take any parameters, but you said =back X<Mouse>
-.IP "Around line 3048:" 4
-.IX Item "Around line 3048:"
-=back doesn't take any parameters, but you said =back X<KeyCodes>
all escape sequences, and other background information.
The newest version of this document is also available on the World Wide
- Web at
- <http://cvs.schmorp.de/browse/*checkout*/rxvt-unicode/doc/rxvt.7.html>.
+ Web at <http://cvs.schmorp.de/browse/rxvt-unicode/doc/rxvt.7.html>.
RXVT-UNICODE/URXVT FREQUENTLY ASKED QUESTIONS
Meta, Features & Commandline Issues
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)
No large bloated libraries (of course, none were linked in statically),
except maybe libX11 :)
arises).
The correct solution for this problem is to install the terminfo, this
- can be done like this (with ncurses' infocmp):
+ can be done like this (with ncurses' infocmp and works as user and
+ admin):
REMOTE=remotesystem.domain
- infocmp rxvt-unicode | ssh $REMOTE "cat >/tmp/ti && tic /tmp/ti"
+ infocmp rxvt-unicode | ssh $REMOTE "mkdir -p .terminfo && cat >/tmp/ti && tic /tmp/ti"
... or by installing rxvt-unicode normally on the remote system,
+ One some systems you might need to set $TERMINFO to the full path of
+ $HOME/.terminfo for this to work.
+
If you cannot or do not want to do this, then you can simply set
"TERM=rxvt" or even "TERM=xterm", and live with the small number of
problems arising, which includes wrong keymapping, less and different
xprop -root XIM_SERVERS
-
+ *
My input method wants <some encoding> but I want UTF-8, what can I do?
You can specify separate locales for the input method and the rest of
Where "C" is one of:
- C = 0 DEC Special Character and Line Drawing Set
- C = A United Kingdom (UK)
- C = B United States (USASCII)
- C = < Multinational character set unimplemented
- C = 5 Finnish character set unimplemented
- C = C Finnish character set unimplemented
- C = K German character set unimplemented
+ C = 0 DEC Special Character and Line Drawing Set
+ C = A United Kingdom (UK)
+ C = B United States (USASCII)
+ C = < Multinational character set unimplemented
+ C = 5 Finnish character set unimplemented
+ C = C Finnish character set unimplemented
+ C = K German character set unimplemented
+
CSI (Command Sequence Introducer) Sequences
"ESC [ Ps J"
Erase in Display (ED)
- Ps = 0 Clear Below (default)
- Ps = 1 Clear Above
- Ps = 2 Clear All
+ Ps = 0 Clear Below (default)
+ Ps = 1 Clear Above
+ Ps = 2 Clear All
+
"ESC [ Ps K"
Erase in Line (EL)
- Ps = 0 Clear to Right (default)
- Ps = 1 Clear to Left
- Ps = 2 Clear All
+ Ps = 0 Clear to Right (default)
+ Ps = 1 Clear to Left
+ Ps = 2 Clear All
+
"ESC [ Ps L"
Insert "Ps" Line(s) [default: 1] (IL)
"ESC [ Ps W"
Tabulator functions
- Ps = 0 Tab Set (HTS)
- Ps = 2 Tab Clear (TBC), Clear Current Column (default)
- Ps = 5 Tab Clear (TBC), Clear All
+ Ps = 0 Tab Set (HTS)
+ Ps = 2 Tab Clear (TBC), Clear Current Column (default)
+ Ps = 5 Tab Clear (TBC), Clear All
+
"ESC [ Ps X"
Erase "Ps" Character(s) [default: 1] (ECH)
"ESC [ Ps g"
Tab Clear (TBC)
- Ps = 0 Clear Current Column (default)
- Ps = 3 Clear All (TBC)
+ Ps = 0 Clear Current Column (default)
+ Ps = 3 Clear All (TBC)
+
"ESC [ Pm h"
Set Mode (SM). See "ESC [ Pm l" sequence for description of "Pm".
"ESC [ Ps i"
Printing. See also the "print-pipe" resource.
- Ps = 0 print screen (MC0)
- Ps = 4 disable transparent print mode (MC4)
- Ps = 5 enable transparent print mode (MC5)
+ Ps = 0 print screen (MC0)
+ Ps = 4 disable transparent print mode (MC4)
+ Ps = 5 enable transparent print mode (MC5)
+
"ESC [ Pm l"
Reset Mode (RM)
- h Insert Mode (SMIR)
- l Replace Mode (RMIR)
"Ps = 4"
- h Automatic Newline (LNM)
- l Normal Linefeed (LNM)
+ h Insert Mode (SMIR)
+ l Replace Mode (RMIR)
+
"Ps = 20" (partially implemented)
+ h Automatic Newline (LNM)
+ l Normal Linefeed (LNM)
"ESC [ Pm m"
Character Attributes (SGR)
- Ps = 0 Normal (default)
- Ps = 1 / 21 On / Off Bold (bright fg)
- Ps = 3 / 23 On / Off Italic
- Ps = 4 / 24 On / Off Underline
- Ps = 5 / 25 On / Off Slow Blink (bright bg)
- Ps = 6 / 26 On / Off Rapid Blink (bright bg)
- Ps = 7 / 27 On / Off Inverse
- Ps = 8 / 27 On / Off Invisible (NYI)
- Ps = 30 / 40 fg/bg Black
- Ps = 31 / 41 fg/bg Red
- Ps = 32 / 42 fg/bg Green
- Ps = 33 / 43 fg/bg Yellow
- Ps = 34 / 44 fg/bg Blue
- Ps = 35 / 45 fg/bg Magenta
- Ps = 36 / 46 fg/bg Cyan
- Ps = 38;5 / 48;5 set fg/bg to color #m (ISO 8613-6)
- Ps = 37 / 47 fg/bg White
- Ps = 39 / 49 fg/bg Default
- Ps = 90 / 100 fg/bg Bright Black
- Ps = 91 / 101 fg/bg Bright Red
- Ps = 92 / 102 fg/bg Bright Green
- Ps = 93 / 103 fg/bg Bright Yellow
- Ps = 94 / 104 fg/bg Bright Blue
- Ps = 95 / 105 fg/bg Bright Magenta
- Ps = 96 / 106 fg/bg Bright Cyan
- Ps = 97 / 107 fg/bg Bright White
- Ps = 99 / 109 fg/bg Bright Default
+ Ps = 0 Normal (default)
+ Ps = 1 / 21 On / Off Bold (bright fg)
+ Ps = 3 / 23 On / Off Italic
+ Ps = 4 / 24 On / Off Underline
+ Ps = 5 / 25 On / Off Slow Blink (bright bg)
+ Ps = 6 / 26 On / Off Rapid Blink (bright bg)
+ Ps = 7 / 27 On / Off Inverse
+ Ps = 8 / 27 On / Off Invisible (NYI)
+ Ps = 30 / 40 fg/bg Black
+ Ps = 31 / 41 fg/bg Red
+ Ps = 32 / 42 fg/bg Green
+ Ps = 33 / 43 fg/bg Yellow
+ Ps = 34 / 44 fg/bg Blue
+ Ps = 35 / 45 fg/bg Magenta
+ Ps = 36 / 46 fg/bg Cyan
+ Ps = 38;5 / 48;5 set fg/bg to color #m (ISO 8613-6)
+ Ps = 37 / 47 fg/bg White
+ Ps = 39 / 49 fg/bg Default
+ Ps = 90 / 100 fg/bg Bright Black
+ Ps = 91 / 101 fg/bg Bright Red
+ Ps = 92 / 102 fg/bg Bright Green
+ Ps = 93 / 103 fg/bg Bright Yellow
+ Ps = 94 / 104 fg/bg Bright Blue
+ Ps = 95 / 105 fg/bg Bright Magenta
+ Ps = 96 / 106 fg/bg Bright Cyan
+ Ps = 97 / 107 fg/bg Bright White
+ Ps = 99 / 109 fg/bg Bright Default
+
"ESC [ Ps n"
Device Status Report (DSR)
- Ps = 5 Status Report ESC [ 0 n (``OK'')
- Ps = 6 Report Cursor Position (CPR) [row;column] as ESC [ r ; c R
- Ps = 7 Request Display Name
- Ps = 8 Request Version Number (place in window title)
+ Ps = 5 Status Report ESC [ 0 n (``OK'')
+ Ps = 6 Report Cursor Position (CPR) [row;column] as ESC [ r ; c R
+ Ps = 7 Request Display Name
+ Ps = 8 Request Version Number (place in window title)
+
"ESC [ Ps;Ps r"
Set Scrolling Region [top;bottom] [default: full size of window]
(CSR)
"ESC [ Ps;Pt t"
Window Operations
- Ps = 1 Deiconify (map) window
- Ps = 2 Iconify window
- Ps = 3 ESC [ 3 ; X ; Y t Move window to (X|Y)
- Ps = 4 ESC [ 4 ; H ; W t Resize to WxH pixels
- Ps = 5 Raise window
- Ps = 6 Lower window
- Ps = 7 Refresh screen once
- Ps = 8 ESC [ 8 ; R ; C t Resize to R rows and C columns
- Ps = 11 Report window state (responds with Ps = 1 or Ps = 2)
- Ps = 13 Report window position (responds with Ps = 3)
- Ps = 14 Report window pixel size (responds with Ps = 4)
- Ps = 18 Report window text size (responds with Ps = 7)
- Ps = 19 Currently the same as Ps = 18, but responds with Ps = 9
- Ps = 20 Reports icon label (ESC ] L NAME \234)
- Ps = 21 Reports window title (ESC ] l NAME \234)
- Ps = 24.. Set window height to Ps rows
+ Ps = 1 Deiconify (map) window
+ Ps = 2 Iconify window
+ Ps = 3 ESC [ 3 ; X ; Y t Move window to (X|Y)
+ Ps = 4 ESC [ 4 ; H ; W t Resize to WxH pixels
+ Ps = 5 Raise window
+ Ps = 6 Lower window
+ Ps = 7 Refresh screen once
+ Ps = 8 ESC [ 8 ; R ; C t Resize to R rows and C columns
+ Ps = 11 Report window state (responds with Ps = 1 or Ps = 2)
+ Ps = 13 Report window position (responds with Ps = 3)
+ Ps = 14 Report window pixel size (responds with Ps = 4)
+ Ps = 18 Report window text size (responds with Ps = 7)
+ Ps = 19 Currently the same as Ps = 18, but responds with Ps = 9
+ Ps = 20 Reports icon label (ESC ] L NAME \234)
+ Ps = 21 Reports window title (ESC ] l NAME \234)
+ Ps = 24.. Set window height to Ps rows
+
"ESC [ u"
Restore Cursor
"ESC [ ? Pm t"
Toggle DEC Private Mode Values (rxvt extension). *where*
- h Application Cursor Keys
- l Normal Cursor Keys
"Pm = 1" (DECCKM)
- h Enter VT52 mode
- l Enter VT52 mode
+ h Application Cursor Keys
+ l Normal Cursor Keys
+
"Pm = 2" (ANSI/VT52 mode)
- h 132 Column Mode (DECCOLM)
- l 80 Column Mode (DECCOLM)
+ h Enter VT52 mode
+ l Enter VT52 mode
+
"Pm = 3"
- h Smooth (Slow) Scroll (DECSCLM)
- l Jump (Fast) Scroll (DECSCLM)
+ h 132 Column Mode (DECCOLM)
+ l 80 Column Mode (DECCOLM)
+
"Pm = 4"
- h Reverse Video (DECSCNM)
- l Normal Video (DECSCNM)
+ h Smooth (Slow) Scroll (DECSCLM)
+ l Jump (Fast) Scroll (DECSCLM)
+
"Pm = 5"
- h Origin Mode (DECOM)
- l Normal Cursor Mode (DECOM)
+ h Reverse Video (DECSCNM)
+ l Normal Video (DECSCNM)
+
"Pm = 6"
- h Wraparound Mode (DECAWM)
- l No Wraparound Mode (DECAWM)
+ h Origin Mode (DECOM)
+ l Normal Cursor Mode (DECOM)
+
"Pm = 7"
- h Auto-repeat Keys (DECARM)
- l No Auto-repeat Keys (DECARM)
+ h Wraparound Mode (DECAWM)
+ l No Wraparound Mode (DECAWM)
+
"Pm = 8" *unimplemented*
- h Send Mouse X & Y on button press.
- l No mouse reporting.
+ h Auto-repeat Keys (DECARM)
+ l No Auto-repeat Keys (DECARM)
+
"Pm = 9" X10 XTerm
- h Visible cursor {cnorm/cvvis}
- l Invisible cursor {civis}
+ h Send Mouse X & Y on button press.
+ l No mouse reporting.
+
"Pm = 25"
- h scrollBar visisble
- l scrollBar invisisble
+ h Visible cursor {cnorm/cvvis}
+ l Invisible cursor {civis}
+
"Pm = 30"
- h Allow XTerm Shift+key sequences
- l Disallow XTerm Shift+key sequences
+ h scrollBar visisble
+ l scrollBar invisisble
+
"Pm = 35" (rxvt)
+ h Allow XTerm Shift+key sequences
+ l Disallow XTerm Shift+key sequences
+
"Pm = 38" *unimplemented*
Enter Tektronix Mode (DECTEK)
- h Allow 80/132 Mode
- l Disallow 80/132 Mode
"Pm = 40"
- h Turn On Margin Bell
- l Turn Off Margin Bell
+ h Allow 80/132 Mode
+ l Disallow 80/132 Mode
+
"Pm = 44" *unimplemented*
- h Reverse-wraparound Mode
- l No Reverse-wraparound Mode
+ h Turn On Margin Bell
+ l Turn Off Margin Bell
+
"Pm = 45" *unimplemented*
+ h Reverse-wraparound Mode
+ l No Reverse-wraparound Mode
+
"Pm = 46" *unimplemented*
- h Use Alternate Screen Buffer
- l Use Normal Screen Buffer
"Pm = 47"
+ h Use Alternate Screen Buffer
+ l Use Normal Screen Buffer
+
+
- h Application Keypad (DECPAM) == ESC =
- l Normal Keypad (DECPNM) == ESC >
"Pm = 66"
- h Backspace key sends BS (DECBKM)
- l Backspace key sends DEL
+ h Application Keypad (DECPAM) == ESC =
+ l Normal Keypad (DECPNM) == ESC >
+
"Pm = 67"
- h Send Mouse X & Y on button press and release.
- l No mouse reporting.
+ h Backspace key sends BS (DECBKM)
+ l Backspace key sends DEL
+
"Pm = 1000" (X11 XTerm)
- h Use Hilite Mouse Tracking.
- l No mouse reporting.
+ h Send Mouse X & Y on button press and release.
+ l No mouse reporting.
+
"Pm = 1001" (X11 XTerm) *unimplemented*
- h Don't scroll to bottom on TTY output
- l Scroll to bottom on TTY output
+ h Use Hilite Mouse Tracking.
+ l No mouse reporting.
+
"Pm = 1010" (rxvt)
- h Scroll to bottom when a key is pressed
- l Don't scroll to bottom when a key is pressed
+ h Don't scroll to bottom on TTY output
+ l Scroll to bottom on TTY output
+
"Pm = 1011" (rxvt)
- h Bold/italic implies high intensity (see option -is)
- l Font styles have no effect on intensity (Compile styles)
+ h Scroll to bottom when a key is pressed
+ l Don't scroll to bottom when a key is pressed
+
"Pm = 1021" (rxvt)
- h Use Alternate Screen Buffer
- l Use Normal Screen Buffer - clear Alternate Screen Buffer if returning from it
+ h Bold/italic implies high intensity (see option -is)
+ l Font styles have no effect on intensity (Compile styles)
+
"Pm = 1047"
- h Save cursor position
- l Restore cursor position
+ h Use Alternate Screen Buffer
+ l Use Normal Screen Buffer - clear Alternate Screen Buffer if returning from it
+
"Pm = 1048"
- h Use Alternate Screen Buffer - clear Alternate Screen Buffer if switching to it
- l Use Normal Screen Buffer
+ h Save cursor position
+ l Restore cursor position
+
"Pm = 1049"
+ h Use Alternate Screen Buffer - clear Alternate Screen Buffer if switching to it
+ l Use Normal Screen Buffer
accepted. any octet can be escaped by prefixing it with SYN (0x16,
^V).
- Ps = 0 Change Icon Name and Window Title to Pt
- Ps = 1 Change Icon Name to Pt
- Ps = 2 Change Window Title to Pt
- Ps = 3 If Pt starts with a ?, query the (STRING) property of the window and return it. If Pt contains a =, set the named property to the given value, else delete the specified property.
- Ps = 4 Pt is a semi-colon separated sequence of one or more semi-colon separated number/name pairs, where number is an index to a colour and name is the name of a colour. Each pair causes the numbered colour to be changed to name. Numbers 0-7 corresponds to low-intensity (normal) colours and 8-15 corresponds to high-intensity colours. 0=black, 1=red, 2=green, 3=yellow, 4=blue, 5=magenta, 6=cyan, 7=white
- Ps = 10 Change colour of text foreground to Pt (NB: may change in future)
- Ps = 11 Change colour of text background to Pt (NB: may change in future)
- Ps = 12 Change colour of text cursor foreground to Pt
- 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 = 39 Change default foreground colour to Pt.
- Ps = 46 Change Log File to Pt unimplemented
- Ps = 49 Change default background colour to Pt.
- Ps = 50 Set fontset to Pt, with the following special values of Pt (rxvt) #+n change up n #-n change down n if n is missing of 0, a value of 1 is used empty change to font0 n change to font n
- Ps = 55 Log all scrollback buffer and all of screen to Pt
- Ps = 701 Change current locale to Pt, or, if Pt is ?, return the current locale (Compile frills).
- Ps = 702 Request version if Pt is ?, returning rxvt-unicode, the resource name, the major and minor version numbers, e.g. ESC ] 702 ; rxvt-unicode ; urxvt ; 7 ; 4 ST.
- Ps = 704 Change colour of italic characters to Pt
- Ps = 705 Change background pixmap tint colour to Pt (Compile transparency).
- Ps = 706 Change colour of bold characters to Pt
- Ps = 707 Change colour of underlined characters to Pt
- Ps = 710 Set normal fontset to Pt. Same as Ps = 50.
- Ps = 711 Set bold fontset to Pt. Similar to Ps = 50 (Compile styles).
- Ps = 712 Set italic fontset to Pt. Similar to Ps = 50 (Compile styles).
- Ps = 713 Set bold-italic fontset to Pt. Similar to Ps = 50 (Compile styles).
- Ps = 720 Move viewing window up by Pt lines, or clear scrollback buffer if Pt = 0 (Compile frills).
- Ps = 721 Move viewing window down by Pt lines, or clear scrollback buffer if Pt = 0 (Compile frills).
- Ps = 777 Call the perl extension with the given string, which should be of the form extension:parameters (Compile perl).
+ Ps = 0 Change Icon Name and Window Title to Pt
+ Ps = 1 Change Icon Name to Pt
+ Ps = 2 Change Window Title to Pt
+ Ps = 3 If Pt starts with a ?, query the (STRING) property of the window and return it. If Pt contains a =, set the named property to the given value, else delete the specified property.
+ Ps = 4 Pt is a semi-colon separated sequence of one or more semi-colon separated number/name pairs, where number is an index to a colour and name is the name of a colour. Each pair causes the numbered colour to be changed to name. Numbers 0-7 corresponds to low-intensity (normal) colours and 8-15 corresponds to high-intensity colours. 0=black, 1=red, 2=green, 3=yellow, 4=blue, 5=magenta, 6=cyan, 7=white
+ Ps = 10 Change colour of text foreground to Pt (NB: may change in future)
+ Ps = 11 Change colour of text background to Pt (NB: may change in future)
+ Ps = 12 Change colour of text cursor foreground to Pt
+ 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 = 39 Change default foreground colour to Pt.
+ Ps = 46 Change Log File to Pt unimplemented
+ Ps = 49 Change default background colour to Pt.
+ Ps = 50 Set fontset to Pt, with the following special values of Pt (rxvt) #+n change up n #-n change down n if n is missing of 0, a value of 1 is used empty change to font0 n change to font n
+ Ps = 55 Log all scrollback buffer and all of screen to Pt
+ Ps = 701 Change current locale to Pt, or, if Pt is ?, return the current locale (Compile frills).
+ Ps = 702 Request version if Pt is ?, returning rxvt-unicode, the resource name, the major and minor version numbers, e.g. ESC ] 702 ; rxvt-unicode ; urxvt ; 7 ; 4 ST.
+ Ps = 704 Change colour of italic characters to Pt
+ Ps = 705 Change background pixmap tint colour to Pt (Compile transparency).
+ Ps = 706 Change colour of bold characters to Pt
+ Ps = 707 Change colour of underlined characters to Pt
+ Ps = 710 Set normal fontset to Pt. Same as Ps = 50.
+ Ps = 711 Set bold fontset to Pt. Similar to Ps = 50 (Compile styles).
+ Ps = 712 Set italic fontset to Pt. Similar to Ps = 50 (Compile styles).
+ Ps = 713 Set bold-italic fontset to Pt. Similar to Ps = 50 (Compile styles).
+ Ps = 720 Move viewing window up by Pt lines, or clear scrollback buffer if Pt = 0 (Compile frills).
+ Ps = 721 Move viewing window down by Pt lines, or clear scrollback buffer if Pt = 0 (Compile frills).
+ Ps = 777 Call the perl extension with the given string, which should be of the form extension:parameters (Compile perl).
+
XPM
For the XPM XTerm escape sequence "ESC ] 20 ; Pt ST" then value of "Pt"
can be the name of the background pixmap followed by a sequence of
The lower 2 bits of "<b>" indicate the button:
- 0 Button1 pressed
- 1 Button2 pressed
- 2 Button3 pressed
- 3 button released (X11 mouse report)
Button = "(<b> - SPACE) & 3"
+ 0 Button1 pressed
+ 1 Button2 pressed
+ 2 Button3 pressed
+ 3 button released (X11 mouse report)
The upper bits of "<b>" indicate the modifiers when the button was
pressed and are added together (X11 mouse report only):
- 4 Shift
- 8 Meta
- 16 Control
- 32 Double Click (rxvt extension)
State = "(<b> - SPACE) & 60"
+ 4 Shift
+ 8 Meta
+ 16 Control
+ 32 Double Click (rxvt extension)
+
Col = "<x> - SPACE"
Row = "<y> - SPACE"
off, toggle Application-Keypad setting. Also note that values of Home,
End, Delete may have been compiled differently on your system.
- Normal Shift Control Ctrl+Shift
- Tab ^I ESC [ Z ^I ESC [ Z
- BackSpace ^H ^? ^? ^?
- Find ESC [ 1 ~ ESC [ 1 $ ESC [ 1 ^ ESC [ 1 @
- Insert ESC [ 2 ~ paste ESC [ 2 ^ ESC [ 2 @
- Execute ESC [ 3 ~ ESC [ 3 $ ESC [ 3 ^ ESC [ 3 @
- Select ESC [ 4 ~ ESC [ 4 $ ESC [ 4 ^ ESC [ 4 @
- Prior ESC [ 5 ~ scroll-up ESC [ 5 ^ ESC [ 5 @
- Next ESC [ 6 ~ scroll-down ESC [ 6 ^ ESC [ 6 @
- Home ESC [ 7 ~ ESC [ 7 $ ESC [ 7 ^ ESC [ 7 @
- End ESC [ 8 ~ ESC [ 8 $ ESC [ 8 ^ ESC [ 8 @
- Delete ESC [ 3 ~ ESC [ 3 $ ESC [ 3 ^ ESC [ 3 @
- F1 ESC [ 11 ~ ESC [ 23 ~ ESC [ 11 ^ ESC [ 23 ^
- F2 ESC [ 12 ~ ESC [ 24 ~ ESC [ 12 ^ ESC [ 24 ^
- F3 ESC [ 13 ~ ESC [ 25 ~ ESC [ 13 ^ ESC [ 25 ^
- F4 ESC [ 14 ~ ESC [ 26 ~ ESC [ 14 ^ ESC [ 26 ^
- F5 ESC [ 15 ~ ESC [ 28 ~ ESC [ 15 ^ ESC [ 28 ^
- F6 ESC [ 17 ~ ESC [ 29 ~ ESC [ 17 ^ ESC [ 29 ^
- F7 ESC [ 18 ~ ESC [ 31 ~ ESC [ 18 ^ ESC [ 31 ^
- F8 ESC [ 19 ~ ESC [ 32 ~ ESC [ 19 ^ ESC [ 32 ^
- F9 ESC [ 20 ~ ESC [ 33 ~ ESC [ 20 ^ ESC [ 33 ^
- F10 ESC [ 21 ~ ESC [ 34 ~ ESC [ 21 ^ ESC [ 34 ^
- F11 ESC [ 23 ~ ESC [ 23 $ ESC [ 23 ^ ESC [ 23 @
- F12 ESC [ 24 ~ ESC [ 24 $ ESC [ 24 ^ ESC [ 24 @
- F13 ESC [ 25 ~ ESC [ 25 $ ESC [ 25 ^ ESC [ 25 @
- F14 ESC [ 26 ~ ESC [ 26 $ ESC [ 26 ^ ESC [ 26 @
- F15 (Help) ESC [ 28 ~ ESC [ 28 $ ESC [ 28 ^ ESC [ 28 @
- F16 (Menu) ESC [ 29 ~ ESC [ 29 $ ESC [ 29 ^ ESC [ 29 @
- F17 ESC [ 31 ~ ESC [ 31 $ ESC [ 31 ^ ESC [ 31 @
- F18 ESC [ 32 ~ ESC [ 32 $ ESC [ 32 ^ ESC [ 32 @
- F19 ESC [ 33 ~ ESC [ 33 $ ESC [ 33 ^ ESC [ 33 @
- F20 ESC [ 34 ~ ESC [ 34 $ ESC [ 34 ^ ESC [ 34 @
- Application
- Up ESC [ A ESC [ a ESC O a ESC O A
- Down ESC [ B ESC [ b ESC O b ESC O B
- Right ESC [ C ESC [ c ESC O c ESC O C
- Left ESC [ D ESC [ d ESC O d ESC O D
- KP_Enter ^M ESC O M
- KP_F1 ESC O P ESC O P
- KP_F2 ESC O Q ESC O Q
- KP_F3 ESC O R ESC O R
- KP_F4 ESC O S ESC O S
- XK_KP_Multiply * ESC O j
- XK_KP_Add + ESC O k
- XK_KP_Separator , ESC O l
- XK_KP_Subtract - ESC O m
- XK_KP_Decimal . ESC O n
- XK_KP_Divide / ESC O o
- XK_KP_0 0 ESC O p
- XK_KP_1 1 ESC O q
- XK_KP_2 2 ESC O r
- XK_KP_3 3 ESC O s
- XK_KP_4 4 ESC O t
- XK_KP_5 5 ESC O u
- XK_KP_6 6 ESC O v
- XK_KP_7 7 ESC O w
- XK_KP_8 8 ESC O x
- XK_KP_9 9 ESC O y
+ Normal Shift Control Ctrl+Shift
+ Tab ^I ESC [ Z ^I ESC [ Z
+ BackSpace ^H ^? ^? ^?
+ Find ESC [ 1 ~ ESC [ 1 $ ESC [ 1 ^ ESC [ 1 @
+ Insert ESC [ 2 ~ paste ESC [ 2 ^ ESC [ 2 @
+ Execute ESC [ 3 ~ ESC [ 3 $ ESC [ 3 ^ ESC [ 3 @
+ Select ESC [ 4 ~ ESC [ 4 $ ESC [ 4 ^ ESC [ 4 @
+ Prior ESC [ 5 ~ scroll-up ESC [ 5 ^ ESC [ 5 @
+ Next ESC [ 6 ~ scroll-down ESC [ 6 ^ ESC [ 6 @
+ Home ESC [ 7 ~ ESC [ 7 $ ESC [ 7 ^ ESC [ 7 @
+ End ESC [ 8 ~ ESC [ 8 $ ESC [ 8 ^ ESC [ 8 @
+ Delete ESC [ 3 ~ ESC [ 3 $ ESC [ 3 ^ ESC [ 3 @
+ F1 ESC [ 11 ~ ESC [ 23 ~ ESC [ 11 ^ ESC [ 23 ^
+ F2 ESC [ 12 ~ ESC [ 24 ~ ESC [ 12 ^ ESC [ 24 ^
+ F3 ESC [ 13 ~ ESC [ 25 ~ ESC [ 13 ^ ESC [ 25 ^
+ F4 ESC [ 14 ~ ESC [ 26 ~ ESC [ 14 ^ ESC [ 26 ^
+ F5 ESC [ 15 ~ ESC [ 28 ~ ESC [ 15 ^ ESC [ 28 ^
+ F6 ESC [ 17 ~ ESC [ 29 ~ ESC [ 17 ^ ESC [ 29 ^
+ F7 ESC [ 18 ~ ESC [ 31 ~ ESC [ 18 ^ ESC [ 31 ^
+ F8 ESC [ 19 ~ ESC [ 32 ~ ESC [ 19 ^ ESC [ 32 ^
+ F9 ESC [ 20 ~ ESC [ 33 ~ ESC [ 20 ^ ESC [ 33 ^
+ F10 ESC [ 21 ~ ESC [ 34 ~ ESC [ 21 ^ ESC [ 34 ^
+ F11 ESC [ 23 ~ ESC [ 23 $ ESC [ 23 ^ ESC [ 23 @
+ F12 ESC [ 24 ~ ESC [ 24 $ ESC [ 24 ^ ESC [ 24 @
+ F13 ESC [ 25 ~ ESC [ 25 $ ESC [ 25 ^ ESC [ 25 @
+ F14 ESC [ 26 ~ ESC [ 26 $ ESC [ 26 ^ ESC [ 26 @
+ F15 (Help) ESC [ 28 ~ ESC [ 28 $ ESC [ 28 ^ ESC [ 28 @
+ F16 (Menu) ESC [ 29 ~ ESC [ 29 $ ESC [ 29 ^ ESC [ 29 @
+ F17 ESC [ 31 ~ ESC [ 31 $ ESC [ 31 ^ ESC [ 31 @
+ F18 ESC [ 32 ~ ESC [ 32 $ ESC [ 32 ^ ESC [ 32 @
+ F19 ESC [ 33 ~ ESC [ 33 $ ESC [ 33 ^ ESC [ 33 @
+ F20 ESC [ 34 ~ ESC [ 34 $ ESC [ 34 ^ ESC [ 34 @
+ Application
+ Up ESC [ A ESC [ a ESC O a ESC O A
+ Down ESC [ B ESC [ b ESC O b ESC O B
+ Right ESC [ C ESC [ c ESC O c ESC O C
+ Left ESC [ D ESC [ d ESC O d ESC O D
+ KP_Enter ^M ESC O M
+ KP_F1 ESC O P ESC O P
+ KP_F2 ESC O Q ESC O Q
+ KP_F3 ESC O R ESC O R
+ KP_F4 ESC O S ESC O S
+ XK_KP_Multiply * ESC O j
+ XK_KP_Add + ESC O k
+ XK_KP_Separator , ESC O l
+ XK_KP_Subtract - ESC O m
+ XK_KP_Decimal . ESC O n
+ XK_KP_Divide / ESC O o
+ XK_KP_0 0 ESC O p
+ XK_KP_1 1 ESC O q
+ XK_KP_2 2 ESC O r
+ XK_KP_3 3 ESC O s
+ XK_KP_4 4 ESC O t
+ XK_KP_5 5 ESC O u
+ XK_KP_6 6 ESC O v
+ XK_KP_7 7 ESC O w
+ XK_KP_8 8 ESC O x
+ XK_KP_9 9 ESC O y
+
CONFIGURE OPTIONS
General hint: if you get compile errors, then likely your configuration
hasn't been tested well. Either try with "--enable-everything" or use
about 700kB), but it doesn't increase memory usage unless you use a
font requiring one of these encodings.
- all all available codeset groups
- zh common chinese encodings
- zh_ext rarely used but very big chinese encodigs
- jp common japanese encodings
- jp_ext rarely used but big japanese encodings
- kr korean encodings
+ all all available codeset groups
+ zh common chinese encodings
+ zh_ext rarely used but very big chinese encodigs
+ jp common japanese encodings
+ jp_ext rarely used but big japanese encodings
+ kr korean encodings
+
--enable-xim (default: on)
Add support for XIM (X Input Method) protocol. This allows using
alternative input methods (e.g. kinput2) and will also correctly set
Geoff Wing <gcw@pobox.com>, who in turn used the XTerm documentation and
other sources.
-POD ERRORS
- Hey! The above document had some coding errors, which are explained
- below:
-
- Around line 2952:
- =back doesn't take any parameters, but you said =back X<Mouse>
-
- Around line 3048:
- =back doesn't take any parameters, but you said =back X<KeyCodes>
-
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
-<title>urxvtd - urxvt terminal daemon</title>
+<title>rxvtd - rxvt terminal daemon</title>
<meta http-equiv="content-type" content="text/html; charset=utf-8" />
<link rev="made" href="mailto:perl-binary@plan9.de" />
</head>
<p>
</p>
<h1><a name="name">NAME</a></h1>
-<p>urxvtd - urxvt terminal daemon</p>
+<p>rxvtd - rxvt terminal daemon</p>
<p>
</p>
<hr />
<h1><a name="synopsis">SYNOPSIS</a></h1>
-<p><strong>urxvtd</strong> [-q|--quiet] [-o|--opendisplay] [-f|--fork]</p>
+<p><strong>rxvtd</strong> [-q|--quiet] [-o|--opendisplay] [-f|--fork]</p>
<p>
</p>
<hr />
<h1><a name="description">DESCRIPTION</a></h1>
-<p>This manpage describes the urxvtd daemon, which is the same vt102
-terminal emulator as urxvt, but runs as a daemon that can open
+<p>This manpage describes the rxvtd daemon, which is the same vt102
+terminal emulator as rxvt, but runs as a daemon that can open
multiple terminal windows within the same process.</p>
<p>You can run it from your X startup scripts, for example, although it is
not dependent on a working DISPLAY and, in fact, can open windows on
multiple X displays on the same time.</p>
-<p>Advantages of running a urxvt daemon include faster creation time
+<p>Advantages of running a rxvt daemon include faster creation time
for terminal windows and a lot of saved memory.</p>
<p>The disadvantage is a possible impact on stability - if the
main program crashes, all processes in the terminal windows are
terminated. For example, as there is no way to cleanly react to abnormal
connection closes, <code>xkill</code> and server resets/restarts will kill the
-<strong>urxvtd</strong> instance including all windows it has opened.</p>
+<strong>rxvtd</strong> instance including all windows it has opened.</p>
<p>
</p>
<hr />
<h1><a name="options">OPTIONS</a></h1>
-<p><strong>urxvtd</strong> currently understands a few options only. Bundling of
+<p><strong>rxvtd</strong> currently understands a few options only. Bundling of
options is not yet supported.</p>
<dl>
<dt><strong><a name="item__2dq_2c__2d_2dquiet"><strong>-q</strong>, <strong>--quiet</strong></a></strong>
<dd>
-<p>Normally, <strong>urxvtd</strong> outputs the message <code>rxvt-unicode daemon
+<p>Normally, <strong>rxvtd</strong> outputs the message <code>rxvt-unicode daemon
listening on <path></code> after binding to its control socket. This option
will suppress this message (errors and warnings will still be logged).</p>
</dd>
<dt><strong><a name="item__2do_2c__2d_2dopendisplay"><strong>-o</strong>, <strong>--opendisplay</strong></a></strong>
<dd>
-<p>This forces <strong>urxvtd</strong> to open a connection to the current
+<p>This forces <strong>rxvtd</strong> to open a connection to the current
<code>$DISPLAY</code> and keep it open.</p>
</dd>
<dd>
-<p>This is useful if you want to bind an instance of <strong>urxvtd</strong> to
+<p>This is useful if you want to bind an instance of <strong>rxvtd</strong> to
the lifetime of a specific display/server. If the server does a reset,
-<strong>urxvtd</strong> will be killed automatically.</p>
+<strong>rxvtd</strong> will be killed automatically.</p>
</dd>
</li>
<dt><strong><a name="item__2df_2c__2d_2dfork"><strong>-f</strong>, <strong>--fork</strong></a></strong>
<dd>
-<p>This makes <strong>urxvtd</strong> fork after it has bound itself to its control
+<p>This makes <strong>rxvtd</strong> fork after it has bound itself to its control
socket.</p>
</dd>
</li>
</p>
<hr />
<h1><a name="examples">EXAMPLES</a></h1>
-<p>This is a useful invocation of <strong>urxvtd</strong> in a <em>.xsession</em>-style
+<p>This is a useful invocation of <strong>rxvtd</strong> in a <em>.xsession</em>-style
script:</p>
<pre>
- B<urxvtd> -q -f -o</pre>
+ rxvtd -q -f -o</pre>
<p>This waits till the control socket is available, opens the current display
and forks into the background. When you log-out, the server is reset and
-<strong>urxvtd</strong> is killed.</p>
+<strong>rxvtd</strong> is killed.</p>
<p>
</p>
<hr />
<dt><strong><a name="item_rxvt_socket"><strong>RXVT_SOCKET</strong></a></strong>
<dd>
-<p>Both <strong>urxvtc</strong> and <strong>urxvtd</strong> use the environment
+<p>Both <strong>rxvtc</strong> and <strong>rxvtd</strong> use the environment
variable <em>RXVT_SOCKET</em> to create a listening socket and to contact
-the urxvtd, respectively. If the variable is missing,
+the rxvtd, respectively. If the variable is missing,
<em>$HOME/.rxvt-unicode-<em><nodename</em> </em>> >>> is used. The variable must
specify the absolute path of the socket to create.</p>
</dd>
</p>
<hr />
<h1><a name="see_also">SEE ALSO</a></h1>
-<p>urxvt(7), <code>urxvtc(1)</code></p>
+<p>rxvt(7), <code>rxvtc(1)</code></p>
</body>
-.\" Automatically generated by Pod::Man 2.09 (Pod::Simple 3.04)
+.\" Automatically generated by Pod::Man v1.37, Pod::Parser v1.32
.\"
.\" Standard preamble:
.\" ========================================================================
.\" ========================================================================
.\"
.IX Title "@@RXVT_NAME@@ 1"
-.TH @@RXVT_NAME@@ 1 "2006-07-17" "7.8" "RXVT-UNICODE"
+.TH @@RXVT_NAME@@ 1 "2006-11-02" "8.0" "RXVT-UNICODE"
.SH "NAME"
@@RXVT_NAME@@d \- @@RXVT_NAME@@ terminal daemon
.SH "SYNOPSIS"
script:
.PP
.Vb 1
-\& B<@@RXVT_NAME@@d> \-q \-f \-o
+\& @@RXVT_NAME@@d -q -f -o
.Ve
.PP
This waits till the control socket is available, opens the current display
Both \fB@@RXVT_NAME@@c\fR and \fB@@RXVT_NAME@@d\fR use the environment
variable \fI\s-1RXVT_SOCKET\s0\fR to create a listening socket and to contact
the @@RXVT_NAME@@d, respectively. If the variable is missing,
-\&\fI\f(CI$HOME\fI/.rxvt\-unicode\-\fI<nodename>\fI\fR is used. The variable must
+\&\fI$HOME/.rxvt\-unicode\-\fI<nodename>\fI\fR is used. The variable must
specify the absolute path of the socket to create.
.IP "\fB\s-1DISPLAY\s0\fR" 4
.IX Item "DISPLAY"
Only used when the \f(CW\*(C`\-\-opendisplay\*(C'\fR option is specified. Must contain a
valid X display name.
.RS 4
-.RE
-.RS 4
-.RE
.SH "SEE ALSO"
.IX Header "SEE ALSO"
+.RS 4
@@RXVT_NAME@@(7), @@RXVT_NAME@@c(1)
-.SH "POD ERRORS"
-.IX Header "POD ERRORS"
-Hey! \fBThe above document had some coding errors, which are explained below:\fR
-.IP "Around line 87:" 4
-.IX Item "Around line 87:"
-You forgot a '=back' before '=head1'
-.Sp
-You forgot a '=back' before '=head1'
NAME
- urxvtd - urxvt terminal daemon
+ rxvtd - rxvt terminal daemon
SYNOPSIS
- urxvtd [-q|--quiet] [-o|--opendisplay] [-f|--fork]
+ rxvtd [-q|--quiet] [-o|--opendisplay] [-f|--fork]
DESCRIPTION
- This manpage describes the urxvtd daemon, which is the same vt102
- terminal emulator as urxvt, but runs as a daemon that can open multiple
+ This manpage describes the rxvtd daemon, which is the same vt102
+ terminal emulator as rxvt, but runs as a daemon that can open multiple
terminal windows within the same process.
You can run it from your X startup scripts, for example, although it is
not dependent on a working DISPLAY and, in fact, can open windows on
multiple X displays on the same time.
- Advantages of running a urxvt daemon include faster creation time for
+ Advantages of running a rxvt daemon include faster creation time for
terminal windows and a lot of saved memory.
The disadvantage is a possible impact on stability - if the main program
crashes, all processes in the terminal windows are terminated. For
example, as there is no way to cleanly react to abnormal connection
- closes, "xkill" and server resets/restarts will kill the urxvtd instance
+ closes, "xkill" and server resets/restarts will kill the rxvtd instance
including all windows it has opened.
OPTIONS
- urxvtd currently understands a few options only. Bundling of options is
+ rxvtd currently understands a few options only. Bundling of options is
not yet supported.
-q, --quiet
- Normally, urxvtd outputs the message "rxvt-unicode daemon listening
+ Normally, rxvtd outputs the message "rxvt-unicode daemon listening
on <path>" after binding to its control socket. This option will
suppress this message (errors and warnings will still be logged).
-o, --opendisplay
- This forces urxvtd to open a connection to the current $DISPLAY and
+ This forces rxvtd to open a connection to the current $DISPLAY and
keep it open.
- This is useful if you want to bind an instance of urxvtd to the
+ This is useful if you want to bind an instance of rxvtd to the
lifetime of a specific display/server. If the server does a reset,
- urxvtd will be killed automatically.
+ rxvtd will be killed automatically.
-f, --fork
- This makes urxvtd fork after it has bound itself to its control
+ This makes rxvtd fork after it has bound itself to its control
socket.
EXAMPLES
- This is a useful invocation of urxvtd in a .xsession-style script:
+ This is a useful invocation of rxvtd in a .xsession-style script:
- B<urxvtd> -q -f -o
+ rxvtd -q -f -o
This waits till the control socket is available, opens the current
display and forks into the background. When you log-out, the server is
- reset and urxvtd is killed.
+ reset and rxvtd is killed.
ENVIRONMENT
RXVT_SOCKET
- Both urxvtc and urxvtd use the environment variable RXVT_SOCKET to
- create a listening socket and to contact the urxvtd, respectively.
- If the variable is missing, $HOME/.rxvt-unicode-*<nodename>* is
- used. The variable must specify the absolute path of the socket to
- create.
+ Both rxvtc and rxvtd use the environment variable RXVT_SOCKET to
+ create a listening socket and to contact the rxvtd, respectively. If
+ the variable is missing, $HOME/.rxvt-unicode-*<nodename>* is used.
+ The variable must specify the absolute path of the socket to create.
DISPLAY
Only used when the "--opendisplay" option is specified. Must contain
a valid X display name.
SEE ALSO
- urxvt(7), urxvtc(1)
-
-POD ERRORS
- Hey! The above document had some coding errors, which are explained
- below:
-
- Around line 87:
- You forgot a '=back' before '=head1'
-
- You forgot a '=back' before '=head1'
+ rxvt(7), rxvtc(1)
indices.</p>
</dd>
</li>
-<dt><strong><a name="item_mark_2durls">mark-urls</a></strong>
+<dt><strong><a name="item_matcher">matcher</a></strong>
<dd>
-<p>Uses per-line display filtering (<code>on_line_update</code>) to underline urls and
-make them clickable. When middle-clicked, the program specified in the
-resource <code>urlLauncher</code> (default <code>x-www-browser</code>) will be started with
-the URL as first argument.</p>
+<p>Uses per-line display filtering (<code>on_line_update</code>) to underline text
+matching a certain pattern and make it clickable. When clicked with the
+mouse button specified in the <code>matcher.button</code> resource (default 2, or
+middle), the program specified in the <code>matcher.launcher</code> resource
+(default, the <code>urlLauncher</code> resource, <code>sensible-browser</code>) will be started
+with the matched text as first argument. The default configuration is
+suitable for matching URLs and launching a web browser, like the
+former ``mark-urls'' extension.</p>
+</dd>
+<dd>
+<p>The default pattern to match URLs can be overridden with the
+<code>matcher.pattern.0</code> resource, and additional patterns can be specified
+with numbered patterns, in a manner similar to the ``selection'' extension.
+The launcher can also be overridden on a per-pattern basis.</p>
+</dd>
+<dd>
+<p>Example configuration:</p>
+</dd>
+<dd>
+<pre>
+ URxvt.perl-ext: default,matcher
+ URxvt.urlLauncher: sensible-browser
+ URxvt.matcher.button: 1
+ URxvt.matcher.pattern.1: \\bwww\\.[\\w-]+\\.[\\w./?&@#-]*[\\w/-]
+ URxvt.matcher.pattern.2: \\B(/\\S+?):(\\d+)(?=:|$)
+ URxvt.matcher.launcher.2: gvim +$2 $1</pre>
</dd>
</li>
<dt><strong><a name="item_xim_2donthespot">xim-onthespot</a></strong>
<pre>
URxvt.selection-pastebin.url: <a href="http://www.ta-sa.org/files/txt/%">http://www.ta-sa.org/files/txt/%</a></pre>
</dd>
+<dd>
+<p><em>Note to xrdb users:</em> xrdb uses the C preprocessor, which might interpret
+the double <code>/</code> characters as comment start. Use <code>\057\057</code> instead,
+which works regardless of wether xrdb is used to parse the resource file
+or not.</p>
+</dd>
</li>
<dt><strong><a name="item_example_2drefresh_2dhooks">example-refresh-hooks</a></strong>
</p>
<h2><a name="extension_objects">Extension Objects</a></h2>
<p>Every perl extension is a perl class. A separate perl object is created
-for each terminal and each extension and passed as the first parameter to
-hooks. So extensions can use their <code>$self</code> object without having to think
-about other extensions, with the exception of methods and members that
-begin with an underscore character <code>_</code>: these are reserved for internal
-use.</p>
+for each terminal, and each terminal has its own set of extenion objects,
+which are passed as the first parameter to hooks. So extensions can use
+their <code>$self</code> object without having to think about clashes with other
+extensions or other terminals, with the exception of methods and members
+that begin with an underscore character <code>_</code>: these are reserved for
+internal use.</p>
<p>Although it isn't a <code>urxvt::term</code> object, you can call all methods of the
<code>urxvt::term</code> class on this object.</p>
<p>It has the following methods and data members:</p>
-.\" Automatically generated by Pod::Man 2.09 (Pod::Simple 3.04)
+.\" Automatically generated by Pod::Man v1.37, Pod::Parser v1.32
.\"
.\" Standard preamble:
.\" ========================================================================
.\" ========================================================================
.\"
.IX Title "@@RXVT_NAME@@ 3"
-.TH @@RXVT_NAME@@ 3 "2006-08-07" "7.9" "RXVT-UNICODE"
+.TH @@RXVT_NAME@@ 3 "2006-11-02" "8.0" "RXVT-UNICODE"
.SH "NAME"
@@RXVT_NAME@@perl \- rxvt\-unicode's embedded perl interpreter
.SH "SYNOPSIS"
.IX Header "SYNOPSIS"
.Vb 1
\& # create a file grab_test in $HOME:
-\&
+.Ve
+.PP
+.Vb 4
\& sub on_sel_grab {
-\& warn "you selected ", $_[0]\->selection;
+\& warn "you selected ", $_[0]->selection;
\& ()
\& }
-\&
+.Ve
+.PP
+.Vb 1
\& # start a @@RXVT_NAME@@ using it:
-\&
-\& @@RXVT_NAME@@ \-\-perl\-lib $HOME \-pe grab_test
+.Ve
+.PP
+.Vb 1
+\& @@RXVT_NAME@@ --perl-lib $HOME -pe grab_test
.Ve
.SH "DESCRIPTION"
.IX Header "DESCRIPTION"
You can activate them like this:
.PP
.Vb 1
-\& @@RXVT_NAME@@ \-pe <extensionname>
+\& @@RXVT_NAME@@ -pe <extensionname>
.Ve
.PP
Or by adding them to the resource for extensions loaded by default:
.PP
.Vb 1
-\& URxvt.perl\-ext\-common: default,automove\-background,selection\-autotransform
+\& URxvt.perl-ext-common: default,automove-background,selection-autotransform
.Ve
.IP "selection (enabled by default)" 4
.IX Item "selection (enabled by default)"
specifying resources of the form:
.Sp
.Vb 3
-\& URxvt.selection.pattern\-0: perl\-regex
-\& URxvt.selection.pattern\-1: perl\-regex
+\& URxvt.selection.pattern-0: perl-regex
+\& URxvt.selection.pattern-1: perl-regex
\& ...
.Ve
.Sp
between two vertical bars:
.Sp
.Vb 1
-\& URxvt.selection.pattern\-0: \e\e|([^|]+)\e\e|
+\& URxvt.selection.pattern-0: \e\e|([^|]+)\e\e|
.Ve
.Sp
Another example: Programs I use often output \*(L"absolute path: \*(R" at the
end):
.Sp
.Vb 1
-\& URxvt.selection.pattern\-0: ^(/[^:]+):\e
+\& URxvt.selection.pattern-0: ^(/[^:]+):\e
.Ve
.Sp
You can look at the source of the selection extension to see more
Rot\-13 the selection when activated. Used via keyboard trigger:
.Sp
.Vb 1
-\& URxvt.keysym.C\-M\-r: perl:selection:rot13
+\& URxvt.keysym.C-M-r: perl:selection:rot13
.Ve
.RE
.RS 4
\&\f(CW\*(C`$self\-\*(C'\fR{myoption}>:
.Sp
.Vb 3
-\& push @{ $self\->{term}{option_popup_hook} }, sub {
-\& ("my option" => $myoption, sub { $self\->{myoption} = $_[0] })
+\& push @{ $self->{term}{option_popup_hook} }, sub {
+\& ("my option" => $myoption, sub { $self->{myoption} = $_[0] })
\& };
.Ve
.IP "selection-popup (enabled by default)" 4
\&\f(CW\*(C`a\*(C'\fRs:
.Sp
.Vb 4
-\& push @{ $self\->{term}{selection_popup_hook} }, sub {
+\& push @{ $self->{term}{selection_popup_hook} }, sub {
\& /a/ ? ("a to be" => sub { s/a/b/g }
\& : ()
\& };
operator) that modify \f(CW$_\fR as resources:
.Sp
.Vb 3
-\& URxvt.selection\-autotransform.0: transform
-\& URxvt.selection\-autotransform.1: transform
+\& URxvt.selection-autotransform.0: transform
+\& URxvt.selection-autotransform.1: transform
\& ...
.Ve
.Sp
$word\*(C'\fR:
.Sp
.Vb 1
-\& URxvt.selection\-autotransform.0: s/^([^:[:space:]]+):(\e\ed+):?$/vi +$2 \e\eQ$1\e\eE\e\ex0d/
+\& URxvt.selection-autotransform.0: s/^([^:[:space:]]+):(\e\ed+):?$/vi +$2 \e\eQ$1\e\eE\e\ex0d/
.Ve
.Sp
And this example matches the same,but replaces it with vi-commands you can
paste directly into your (vi :) editor:
.Sp
.Vb 1
-\& URxvt.selection\-autotransform.0: s/^([^:[:space:]]+(\e\ed+):?$/:e \e\eQ$1\e\eE\e\ex0d:$2\e\ex0d/
+\& URxvt.selection-autotransform.0: s/^([^:[:space:]]+(\e\ed+):?$/:e \e\eQ$1\e\eE\e\ex0d:$2\e\ex0d/
.Ve
.Sp
Of course, this can be modified to suit your needs and your editor :)
\&\s-1FILENAME\s0 line \s-1YYY\s0.\*(R"), you need a slightly more elaborate solution:
.Sp
.Vb 2
-\& URxvt.selection.pattern\-0: ( at .*? line \e\ed+[,.])
-\& URxvt.selection\-autotransform.0: s/^ at (.*?) line (\e\ed+)[,.]$/:e \e\eQ$1\eE\e\ex0d:$2\e\ex0d/
+\& URxvt.selection.pattern-0: ( at .*? line \e\ed+[,.])
+\& URxvt.selection-autotransform.0: s/^ at (.*?) line (\e\ed+)[,.]$/:e \e\eQ$1\eE\e\ex0d:$2\e\ex0d/
.Ve
.Sp
The first line tells the selection code to treat the unchanging part of
following four resources (shown with defaults):
.Sp
.Vb 4
-\& URxvt.tabbed.tabbar\-fg: <colour\-index, default 3>
-\& URxvt.tabbed.tabbar\-bg: <colour\-index, default 0>
-\& URxvt.tabbed.tab\-fg: <colour\-index, default 0>
-\& URxvt.tabbed.tab\-bg: <colour\-index, default 1>
+\& URxvt.tabbed.tabbar-fg: <colour-index, default 3>
+\& URxvt.tabbed.tabbar-bg: <colour-index, default 0>
+\& URxvt.tabbed.tab-fg: <colour-index, default 0>
+\& URxvt.tabbed.tab-bg: <colour-index, default 1>
.Ve
.Sp
See \fI\s-1COLOR\s0 \s-1AND\s0 \s-1GRAPHICS\s0\fR in the @@RXVT_NAME@@(1) manpage for valid
indices.
-.IP "mark-urls" 4
-.IX Item "mark-urls"
-Uses per-line display filtering (\f(CW\*(C`on_line_update\*(C'\fR) to underline urls and
-make them clickable. When middle\-clicked, the program specified in the
-resource \f(CW\*(C`urlLauncher\*(C'\fR (default \f(CW\*(C`x\-www\-browser\*(C'\fR) will be started with
-the \s-1URL\s0 as first argument.
+.IP "matcher" 4
+.IX Item "matcher"
+Uses per-line display filtering (\f(CW\*(C`on_line_update\*(C'\fR) to underline text
+matching a certain pattern and make it clickable. When clicked with the
+mouse button specified in the \f(CW\*(C`matcher.button\*(C'\fR resource (default 2, or
+middle), the program specified in the \f(CW\*(C`matcher.launcher\*(C'\fR resource
+(default, the \f(CW\*(C`urlLauncher\*(C'\fR resource, \f(CW\*(C`sensible\-browser\*(C'\fR) will be started
+with the matched text as first argument. The default configuration is
+suitable for matching URLs and launching a web browser, like the
+former \*(L"mark\-urls\*(R" extension.
+.Sp
+The default pattern to match URLs can be overridden with the
+\&\f(CW\*(C`matcher.pattern.0\*(C'\fR resource, and additional patterns can be specified
+with numbered patterns, in a manner similar to the \*(L"selection\*(R" extension.
+The launcher can also be overridden on a per-pattern basis.
+.Sp
+Example configuration:
+.Sp
+.Vb 6
+\& URxvt.perl-ext: default,matcher
+\& URxvt.urlLauncher: sensible-browser
+\& URxvt.matcher.button: 1
+\& URxvt.matcher.pattern.1: \e\ebwww\e\e.[\e\ew-]+\e\e.[\e\ew./?&@#-]*[\e\ew/-]
+\& URxvt.matcher.pattern.2: \e\eB(/\e\eS+?):(\e\ed+)(?=:|$)
+\& URxvt.matcher.launcher.2: gvim +$2 $1
+.Ve
.IP "xim-onthespot" 4
.IX Item "xim-onthespot"
This (experimental) perl extension implements OnTheSpot editing. It does
\&\f(CW\*(C`OnTheSpot\*(C'\fR, i.e.:
.Sp
.Vb 1
-\& @@RXVT_NAME@@ \-pt OnTheSpot \-pe xim\-onthespot
+\& @@RXVT_NAME@@ -pt OnTheSpot -pe xim-onthespot
.Ve
.IP "kuake<hotkey>" 4
.IX Item "kuake<hotkey>"
supported in this mode. Example:
.Sp
.Vb 1
-\& @@RXVT_NAME@@ \-pixmap background.xpm \-pe automove\-background
+\& @@RXVT_NAME@@ -pixmap background.xpm -pe automove-background
.Ve
.IP "block-graphics-to-ascii" 4
.IX Item "block-graphics-to-ascii"
The defaults (which are likely useless to you) use rsh and cat:
.Sp
.Vb 2
-\& URxvt.remote\-selection.store: rsh ruth 'cat >/tmp/distributed\-selection'
-\& URxvt.remote\-selection.fetch: rsh ruth 'cat /tmp/distributed\-selection'
+\& URxvt.remote-selection.store: rsh ruth 'cat >/tmp/distributed-selection'
+\& URxvt.remote-selection.fetch: rsh ruth 'cat /tmp/distributed-selection'
.Ve
.IP "selection-pastebin" 4
.IX Item "selection-pastebin"
i.e.
.Sp
.Vb 1
-\& URxvt.keysym.C\-M\-e: perl:selection\-pastebin:remote\-pastebin
+\& URxvt.keysym.C-M-e: perl:selection-pastebin:remote-pastebin
.Ve
.Sp
Pressing this combination runs a command with \f(CW\*(C`%\*(C'\fR replaced by the name of
the textfile. This command can be set via a resource:
.Sp
.Vb 1
-\& URxvt.selection\-pastebin.cmd: rsync \-apP % ruth:/var/www/www.ta\-sa.org/files/txt/.
+\& URxvt.selection-pastebin.cmd: rsync -apP % ruth:/var/www/www.ta-sa.org/files/txt/.
.Ve
.Sp
And the default is likely not useful to anybody but the few people around
for the filename):
.Sp
.Vb 1
-\& URxvt.selection\-pastebin.url: http://www.ta\-sa.org/files/txt/%
+\& URxvt.selection-pastebin.url: http://www.ta-sa.org/files/txt/%
.Ve
+.Sp
+\&\fINote to xrdb users:\fR xrdb uses the C preprocessor, which might interpret
+the double \f(CW\*(C`/\*(C'\fR characters as comment start. Use \f(CW\*(C`\e057\e057\*(C'\fR instead,
+which works regardless of wether xrdb is used to parse the resource file
+or not.
.IP "example-refresh-hooks" 4
.IX Item "example-refresh-hooks"
Displays a very simple digital clock in the upper right corner of the
.PP
Argument names also often indicate the type of a parameter. Here are some
hints on what they mean:
-.ie n .IP "$text" 4
-.el .IP "\f(CW$text\fR" 4
+.IP "$text" 4
.IX Item "$text"
Rxvt-unicodes special way of encoding text, where one \*(L"unicode\*(R" character
always represents one screen cell. See ROW_t for a discussion of this format.
-.ie n .IP "$string" 4
-.el .IP "\f(CW$string\fR" 4
+.IP "$string" 4
.IX Item "$string"
A perl text string, with an emphasis on \fItext\fR. It can store all unicode
characters and is to be distinguished with text encoded in a specific
encoding (often locale\-specific) and binary data.
-.ie n .IP "$octets" 4
-.el .IP "\f(CW$octets\fR" 4
+.IP "$octets" 4
.IX Item "$octets"
Either binary data or \- more common \- a text string encoded in a
locale-specific way.
.Sh "Extension Objects"
.IX Subsection "Extension Objects"
Every perl extension is a perl class. A separate perl object is created
-for each terminal and each extension and passed as the first parameter to
-hooks. So extensions can use their \f(CW$self\fR object without having to think
-about other extensions, with the exception of methods and members that
-begin with an underscore character \f(CW\*(C`_\*(C'\fR: these are reserved for internal
-use.
+for each terminal, and each terminal has its own set of extenion objects,
+which are passed as the first parameter to hooks. So extensions can use
+their \f(CW$self\fR object without having to think about clashes with other
+extensions or other terminals, with the exception of methods and members
+that begin with an underscore character \f(CW\*(C`_\*(C'\fR: these are reserved for
+internal use.
.PP
Although it isn't a \f(CW\*(C`urxvt::term\*(C'\fR object, you can call all methods of the
\&\f(CW\*(C`urxvt::term\*(C'\fR class on this object.
.PP
It has the following methods and data members:
-.ie n .IP "$urxvt_term\fR = \f(CW$self\->{term}" 4
-.el .IP "\f(CW$urxvt_term\fR = \f(CW$self\fR\->{term}" 4
+.ie n .IP "$urxvt_term = $self\->{term}" 4
+.el .IP "$urxvt_term = \f(CW$self\fR\->{term}" 4
.IX Item "$urxvt_term = $self->{term}"
Returns the \f(CW\*(C`urxvt::term\*(C'\fR object associated with this instance of the
extension. This member \fImust not\fR be changed in any way.
-.ie n .IP "$self\fR\->enable ($hook_name => \f(CW$cb\fR, [$hook_name => \f(CW$cb..])" 4
-.el .IP "\f(CW$self\fR\->enable ($hook_name => \f(CW$cb\fR, [$hook_name => \f(CW$cb\fR..])" 4
+.ie n .IP "$self\->enable ($hook_name => $cb\fR, [$hook_name => \f(CW$cb..])" 4
+.el .IP "$self\->enable ($hook_name => \f(CW$cb\fR, [$hook_name => \f(CW$cb\fR..])" 4
.IX Item "$self->enable ($hook_name => $cb, [$hook_name => $cb..])"
Dynamically enable the given hooks (named without the \f(CW\*(C`on_\*(C'\fR prefix) for
this extension, replacing any previous hook. This is useful when you want
to overwrite time-critical hooks only temporarily.
-.ie n .IP "$self\fR\->disable ($hook_name[, \f(CW$hook_name..])" 4
-.el .IP "\f(CW$self\fR\->disable ($hook_name[, \f(CW$hook_name\fR..])" 4
+.ie n .IP "$self\->disable ($hook_name[, $hook_name..])" 4
+.el .IP "$self\->disable ($hook_name[, \f(CW$hook_name\fR..])" 4
.IX Item "$self->disable ($hook_name[, $hook_name..])"
Dynamically disable the given hooks.
.Sh "Hooks"
.ie n .Sh "Variables in the ""urxvt"" Package"
.el .Sh "Variables in the \f(CWurxvt\fP Package"
.IX Subsection "Variables in the urxvt Package"
-.ie n .IP "$urxvt::LIBDIR" 4
-.el .IP "\f(CW$urxvt::LIBDIR\fR" 4
+.IP "$urxvt::LIBDIR" 4
.IX Item "$urxvt::LIBDIR"
The rxvt-unicode library directory, where, among other things, the perl
modules and scripts are stored.
-.ie n .IP "$urxvt::RESCLASS\fR, \f(CW$urxvt::RESCLASS" 4
-.el .IP "\f(CW$urxvt::RESCLASS\fR, \f(CW$urxvt::RESCLASS\fR" 4
+.ie n .IP "$urxvt::RESCLASS, $urxvt::RESCLASS" 4
+.el .IP "$urxvt::RESCLASS, \f(CW$urxvt::RESCLASS\fR" 4
.IX Item "$urxvt::RESCLASS, $urxvt::RESCLASS"
The resource class and name rxvt-unicode uses to look up X resources.
-.ie n .IP "$urxvt::RXVTNAME" 4
-.el .IP "\f(CW$urxvt::RXVTNAME\fR" 4
+.IP "$urxvt::RXVTNAME" 4
.IX Item "$urxvt::RXVTNAME"
The basename of the installed binaries, usually \f(CW\*(C`urxvt\*(C'\fR.
-.ie n .IP "$urxvt::TERM" 4
-.el .IP "\f(CW$urxvt::TERM\fR" 4
+.IP "$urxvt::TERM" 4
.IX Item "$urxvt::TERM"
The current terminal. This variable stores the current \f(CW\*(C`urxvt::term\*(C'\fR
object, whenever a callback/hook is executing.
-.ie n .IP "@urxvt::TERM_INIT" 4
-.el .IP "\f(CW@urxvt::TERM_INIT\fR" 4
+.IP "@urxvt::TERM_INIT" 4
.IX Item "@urxvt::TERM_INIT"
All code references in this array will be called as methods of the next newly
created \f(CW\*(C`urxvt::term\*(C'\fR object (during the \f(CW\*(C`on_init\*(C'\fR phase). The array
.Sp
This complements to the perl-eval command line option, but gets executed
first.
-.ie n .IP "@urxvt::TERM_EXT" 4
-.el .IP "\f(CW@urxvt::TERM_EXT\fR" 4
+.IP "@urxvt::TERM_EXT" 4
.IX Item "@urxvt::TERM_EXT"
Works similar to \f(CW@TERM_INIT\fR, but contains perl package/class names, which
get registered as normal extensions after calling the hooks in \f(CW@TERM_INIT\fR
correct place, e.g. on stderr of the connecting urxvtc client.
.Sp
Messages have a size limit of 1023 bytes currently.
-.ie n .IP "@terms = urxvt::termlist" 4
-.el .IP "\f(CW@terms\fR = urxvt::termlist" 4
+.IP "@terms = urxvt::termlist" 4
.IX Item "@terms = urxvt::termlist"
Returns all urxvt::term objects that exist in this process, regardless of
whether they are started, being destroyed etc., so be careful. Only term
objects that have perl extensions attached will be returned (because there
is no urxvt::term objet associated with others).
-.ie n .IP "$time = urxvt::NOW" 4
-.el .IP "\f(CW$time\fR = urxvt::NOW" 4
+.IP "$time = urxvt::NOW" 4
.IX Item "$time = urxvt::NOW"
Returns the \*(L"current time\*(R" (as per the event loop).
.IP "urxvt::CurrentTime" 4
never just create a bitset, you should always modify an existing one,
as they contain important information required for correct operation of
rxvt\-unicode.
-.ie n .IP "$rend = urxvt::DEFAULT_RSTYLE" 4
-.el .IP "\f(CW$rend\fR = urxvt::DEFAULT_RSTYLE" 4
+.IP "$rend = urxvt::DEFAULT_RSTYLE" 4
.IX Item "$rend = urxvt::DEFAULT_RSTYLE"
Returns the default rendition, as used when the terminal is starting up or
being reset. Useful as a base to start when creating renditions.
-.ie n .IP "$rend = urxvt::OVERLAY_RSTYLE" 4
-.el .IP "\f(CW$rend\fR = urxvt::OVERLAY_RSTYLE" 4
+.IP "$rend = urxvt::OVERLAY_RSTYLE" 4
.IX Item "$rend = urxvt::OVERLAY_RSTYLE"
Return the rendition mask used for overlays by default.
-.ie n .IP "$rendbit = urxvt::RS_Bold, RS_Italic, RS_Blink, RS_RVid, RS_Uline" 4
-.el .IP "\f(CW$rendbit\fR = urxvt::RS_Bold, RS_Italic, RS_Blink, RS_RVid, RS_Uline" 4
+.IP "$rendbit = urxvt::RS_Bold, RS_Italic, RS_Blink, RS_RVid, RS_Uline" 4
.IX Item "$rendbit = urxvt::RS_Bold, RS_Italic, RS_Blink, RS_RVid, RS_Uline"
Return the bit that enabled bold, italic, blink, reverse-video and
underline, respectively. To enable such a style, just logically \s-1OR\s0 it into
the bitset.
-.ie n .IP "$foreground\fR = urxvt::GET_BASEFG \f(CW$rend" 4
-.el .IP "\f(CW$foreground\fR = urxvt::GET_BASEFG \f(CW$rend\fR" 4
+.ie n .IP "$foreground = urxvt::GET_BASEFG $rend" 4
+.el .IP "$foreground = urxvt::GET_BASEFG \f(CW$rend\fR" 4
.IX Item "$foreground = urxvt::GET_BASEFG $rend"
.PD 0
-.ie n .IP "$background\fR = urxvt::GET_BASEBG \f(CW$rend" 4
-.el .IP "\f(CW$background\fR = urxvt::GET_BASEBG \f(CW$rend\fR" 4
+.ie n .IP "$background = urxvt::GET_BASEBG $rend" 4
+.el .IP "$background = urxvt::GET_BASEBG \f(CW$rend\fR" 4
.IX Item "$background = urxvt::GET_BASEBG $rend"
.PD
Return the foreground/background colour index, respectively.
-.ie n .IP "$rend\fR = urxvt::SET_FGCOLOR \f(CW$rend\fR, \f(CW$new_colour" 4
-.el .IP "\f(CW$rend\fR = urxvt::SET_FGCOLOR \f(CW$rend\fR, \f(CW$new_colour\fR" 4
+.ie n .IP "$rend = urxvt::SET_FGCOLOR $rend\fR, \f(CW$new_colour" 4
+.el .IP "$rend = urxvt::SET_FGCOLOR \f(CW$rend\fR, \f(CW$new_colour\fR" 4
.IX Item "$rend = urxvt::SET_FGCOLOR $rend, $new_colour"
.PD 0
-.ie n .IP "$rend\fR = urxvt::SET_BGCOLOR \f(CW$rend\fR, \f(CW$new_colour" 4
-.el .IP "\f(CW$rend\fR = urxvt::SET_BGCOLOR \f(CW$rend\fR, \f(CW$new_colour\fR" 4
+.ie n .IP "$rend = urxvt::SET_BGCOLOR $rend\fR, \f(CW$new_colour" 4
+.el .IP "$rend = urxvt::SET_BGCOLOR \f(CW$rend\fR, \f(CW$new_colour\fR" 4
.IX Item "$rend = urxvt::SET_BGCOLOR $rend, $new_colour"
-.ie n .IP "$rend\fR = urxvt::SET_COLOR \f(CW$rend\fR, \f(CW$new_fg\fR, \f(CW$new_bg" 4
-.el .IP "\f(CW$rend\fR = urxvt::SET_COLOR \f(CW$rend\fR, \f(CW$new_fg\fR, \f(CW$new_bg\fR" 4
+.ie n .IP "$rend = urxvt::SET_COLOR $rend\fR, \f(CW$new_fg\fR, \f(CW$new_bg" 4
+.el .IP "$rend = urxvt::SET_COLOR \f(CW$rend\fR, \f(CW$new_fg\fR, \f(CW$new_bg\fR" 4
.IX Item "$rend = urxvt::SET_COLOR $rend, $new_fg, $new_bg"
.PD
Replace the foreground/background colour in the rendition mask with the
specified one.
-.ie n .IP "$value\fR = urxvt::GET_CUSTOM \f(CW$rend" 4
-.el .IP "\f(CW$value\fR = urxvt::GET_CUSTOM \f(CW$rend\fR" 4
+.ie n .IP "$value = urxvt::GET_CUSTOM $rend" 4
+.el .IP "$value = urxvt::GET_CUSTOM \f(CW$rend\fR" 4
.IX Item "$value = urxvt::GET_CUSTOM $rend"
Return the \*(L"custom\*(R" value: Every rendition has 5 bits for use by
extensions. They can be set and changed as you like and are initially
zero.
-.ie n .IP "$rend\fR = urxvt::SET_CUSTOM \f(CW$rend\fR, \f(CW$new_value" 4
-.el .IP "\f(CW$rend\fR = urxvt::SET_CUSTOM \f(CW$rend\fR, \f(CW$new_value\fR" 4
+.ie n .IP "$rend = urxvt::SET_CUSTOM $rend\fR, \f(CW$new_value" 4
+.el .IP "$rend = urxvt::SET_CUSTOM \f(CW$rend\fR, \f(CW$new_value\fR" 4
.IX Item "$rend = urxvt::SET_CUSTOM $rend, $new_value"
Change the custom value.
.ie n .Sh "The ""urxvt::anyevent"" Class"
.ie n .Sh "The ""urxvt::term"" Class"
.el .Sh "The \f(CWurxvt::term\fP Class"
.IX Subsection "The urxvt::term Class"
-.ie n .IP "$term\fR = new urxvt::term \f(CW$envhashref\fR, \f(CW$rxvtname, [arg...]" 4
-.el .IP "\f(CW$term\fR = new urxvt::term \f(CW$envhashref\fR, \f(CW$rxvtname\fR, [arg...]" 4
+.ie n .IP "$term = new urxvt::term $envhashref\fR, \f(CW$rxvtname, [arg...]" 4
+.el .IP "$term = new urxvt::term \f(CW$envhashref\fR, \f(CW$rxvtname\fR, [arg...]" 4
.IX Item "$term = new urxvt::term $envhashref, $rxvtname, [arg...]"
Creates a new terminal, very similar as if you had started it with system
\&\f(CW\*(C`$rxvtname, arg...\*(C'\fR. \f(CW$envhashref\fR must be a reference to a \f(CW%ENV\fR\-like
initialise perl, and the terminal object otherwise. The \f(CW\*(C`init\*(C'\fR and
\&\f(CW\*(C`start\*(C'\fR hooks will be called before this call returns, and are free to
refer to global data (which is race free).
-.ie n .IP "$term\->destroy" 4
-.el .IP "\f(CW$term\fR\->destroy" 4
+.IP "$term\->destroy" 4
.IX Item "$term->destroy"
Destroy the terminal object (close the window, free resources
etc.). Please note that @@RXVT_NAME@@ will not exit as long as any event
watchers (timers, io watchers) are still active.
-.ie n .IP "$term\fR\->exec_async ($cmd[, \f(CW@args])" 4
-.el .IP "\f(CW$term\fR\->exec_async ($cmd[, \f(CW@args\fR])" 4
+.ie n .IP "$term\->exec_async ($cmd[, @args])" 4
+.el .IP "$term\->exec_async ($cmd[, \f(CW@args\fR])" 4
.IX Item "$term->exec_async ($cmd[, @args])"
Works like the combination of the \f(CW\*(C`fork\*(C'\fR/\f(CW\*(C`exec\*(C'\fR builtins, which executes
(\*(L"starts\*(R") programs in the background. This function takes care of setting
be preferred over explicit calls to \f(CW\*(C`exec\*(C'\fR or \f(CW\*(C`system\*(C'\fR.
.Sp
Returns the pid of the subprocess or \f(CW\*(C`undef\*(C'\fR on error.
-.ie n .IP "$isset\fR = \f(CW$term\fR\->option ($optval[, \f(CW$set])" 4
-.el .IP "\f(CW$isset\fR = \f(CW$term\fR\->option ($optval[, \f(CW$set\fR])" 4
+.ie n .IP "$isset = $term\fR\->option ($optval[, \f(CW$set])" 4
+.el .IP "$isset = \f(CW$term\fR\->option ($optval[, \f(CW$set\fR])" 4
.IX Item "$isset = $term->option ($optval[, $set])"
Returns true if the option specified by \f(CW$optval\fR is enabled, and
optionally change it. All option values are stored by name in the hash
.Vb 6
\& borderLess console cursorBlink cursorUnderline hold iconic insecure
\& intensityStyles jumpScroll loginShell mapAlert meta8 mouseWheelScrollPage
-\& override\-redirect pastableTabs pointerBlank reverseVideo scrollBar
+\& override-redirect pastableTabs pointerBlank reverseVideo scrollBar
\& scrollBar_floating scrollBar_right scrollTtyKeypress scrollTtyOutput
\& scrollWithBuffer secondaryScreen secondaryScroll skipBuiltinGlyphs
\& transparent tripleclickwords utmpInhibit visualBell
.Ve
-.ie n .IP "$value\fR = \f(CW$term\fR\->resource ($name[, \f(CW$newval])" 4
-.el .IP "\f(CW$value\fR = \f(CW$term\fR\->resource ($name[, \f(CW$newval\fR])" 4
+.ie n .IP "$value = $term\fR\->resource ($name[, \f(CW$newval])" 4
+.el .IP "$value = \f(CW$term\fR\->resource ($name[, \f(CW$newval\fR])" 4
.IX Item "$value = $term->resource ($name[, $newval])"
Returns the current resource value associated with a given name and
optionally sets a new value. Setting values is most useful in the \f(CW\*(C`init\*(C'\fR
are supported in every build, please see the source file \fI/src/rsinc.h\fR
to see the actual list:
.Sp
-.Vb 10
+.Vb 13
\& answerbackstring backgroundPixmap backspace_key boldFont boldItalicFont
\& borderLess color cursorBlink cursorUnderline cutchars delete_key
\& display_name embed ext_bwidth fade font geometry hold iconName
\& transient_for transparent transparent_all tripleclickwords utmpInhibit
\& visualBell
.Ve
-.ie n .IP "$value\fR = \f(CW$term\->x_resource ($pattern)" 4
-.el .IP "\f(CW$value\fR = \f(CW$term\fR\->x_resource ($pattern)" 4
+.ie n .IP "$value = $term\->x_resource ($pattern)" 4
+.el .IP "$value = \f(CW$term\fR\->x_resource ($pattern)" 4
.IX Item "$value = $term->x_resource ($pattern)"
Returns the X\-Resource for the given pattern, excluding the program or
class name, i.e. \f(CW\*(C`$term\->x_resource ("boldFont")\*(C'\fR should return the
This method should only be called during the \f(CW\*(C`on_start\*(C'\fR hook, as there is
only one resource database per display, and later invocations might return
the wrong resources.
-.ie n .IP "$success\fR = \f(CW$term\fR\->parse_keysym ($keysym_spec, \f(CW$command_string)" 4
-.el .IP "\f(CW$success\fR = \f(CW$term\fR\->parse_keysym ($keysym_spec, \f(CW$command_string\fR)" 4
+.ie n .IP "$success = $term\fR\->parse_keysym ($keysym_spec, \f(CW$command_string)" 4
+.el .IP "$success = \f(CW$term\fR\->parse_keysym ($keysym_spec, \f(CW$command_string\fR)" 4
.IX Item "$success = $term->parse_keysym ($keysym_spec, $command_string)"
Adds a keymap translation exactly as specified via a resource. See the
\&\f(CW\*(C`keysym\*(C'\fR resource in the @@RXVT_NAME@@(1) manpage.
-.ie n .IP "$rend\fR = \f(CW$term\->rstyle ([$new_rstyle])" 4
-.el .IP "\f(CW$rend\fR = \f(CW$term\fR\->rstyle ([$new_rstyle])" 4
+.ie n .IP "$rend = $term\->rstyle ([$new_rstyle])" 4
+.el .IP "$rend = \f(CW$term\fR\->rstyle ([$new_rstyle])" 4
.IX Item "$rend = $term->rstyle ([$new_rstyle])"
Return and optionally change the current rendition. Text that is output by
the terminal application will use this style.
.PD
Return the current values of the selection mark, begin or end positions,
and optionally set them to new values.
-.ie n .IP "$term\fR\->selection_make ($eventtime[, \f(CW$rectangular])" 4
-.el .IP "\f(CW$term\fR\->selection_make ($eventtime[, \f(CW$rectangular\fR])" 4
+.ie n .IP "$term\->selection_make ($eventtime[, $rectangular])" 4
+.el .IP "$term\->selection_make ($eventtime[, \f(CW$rectangular\fR])" 4
.IX Item "$term->selection_make ($eventtime[, $rectangular])"
Tries to make a selection as set by \f(CW\*(C`selection_beg\*(C'\fR and
\&\f(CW\*(C`selection_end\*(C'\fR. If \f(CW$rectangular\fR is true (default: false), a
rectangular selection will be made. This is the prefered function to make
a selection.
-.ie n .IP "$success\fR = \f(CW$term\->selection_grab ($eventtime)" 4
-.el .IP "\f(CW$success\fR = \f(CW$term\fR\->selection_grab ($eventtime)" 4
+.ie n .IP "$success = $term\->selection_grab ($eventtime)" 4
+.el .IP "$success = \f(CW$term\fR\->selection_grab ($eventtime)" 4
.IX Item "$success = $term->selection_grab ($eventtime)"
Try to request the primary selection text from the server (for example, as
set by the next method). No visual feedback will be given. This function
is mostly useful from within \f(CW\*(C`on_sel_grab\*(C'\fR hooks.
-.ie n .IP "$oldtext\fR = \f(CW$term\->selection ([$newtext])" 4
-.el .IP "\f(CW$oldtext\fR = \f(CW$term\fR\->selection ([$newtext])" 4
+.ie n .IP "$oldtext = $term\->selection ([$newtext])" 4
+.el .IP "$oldtext = \f(CW$term\fR\->selection ([$newtext])" 4
.IX Item "$oldtext = $term->selection ([$newtext])"
Return the current selection text and optionally replace it by \f(CW$newtext\fR.
-.ie n .IP "$term\fR\->overlay_simple ($x, \f(CW$y\fR, \f(CW$text)" 4
-.el .IP "\f(CW$term\fR\->overlay_simple ($x, \f(CW$y\fR, \f(CW$text\fR)" 4
+.ie n .IP "$term\->overlay_simple ($x, $y\fR, \f(CW$text)" 4
+.el .IP "$term\->overlay_simple ($x, \f(CW$y\fR, \f(CW$text\fR)" 4
.IX Item "$term->overlay_simple ($x, $y, $text)"
Create a simple multi-line overlay box. See the next method for details.
-.ie n .IP "$term\fR\->overlay ($x, \f(CW$y\fR, \f(CW$width\fR, \f(CW$height\fR[, \f(CW$rstyle\fR[, \f(CW$border]])" 4
-.el .IP "\f(CW$term\fR\->overlay ($x, \f(CW$y\fR, \f(CW$width\fR, \f(CW$height\fR[, \f(CW$rstyle\fR[, \f(CW$border\fR]])" 4
+.ie n .IP "$term\->overlay ($x, $y\fR, \f(CW$width\fR, \f(CW$height\fR[, \f(CW$rstyle\fR[, \f(CW$border]])" 4
+.el .IP "$term\->overlay ($x, \f(CW$y\fR, \f(CW$width\fR, \f(CW$height\fR[, \f(CW$rstyle\fR[, \f(CW$border\fR]])" 4
.IX Item "$term->overlay ($x, $y, $width, $height[, $rstyle[, $border]])"
Create a new (empty) overlay at the given position with the given
width/height. \f(CW$rstyle\fR defines the initial rendition style
.Sp
The methods currently supported on \f(CW\*(C`urxvt::overlay\*(C'\fR objects are:
.RS 4
-.ie n .IP "$overlay\fR\->set ($x, \f(CW$y\fR, \f(CW$text\fR, \f(CW$rend)" 4
-.el .IP "\f(CW$overlay\fR\->set ($x, \f(CW$y\fR, \f(CW$text\fR, \f(CW$rend\fR)" 4
+.ie n .IP "$overlay\->set ($x, $y\fR, \f(CW$text\fR, \f(CW$rend)" 4
+.el .IP "$overlay\->set ($x, \f(CW$y\fR, \f(CW$text\fR, \f(CW$rend\fR)" 4
.IX Item "$overlay->set ($x, $y, $text, $rend)"
Similar to \f(CW\*(C`$term\->ROW_t\*(C'\fR and \f(CW\*(C`$term\->ROW_r\*(C'\fR in that it puts
text in rxvt\-unicode's special encoding and an array of rendition values
at a specific position inside the overlay.
-.ie n .IP "$overlay\->hide" 4
-.el .IP "\f(CW$overlay\fR\->hide" 4
+.IP "$overlay\->hide" 4
.IX Item "$overlay->hide"
If visible, hide the overlay, but do not destroy it.
-.ie n .IP "$overlay\->show" 4
-.el .IP "\f(CW$overlay\fR\->show" 4
+.IP "$overlay\->show" 4
.IX Item "$overlay->show"
If hidden, display the overlay again.
.RE
.RS 4
.RE
-.ie n .IP "$popup\fR = \f(CW$term\->popup ($event)" 4
-.el .IP "\f(CW$popup\fR = \f(CW$term\fR\->popup ($event)" 4
+.ie n .IP "$popup = $term\->popup ($event)" 4
+.el .IP "$popup = \f(CW$term\fR\->popup ($event)" 4
.IX Item "$popup = $term->popup ($event)"
Creates a new \f(CW\*(C`urxvt::popup\*(C'\fR object that implements a popup menu. The
\&\f(CW$event\fR \fImust\fR be the event causing the menu to pop up (a button event,
currently).
-.ie n .IP "$cellwidth\fR = \f(CW$term\->strwidth ($string)" 4
-.el .IP "\f(CW$cellwidth\fR = \f(CW$term\fR\->strwidth ($string)" 4
+.ie n .IP "$cellwidth = $term\->strwidth ($string)" 4
+.el .IP "$cellwidth = \f(CW$term\fR\->strwidth ($string)" 4
.IX Item "$cellwidth = $term->strwidth ($string)"
Returns the number of screen-cells this string would need. Correctly
accounts for wide and combining characters.
-.ie n .IP "$octets\fR = \f(CW$term\->locale_encode ($string)" 4
-.el .IP "\f(CW$octets\fR = \f(CW$term\fR\->locale_encode ($string)" 4
+.ie n .IP "$octets = $term\->locale_encode ($string)" 4
+.el .IP "$octets = \f(CW$term\fR\->locale_encode ($string)" 4
.IX Item "$octets = $term->locale_encode ($string)"
Convert the given text string into the corresponding locale encoding.
-.ie n .IP "$string\fR = \f(CW$term\->locale_decode ($octets)" 4
-.el .IP "\f(CW$string\fR = \f(CW$term\fR\->locale_decode ($octets)" 4
+.ie n .IP "$string = $term\->locale_decode ($octets)" 4
+.el .IP "$string = \f(CW$term\fR\->locale_decode ($octets)" 4
.IX Item "$string = $term->locale_decode ($octets)"
Convert the given locale-encoded octets into a perl string.
-.ie n .IP "$term\fR\->scr_xor_span ($beg_row, \f(CW$beg_col\fR, \f(CW$end_row\fR, \f(CW$end_col\fR[, \f(CW$rstyle])" 4
-.el .IP "\f(CW$term\fR\->scr_xor_span ($beg_row, \f(CW$beg_col\fR, \f(CW$end_row\fR, \f(CW$end_col\fR[, \f(CW$rstyle\fR])" 4
+.ie n .IP "$term\->scr_xor_span ($beg_row, $beg_col\fR, \f(CW$end_row\fR, \f(CW$end_col\fR[, \f(CW$rstyle])" 4
+.el .IP "$term\->scr_xor_span ($beg_row, \f(CW$beg_col\fR, \f(CW$end_row\fR, \f(CW$end_col\fR[, \f(CW$rstyle\fR])" 4
.IX Item "$term->scr_xor_span ($beg_row, $beg_col, $end_row, $end_col[, $rstyle])"
XORs the rendition values in the given span with the provided value
(default: \f(CW\*(C`RS_RVid\*(C'\fR), which \fI\s-1MUST\s0 \s-1NOT\s0\fR contain font styles. Useful in
refresh hooks to provide effects similar to the selection.
-.ie n .IP "$term\fR\->scr_xor_rect ($beg_row, \f(CW$beg_col\fR, \f(CW$end_row\fR, \f(CW$end_col\fR[, \f(CW$rstyle1\fR[, \f(CW$rstyle2]])" 4
-.el .IP "\f(CW$term\fR\->scr_xor_rect ($beg_row, \f(CW$beg_col\fR, \f(CW$end_row\fR, \f(CW$end_col\fR[, \f(CW$rstyle1\fR[, \f(CW$rstyle2\fR]])" 4
+.ie n .IP "$term\->scr_xor_rect ($beg_row, $beg_col\fR, \f(CW$end_row\fR, \f(CW$end_col\fR[, \f(CW$rstyle1\fR[, \f(CW$rstyle2]])" 4
+.el .IP "$term\->scr_xor_rect ($beg_row, \f(CW$beg_col\fR, \f(CW$end_row\fR, \f(CW$end_col\fR[, \f(CW$rstyle1\fR[, \f(CW$rstyle2\fR]])" 4
.IX Item "$term->scr_xor_rect ($beg_row, $beg_col, $end_row, $end_col[, $rstyle1[, $rstyle2]])"
Similar to \f(CW\*(C`scr_xor_span\*(C'\fR, but xors a rectangle instead. Trailing
whitespace will additionally be xored with the \f(CW$rstyle2\fR, which defaults
to \f(CW\*(C`RS_RVid | RS_Uline\*(C'\fR, which removes reverse video again and underlines
it instead. Both styles \fI\s-1MUST\s0 \s-1NOT\s0\fR contain font styles.
-.ie n .IP "$term\->scr_bell" 4
-.el .IP "\f(CW$term\fR\->scr_bell" 4
+.IP "$term\->scr_bell" 4
.IX Item "$term->scr_bell"
Ring the bell!
-.ie n .IP "$term\->scr_add_lines ($string)" 4
-.el .IP "\f(CW$term\fR\->scr_add_lines ($string)" 4
+.IP "$term\->scr_add_lines ($string)" 4
.IX Item "$term->scr_add_lines ($string)"
Write the given text string to the screen, as if output by the application
running inside the terminal. It may not contain command sequences (escape
Normally its not a good idea to use this function, as programs might be
confused by changes in cursor position or scrolling. Its useful inside a
\&\f(CW\*(C`on_add_lines\*(C'\fR hook, though.
-.ie n .IP "$term\->scr_change_screen ($screen)" 4
-.el .IP "\f(CW$term\fR\->scr_change_screen ($screen)" 4
+.IP "$term\->scr_change_screen ($screen)" 4
.IX Item "$term->scr_change_screen ($screen)"
Switch to given screen \- 0 primary, 1 secondary.
-.ie n .IP "$term\->cmd_parse ($octets)" 4
-.el .IP "\f(CW$term\fR\->cmd_parse ($octets)" 4
+.IP "$term\->cmd_parse ($octets)" 4
.IX Item "$term->cmd_parse ($octets)"
Similar to \f(CW\*(C`scr_add_lines\*(C'\fR, but the argument must be in the
locale-specific encoding of the terminal and can contain command sequences
(escape codes) that will be interpreted.
-.ie n .IP "$term\->tt_write ($octets)" 4
-.el .IP "\f(CW$term\fR\->tt_write ($octets)" 4
+.IP "$term\->tt_write ($octets)" 4
.IX Item "$term->tt_write ($octets)"
Write the octets given in \f(CW$data\fR to the tty (i.e. as program input). To
pass characters instead of octets, you should convert your strings first
to the locale-specific encoding using \f(CW\*(C`$term\->locale_encode\*(C'\fR.
-.ie n .IP "$old_events\fR = \f(CW$term\->pty_ev_events ([$new_events])" 4
-.el .IP "\f(CW$old_events\fR = \f(CW$term\fR\->pty_ev_events ([$new_events])" 4
+.ie n .IP "$old_events = $term\->pty_ev_events ([$new_events])" 4
+.el .IP "$old_events = \f(CW$term\fR\->pty_ev_events ([$new_events])" 4
.IX Item "$old_events = $term->pty_ev_events ([$new_events])"
Replaces the event mask of the pty watcher by the given event mask. Can
be used to suppress input and output handling to the pty/tty. See the
description of \f(CW\*(C`urxvt::timer\->events\*(C'\fR. Make sure to always restore
the previous value.
-.ie n .IP "$fd\fR = \f(CW$term\->pty_fd" 4
-.el .IP "\f(CW$fd\fR = \f(CW$term\fR\->pty_fd" 4
+.ie n .IP "$fd = $term\->pty_fd" 4
+.el .IP "$fd = \f(CW$term\fR\->pty_fd" 4
.IX Item "$fd = $term->pty_fd"
Returns the master file descriptor for the pty in use, or \f(CW\*(C`\-1\*(C'\fR if no pty
is used.
-.ie n .IP "$windowid\fR = \f(CW$term\->parent" 4
-.el .IP "\f(CW$windowid\fR = \f(CW$term\fR\->parent" 4
+.ie n .IP "$windowid = $term\->parent" 4
+.el .IP "$windowid = \f(CW$term\fR\->parent" 4
.IX Item "$windowid = $term->parent"
Return the window id of the toplevel window.
-.ie n .IP "$windowid\fR = \f(CW$term\->vt" 4
-.el .IP "\f(CW$windowid\fR = \f(CW$term\fR\->vt" 4
+.ie n .IP "$windowid = $term\->vt" 4
+.el .IP "$windowid = \f(CW$term\fR\->vt" 4
.IX Item "$windowid = $term->vt"
Return the window id of the terminal window.
-.ie n .IP "$term\->vt_emask_add ($x_event_mask)" 4
-.el .IP "\f(CW$term\fR\->vt_emask_add ($x_event_mask)" 4
+.IP "$term\->vt_emask_add ($x_event_mask)" 4
.IX Item "$term->vt_emask_add ($x_event_mask)"
Adds the specified events to the vt event mask. Useful e.g. when you want
to receive pointer events all the times:
.Sp
.Vb 1
-\& $term\->vt_emask_add (urxvt::PointerMotionMask);
+\& $term->vt_emask_add (urxvt::PointerMotionMask);
.Ve
-.ie n .IP "$term\->focus_in" 4
-.el .IP "\f(CW$term\fR\->focus_in" 4
+.IP "$term\->focus_in" 4
.IX Item "$term->focus_in"
.PD 0
-.ie n .IP "$term\->focus_out" 4
-.el .IP "\f(CW$term\fR\->focus_out" 4
+.IP "$term\->focus_out" 4
.IX Item "$term->focus_out"
-.ie n .IP "$term\fR\->key_press ($state, \f(CW$keycode\fR[, \f(CW$time])" 4
-.el .IP "\f(CW$term\fR\->key_press ($state, \f(CW$keycode\fR[, \f(CW$time\fR])" 4
+.ie n .IP "$term\->key_press ($state, $keycode\fR[, \f(CW$time])" 4
+.el .IP "$term\->key_press ($state, \f(CW$keycode\fR[, \f(CW$time\fR])" 4
.IX Item "$term->key_press ($state, $keycode[, $time])"
-.ie n .IP "$term\fR\->key_release ($state, \f(CW$keycode\fR[, \f(CW$time])" 4
-.el .IP "\f(CW$term\fR\->key_release ($state, \f(CW$keycode\fR[, \f(CW$time\fR])" 4
+.ie n .IP "$term\->key_release ($state, $keycode\fR[, \f(CW$time])" 4
+.el .IP "$term\->key_release ($state, \f(CW$keycode\fR[, \f(CW$time\fR])" 4
.IX Item "$term->key_release ($state, $keycode[, $time])"
.PD
Deliver various fake events to to terminal.
-.ie n .IP "$window_width\fR = \f(CW$term\->width" 4
-.el .IP "\f(CW$window_width\fR = \f(CW$term\fR\->width" 4
+.ie n .IP "$window_width = $term\->width" 4
+.el .IP "$window_width = \f(CW$term\fR\->width" 4
.IX Item "$window_width = $term->width"
.PD 0
-.ie n .IP "$window_height\fR = \f(CW$term\->height" 4
-.el .IP "\f(CW$window_height\fR = \f(CW$term\fR\->height" 4
+.ie n .IP "$window_height = $term\->height" 4
+.el .IP "$window_height = \f(CW$term\fR\->height" 4
.IX Item "$window_height = $term->height"
-.ie n .IP "$font_width\fR = \f(CW$term\->fwidth" 4
-.el .IP "\f(CW$font_width\fR = \f(CW$term\fR\->fwidth" 4
+.ie n .IP "$font_width = $term\->fwidth" 4
+.el .IP "$font_width = \f(CW$term\fR\->fwidth" 4
.IX Item "$font_width = $term->fwidth"
-.ie n .IP "$font_height\fR = \f(CW$term\->fheight" 4
-.el .IP "\f(CW$font_height\fR = \f(CW$term\fR\->fheight" 4
+.ie n .IP "$font_height = $term\->fheight" 4
+.el .IP "$font_height = \f(CW$term\fR\->fheight" 4
.IX Item "$font_height = $term->fheight"
-.ie n .IP "$font_ascent\fR = \f(CW$term\->fbase" 4
-.el .IP "\f(CW$font_ascent\fR = \f(CW$term\fR\->fbase" 4
+.ie n .IP "$font_ascent = $term\->fbase" 4
+.el .IP "$font_ascent = \f(CW$term\fR\->fbase" 4
.IX Item "$font_ascent = $term->fbase"
-.ie n .IP "$terminal_rows\fR = \f(CW$term\->nrow" 4
-.el .IP "\f(CW$terminal_rows\fR = \f(CW$term\fR\->nrow" 4
+.ie n .IP "$terminal_rows = $term\->nrow" 4
+.el .IP "$terminal_rows = \f(CW$term\fR\->nrow" 4
.IX Item "$terminal_rows = $term->nrow"
-.ie n .IP "$terminal_columns\fR = \f(CW$term\->ncol" 4
-.el .IP "\f(CW$terminal_columns\fR = \f(CW$term\fR\->ncol" 4
+.ie n .IP "$terminal_columns = $term\->ncol" 4
+.el .IP "$terminal_columns = \f(CW$term\fR\->ncol" 4
.IX Item "$terminal_columns = $term->ncol"
-.ie n .IP "$has_focus\fR = \f(CW$term\->focus" 4
-.el .IP "\f(CW$has_focus\fR = \f(CW$term\fR\->focus" 4
+.ie n .IP "$has_focus = $term\->focus" 4
+.el .IP "$has_focus = \f(CW$term\fR\->focus" 4
.IX Item "$has_focus = $term->focus"
-.ie n .IP "$is_mapped\fR = \f(CW$term\->mapped" 4
-.el .IP "\f(CW$is_mapped\fR = \f(CW$term\fR\->mapped" 4
+.ie n .IP "$is_mapped = $term\->mapped" 4
+.el .IP "$is_mapped = \f(CW$term\fR\->mapped" 4
.IX Item "$is_mapped = $term->mapped"
-.ie n .IP "$max_scrollback\fR = \f(CW$term\->saveLines" 4
-.el .IP "\f(CW$max_scrollback\fR = \f(CW$term\fR\->saveLines" 4
+.ie n .IP "$max_scrollback = $term\->saveLines" 4
+.el .IP "$max_scrollback = \f(CW$term\fR\->saveLines" 4
.IX Item "$max_scrollback = $term->saveLines"
-.ie n .IP "$nrow_plus_saveLines\fR = \f(CW$term\->total_rows" 4
-.el .IP "\f(CW$nrow_plus_saveLines\fR = \f(CW$term\fR\->total_rows" 4
+.ie n .IP "$nrow_plus_saveLines = $term\->total_rows" 4
+.el .IP "$nrow_plus_saveLines = \f(CW$term\fR\->total_rows" 4
.IX Item "$nrow_plus_saveLines = $term->total_rows"
-.ie n .IP "$topmost_scrollback_row\fR = \f(CW$term\->top_row" 4
-.el .IP "\f(CW$topmost_scrollback_row\fR = \f(CW$term\fR\->top_row" 4
+.ie n .IP "$topmost_scrollback_row = $term\->top_row" 4
+.el .IP "$topmost_scrollback_row = \f(CW$term\fR\->top_row" 4
.IX Item "$topmost_scrollback_row = $term->top_row"
.PD
Return various integers describing terminal characteristics.
-.ie n .IP "$x_display\fR = \f(CW$term\->display_id" 4
-.el .IP "\f(CW$x_display\fR = \f(CW$term\fR\->display_id" 4
+.ie n .IP "$x_display = $term\->display_id" 4
+.el .IP "$x_display = \f(CW$term\fR\->display_id" 4
.IX Item "$x_display = $term->display_id"
Return the \s-1DISPLAY\s0 used by rxvt\-unicode.
-.ie n .IP "$lc_ctype\fR = \f(CW$term\->locale" 4
-.el .IP "\f(CW$lc_ctype\fR = \f(CW$term\fR\->locale" 4
+.ie n .IP "$lc_ctype = $term\->locale" 4
+.el .IP "$lc_ctype = \f(CW$term\fR\->locale" 4
.IX Item "$lc_ctype = $term->locale"
Returns the \s-1LC_CTYPE\s0 category string used by this rxvt\-unicode.
-.ie n .IP "$env\fR = \f(CW$term\->env" 4
-.el .IP "\f(CW$env\fR = \f(CW$term\fR\->env" 4
+.ie n .IP "$env = $term\->env" 4
+.el .IP "$env = \f(CW$term\fR\->env" 4
.IX Item "$env = $term->env"
Returns a copy of the environment in effect for the terminal as a hashref
similar to \f(CW\*(C`\e%ENV\*(C'\fR.
-.ie n .IP "@envv\fR = \f(CW$term\->envv" 4
-.el .IP "\f(CW@envv\fR = \f(CW$term\fR\->envv" 4
+.ie n .IP "@envv = $term\->envv" 4
+.el .IP "@envv = \f(CW$term\fR\->envv" 4
.IX Item "@envv = $term->envv"
Returns the environment as array of strings of the form \f(CW\*(C`VAR=VALUE\*(C'\fR.
-.ie n .IP "@argv\fR = \f(CW$term\->argv" 4
-.el .IP "\f(CW@argv\fR = \f(CW$term\fR\->argv" 4
+.ie n .IP "@argv = $term\->argv" 4
+.el .IP "@argv = \f(CW$term\fR\->argv" 4
.IX Item "@argv = $term->argv"
Return the argument vector as this terminal, similar to \f(CW@ARGV\fR, but
includes the program name as first element.
-.ie n .IP "$modifiermask\fR = \f(CW$term\->ModLevel3Mask" 4
-.el .IP "\f(CW$modifiermask\fR = \f(CW$term\fR\->ModLevel3Mask" 4
+.ie n .IP "$modifiermask = $term\->ModLevel3Mask" 4
+.el .IP "$modifiermask = \f(CW$term\fR\->ModLevel3Mask" 4
.IX Item "$modifiermask = $term->ModLevel3Mask"
.PD 0
-.ie n .IP "$modifiermask\fR = \f(CW$term\->ModMetaMask" 4
-.el .IP "\f(CW$modifiermask\fR = \f(CW$term\fR\->ModMetaMask" 4
+.ie n .IP "$modifiermask = $term\->ModMetaMask" 4
+.el .IP "$modifiermask = \f(CW$term\fR\->ModMetaMask" 4
.IX Item "$modifiermask = $term->ModMetaMask"
-.ie n .IP "$modifiermask\fR = \f(CW$term\->ModNumLockMask" 4
-.el .IP "\f(CW$modifiermask\fR = \f(CW$term\fR\->ModNumLockMask" 4
+.ie n .IP "$modifiermask = $term\->ModNumLockMask" 4
+.el .IP "$modifiermask = \f(CW$term\fR\->ModNumLockMask" 4
.IX Item "$modifiermask = $term->ModNumLockMask"
.PD
Return the modifier masks corresponding to the \*(L"\s-1ISO\s0 Level 3 Shift\*(R" (often
AltGr), the meta key (often Alt) and the num lock key, if applicable.
-.ie n .IP "$screen\fR = \f(CW$term\->current_screen" 4
-.el .IP "\f(CW$screen\fR = \f(CW$term\fR\->current_screen" 4
+.ie n .IP "$screen = $term\->current_screen" 4
+.el .IP "$screen = \f(CW$term\fR\->current_screen" 4
.IX Item "$screen = $term->current_screen"
Returns the currently displayed screen (0 primary, 1 secondary).
-.ie n .IP "$cursor_is_hidden\fR = \f(CW$term\->hidden_cursor" 4
-.el .IP "\f(CW$cursor_is_hidden\fR = \f(CW$term\fR\->hidden_cursor" 4
+.ie n .IP "$cursor_is_hidden = $term\->hidden_cursor" 4
+.el .IP "$cursor_is_hidden = \f(CW$term\fR\->hidden_cursor" 4
.IX Item "$cursor_is_hidden = $term->hidden_cursor"
Returns whether the cursor is currently hidden or not.
-.ie n .IP "$view_start\fR = \f(CW$term\->view_start ([$newvalue])" 4
-.el .IP "\f(CW$view_start\fR = \f(CW$term\fR\->view_start ([$newvalue])" 4
+.ie n .IP "$view_start = $term\->view_start ([$newvalue])" 4
+.el .IP "$view_start = \f(CW$term\fR\->view_start ([$newvalue])" 4
.IX Item "$view_start = $term->view_start ([$newvalue])"
Returns the row number of the topmost displayed line. Maximum value is
\&\f(CW0\fR, which displays the normal terminal contents. Lower values scroll
this many lines into the scrollback buffer.
-.ie n .IP "$term\->want_refresh" 4
-.el .IP "\f(CW$term\fR\->want_refresh" 4
+.IP "$term\->want_refresh" 4
.IX Item "$term->want_refresh"
Requests a screen refresh. At the next opportunity, rxvt-unicode will
compare the on-screen display with its stored representation. If they
differ, it redraws the differences.
.Sp
Used after changing terminal contents to display them.
-.ie n .IP "$text\fR = \f(CW$term\fR\->ROW_t ($row_number[, \f(CW$new_text\fR[, \f(CW$start_col]])" 4
-.el .IP "\f(CW$text\fR = \f(CW$term\fR\->ROW_t ($row_number[, \f(CW$new_text\fR[, \f(CW$start_col\fR]])" 4
+.ie n .IP "$text = $term\fR\->ROW_t ($row_number[, \f(CW$new_text\fR[, \f(CW$start_col]])" 4
+.el .IP "$text = \f(CW$term\fR\->ROW_t ($row_number[, \f(CW$new_text\fR[, \f(CW$start_col\fR]])" 4
.IX Item "$text = $term->ROW_t ($row_number[, $new_text[, $start_col]])"
Returns the text of the entire row with number \f(CW$row_number\fR. Row \f(CW0\fR
is the topmost terminal line, row \f(CW\*(C`$term\->$ncol\-1\*(C'\fR is the bottommost
.Sp
The methods \f(CW\*(C`$term\->special_encode\*(C'\fR and \f(CW\*(C`$term\->special_decode\*(C'\fR
can be used to convert normal strings into this encoding and vice versa.
-.ie n .IP "$rend\fR = \f(CW$term\fR\->ROW_r ($row_number[, \f(CW$new_rend\fR[, \f(CW$start_col]])" 4
-.el .IP "\f(CW$rend\fR = \f(CW$term\fR\->ROW_r ($row_number[, \f(CW$new_rend\fR[, \f(CW$start_col\fR]])" 4
+.ie n .IP "$rend = $term\fR\->ROW_r ($row_number[, \f(CW$new_rend\fR[, \f(CW$start_col]])" 4
+.el .IP "$rend = \f(CW$term\fR\->ROW_r ($row_number[, \f(CW$new_rend\fR[, \f(CW$start_col\fR]])" 4
.IX Item "$rend = $term->ROW_r ($row_number[, $new_rend[, $start_col]])"
Like \f(CW\*(C`$term\->ROW_t\*(C'\fR, but returns an arrayref with rendition
bitsets. Rendition bitsets contain information about colour, font, font
When setting rendition, the font mask will be ignored.
.Sp
See the section on \s-1RENDITION\s0, above.
-.ie n .IP "$length\fR = \f(CW$term\fR\->ROW_l ($row_number[, \f(CW$new_length])" 4
-.el .IP "\f(CW$length\fR = \f(CW$term\fR\->ROW_l ($row_number[, \f(CW$new_length\fR])" 4
+.ie n .IP "$length = $term\fR\->ROW_l ($row_number[, \f(CW$new_length])" 4
+.el .IP "$length = \f(CW$term\fR\->ROW_l ($row_number[, \f(CW$new_length\fR])" 4
.IX Item "$length = $term->ROW_l ($row_number[, $new_length])"
Returns the number of screen cells that are in use (\*(L"the line
length\*(R"). Unlike the urxvt core, this returns \f(CW\*(C`$term\->ncol\*(C'\fR if the
line is joined with the following one.
-.ie n .IP "$bool\fR = \f(CW$term\->is_longer ($row_number)" 4
-.el .IP "\f(CW$bool\fR = \f(CW$term\fR\->is_longer ($row_number)" 4
+.ie n .IP "$bool = $term\->is_longer ($row_number)" 4
+.el .IP "$bool = \f(CW$term\fR\->is_longer ($row_number)" 4
.IX Item "$bool = $term->is_longer ($row_number)"
Returns true if the row is part of a multiple-row logical \*(L"line\*(R" (i.e.
joined with the following row), which means all characters are in use
and it is continued on the next row (and possibly a continuation of the
previous row(s)).
-.ie n .IP "$line\fR = \f(CW$term\->line ($row_number)" 4
-.el .IP "\f(CW$line\fR = \f(CW$term\fR\->line ($row_number)" 4
+.ie n .IP "$line = $term\->line ($row_number)" 4
+.el .IP "$line = \f(CW$term\fR\->line ($row_number)" 4
.IX Item "$line = $term->line ($row_number)"
Create and return a new \f(CW\*(C`urxvt::line\*(C'\fR object that stores information
about the logical line that row \f(CW$row_number\fR is part of. It supports the
following methods:
.RS 4
-.ie n .IP "$text\fR = \f(CW$line\->t ([$new_text])" 4
-.el .IP "\f(CW$text\fR = \f(CW$line\fR\->t ([$new_text])" 4
+.ie n .IP "$text = $line\->t ([$new_text])" 4
+.el .IP "$text = \f(CW$line\fR\->t ([$new_text])" 4
.IX Item "$text = $line->t ([$new_text])"
Returns or replaces the full text of the line, similar to \f(CW\*(C`ROW_t\*(C'\fR
-.ie n .IP "$rend\fR = \f(CW$line\->r ([$new_rend])" 4
-.el .IP "\f(CW$rend\fR = \f(CW$line\fR\->r ([$new_rend])" 4
+.ie n .IP "$rend = $line\->r ([$new_rend])" 4
+.el .IP "$rend = \f(CW$line\fR\->r ([$new_rend])" 4
.IX Item "$rend = $line->r ([$new_rend])"
Returns or replaces the full rendition array of the line, similar to \f(CW\*(C`ROW_r\*(C'\fR
-.ie n .IP "$length\fR = \f(CW$line\->l" 4
-.el .IP "\f(CW$length\fR = \f(CW$line\fR\->l" 4
+.ie n .IP "$length = $line\->l" 4
+.el .IP "$length = \f(CW$line\fR\->l" 4
.IX Item "$length = $line->l"
Returns the length of the line in cells, similar to \f(CW\*(C`ROW_l\*(C'\fR.
-.ie n .IP "$rownum\fR = \f(CW$line\->beg" 4
-.el .IP "\f(CW$rownum\fR = \f(CW$line\fR\->beg" 4
+.ie n .IP "$rownum = $line\->beg" 4
+.el .IP "$rownum = \f(CW$line\fR\->beg" 4
.IX Item "$rownum = $line->beg"
.PD 0
-.ie n .IP "$rownum\fR = \f(CW$line\->end" 4
-.el .IP "\f(CW$rownum\fR = \f(CW$line\fR\->end" 4
+.ie n .IP "$rownum = $line\->end" 4
+.el .IP "$rownum = \f(CW$line\fR\->end" 4
.IX Item "$rownum = $line->end"
.PD
Return the row number of the first/last row of the line, respectively.
-.ie n .IP "$offset\fR = \f(CW$line\fR\->offset_of ($row, \f(CW$col)" 4
-.el .IP "\f(CW$offset\fR = \f(CW$line\fR\->offset_of ($row, \f(CW$col\fR)" 4
+.ie n .IP "$offset = $line\fR\->offset_of ($row, \f(CW$col)" 4
+.el .IP "$offset = \f(CW$line\fR\->offset_of ($row, \f(CW$col\fR)" 4
.IX Item "$offset = $line->offset_of ($row, $col)"
Returns the character offset of the given row|col pair within the logical
line. Works for rows outside the line, too, and returns corresponding
.RE
.RS 4
.RE
-.ie n .IP "$text\fR = \f(CW$term\fR\->special_encode \f(CW$string" 4
-.el .IP "\f(CW$text\fR = \f(CW$term\fR\->special_encode \f(CW$string\fR" 4
+.ie n .IP "$text = $term\fR\->special_encode \f(CW$string" 4
+.el .IP "$text = \f(CW$term\fR\->special_encode \f(CW$string\fR" 4
.IX Item "$text = $term->special_encode $string"
Converts a perl string into the special encoding used by rxvt\-unicode,
where one character corresponds to one screen cell. See
\&\f(CW\*(C`$term\->ROW_t\*(C'\fR for details.
-.ie n .IP "$string\fR = \f(CW$term\fR\->special_decode \f(CW$text" 4
-.el .IP "\f(CW$string\fR = \f(CW$term\fR\->special_decode \f(CW$text\fR" 4
+.ie n .IP "$string = $term\fR\->special_decode \f(CW$text" 4
+.el .IP "$string = \f(CW$term\fR\->special_decode \f(CW$text\fR" 4
.IX Item "$string = $term->special_decode $text"
Converts rxvt-unicodes text representation into a perl string. See
\&\f(CW\*(C`$term\->ROW_t\*(C'\fR for details.
-.ie n .IP "$success\fR = \f(CW$term\fR\->grab_button ($button, \f(CW$modifiermask\fR[, \f(CW$window\fR = \f(CW$term\->vt])" 4
-.el .IP "\f(CW$success\fR = \f(CW$term\fR\->grab_button ($button, \f(CW$modifiermask\fR[, \f(CW$window\fR = \f(CW$term\fR\->vt])" 4
+.ie n .IP "$success = $term\fR\->grab_button ($button, \f(CW$modifiermask\fR[, \f(CW$window\fR = \f(CW$term\->vt])" 4
+.el .IP "$success = \f(CW$term\fR\->grab_button ($button, \f(CW$modifiermask\fR[, \f(CW$window\fR = \f(CW$term\fR\->vt])" 4
.IX Item "$success = $term->grab_button ($button, $modifiermask[, $window = $term->vt])"
.PD 0
-.ie n .IP "$term\fR\->ungrab_button ($button, \f(CW$modifiermask\fR[, \f(CW$window\fR = \f(CW$term\->vt])" 4
-.el .IP "\f(CW$term\fR\->ungrab_button ($button, \f(CW$modifiermask\fR[, \f(CW$window\fR = \f(CW$term\fR\->vt])" 4
+.ie n .IP "$term\->ungrab_button ($button, $modifiermask\fR[, \f(CW$window\fR = \f(CW$term\->vt])" 4
+.el .IP "$term\->ungrab_button ($button, \f(CW$modifiermask\fR[, \f(CW$window\fR = \f(CW$term\fR\->vt])" 4
.IX Item "$term->ungrab_button ($button, $modifiermask[, $window = $term->vt])"
.PD
Register/unregister a synchronous button grab. See the XGrabButton
manpage.
-.ie n .IP "$success\fR = \f(CW$term\fR\->grab ($eventtime[, \f(CW$sync])" 4
-.el .IP "\f(CW$success\fR = \f(CW$term\fR\->grab ($eventtime[, \f(CW$sync\fR])" 4
+.ie n .IP "$success = $term\fR\->grab ($eventtime[, \f(CW$sync])" 4
+.el .IP "$success = \f(CW$term\fR\->grab ($eventtime[, \f(CW$sync\fR])" 4
.IX Item "$success = $term->grab ($eventtime[, $sync])"
Calls XGrabPointer and XGrabKeyboard in asynchronous (default) or
synchronous (\f(CW$sync\fR is true). Also remembers the grab timestamp.
-.ie n .IP "$term\->allow_events_async" 4
-.el .IP "\f(CW$term\fR\->allow_events_async" 4
+.IP "$term\->allow_events_async" 4
.IX Item "$term->allow_events_async"
Calls XAllowEvents with AsyncBoth for the most recent grab.
-.ie n .IP "$term\->allow_events_sync" 4
-.el .IP "\f(CW$term\fR\->allow_events_sync" 4
+.IP "$term\->allow_events_sync" 4
.IX Item "$term->allow_events_sync"
Calls XAllowEvents with SyncBoth for the most recent grab.
-.ie n .IP "$term\->allow_events_replay" 4
-.el .IP "\f(CW$term\fR\->allow_events_replay" 4
+.IP "$term\->allow_events_replay" 4
.IX Item "$term->allow_events_replay"
Calls XAllowEvents with both ReplayPointer and ReplayKeyboard for the most
recent grab.
-.ie n .IP "$term\->ungrab" 4
-.el .IP "\f(CW$term\fR\->ungrab" 4
+.IP "$term\->ungrab" 4
.IX Item "$term->ungrab"
Calls XUngrab for the most recent grab. Is called automatically on
evaluation errors, as it is better to lose the grab in the error case as
the session.
-.ie n .IP "$atom\fR = \f(CW$term\fR\->XInternAtom ($atom_name[, \f(CW$only_if_exists])" 4
-.el .IP "\f(CW$atom\fR = \f(CW$term\fR\->XInternAtom ($atom_name[, \f(CW$only_if_exists\fR])" 4
+.ie n .IP "$atom = $term\fR\->XInternAtom ($atom_name[, \f(CW$only_if_exists])" 4
+.el .IP "$atom = \f(CW$term\fR\->XInternAtom ($atom_name[, \f(CW$only_if_exists\fR])" 4
.IX Item "$atom = $term->XInternAtom ($atom_name[, $only_if_exists])"
.PD 0
-.ie n .IP "$atom_name\fR = \f(CW$term\->XGetAtomName ($atom)" 4
-.el .IP "\f(CW$atom_name\fR = \f(CW$term\fR\->XGetAtomName ($atom)" 4
+.ie n .IP "$atom_name = $term\->XGetAtomName ($atom)" 4
+.el .IP "$atom_name = \f(CW$term\fR\->XGetAtomName ($atom)" 4
.IX Item "$atom_name = $term->XGetAtomName ($atom)"
-.ie n .IP "@atoms\fR = \f(CW$term\->XListProperties ($window)" 4
-.el .IP "\f(CW@atoms\fR = \f(CW$term\fR\->XListProperties ($window)" 4
+.ie n .IP "@atoms = $term\->XListProperties ($window)" 4
+.el .IP "@atoms = \f(CW$term\fR\->XListProperties ($window)" 4
.IX Item "@atoms = $term->XListProperties ($window)"
.ie n .IP "($type,$format,$octets) = $term\fR\->XGetWindowProperty ($window, \f(CW$property)" 4
.el .IP "($type,$format,$octets) = \f(CW$term\fR\->XGetWindowProperty ($window, \f(CW$property\fR)" 4
.IX Item "($type,$format,$octets) = $term->XGetWindowProperty ($window, $property)"
-.ie n .IP "$term\fR\->XChangeWindowProperty ($window, \f(CW$property\fR, \f(CW$type\fR, \f(CW$format\fR, \f(CW$octets)" 4
-.el .IP "\f(CW$term\fR\->XChangeWindowProperty ($window, \f(CW$property\fR, \f(CW$type\fR, \f(CW$format\fR, \f(CW$octets\fR)" 4
+.ie n .IP "$term\->XChangeWindowProperty ($window, $property\fR, \f(CW$type\fR, \f(CW$format\fR, \f(CW$octets)" 4
+.el .IP "$term\->XChangeWindowProperty ($window, \f(CW$property\fR, \f(CW$type\fR, \f(CW$format\fR, \f(CW$octets\fR)" 4
.IX Item "$term->XChangeWindowProperty ($window, $property, $type, $format, $octets)"
-.ie n .IP "$term\fR\->XDeleteProperty ($window, \f(CW$property)" 4
-.el .IP "\f(CW$term\fR\->XDeleteProperty ($window, \f(CW$property\fR)" 4
+.ie n .IP "$term\->XDeleteProperty ($window, $property)" 4
+.el .IP "$term\->XDeleteProperty ($window, \f(CW$property\fR)" 4
.IX Item "$term->XDeleteProperty ($window, $property)"
-.ie n .IP "$window\fR = \f(CW$term\->DefaultRootWindow" 4
-.el .IP "\f(CW$window\fR = \f(CW$term\fR\->DefaultRootWindow" 4
+.ie n .IP "$window = $term\->DefaultRootWindow" 4
+.el .IP "$window = \f(CW$term\fR\->DefaultRootWindow" 4
.IX Item "$window = $term->DefaultRootWindow"
-.ie n .IP "$term\fR\->XReparentWindow ($window, \f(CW$parent\fR, [$x, \f(CW$y])" 4
-.el .IP "\f(CW$term\fR\->XReparentWindow ($window, \f(CW$parent\fR, [$x, \f(CW$y\fR])" 4
+.ie n .IP "$term\->XReparentWindow ($window, $parent\fR, [$x, \f(CW$y])" 4
+.el .IP "$term\->XReparentWindow ($window, \f(CW$parent\fR, [$x, \f(CW$y\fR])" 4
.IX Item "$term->XReparentWindow ($window, $parent, [$x, $y])"
-.ie n .IP "$term\->XMapWindow ($window)" 4
-.el .IP "\f(CW$term\fR\->XMapWindow ($window)" 4
+.IP "$term\->XMapWindow ($window)" 4
.IX Item "$term->XMapWindow ($window)"
-.ie n .IP "$term\->XUnmapWindow ($window)" 4
-.el .IP "\f(CW$term\fR\->XUnmapWindow ($window)" 4
+.IP "$term\->XUnmapWindow ($window)" 4
.IX Item "$term->XUnmapWindow ($window)"
-.ie n .IP "$term\fR\->XMoveResizeWindow ($window, \f(CW$x\fR, \f(CW$y\fR, \f(CW$width\fR, \f(CW$height)" 4
-.el .IP "\f(CW$term\fR\->XMoveResizeWindow ($window, \f(CW$x\fR, \f(CW$y\fR, \f(CW$width\fR, \f(CW$height\fR)" 4
+.ie n .IP "$term\->XMoveResizeWindow ($window, $x\fR, \f(CW$y\fR, \f(CW$width\fR, \f(CW$height)" 4
+.el .IP "$term\->XMoveResizeWindow ($window, \f(CW$x\fR, \f(CW$y\fR, \f(CW$width\fR, \f(CW$height\fR)" 4
.IX Item "$term->XMoveResizeWindow ($window, $x, $y, $width, $height)"
.ie n .IP "($x, $y\fR, \f(CW$child_window\fR) = \f(CW$term\fR\->XTranslateCoordinates ($src, \f(CW$dst\fR, \f(CW$x\fR, \f(CW$y)" 4
.el .IP "($x, \f(CW$y\fR, \f(CW$child_window\fR) = \f(CW$term\fR\->XTranslateCoordinates ($src, \f(CW$dst\fR, \f(CW$x\fR, \f(CW$y\fR)" 4
.IX Item "($x, $y, $child_window) = $term->XTranslateCoordinates ($src, $dst, $x, $y)"
-.ie n .IP "$term\fR\->XChangeInput ($window, \f(CW$add_events\fR[, \f(CW$del_events])" 4
-.el .IP "\f(CW$term\fR\->XChangeInput ($window, \f(CW$add_events\fR[, \f(CW$del_events\fR])" 4
+.ie n .IP "$term\->XChangeInput ($window, $add_events\fR[, \f(CW$del_events])" 4
+.el .IP "$term\->XChangeInput ($window, \f(CW$add_events\fR[, \f(CW$del_events\fR])" 4
.IX Item "$term->XChangeInput ($window, $add_events[, $del_events])"
.PD
Various X or X\-related functions. The \f(CW$term\fR object only serves as
.ie n .Sh "The ""urxvt::popup"" Class"
.el .Sh "The \f(CWurxvt::popup\fP Class"
.IX Subsection "The urxvt::popup Class"
-.ie n .IP "$popup\->add_title ($title)" 4
-.el .IP "\f(CW$popup\fR\->add_title ($title)" 4
+.IP "$popup\->add_title ($title)" 4
.IX Item "$popup->add_title ($title)"
Adds a non-clickable title to the popup.
-.ie n .IP "$popup\->add_separator ([$sepchr])" 4
-.el .IP "\f(CW$popup\fR\->add_separator ([$sepchr])" 4
+.IP "$popup\->add_separator ([$sepchr])" 4
.IX Item "$popup->add_separator ([$sepchr])"
Creates a separator, optionally using the character given as \f(CW$sepchr\fR.
-.ie n .IP "$popup\fR\->add_button ($text, \f(CW$cb)" 4
-.el .IP "\f(CW$popup\fR\->add_button ($text, \f(CW$cb\fR)" 4
+.ie n .IP "$popup\->add_button ($text, $cb)" 4
+.el .IP "$popup\->add_button ($text, \f(CW$cb\fR)" 4
.IX Item "$popup->add_button ($text, $cb)"
Adds a clickable button to the popup. \f(CW$cb\fR is called whenever it is
selected.
-.ie n .IP "$popup\fR\->add_toggle ($text, \f(CW$initial_value\fR, \f(CW$cb)" 4
-.el .IP "\f(CW$popup\fR\->add_toggle ($text, \f(CW$initial_value\fR, \f(CW$cb\fR)" 4
+.ie n .IP "$popup\->add_toggle ($text, $initial_value\fR, \f(CW$cb)" 4
+.el .IP "$popup\->add_toggle ($text, \f(CW$initial_value\fR, \f(CW$cb\fR)" 4
.IX Item "$popup->add_toggle ($text, $initial_value, $cb)"
Adds a toggle/checkbox item to the popup. The callback gets called
whenever it gets toggled, with a boolean indicating its new value as its
first argument.
-.ie n .IP "$popup\->show" 4
-.el .IP "\f(CW$popup\fR\->show" 4
+.IP "$popup\->show" 4
.IX Item "$popup->show"
Displays the popup (which is initially hidden).
.ie n .Sh "The ""urxvt::timer"" Class"
fractional number of seconds since the epoch. Example:
.PP
.Vb 8
-\& $term\->{overlay} = $term\->overlay (\-1, 0, 8, 1, urxvt::OVERLAY_RSTYLE, 0);
-\& $term\->{timer} = urxvt::timer
-\& \->new
-\& \->interval (1)
-\& \->cb (sub {
-\& $term\->{overlay}\->set (0, 0,
+\& $term->{overlay} = $term->overlay (-1, 0, 8, 1, urxvt::OVERLAY_RSTYLE, 0);
+\& $term->{timer} = urxvt::timer
+\& ->new
+\& ->interval (1)
+\& ->cb (sub {
+\& $term->{overlay}->set (0, 0,
\& sprintf "%2d:%02d:%02d", (localtime urxvt::NOW)[2,1,0]);
\& });
.Ve
-.ie n .IP "$timer = new urxvt::timer" 4
-.el .IP "\f(CW$timer\fR = new urxvt::timer" 4
+.IP "$timer = new urxvt::timer" 4
.IX Item "$timer = new urxvt::timer"
Create a new timer object in started state. It is scheduled to fire
immediately.
-.ie n .IP "$timer\fR = \f(CW$timer\fR\->cb (sub { my ($timer) = \f(CW@_; ... })" 4
-.el .IP "\f(CW$timer\fR = \f(CW$timer\fR\->cb (sub { my ($timer) = \f(CW@_\fR; ... })" 4
+.ie n .IP "$timer = $timer\fR\->cb (sub { my ($timer) = \f(CW@_; ... })" 4
+.el .IP "$timer = \f(CW$timer\fR\->cb (sub { my ($timer) = \f(CW@_\fR; ... })" 4
.IX Item "$timer = $timer->cb (sub { my ($timer) = @_; ... })"
Set the callback to be called when the timer triggers.
-.ie n .IP "$tstamp\fR = \f(CW$timer\->at" 4
-.el .IP "\f(CW$tstamp\fR = \f(CW$timer\fR\->at" 4
+.ie n .IP "$tstamp = $timer\->at" 4
+.el .IP "$tstamp = \f(CW$timer\fR\->at" 4
.IX Item "$tstamp = $timer->at"
Return the time this watcher will fire next.
-.ie n .IP "$timer\fR = \f(CW$timer\->set ($tstamp)" 4
-.el .IP "\f(CW$timer\fR = \f(CW$timer\fR\->set ($tstamp)" 4
+.ie n .IP "$timer = $timer\->set ($tstamp)" 4
+.el .IP "$timer = \f(CW$timer\fR\->set ($tstamp)" 4
.IX Item "$timer = $timer->set ($tstamp)"
Set the time the event is generated to \f(CW$tstamp\fR.
-.ie n .IP "$timer\fR = \f(CW$timer\->interval ($interval)" 4
-.el .IP "\f(CW$timer\fR = \f(CW$timer\fR\->interval ($interval)" 4
+.ie n .IP "$timer = $timer\->interval ($interval)" 4
+.el .IP "$timer = \f(CW$timer\fR\->interval ($interval)" 4
.IX Item "$timer = $timer->interval ($interval)"
Normally (and when \f(CW$interval\fR is \f(CW0\fR), the timer will automatically
stop after it has fired once. If \f(CW$interval\fR is non\-zero, then the timer
is automatically rescheduled at the given intervals.
-.ie n .IP "$timer\fR = \f(CW$timer\->start" 4
-.el .IP "\f(CW$timer\fR = \f(CW$timer\fR\->start" 4
+.ie n .IP "$timer = $timer\->start" 4
+.el .IP "$timer = \f(CW$timer\fR\->start" 4
.IX Item "$timer = $timer->start"
Start the timer.
-.ie n .IP "$timer\fR = \f(CW$timer\->start ($tstamp)" 4
-.el .IP "\f(CW$timer\fR = \f(CW$timer\fR\->start ($tstamp)" 4
+.ie n .IP "$timer = $timer\->start ($tstamp)" 4
+.el .IP "$timer = \f(CW$timer\fR\->start ($tstamp)" 4
.IX Item "$timer = $timer->start ($tstamp)"
Set the event trigger time to \f(CW$tstamp\fR and start the timer.
-.ie n .IP "$timer\fR = \f(CW$timer\->after ($delay)" 4
-.el .IP "\f(CW$timer\fR = \f(CW$timer\fR\->after ($delay)" 4
+.ie n .IP "$timer = $timer\->after ($delay)" 4
+.el .IP "$timer = \f(CW$timer\fR\->after ($delay)" 4
.IX Item "$timer = $timer->after ($delay)"
Like \f(CW\*(C`start\*(C'\fR, but sets the expiry timer to c<urxvt::NOW + \f(CW$delay\fR>.
-.ie n .IP "$timer\fR = \f(CW$timer\->stop" 4
-.el .IP "\f(CW$timer\fR = \f(CW$timer\fR\->stop" 4
+.ie n .IP "$timer = $timer\->stop" 4
+.el .IP "$timer = \f(CW$timer\fR\->stop" 4
.IX Item "$timer = $timer->stop"
Stop the timer.
.ie n .Sh "The ""urxvt::iow"" Class"
This class implements io watchers/events. Example:
.PP
.Vb 12
-\& $term\->{socket} = ...
-\& $term\->{iow} = urxvt::iow
-\& \->new
-\& \->fd (fileno $term\->{socket})
-\& \->events (urxvt::EVENT_READ)
-\& \->start
-\& \->cb (sub {
+\& $term->{socket} = ...
+\& $term->{iow} = urxvt::iow
+\& ->new
+\& ->fd (fileno $term->{socket})
+\& ->events (urxvt::EVENT_READ)
+\& ->start
+\& ->cb (sub {
\& my ($iow, $revents) = @_;
\& # $revents must be 1 here, no need to check
-\& sysread $term\->{socket}, my $buf, 8192
-\& or end\-of\-file;
+\& sysread $term->{socket}, my $buf, 8192
+\& or end-of-file;
\& });
.Ve
-.ie n .IP "$iow = new urxvt::iow" 4
-.el .IP "\f(CW$iow\fR = new urxvt::iow" 4
+.IP "$iow = new urxvt::iow" 4
.IX Item "$iow = new urxvt::iow"
Create a new io watcher object in stopped state.
-.ie n .IP "$iow\fR = \f(CW$iow\fR\->cb (sub { my ($iow, \f(CW$reventmask\fR) = \f(CW@_; ... })" 4
-.el .IP "\f(CW$iow\fR = \f(CW$iow\fR\->cb (sub { my ($iow, \f(CW$reventmask\fR) = \f(CW@_\fR; ... })" 4
+.ie n .IP "$iow = $iow\fR\->cb (sub { my ($iow, \f(CW$reventmask\fR) = \f(CW@_; ... })" 4
+.el .IP "$iow = \f(CW$iow\fR\->cb (sub { my ($iow, \f(CW$reventmask\fR) = \f(CW@_\fR; ... })" 4
.IX Item "$iow = $iow->cb (sub { my ($iow, $reventmask) = @_; ... })"
Set the callback to be called when io events are triggered. \f(CW$reventmask\fR
is a bitset as described in the \f(CW\*(C`events\*(C'\fR method.
-.ie n .IP "$iow\fR = \f(CW$iow\->fd ($fd)" 4
-.el .IP "\f(CW$iow\fR = \f(CW$iow\fR\->fd ($fd)" 4
+.ie n .IP "$iow = $iow\->fd ($fd)" 4
+.el .IP "$iow = \f(CW$iow\fR\->fd ($fd)" 4
.IX Item "$iow = $iow->fd ($fd)"
Set the file descriptor (not handle) to watch.
-.ie n .IP "$iow\fR = \f(CW$iow\->events ($eventmask)" 4
-.el .IP "\f(CW$iow\fR = \f(CW$iow\fR\->events ($eventmask)" 4
+.ie n .IP "$iow = $iow\->events ($eventmask)" 4
+.el .IP "$iow = \f(CW$iow\fR\->events ($eventmask)" 4
.IX Item "$iow = $iow->events ($eventmask)"
Set the event mask to watch. The only allowed values are
\&\f(CW\*(C`urxvt::EVENT_READ\*(C'\fR and \f(CW\*(C`urxvt::EVENT_WRITE\*(C'\fR, which might be ORed
together, or \f(CW\*(C`urxvt::EVENT_NONE\*(C'\fR.
-.ie n .IP "$iow\fR = \f(CW$iow\->start" 4
-.el .IP "\f(CW$iow\fR = \f(CW$iow\fR\->start" 4
+.ie n .IP "$iow = $iow\->start" 4
+.el .IP "$iow = \f(CW$iow\fR\->start" 4
.IX Item "$iow = $iow->start"
Start watching for requested events on the given handle.
-.ie n .IP "$iow\fR = \f(CW$iow\->stop" 4
-.el .IP "\f(CW$iow\fR = \f(CW$iow\fR\->stop" 4
+.ie n .IP "$iow = $iow\->stop" 4
+.el .IP "$iow = \f(CW$iow\fR\->stop" 4
.IX Item "$iow = $iow->stop"
Stop watching for events on the given file handle.
.ie n .Sh "The ""urxvt::iw"" Class"
This class implements idle watchers, that get called automatically when
the process is idle. They should return as fast as possible, after doing
some useful work.
-.ie n .IP "$iw = new urxvt::iw" 4
-.el .IP "\f(CW$iw\fR = new urxvt::iw" 4
+.IP "$iw = new urxvt::iw" 4
.IX Item "$iw = new urxvt::iw"
Create a new idle watcher object in stopped state.
-.ie n .IP "$iw\fR = \f(CW$iw\fR\->cb (sub { my ($iw) = \f(CW@_; ... })" 4
-.el .IP "\f(CW$iw\fR = \f(CW$iw\fR\->cb (sub { my ($iw) = \f(CW@_\fR; ... })" 4
+.ie n .IP "$iw = $iw\fR\->cb (sub { my ($iw) = \f(CW@_; ... })" 4
+.el .IP "$iw = \f(CW$iw\fR\->cb (sub { my ($iw) = \f(CW@_\fR; ... })" 4
.IX Item "$iw = $iw->cb (sub { my ($iw) = @_; ... })"
Set the callback to be called when the watcher triggers.
-.ie n .IP "$timer\fR = \f(CW$timer\->start" 4
-.el .IP "\f(CW$timer\fR = \f(CW$timer\fR\->start" 4
+.ie n .IP "$timer = $timer\->start" 4
+.el .IP "$timer = \f(CW$timer\fR\->start" 4
.IX Item "$timer = $timer->start"
Start the watcher.
-.ie n .IP "$timer\fR = \f(CW$timer\->stop" 4
-.el .IP "\f(CW$timer\fR = \f(CW$timer\fR\->stop" 4
+.ie n .IP "$timer = $timer\->stop" 4
+.el .IP "$timer = \f(CW$timer\fR\->stop" 4
.IX Item "$timer = $timer->stop"
Stop the watcher.
.ie n .Sh "The ""urxvt::pw"" Class"
.Vb 9
\& my $pid = fork;
\& ...
-\& $term\->{pw} = urxvt::pw
-\& \->new
-\& \->start ($pid)
-\& \->cb (sub {
+\& $term->{pw} = urxvt::pw
+\& ->new
+\& ->start ($pid)
+\& ->cb (sub {
\& my ($pw, $exit_status) = @_;
\& ...
\& });
.Ve
-.ie n .IP "$pw = new urxvt::pw" 4
-.el .IP "\f(CW$pw\fR = new urxvt::pw" 4
+.IP "$pw = new urxvt::pw" 4
.IX Item "$pw = new urxvt::pw"
Create a new process watcher in stopped state.
-.ie n .IP "$pw\fR = \f(CW$pw\fR\->cb (sub { my ($pw, \f(CW$exit_status\fR) = \f(CW@_; ... })" 4
-.el .IP "\f(CW$pw\fR = \f(CW$pw\fR\->cb (sub { my ($pw, \f(CW$exit_status\fR) = \f(CW@_\fR; ... })" 4
+.ie n .IP "$pw = $pw\fR\->cb (sub { my ($pw, \f(CW$exit_status\fR) = \f(CW@_; ... })" 4
+.el .IP "$pw = \f(CW$pw\fR\->cb (sub { my ($pw, \f(CW$exit_status\fR) = \f(CW@_\fR; ... })" 4
.IX Item "$pw = $pw->cb (sub { my ($pw, $exit_status) = @_; ... })"
Set the callback to be called when the timer triggers.
-.ie n .IP "$pw\fR = \f(CW$timer\->start ($pid)" 4
-.el .IP "\f(CW$pw\fR = \f(CW$timer\fR\->start ($pid)" 4
+.ie n .IP "$pw = $timer\->start ($pid)" 4
+.el .IP "$pw = \f(CW$timer\fR\->start ($pid)" 4
.IX Item "$pw = $timer->start ($pid)"
Tells the watcher to start watching for process \f(CW$pid\fR.
-.ie n .IP "$pw\fR = \f(CW$pw\->stop" 4
-.el .IP "\f(CW$pw\fR = \f(CW$pw\fR\->stop" 4
+.ie n .IP "$pw = $pw\->stop" 4
+.el .IP "$pw = \f(CW$pw\fR\->stop" 4
.IX Item "$pw = $pw->stop"
Stop the watcher.
.SH "ENVIRONMENT"
.IX Header "AUTHOR"
.Vb 2
\& Marc Lehmann <pcg@goof.com>
-\& http://software.schmorp.de/pkg/rxvt\-unicode
+\& http://software.schmorp.de/pkg/rxvt-unicode
.Ve
following pattern matches the filename (note, there is a single
space at the very end):
- URxvt.selection.pattern-0: ^(/[^:]+):\
+ URxvt.selection.pattern-0: ^(/[^:]+):\
You can look at the source of the selection extension to see more
interesting uses, such as parsing a line from beginning to end.
See *COLOR AND GRAPHICS* in the rxvt(1) manpage for valid indices.
- mark-urls
- Uses per-line display filtering ("on_line_update") to underline urls
- and make them clickable. When middle-clicked, the program specified
- in the resource "urlLauncher" (default "x-www-browser") will be
- started with the URL as first argument.
+ matcher
+ Uses per-line display filtering ("on_line_update") to underline text
+ matching a certain pattern and make it clickable. When clicked with
+ the mouse button specified in the "matcher.button" resource (default
+ 2, or middle), the program specified in the "matcher.launcher"
+ resource (default, the "urlLauncher" resource, "sensible-browser")
+ will be started with the matched text as first argument. The default
+ configuration is suitable for matching URLs and launching a web
+ browser, like the former "mark-urls" extension.
+
+ The default pattern to match URLs can be overridden with the
+ "matcher.pattern.0" resource, and additional patterns can be
+ specified with numbered patterns, in a manner similar to the
+ "selection" extension. The launcher can also be overridden on a
+ per-pattern basis.
+
+ Example configuration:
+
+ URxvt.perl-ext: default,matcher
+ URxvt.urlLauncher: sensible-browser
+ URxvt.matcher.button: 1
+ URxvt.matcher.pattern.1: \\bwww\\.[\\w-]+\\.[\\w./?&@#-]*[\\w/-]
+ URxvt.matcher.pattern.2: \\B(/\\S+?):(\\d+)(?=:|$)
+ URxvt.matcher.launcher.2: gvim +$2 $1
xim-onthespot
This (experimental) perl extension implements OnTheSpot editing. It
URxvt.selection-pastebin.url: http://www.ta-sa.org/files/txt/%
+ *Note to xrdb users:* xrdb uses the C preprocessor, which might
+ interpret the double "/" characters as comment start. Use "\057\057"
+ instead, which works regardless of wether xrdb is used to parse the
+ resource file or not.
+
example-refresh-hooks
Displays a very simple digital clock in the upper right corner of
the window. Illustrates overwriting the refresh callbacks to create
Extension Objects
Every perl extension is a perl class. A separate perl object is created
- for each terminal and each extension and passed as the first parameter
- to hooks. So extensions can use their $self object without having to
- think about other extensions, with the exception of methods and members
- that begin with an underscore character "_": these are reserved for
- internal use.
+ for each terminal, and each terminal has its own set of extenion
+ objects, which are passed as the first parameter to hooks. So extensions
+ can use their $self object without having to think about clashes with
+ other extensions or other terminals, with the exception of methods and
+ members that begin with an underscore character "_": these are reserved
+ for internal use.
Although it isn't a "urxvt::term" object, you can call all methods of
the "urxvt::term" class on this object.
->cb (sub {
$term->{overlay}->set (0, 0,
sprintf "%2d:%02d:%02d", (localtime urxvt::NOW)[2,1,0]);
- });
+ });
$timer = new urxvt::timer
Create a new timer object in started state. It is scheduled to fire
->cb (sub {
my ($pw, $exit_status) = @_;
...
- });
+ });
$pw = new urxvt::pw
Create a new process watcher in stopped state.
xpm.lo: ../config.h rxvt.h rxvtlib.h optinc.h feature.h encoding.h rxvtutil.h
xpm.lo: rxvtfont.h rxvttoolkit.h iom.h iom_conf.h callback.h salloc.h
xpm.lo: libptytty.h rxvtperl.h hookinc.h rsinc.h
+
+command.lo: ../config.h rxvt.h rxvtlib.h optinc.h feature.h encoding.h
+command.lo: rxvtutil.h rxvtfont.h rxvttoolkit.h iom.h iom_conf.h callback.h
+command.lo: salloc.h libptytty.h rxvtperl.h hookinc.h rsinc.h version.h
+command.lo: command.h keyboard.h
+encoding.lo: ../config.h encoding.h table/iso8859_1.h table/iso8859_15.h
+encoding.lo: table/iso8859_2.h table/iso8859_3.h table/iso8859_4.h
+encoding.lo: table/iso8859_5.h table/iso8859_6.h table/iso8859_7.h
+encoding.lo: table/iso8859_8.h table/iso8859_9.h table/iso8859_10.h
+encoding.lo: table/iso8859_11.h table/iso8859_13.h table/iso8859_14.h
+encoding.lo: table/iso8859_16.h table/koi8_r.h table/koi8_u.h
+encoding.lo: table/ksc5601_1987_0.h table/big5.h table/gbk_0.h
+encoding.lo: table/gb2312_1980_0.h table/cns11643_1992_1.h
+encoding.lo: table/cns11643_1992_2.h table/cns11643_1992_3.h
+encoding.lo: table/cns11643_1992_4.h table/cns11643_1992_5.h
+encoding.lo: table/cns11643_1992_6.h table/cns11643_1992_7.h
+encoding.lo: table/cns11643_1992_f.h table/big5_ext.h table/big5_plus.h
+encoding.lo: table/viscii.h table/jis0201_1976_0.h table/jis0208_1990_0.h
+encoding.lo: table/jis0212_1990_0.h table/jis0213_1.h table/jis0213_2.h
+encoding.lo: table/compose.h table/category.h
+fdpass.lo: ../config.h libptytty.h
+init.lo: ../config.h rxvt.h rxvtlib.h optinc.h feature.h encoding.h
+init.lo: rxvtutil.h rxvtfont.h rxvttoolkit.h iom.h iom_conf.h callback.h
+init.lo: salloc.h libptytty.h rxvtperl.h hookinc.h rsinc.h init.h
+iom.lo: iom.h iom_conf.h rxvtutil.h callback.h
+keyboard.lo: ../config.h rxvt.h rxvtlib.h optinc.h feature.h encoding.h
+keyboard.lo: rxvtutil.h rxvtfont.h rxvttoolkit.h iom.h iom_conf.h callback.h
+keyboard.lo: salloc.h libptytty.h rxvtperl.h hookinc.h rsinc.h keyboard.h
+keyboard.lo: command.h
+logging.lo: ../config.h ptytty.h libptytty.h ptytty_conf.h rxvt.h rxvtlib.h
+logging.lo: optinc.h feature.h encoding.h rxvtutil.h rxvtfont.h rxvttoolkit.h
+logging.lo: iom.h iom_conf.h callback.h salloc.h rxvtperl.h hookinc.h rsinc.h
+main.lo: ../config.h rxvt.h rxvtlib.h optinc.h feature.h encoding.h
+main.lo: rxvtutil.h rxvtfont.h rxvttoolkit.h iom.h iom_conf.h callback.h
+main.lo: salloc.h libptytty.h rxvtperl.h hookinc.h rsinc.h keyboard.h
+misc.lo: ../config.h rxvt.h rxvtlib.h optinc.h feature.h encoding.h
+misc.lo: rxvtutil.h rxvtfont.h rxvttoolkit.h iom.h iom_conf.h callback.h
+misc.lo: salloc.h libptytty.h rxvtperl.h hookinc.h rsinc.h
+netdisp.lo: ../config.h rxvt.h rxvtlib.h optinc.h feature.h encoding.h
+netdisp.lo: rxvtutil.h rxvtfont.h rxvttoolkit.h iom.h iom_conf.h callback.h
+netdisp.lo: salloc.h libptytty.h rxvtperl.h hookinc.h rsinc.h
+proxy.lo: ../config.h ptytty.h libptytty.h ptytty_conf.h rxvt.h rxvtlib.h
+proxy.lo: optinc.h feature.h encoding.h rxvtutil.h rxvtfont.h rxvttoolkit.h
+proxy.lo: iom.h iom_conf.h callback.h salloc.h rxvtperl.h hookinc.h rsinc.h
+ptytty.lo: ../config.h ptytty.h libptytty.h ptytty_conf.h rxvt.h rxvtlib.h
+ptytty.lo: optinc.h feature.h encoding.h rxvtutil.h rxvtfont.h rxvttoolkit.h
+ptytty.lo: iom.h iom_conf.h callback.h salloc.h rxvtperl.h hookinc.h rsinc.h
+rxvt.lo: ../config.h rxvt.h rxvtlib.h optinc.h feature.h encoding.h
+rxvt.lo: rxvtutil.h rxvtfont.h rxvttoolkit.h iom.h iom_conf.h callback.h
+rxvt.lo: salloc.h libptytty.h rxvtperl.h hookinc.h rsinc.h
+rxvtc.lo: ../config.h rxvtdaemon.h rxvtutil.h libptytty.h rxvt.h rxvtlib.h
+rxvtc.lo: optinc.h feature.h encoding.h rxvtfont.h rxvttoolkit.h iom.h
+rxvtc.lo: iom_conf.h callback.h salloc.h rxvtperl.h hookinc.h rsinc.h
+rxvtd.lo: ../config.h rxvt.h rxvtlib.h optinc.h feature.h encoding.h
+rxvtd.lo: rxvtutil.h rxvtfont.h rxvttoolkit.h iom.h iom_conf.h callback.h
+rxvtd.lo: salloc.h libptytty.h rxvtperl.h hookinc.h rsinc.h rxvtdaemon.h
+rxvtdaemon.lo: rxvtdaemon.h rxvtutil.h
+rxvtfont.lo: ../config.h rxvt.h rxvtlib.h optinc.h feature.h encoding.h
+rxvtfont.lo: rxvtutil.h rxvtfont.h rxvttoolkit.h iom.h iom_conf.h callback.h
+rxvtfont.lo: salloc.h libptytty.h rxvtperl.h hookinc.h rsinc.h
+rxvtfont.lo: table/linedraw.h
+rxvtperl.lo: ../config.h iom.h iom_conf.h rxvtutil.h callback.h rxvt.h
+rxvtperl.lo: rxvtlib.h optinc.h feature.h encoding.h rxvtfont.h rxvttoolkit.h
+rxvtperl.lo: salloc.h libptytty.h rxvtperl.h hookinc.h rsinc.h keyboard.h
+rxvtperl.lo: perlxsi.c
+rxvttoolkit.lo: ../config.h rxvt.h rxvtlib.h optinc.h feature.h encoding.h
+rxvttoolkit.lo: rxvtutil.h rxvtfont.h rxvttoolkit.h iom.h iom_conf.h
+rxvttoolkit.lo: callback.h salloc.h libptytty.h rxvtperl.h hookinc.h rsinc.h
+rxvtutil.lo: rxvtutil.h
+salloc.lo: salloc.h
+screen.lo: ../config.h rxvt.h rxvtlib.h optinc.h feature.h encoding.h
+screen.lo: rxvtutil.h rxvtfont.h rxvttoolkit.h iom.h iom_conf.h callback.h
+screen.lo: salloc.h libptytty.h rxvtperl.h hookinc.h rsinc.h salloc.C
+scrollbar-next.lo: ../config.h rxvt.h rxvtlib.h optinc.h feature.h encoding.h
+scrollbar-next.lo: rxvtutil.h rxvtfont.h rxvttoolkit.h iom.h iom_conf.h
+scrollbar-next.lo: callback.h salloc.h libptytty.h rxvtperl.h hookinc.h
+scrollbar-next.lo: rsinc.h
+scrollbar-plain.lo: ../config.h rxvt.h rxvtlib.h optinc.h feature.h
+scrollbar-plain.lo: encoding.h rxvtutil.h rxvtfont.h rxvttoolkit.h iom.h
+scrollbar-plain.lo: iom_conf.h callback.h salloc.h libptytty.h rxvtperl.h
+scrollbar-plain.lo: hookinc.h rsinc.h
+scrollbar-rxvt.lo: ../config.h rxvt.h rxvtlib.h optinc.h feature.h encoding.h
+scrollbar-rxvt.lo: rxvtutil.h rxvtfont.h rxvttoolkit.h iom.h iom_conf.h
+scrollbar-rxvt.lo: callback.h salloc.h libptytty.h rxvtperl.h hookinc.h
+scrollbar-rxvt.lo: rsinc.h
+scrollbar-xterm.lo: ../config.h rxvt.h rxvtlib.h optinc.h feature.h
+scrollbar-xterm.lo: encoding.h rxvtutil.h rxvtfont.h rxvttoolkit.h iom.h
+scrollbar-xterm.lo: iom_conf.h callback.h salloc.h libptytty.h rxvtperl.h
+scrollbar-xterm.lo: hookinc.h rsinc.h
+scrollbar.lo: ../config.h rxvt.h rxvtlib.h optinc.h feature.h encoding.h
+scrollbar.lo: rxvtutil.h rxvtfont.h rxvttoolkit.h iom.h iom_conf.h callback.h
+scrollbar.lo: salloc.h libptytty.h rxvtperl.h hookinc.h rsinc.h
+xdefaults.lo: ../config.h rxvt.h rxvtlib.h optinc.h feature.h encoding.h
+xdefaults.lo: rxvtutil.h rxvtfont.h rxvttoolkit.h iom.h iom_conf.h callback.h
+xdefaults.lo: salloc.h libptytty.h rxvtperl.h hookinc.h rsinc.h version.h
+xdefaults.lo: keyboard.h
+xpm.lo: ../config.h rxvt.h rxvtlib.h optinc.h feature.h encoding.h rxvtutil.h
+xpm.lo: rxvtfont.h rxvttoolkit.h iom.h iom_conf.h callback.h salloc.h
+xpm.lo: libptytty.h rxvtperl.h hookinc.h rsinc.h
+
+command.lo: ../config.h rxvt.h rxvtlib.h optinc.h feature.h encoding.h
+command.lo: rxvtutil.h rxvtfont.h rxvttoolkit.h iom.h iom_conf.h callback.h
+command.lo: salloc.h libptytty.h rxvtperl.h hookinc.h rsinc.h version.h
+command.lo: command.h keyboard.h
+encoding.lo: ../config.h encoding.h table/iso8859_1.h table/iso8859_15.h
+encoding.lo: table/iso8859_2.h table/iso8859_3.h table/iso8859_4.h
+encoding.lo: table/iso8859_5.h table/iso8859_6.h table/iso8859_7.h
+encoding.lo: table/iso8859_8.h table/iso8859_9.h table/iso8859_10.h
+encoding.lo: table/iso8859_11.h table/iso8859_13.h table/iso8859_14.h
+encoding.lo: table/iso8859_16.h table/koi8_r.h table/koi8_u.h
+encoding.lo: table/ksc5601_1987_0.h table/big5.h table/gbk_0.h
+encoding.lo: table/gb2312_1980_0.h table/cns11643_1992_1.h
+encoding.lo: table/cns11643_1992_2.h table/cns11643_1992_3.h
+encoding.lo: table/cns11643_1992_4.h table/cns11643_1992_5.h
+encoding.lo: table/cns11643_1992_6.h table/cns11643_1992_7.h
+encoding.lo: table/cns11643_1992_f.h table/big5_ext.h table/big5_plus.h
+encoding.lo: table/viscii.h table/jis0201_1976_0.h table/jis0208_1990_0.h
+encoding.lo: table/jis0212_1990_0.h table/jis0213_1.h table/jis0213_2.h
+encoding.lo: table/compose.h table/category.h
+fdpass.lo: ../config.h libptytty.h
+init.lo: ../config.h rxvt.h rxvtlib.h optinc.h feature.h encoding.h
+init.lo: rxvtutil.h rxvtfont.h rxvttoolkit.h iom.h iom_conf.h callback.h
+init.lo: salloc.h libptytty.h rxvtperl.h hookinc.h rsinc.h init.h
+iom.lo: iom.h iom_conf.h rxvtutil.h callback.h
+keyboard.lo: ../config.h rxvt.h rxvtlib.h optinc.h feature.h encoding.h
+keyboard.lo: rxvtutil.h rxvtfont.h rxvttoolkit.h iom.h iom_conf.h callback.h
+keyboard.lo: salloc.h libptytty.h rxvtperl.h hookinc.h rsinc.h keyboard.h
+keyboard.lo: command.h
+logging.lo: ../config.h ptytty.h libptytty.h ptytty_conf.h rxvt.h rxvtlib.h
+logging.lo: optinc.h feature.h encoding.h rxvtutil.h rxvtfont.h rxvttoolkit.h
+logging.lo: iom.h iom_conf.h callback.h salloc.h rxvtperl.h hookinc.h rsinc.h
+main.lo: ../config.h rxvt.h rxvtlib.h optinc.h feature.h encoding.h
+main.lo: rxvtutil.h rxvtfont.h rxvttoolkit.h iom.h iom_conf.h callback.h
+main.lo: salloc.h libptytty.h rxvtperl.h hookinc.h rsinc.h keyboard.h
+misc.lo: ../config.h rxvt.h rxvtlib.h optinc.h feature.h encoding.h
+misc.lo: rxvtutil.h rxvtfont.h rxvttoolkit.h iom.h iom_conf.h callback.h
+misc.lo: salloc.h libptytty.h rxvtperl.h hookinc.h rsinc.h
+netdisp.lo: ../config.h rxvt.h rxvtlib.h optinc.h feature.h encoding.h
+netdisp.lo: rxvtutil.h rxvtfont.h rxvttoolkit.h iom.h iom_conf.h callback.h
+netdisp.lo: salloc.h libptytty.h rxvtperl.h hookinc.h rsinc.h
+proxy.lo: ../config.h ptytty.h libptytty.h ptytty_conf.h rxvt.h rxvtlib.h
+proxy.lo: optinc.h feature.h encoding.h rxvtutil.h rxvtfont.h rxvttoolkit.h
+proxy.lo: iom.h iom_conf.h callback.h salloc.h rxvtperl.h hookinc.h rsinc.h
+ptytty.lo: ../config.h ptytty.h libptytty.h ptytty_conf.h rxvt.h rxvtlib.h
+ptytty.lo: optinc.h feature.h encoding.h rxvtutil.h rxvtfont.h rxvttoolkit.h
+ptytty.lo: iom.h iom_conf.h callback.h salloc.h rxvtperl.h hookinc.h rsinc.h
+rxvt.lo: ../config.h rxvt.h rxvtlib.h optinc.h feature.h encoding.h
+rxvt.lo: rxvtutil.h rxvtfont.h rxvttoolkit.h iom.h iom_conf.h callback.h
+rxvt.lo: salloc.h libptytty.h rxvtperl.h hookinc.h rsinc.h
+rxvtc.lo: ../config.h rxvtdaemon.h rxvtutil.h libptytty.h rxvt.h rxvtlib.h
+rxvtc.lo: optinc.h feature.h encoding.h rxvtfont.h rxvttoolkit.h iom.h
+rxvtc.lo: iom_conf.h callback.h salloc.h rxvtperl.h hookinc.h rsinc.h
+rxvtd.lo: ../config.h rxvt.h rxvtlib.h optinc.h feature.h encoding.h
+rxvtd.lo: rxvtutil.h rxvtfont.h rxvttoolkit.h iom.h iom_conf.h callback.h
+rxvtd.lo: salloc.h libptytty.h rxvtperl.h hookinc.h rsinc.h rxvtdaemon.h
+rxvtdaemon.lo: rxvtdaemon.h rxvtutil.h
+rxvtfont.lo: ../config.h rxvt.h rxvtlib.h optinc.h feature.h encoding.h
+rxvtfont.lo: rxvtutil.h rxvtfont.h rxvttoolkit.h iom.h iom_conf.h callback.h
+rxvtfont.lo: salloc.h libptytty.h rxvtperl.h hookinc.h rsinc.h
+rxvtfont.lo: table/linedraw.h
+rxvtperl.lo: ../config.h iom.h iom_conf.h rxvtutil.h callback.h rxvt.h
+rxvtperl.lo: rxvtlib.h optinc.h feature.h encoding.h rxvtfont.h rxvttoolkit.h
+rxvtperl.lo: salloc.h libptytty.h rxvtperl.h hookinc.h rsinc.h keyboard.h
+rxvtperl.lo: perlxsi.c
+rxvttoolkit.lo: ../config.h rxvt.h rxvtlib.h optinc.h feature.h encoding.h
+rxvttoolkit.lo: rxvtutil.h rxvtfont.h rxvttoolkit.h iom.h iom_conf.h
+rxvttoolkit.lo: callback.h salloc.h libptytty.h rxvtperl.h hookinc.h rsinc.h
+rxvtutil.lo: rxvtutil.h
+salloc.lo: salloc.h
+screen.lo: ../config.h rxvt.h rxvtlib.h optinc.h feature.h encoding.h
+screen.lo: rxvtutil.h rxvtfont.h rxvttoolkit.h iom.h iom_conf.h callback.h
+screen.lo: salloc.h libptytty.h rxvtperl.h hookinc.h rsinc.h salloc.C
+scrollbar-next.lo: ../config.h rxvt.h rxvtlib.h optinc.h feature.h encoding.h
+scrollbar-next.lo: rxvtutil.h rxvtfont.h rxvttoolkit.h iom.h iom_conf.h
+scrollbar-next.lo: callback.h salloc.h libptytty.h rxvtperl.h hookinc.h
+scrollbar-next.lo: rsinc.h
+scrollbar-plain.lo: ../config.h rxvt.h rxvtlib.h optinc.h feature.h
+scrollbar-plain.lo: encoding.h rxvtutil.h rxvtfont.h rxvttoolkit.h iom.h
+scrollbar-plain.lo: iom_conf.h callback.h salloc.h libptytty.h rxvtperl.h
+scrollbar-plain.lo: hookinc.h rsinc.h
+scrollbar-rxvt.lo: ../config.h rxvt.h rxvtlib.h optinc.h feature.h encoding.h
+scrollbar-rxvt.lo: rxvtutil.h rxvtfont.h rxvttoolkit.h iom.h iom_conf.h
+scrollbar-rxvt.lo: callback.h salloc.h libptytty.h rxvtperl.h hookinc.h
+scrollbar-rxvt.lo: rsinc.h
+scrollbar-xterm.lo: ../config.h rxvt.h rxvtlib.h optinc.h feature.h
+scrollbar-xterm.lo: encoding.h rxvtutil.h rxvtfont.h rxvttoolkit.h iom.h
+scrollbar-xterm.lo: iom_conf.h callback.h salloc.h libptytty.h rxvtperl.h
+scrollbar-xterm.lo: hookinc.h rsinc.h
+scrollbar.lo: ../config.h rxvt.h rxvtlib.h optinc.h feature.h encoding.h
+scrollbar.lo: rxvtutil.h rxvtfont.h rxvttoolkit.h iom.h iom_conf.h callback.h
+scrollbar.lo: salloc.h libptytty.h rxvtperl.h hookinc.h rsinc.h
+xdefaults.lo: ../config.h rxvt.h rxvtlib.h optinc.h feature.h encoding.h
+xdefaults.lo: rxvtutil.h rxvtfont.h rxvttoolkit.h iom.h iom_conf.h callback.h
+xdefaults.lo: salloc.h libptytty.h rxvtperl.h hookinc.h rsinc.h version.h
+xdefaults.lo: keyboard.h
+xpm.lo: ../config.h rxvt.h rxvtlib.h optinc.h feature.h encoding.h rxvtutil.h
+xpm.lo: rxvtfont.h rxvttoolkit.h iom.h iom_conf.h callback.h salloc.h
+xpm.lo: libptytty.h rxvtperl.h hookinc.h rsinc.h
// VERSION _must_ be \d.\d+
-#define VERSION "7.9"
-#define DATE "2006-08-07"
+#define VERSION "8.0"
+#define DATE "2006-11-02"