From 3aed0f643a3d4ececac901b269a6aeb8a5e0cb78 Mon Sep 17 00:00:00 2001 From: root Date: Thu, 2 Nov 2006 17:37:47 +0000 Subject: [PATCH] *** empty log message *** --- Changes | 2 +- MANIFEST | 2 +- README.FAQ | 12 +- README.configure | 13 +- doc/rxvt.1.html | 7 +- doc/rxvt.1.man.in | 102 +++--- doc/rxvt.1.txt | 58 ++-- doc/rxvt.7.html | 8 +- doc/rxvt.7.man.in | 287 +++++++++-------- doc/rxvt.7.txt | 519 ++++++++++++++++--------------- doc/rxvtd.1.html | 38 +-- doc/rxvtd.1.man.in | 20 +- doc/rxvtd.1.txt | 50 ++- doc/rxvtperl.3.html | 49 ++- doc/rxvtperl.3.man.in | 702 +++++++++++++++++++++--------------------- doc/rxvtperl.3.txt | 51 ++- src/Makefile.in | 198 ++++++++++++ src/version.h | 4 +- 18 files changed, 1218 insertions(+), 904 deletions(-) diff --git a/Changes b/Changes index 973b0928..4363d24f 100644 --- a/Changes +++ b/Changes @@ -20,7 +20,7 @@ WISH: http://www120.pair.com/mccarthy/nextstep/intro.htmld/Workspace.html is the 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). diff --git a/MANIFEST b/MANIFEST index 96ddd8fe..912d45d7 100644 --- a/MANIFEST +++ b/MANIFEST @@ -166,7 +166,7 @@ src/perl/selection-autotransform 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 diff --git a/README.FAQ b/README.FAQ index b0e75e9a..32be5455 100644 --- a/README.FAQ +++ b/README.FAQ @@ -164,7 +164,7 @@ RXVT-UNICODE/URXVT FREQUENTLY ASKED QUESTIONS 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 :) @@ -774,13 +774,17 @@ RXVT-UNICODE/URXVT FREQUENTLY ASKED QUESTIONS 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 @@ -983,7 +987,7 @@ RXVT-UNICODE/URXVT FREQUENTLY ASKED QUESTIONS xprop -root XIM_SERVERS - + * My input method wants but I want UTF-8, what can I do? You can specify separate locales for the input method and the rest of diff --git a/README.configure b/README.configure index 42601a14..bf128e00 100644 --- a/README.configure +++ b/README.configure @@ -37,12 +37,13 @@ CONFIGURE OPTIONS 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 diff --git a/doc/rxvt.1.html b/doc/rxvt.1.html index c00f02fb..db0c1be9 100644 --- a/doc/rxvt.1.html +++ b/doc/rxvt.1.html @@ -55,7 +55,7 @@

DESCRIPTION

-

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

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 -- @@ -67,7 +67,7 @@ a significant advantage on a machine serving many X sessions.

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.

@@ -1386,7 +1386,8 @@ performed in an exact manner; however, the closest match is assured.

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

+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 diff --git a/doc/rxvt.1.man.in b/doc/rxvt.1.man.in index 26205234..e40b0f7c 100644 --- a/doc/rxvt.1.man.in +++ b/doc/rxvt.1.man.in @@ -1,4 +1,4 @@ -.\" Automatically generated by Pod::Man 2.09 (Pod::Simple 3.04) +.\" Automatically generated by Pod::Man v1.37, Pod::Parser v1.32 .\" .\" Standard preamble: .\" ======================================================================== @@ -129,7 +129,7 @@ .\" ======================================================================== .\" .IX Title "@@RXVT_NAME@@ 1" -.TH @@RXVT_NAME@@ 1 "2006-08-07" "7.9" "RXVT-UNICODE" +.TH @@RXVT_NAME@@ 1 "2006-11-02" "8.0" "RXVT-UNICODE" .SH "NAME" rxvt\-unicode (ouR XVT, unicode) \- (a VT102 emulator for the X window system) .SH "SYNOPSIS" @@ -147,7 +147,7 @@ a significant advantage on a machine serving many X sessions. See @@RXVT_NAME@@(7) (try \f(CW\*(C`man 7 @@RXVT_NAME@@\*(C'\fR) for a list of frequently asked questions and answer to them and some common problems. That document is also accessible on the World-Wide-Web at -. +. .SH "RXVT-UNICODE VS. RXVT" .IX Header "RXVT-UNICODE VS. RXVT" Unlike the original rxvt, \fBrxvt-unicode\fR stores all text in Unicode @@ -255,7 +255,7 @@ used to brighten or darken the image in addition to tinting it; resource \&\fItintColor\fR. Example: .Sp .Vb 1 -\& @@RXVT_NAME@@ \-tr \-tint blue \-sh 40 +\& @@RXVT_NAME@@ -tr -tint blue -sh 40 .Ve .IP "\fB\-sh\fR" 4 .IX Item "-sh" @@ -300,8 +300,8 @@ with \f(CW\*(C`x:\*(C'\fR. To specify an XFT\-font, you need to prefix it with \ e.g.: .Sp .Vb 2 -\& @@RXVT_NAME@@ \-fn "xft:Bitstream Vera Sans Mono:pixelsize=15" -\& @@RXVT_NAME@@ \-fn "9x15bold,xft:Bitstream Vera Sans Mono" +\& @@RXVT_NAME@@ -fn "xft:Bitstream Vera Sans Mono:pixelsize=15" +\& @@RXVT_NAME@@ -fn "9x15bold,xft:Bitstream Vera Sans Mono" .Ve .Sp See also the question \*(L"How does rxvt-unicode choose fonts?\*(R" in the \s-1FAQ\s0 @@ -430,7 +430,7 @@ Please note that you must specify a program with arguments. If you want to run shell commands, you have to specify the shell, like this: .Sp .Vb 1 -\& @@RXVT_NAME@@ \-e sh \-c "shell commands" +\& @@RXVT_NAME@@ -e sh -c "shell commands" .Ve .IP "\fB\-title\fR \fItext\fR" 4 .IX Item "-title text" @@ -517,9 +517,9 @@ used (a longer example is in \fIdoc/embed\fR): .Sp .Vb 5 \& my $rxvt = new Gtk2::Socket; -\& $rxvt\->signal_connect_after (realize => sub { -\& my $xid = $_[0]\->window\->get_xid; -\& system "@@RXVT_NAME@@ \-embed $xid &"; +\& $rxvt->signal_connect_after (realize => sub { +\& my $xid = $_[0]->window->get_xid; +\& system "@@RXVT_NAME@@ -embed $xid &"; \& }); .Ve .IP "\fB\-pty\-fd\fR \fIfile descriptor\fR" 4 @@ -542,14 +542,18 @@ longer example is in \fIdoc/pty\-fd\fR): .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 @@ -567,11 +571,11 @@ starts. @@RXVT_NAME@@ will consult the following files/resources in order, with later settings overwriting earlier ones: .PP .Vb 5 -\& 1. system\-wide app\-defaults file, either locale\-dependent OR global -\& 2. app\-defaults file in $XAPPLRESDIR -\& 3. RESOURCE_MANAGER property on root\-window OR $HOME/.Xdefaults +\& 1. system-wide app-defaults file, either locale-dependent OR global +\& 2. app-defaults file in $XAPPLRESDIR +\& 3. RESOURCE_MANAGER property on root-window OR $HOME/.Xdefaults \& 4. SCREEN_RESOURCES for the current screen -\& 5. $XENVIRONMENT file OR $HOME/.Xdefaults\- +\& 5. $XENVIRONMENT file OR $HOME/.Xdefaults- .Ve .PP Note that when reading X resources, \fB@@RXVT_NAME@@\fR recognizes two class @@ -722,8 +726,8 @@ For example, this font resource .Sp .Vb 5 \& URxvt.font: 9x15bold,\e -\& \-misc\-fixed\-bold\-r\-normal\-\-15\-140\-75\-75\-c\-90\-iso10646\-1,\e -\& \-misc\-fixed\-medium\-r\-normal\-\-15\-140\-75\-75\-c\-90\-iso10646\-1, \e +\& -misc-fixed-bold-r-normal--15-140-75-75-c-90-iso10646-1,\e +\& -misc-fixed-medium-r-normal--15-140-75-75-c-90-iso10646-1, \e \& [codeset=JISX0208]xft:Kochi Gothic:antialias=false, \e \& xft:Code2000:antialias=false .Ve @@ -821,7 +825,7 @@ The string will be interpreted as if typed into the shell as\-is. Example: .Sp .Vb 1 -\& URxvt.print\-pipe: cat > $(TMPDIR=$HOME mktemp urxvt.XXXXXX) +\& URxvt.print-pipe: cat > $(TMPDIR=$HOME mktemp urxvt.XXXXXX) .Ve .Sp This creates a new file in your home directory with the screen contents @@ -1033,7 +1037,8 @@ performed in an exact manner; however, the closest match is assured. \&\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 @@ -1047,15 +1052,15 @@ should be a character not used by the strings. Its usage can be demonstrated by an example: .Sp .Vb 1 -\& URxvt.keysym.M\-C\-0x61: list|\e033 +\& URxvt.keysym.M-C-0x61: list|\e033 .Ve .Sp The above line is equivalent to the following three lines: .Sp .Vb 3 -\& URxvt.keysym.Meta\-Control\-0x61: \e033 -\& URxvt.keysym.Meta\-Control\-0x62: \e033 -\& URxvt.keysym.Meta\-Control\-0x63: \e033 +\& URxvt.keysym.Meta-Control-0x61: \e033 +\& URxvt.keysym.Meta-Control-0x62: \e033 +\& URxvt.keysym.Meta-Control-0x63: \e033 .Ve .Sp If \fIstring\fR takes the form of \f(CW\*(C`command:STRING\*(C'\fR, the specified \fB\s-1STRING\s0\fR @@ -1064,7 +1069,7 @@ example the following means "change the current locale to \f(CW\*(C`zh_CN.GBK\*( when Control-Meta-c is being pressed": .Sp .Vb 1 -\& URxvt.keysym.M\-C\-c: command:\e033]701;zh_CN.GBK\e007 +\& URxvt.keysym.M-C-c: command:\e033]701;zh_CN.GBK\e007 .Ve .Sp If \fIstring\fR takes the form \f(CW\*(C`perl:STRING\*(C'\fR, then the specified \fB\s-1STRING\s0\fR @@ -1073,7 +1078,7 @@ manpage. For example, the \fIselection\fR extension (activated via \&\f(CW\*(C`@@RXVT_NAME@@ \-pe selection\*(C'\fR) listens for \f(CW\*(C`selection:rot13\*(C'\fR events: .Sp .Vb 1 -\& URxvt.keysym.M\-C\-c: perl:selection:rot13 +\& URxvt.keysym.M-C-c: perl:selection:rot13 .Ve .Sp Due the the large number of modifier combinations, a defined key mapping @@ -1090,7 +1095,7 @@ user-defined keymap using the \f(CW\*(C`builtin:\*(C'\fR replacement: .Sp .Vb 2 \& URxvt.keysym.Insert: -\& URxvt.keysym.S\-Insert: builtin: +\& URxvt.keysym.S-Insert: builtin: .Ve .Sp The first line defines a mapping for \f(CW\*(C`Insert\*(C'\fR and \fIany\fR combination @@ -1102,16 +1107,16 @@ the fonts \f(CW\*(C`suxuseuro\*(C'\fR and \f(CW\*(C`9x15bold\*(C'\fR, so you can font-switching at runtime: .Sp .Vb 2 -\& URxvt.keysym.M\-C\-1: command:\e033]50;suxuseuro\e007 -\& URxvt.keysym.M\-C\-2: command:\e033]50;9x15bold\e007 +\& URxvt.keysym.M-C-1: command:\e033]50;suxuseuro\e007 +\& URxvt.keysym.M-C-2: command:\e033]50;9x15bold\e007 .Ve .Sp Other things are possible, e.g. resizing (see @@RXVT_NAME@@(7) for more info): .Sp .Vb 2 -\& URxvt.keysym.M\-C\-3: command:\e033[8;25;80t -\& URxvt.keysym.M\-C\-4: command:\e033[8;48;110t +\& URxvt.keysym.M-C-3: command:\e033[8;25;80t +\& URxvt.keysym.M-C-4: command:\e033[8;48;110t .Ve .IP "\fBperl-ext-common\fR: \fIstring\fR" 4 .IX Item "perl-ext-common: string" @@ -1240,8 +1245,8 @@ You can, however, switch fonts at runtime using escape sequences, e.g.: You can use keyboard shortcuts, too: .PP .Vb 2 -\& URxvt.keysym.M\-C\-1: command:\e033]710;suxuseuro\e007\e033]711;suxuseuro\e007 -\& URxvt.keysym.M\-C\-2: command:\e033]710;9x15bold\e007\e033]711;9x15bold\e007 +\& URxvt.keysym.M-C-1: command:\e033]710;suxuseuro\e007\e033]711;suxuseuro\e007 +\& URxvt.keysym.M-C-2: command:\e033]710;9x15bold\e007\e033]711;9x15bold\e007 .Ve .PP rxvt-unicode will automatically re-apply these fonts to the output so far. @@ -1252,9 +1257,8 @@ and character codes using the keyboard. It consists of 4 parts. The 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 @@ -1269,9 +1273,8 @@ address, which you cannot type. Fortunately, the card has the e\-mail address printed as hexcodes, e.g. \f(CW\*(C`671d 65e5\*(C'\fR. You can enter this easily by pressing \f(CW\*(C`Control\*(C'\fR and \f(CW\*(C`Shift\*(C'\fR, followed by \f(CW\*(C`6\-7\-1\-D\-SPACE\-6\-5\-E\-5\*(C'\fR, followed by releasing the modifier keys. -.IP "\(bu" 4 -5.2: Keyboard symbols entry method -.Sp +.IP "* 5.2: Keyboard symbols entry method" 4 +.IX Item "5.2: Keyboard symbols entry method" This mode lets you input characters representing the keycap symbols of your keyboard, if representable in the current locale encoding. .Sp @@ -1282,14 +1285,12 @@ keycap symbol. The symbol will only be entered when the key has been released, otherwise pressing e.g. \f(CW\*(C`Shift\*(C'\fR would enter the symbol for \&\f(CW\*(C`ISO Level 2 Switch\*(C'\fR, although your intention might have been to enter a reverse tab (Shift\-Tab). -.IP "\(bu" 4 -5.3: Screen-selection entry method -.Sp +.IP "* 5.3: Screen-selection entry method" 4 +.IX Item "5.3: Screen-selection entry method" While this is implemented already (it's basically the selection mechanism), it could be extended by displaying a unicode character map. -.IP "\(bu" 4 -5.4: Feedback method for identifying displayed characters for later input -.Sp +.IP "* 5.4: Feedback method for identifying displayed characters for later input" 4 +.IX Item "5.4: Feedback method for identifying displayed characters for later input" This method lets you display the unicode character code associated with characters already displayed. .Sp @@ -1338,6 +1339,7 @@ color15 (bright white) = White 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 @@ -1379,7 +1381,7 @@ For example, the following selects an almost completely transparent red background, and an almost opaque pink foreground: .PP .Vb 1 -\& @@RXVT_NAME@@ \-depth 32 \-bg rgba:0000/0000/0000/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 @@ -1426,7 +1428,7 @@ The shell to be used for command execution, defaults to \f(CW\*(C`/bin/sh\*(C'\f 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. + . RXVT-UNICODE VS. RXVT Unlike the original rxvt, rxvt-unicode stores all text in Unicode @@ -888,7 +888,8 @@ RESOURCES (available also as long-options) "\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 @@ -1091,8 +1092,7 @@ ISO 14755 SUPPORT 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 @@ -1108,8 +1108,7 @@ ISO 14755 SUPPORT 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. @@ -1121,15 +1120,13 @@ ISO 14755 SUPPORT 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. @@ -1158,24 +1155,25 @@ COLORS AND GRAPHICS 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 diff --git a/doc/rxvt.7.html b/doc/rxvt.7.html index 7cb49629..ecba902e 100644 --- a/doc/rxvt.7.html +++ b/doc/rxvt.7.html @@ -156,7 +156,7 @@

This document contains the FAQ, the RXVT TECHNICAL REFERENCE documenting 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.

+http://cvs.schmorp.de/browse/rxvt-unicode/doc/rxvt.7.html.

@@ -893,11 +893,13 @@ works. If unsure, use the form above.

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

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):

    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 diff --git a/doc/rxvt.7.man.in b/doc/rxvt.7.man.in index 3306e39b..8db5351d 100644 --- a/doc/rxvt.7.man.in +++ b/doc/rxvt.7.man.in @@ -1,4 +1,4 @@ -.\" Automatically generated by Pod::Man 2.09 (Pod::Simple 3.04) +.\" Automatically generated by Pod::Man v1.37, Pod::Parser v1.32 .\" .\" Standard preamble: .\" ======================================================================== @@ -129,7 +129,7 @@ .\" ======================================================================== .\" .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" @@ -137,10 +137,14 @@ RXVT REFERENCE \- FAQ, command sequences and other background information .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 @@ -150,7 +154,7 @@ This document contains the \s-1FAQ\s0, the \s-1RXVT\s0 \s-1TECHNICAL\s0 \s-1REFE all escape sequences, and other background information. .PP The newest version of this document is also available on the World Wide Web at -. +. .SH "RXVT\-UNICODE/URXVT FREQUENTLY ASKED QUESTIONS" .IX Header "RXVT-UNICODE/URXVT FREQUENTLY ASKED QUESTIONS" .Sh "Meta, Features & Commandline Issues" @@ -170,9 +174,11 @@ simple tabbed terminal. It is installed by default, so any of these should give you tabs: .PP .Vb 1 -\& @@URXVT_NAME@@ \-pe tabbed -\& -\& URxvt.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 @@ -220,8 +226,8 @@ If you want to start @@URXVT_NAME@@d automatically whenever you run .Vb 6 \& #!/bin/sh \& @@URXVT_NAME@@c "$@" -\& if [ $? \-eq 2 ]; then -\& @@URXVT_NAME@@d \-q \-o \-f +\& if [ $? -eq 2 ]; then +\& @@URXVT_NAME@@d -q -o -f \& @@URXVT_NAME@@c "$@" \& fi .Ve @@ -254,14 +260,14 @@ snippets: .PP .Vb 12 \& # Bourne/Korn/POSIX family of shells: -\& [ ${TERM:\-foo} = foo ] && TERM=xterm # assume an xterm if we don't know -\& if [ ${TERM:\-foo} = xterm ]; then -\& stty \-icanon \-echo min 0 time 15 # see if enhanced rxvt or not -\& echo \-n '^[Z' +\& [ ${TERM:-foo} = foo ] && TERM=xterm # assume an xterm if we don't know +\& if [ ${TERM:-foo} = xterm ]; then +\& stty -icanon -echo min 0 time 15 # see if enhanced rxvt or not +\& echo -n '^[Z' \& read term_id \& stty icanon echo -\& if [ ""${term_id} = '^[[?1;2C' \-a ${DISPLAY:\-foo} = foo ]; then -\& echo \-n '^[[7n' # query the rxvt we are in for the DISPLAY string +\& if [ ""${term_id} = '^[[?1;2C' -a ${DISPLAY:-foo} = foo ]; then +\& echo -n '^[[7n' # query the rxvt we are in for the DISPLAY string \& read DISPLAY # set it in our local shell \& fi \& fi @@ -287,8 +293,8 @@ already in use in this mode. .PP .Vb 3 \& text data bss drs rss filename -\& 98398 1664 24 15695 1824 rxvt \-\-disable\-everything -\& 188985 9048 66616 18222 1788 urxvt \-\-disable\-everything +\& 98398 1664 24 15695 1824 rxvt --disable-everything +\& 188985 9048 66616 18222 1788 urxvt --disable-everything .Ve .PP When you \f(CW\*(C`\-\-enable\-everything\*(C'\fR (which \fIis\fR unfair, as this involves xft @@ -297,8 +303,8 @@ libc), the two diverge, but not unreasonably so. .PP .Vb 3 \& text data bss drs rss filename -\& 163431 2152 24 20123 2060 rxvt \-\-enable\-everything -\& 1035683 49680 66648 29096 3680 urxvt \-\-enable\-everything +\& 163431 2152 24 20123 2060 rxvt --enable-everything +\& 1035683 49680 66648 29096 3680 urxvt --enable-everything .Ve .PP The very large size of the text section is explained by the east-asian @@ -344,7 +350,7 @@ system with a minimal config: \& libX11.so.6 => /usr/X11R6/lib/libX11.so.6 (0x00002aaaaabc3000) \& libc.so.6 => /lib/libc.so.6 (0x00002aaaaadde000) \& libdl.so.2 => /lib/libdl.so.2 (0x00002aaaab01d000) -\& /lib64/ld\-linux\-x86\-64.so.2 (0x00002aaaaaaab000) +\& /lib64/ld-linux-x86-64.so.2 (0x00002aaaaaaab000) .Ve .PP And here is rxvt\-unicode: @@ -354,7 +360,7 @@ And here is rxvt\-unicode: \& libgcc_s.so.1 => /lib/libgcc_s.so.1 (0x00002aaaaada2000) \& libc.so.6 => /lib/libc.so.6 (0x00002aaaaaeb0000) \& libdl.so.2 => /lib/libdl.so.2 (0x00002aaaab0ee000) -\& /lib64/ld\-linux\-x86\-64.so.2 (0x00002aaaaaaab000) +\& /lib64/ld-linux-x86-64.so.2 (0x00002aaaaaaab000) .Ve .PP No large bloated libraries (of course, none were linked in statically), @@ -376,7 +382,7 @@ descriptions for the programs mentioned and rxvt\-unicode. Really, do it! .PP .Vb 2 \& Esetroot wallpaper.jpg -\& @@URXVT_NAME@@ \-ip \-tint red \-sh 40 +\& @@URXVT_NAME@@ -ip -tint red -sh 40 .Ve .PP That works. If you think it doesn't, you lack transparency and tinting @@ -387,8 +393,8 @@ to use effects other than tinting and shading: Just shade/tint/whatever your picture with gimp or any other tool: .PP .Vb 2 -\& convert wallpaper.jpg \-blur 20x20 \-modulate 30 background.xpm -\& @@URXVT_NAME@@ \-pixmap background.xpm \-pe automove\-background +\& convert wallpaper.jpg -blur 20x20 -modulate 30 background.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 @@ -397,7 +403,7 @@ are unable to read. 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 @@ -409,8 +415,8 @@ doesn't mean that your \s-1WM\s0 has the required kludges in place. 4. Use xcompmgr and let it do the job: .PP .Vb 2 -\& xprop \-frame \-f _NET_WM_WINDOW_OPACITY 32c \e -\& \-set _NET_WM_WINDOW_OPACITY 0xc0000000 +\& xprop -frame -f _NET_WM_WINDOW_OPACITY 32c \e +\& -set _NET_WM_WINDOW_OPACITY 0xc0000000 .Ve .PP Then click on a window you want to make transparent. Replace \f(CW0xc0000000\fR @@ -549,7 +555,9 @@ including the murky brown that passes for low-intensity yellow: \& URxvt.color5: #A800A8 \& URxvt.color6: #00A8A8 \& URxvt.color7: #A8A8A8 -\& +.Ve +.PP +.Vb 8 \& URxvt.color8: #000054 \& URxvt.color9: #FF0054 \& URxvt.color10: #00FF54 @@ -562,7 +570,7 @@ including the murky brown that passes for low-intensity yellow: .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 @@ -609,7 +617,7 @@ In that case, select a font of your taste and add it to the font list, e.g.: .PP .Vb 1 -\& @@URXVT_NAME@@ \-fn basefont,font2,font3... +\& @@URXVT_NAME@@ -fn basefont,font2,font3... .Ve .PP When rxvt-unicode sees a character, it will first look at the base @@ -644,8 +652,7 @@ runtime (the internal data structure has no problem with using different 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 @@ -655,7 +662,7 @@ If you want to select e.g. alphanumeric words, you can use the following setting: .PP .Vb 1 -\& URxvt.selection.pattern\-0: ([[:word:]]+) +\& URxvt.selection.pattern-0: ([[:word:]]+) .Ve .PP If you click more than twice, the selection will be extended @@ -664,7 +671,7 @@ more and more. To get a selection that is very similar to the old code, try this pattern: .PP .Vb 1 -\& URxvt.selection.pattern\-0: ([^"&'()*,;<=>?@[\e\e\e\e]^`{|})]+) +\& URxvt.selection.pattern-0: ([^"&'()*,;<=>?@[\e\e\e\e]^`{|})]+) .Ve .PP Please also note that the \fILeftClick Shift-LeftClik\fR combination also @@ -684,7 +691,7 @@ example, to disable the \fBselection-popup\fR and \fBoption-popup\fR, specify this \fBperl-ext-common\fR resource: .PP .Vb 1 -\& URxvt.perl\-ext\-common: default,\-selection\-popup,\-option\-popup +\& URxvt.perl-ext-common: default,-selection-popup,-option-popup .Ve .PP This will keep the default extensions, but disable the two popup @@ -693,7 +700,7 @@ scrollback search mode is triggered by \fBM\-s\fR. You can move it to any other combination either by setting the \fBsearchable-scrollback\fR resource: .PP .Vb 1 -\& URxvt.searchable\-scrollback: CM\-s +\& URxvt.searchable-scrollback: CM-s .Ve .PP \fIThe cursor moves when selecting text in the current input line, how do I switch this off?\fR @@ -714,7 +721,7 @@ You can permanently switch this feature off by disabling the \f(CW\*(C`readline\ extension: .PP .Vb 1 -\& URxvt.perl\-ext\-common: default,\-readline +\& URxvt.perl-ext-common: default,-readline .Ve .PP \fIMy numerical keypad acts weird and generates differing output?\fR @@ -782,7 +789,9 @@ For starting a new rxvt\-unicode: \& # use Backspace = ^H \& $ stty erase ^H \& $ @@URXVT_NAME@@ -\& +.Ve +.PP +.Vb 3 \& # use Backspace = ^? \& $ stty erase ^? \& $ @@URXVT_NAME@@ @@ -795,11 +804,13 @@ For an existing rxvt\-unicode: .Vb 3 \& # use Backspace = ^H \& $ stty erase ^H -\& $ echo \-n "^[[36h" -\& +\& $ echo -n "^[[36h" +.Ve +.PP +.Vb 3 \& # use Backspace = ^? \& $ stty erase ^? -\& $ echo \-n "^[[36l" +\& $ echo -n "^[[36l" .Ve .PP This helps satisfy some of the Backspace discrepancies that occur, but @@ -828,26 +839,26 @@ use the `keysym' resource to alter the keystrings associated with keysyms. .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 -\& URxvt.keysym.C\-slash: \e033 -\& URxvt.keysym.C\-semicolon: \e033 -\& URxvt.keysym.C\-grave: \e033 -\& URxvt.keysym.C\-comma: \e033 -\& URxvt.keysym.C\-period: \e033 -\& URxvt.keysym.C\-0x60: \e033 -\& URxvt.keysym.C\-Tab: \e033 -\& URxvt.keysym.C\-Return: \e033 -\& URxvt.keysym.S\-Return: \e033 -\& URxvt.keysym.S\-space: \e033 -\& URxvt.keysym.M\-Up: \e033 -\& URxvt.keysym.M\-Down: \e033 -\& URxvt.keysym.M\-Left: \e033 -\& URxvt.keysym.M\-Right: \e033 -\& URxvt.keysym.M\-C\-0: list \e033 -\& URxvt.keysym.M\-C\-a: list \e033 +\& URxvt.keysym.C-apostrophe: \e033 +\& URxvt.keysym.C-slash: \e033 +\& URxvt.keysym.C-semicolon: \e033 +\& URxvt.keysym.C-grave: \e033 +\& URxvt.keysym.C-comma: \e033 +\& URxvt.keysym.C-period: \e033 +\& URxvt.keysym.C-0x60: \e033 +\& URxvt.keysym.C-Tab: \e033 +\& URxvt.keysym.C-Return: \e033 +\& URxvt.keysym.S-Return: \e033 +\& URxvt.keysym.S-space: \e033 +\& URxvt.keysym.M-Up: \e033 +\& URxvt.keysym.M-Down: \e033 +\& URxvt.keysym.M-Left: \e033 +\& URxvt.keysym.M-Right: \e033 +\& URxvt.keysym.M-C-0: list \e033 +\& URxvt.keysym.M-C-a: list \e033 \& URxvt.keysym.F12: command:\e033]701;zh_CN.GBK\e007 .Ve .PP @@ -883,13 +894,13 @@ not \fItypical\fR, but what's typical... .PP .Vb 2 \& URxvt.cutchars: "()*,<>[]{}|' -\& URxvt.print\-pipe: cat >/tmp/xxx +\& URxvt.print-pipe: cat >/tmp/xxx .Ve .PP These are just for testing stuff. .PP .Vb 2 -\& URxvt.imLocale: ja_JP.UTF\-8 +\& URxvt.imLocale: ja_JP.UTF-8 \& URxvt.preeditType: OnTheSpot,None .Ve .PP @@ -899,12 +910,12 @@ type, which requires the \f(CW\*(C`xim\-onthespot\*(C'\fR perl extension but rew with correct-looking fonts. .PP .Vb 6 -\& URxvt.perl\-lib: /root/lib/urxvt -\& URxvt.perl\-ext\-common: default,selection\-autotransform,selection\-pastebin,xim\-onthespot,remote\-clipboard -\& URxvt.selection.pattern\-0: ( at .*? line \e\ed+) -\& URxvt.selection.pattern\-1: ^(/[^:]+):\e -\& URxvt.selection\-autotransform.0: s/^([^:[:space:]]+):(\e\ed+):?$/:e \e\eQ$1\e\eE\e\ex0d:$2\e\ex0d/ -\& URxvt.selection\-autotransform.1: s/^ at (.*?) line (\e\ed+)$/:e \e\eQ$1\e\eE\e\ex0d:$2\e\ex0d/ +\& URxvt.perl-lib: /root/lib/urxvt +\& URxvt.perl-ext-common: default,selection-autotransform,selection-pastebin,xim-onthespot,remote-clipboard +\& URxvt.selection.pattern-0: ( at .*? line \e\ed+) +\& URxvt.selection.pattern-1: ^(/[^:]+):\e +\& URxvt.selection-autotransform.0: s/^([^:[:space:]]+):(\e\ed+):?$/:e \e\eQ$1\e\eE\e\ex0d:$2\e\ex0d/ +\& URxvt.selection-autotransform.1: s/^ at (.*?) line (\e\ed+)$/:e \e\eQ$1\e\eE\e\ex0d:$2\e\ex0d/ .Ve .PP This is my perl configuration. The first two set the perl library @@ -991,12 +1002,12 @@ I once thought this is a great idea. .PP .Vb 9 \& urxvt.font: 9x15bold,\e -\& \-misc\-fixed\-bold\-r\-normal\-\-15\-140\-75\-75\-c\-90\-iso10646\-1,\e -\& \-misc\-fixed\-medium\-r\-normal\-\-15\-140\-75\-75\-c\-90\-iso10646\-1, \e +\& -misc-fixed-bold-r-normal--15-140-75-75-c-90-iso10646-1,\e +\& -misc-fixed-medium-r-normal--15-140-75-75-c-90-iso10646-1, \e \& [codeset=JISX0208]xft:Kochi Gothic, \e \& xft:Bitstream Vera Sans Mono:autohint=true, \e \& xft:Code2000:antialias=false -\& urxvt.boldFont: \-xos4\-terminus\-bold\-r\-normal\-\-14\-140\-72\-72\-c\-80\-iso8859\-15 +\& urxvt.boldFont: -xos4-terminus-bold-r-normal--14-140-72-72-c-80-iso8859-15 \& urxvt.italicFont: xft:Bitstream Vera Sans Mono:italic:autohint=true \& urxvt.boldItalicFont: xft:Bitstream Vera Sans Mono:bold:italic:autohint=true .Ve @@ -1028,8 +1039,8 @@ defaults: \& IRC*font: suxuseuro \& IRC*boldFont: suxuseuro \& IRC*colorBD: white -\& IRC*keysym.M\-C\-1: command:\e033]710;suxuseuro\e007\e033]711;suxuseuro\e007 -\& IRC*keysym.M\-C\-2: command:\e033]710;9x15bold\e007\e033]711;9x15bold\e007 +\& IRC*keysym.M-C-1: command:\e033]710;suxuseuro\e007\e033]711;suxuseuro\e007 +\& IRC*keysym.M-C-2: command:\e033]710;9x15bold\e007\e033]711;9x15bold\e007 .Ve .PP \&\f(CW\*(C`Alt\-Shift\-1\*(C'\fR and \f(CW\*(C`Alt\-Shift\-2\*(C'\fR switch between two different font @@ -1042,11 +1053,11 @@ The above is all in my \f(CW\*(C`.Xdefaults\*(C'\fR (I don't use \f(CW\*(C`.Xres file for different hosts, for example, on ym main desktop, I use: .PP .Vb 5 -\& URxvt.keysym.C\-M\-q: command:\e033[3;5;5t -\& URxvt.keysym.C\-M\-y: command:\e033[3;5;606t -\& URxvt.keysym.C\-M\-e: command:\e033[3;1605;5t -\& URxvt.keysym.C\-M\-c: command:\e033[3;1605;606t -\& URxvt.keysym.C\-M\-p: perl:test +\& URxvt.keysym.C-M-q: command:\e033[3;5;5t +\& URxvt.keysym.C-M-y: command:\e033[3;5;606t +\& URxvt.keysym.C-M-e: command:\e033[3;1605;5t +\& URxvt.keysym.C-M-c: command:\e033[3;1605;606t +\& URxvt.keysym.C-M-p: perl:test .Ve .PP The first for keysym definitions allow me to quickly bring some windows @@ -1062,9 +1073,9 @@ Well, why, indeed? It does, in a way very similar to other X 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 @@ -1085,15 +1096,18 @@ 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). .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 @@ -1135,13 +1149,13 @@ You can also create a termcap entry by using terminfo's infocmp program like this: .PP .Vb 1 -\& infocmp \-C rxvt\-unicode +\& infocmp -C rxvt-unicode .Ve .PP Or you could use this termcap entry, generated by the command above: .PP -.Vb 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 @@ -1172,13 +1186,13 @@ file. Needless to say, \f(CW\*(C`rxvt\-unicode\*(C'\fR is not in its default fil with most other terminals supporting colour). Either add: .PP .Vb 1 -\& TERM rxvt\-unicode +\& TERM rxvt-unicode .Ve .PP to \f(CW\*(C`/etc/DIR_COLORS\*(C'\fR or simply add: .PP .Vb 1 -\& alias ls='ls \-\-color=auto' +\& alias ls='ls --color=auto' .Ve .PP to your \f(CW\*(C`.profile\*(C'\fR or \f(CW\*(C`.bashrc\*(C'\fR. @@ -1306,8 +1320,8 @@ first switches to a locale supported by xjdic and back later: .PP .Vb 3 \& printf '\e33]701;%s\e007' ja_JP.SJIS -\& xjdic \-js -\& printf '\e33]701;%s\e007' de_DE.UTF\-8 +\& xjdic -js +\& printf '\e33]701;%s\e007' de_DE.UTF-8 .Ve .PP You can also use xterm's \f(CW\*(C`luit\*(C'\fR program, which usually works fine, except @@ -1339,9 +1353,9 @@ When you want to use e.g. \fBkinput2\fR, it must be set to method servers are running with this command: .Sp .Vb 1 -\& xprop \-root XIM_SERVERS +\& xprop -root XIM_SERVERS .Ve -.IP "" 4 +.IP "*" 4 .PP \fIMy input method wants but I want \s-1UTF\-8\s0, what can I do?\fR .IX Subsection "My input method wants but I want UTF-8, what can I do?" @@ -1350,7 +1364,7 @@ You can specify separate locales for the input method and the rest of the terminal, using the resource \f(CW\*(C`imlocale\*(C'\fR: .PP .Vb 1 -\& URxvt.imlocale: ja_JP.EUC\-JP +\& URxvt.imlocale: ja_JP.EUC-JP .Ve .PP Now you can start your terminal with \f(CW\*(C`LC_CTYPE=ja_JP.UTF\-8\*(C'\fR and still @@ -1669,6 +1683,7 @@ C = 5 Finnish character set unimplemented C = C Finnish character set unimplemented C = K German character set unimplemented .TE + .PP .IX Xref "CSI" @@ -1727,6 +1742,7 @@ Ps = 0 Clear Below (default) 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" @@ -1737,6 +1753,7 @@ Ps = 0 Clear to Right (default) 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" @@ -1764,6 +1781,7 @@ Ps = 0 Tab Set (HTS) 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" @@ -1808,6 +1826,7 @@ l l . 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" @@ -1822,6 +1841,7 @@ Ps = 0 print screen (MC0) 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" @@ -1835,6 +1855,7 @@ l 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 @@ -1844,6 +1865,7 @@ l l . h Automatic Newline (LNM) l Normal Linefeed (LNM) .TE + .RE .RS 4 .RE @@ -1882,6 +1904,7 @@ Ps = 96 / 106 fg/bg Bright Cyan 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" @@ -1893,6 +1916,7 @@ 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) .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" @@ -1925,6 +1949,7 @@ 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 .TE + .ie n .IP "\fB\fB""ESC [ u""\fB\fR" 4 .el .IP "\fB\f(CBESC [ u\fB\fR" 4 .IX Item "ESC [ u" @@ -1967,6 +1992,7 @@ l l . 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 @@ -1976,6 +2002,7 @@ l l . 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" @@ -1984,6 +2011,7 @@ l l . 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" @@ -1992,6 +2020,7 @@ l l . 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" @@ -2000,6 +2029,7 @@ l l . 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" @@ -2008,6 +2038,7 @@ l l . 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" @@ -2016,6 +2047,7 @@ l l . 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" @@ -2024,6 +2056,7 @@ l l . 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" @@ -2032,6 +2065,7 @@ l l . 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" @@ -2040,6 +2074,7 @@ l l . 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" @@ -2048,6 +2083,7 @@ l l . 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)" @@ -2056,6 +2092,7 @@ l l . 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" @@ -2069,6 +2106,7 @@ l l . 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 @@ -2078,6 +2116,7 @@ l l . 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" @@ -2086,6 +2125,7 @@ l l . 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" @@ -2097,6 +2137,7 @@ l l . h Use Alternate Screen Buffer l Use Normal Screen Buffer .TE + .PD .IX Xref "Priv66" @@ -2108,6 +2149,7 @@ l l . 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 @@ -2117,6 +2159,7 @@ l l . 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)" @@ -2125,6 +2168,7 @@ l l . 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" @@ -2133,6 +2177,7 @@ l l . 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)" @@ -2141,6 +2186,7 @@ l l . 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)" @@ -2149,6 +2195,7 @@ l l . 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)" @@ -2157,6 +2204,7 @@ l l . 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" @@ -2165,6 +2213,7 @@ l l . 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" @@ -2173,6 +2222,7 @@ l l . 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" @@ -2181,6 +2231,7 @@ l l . h Use Alternate Screen Buffer - clear Alternate Screen Buffer if switching to it l Use Normal Screen Buffer .TE + .RE .RS 4 .RE @@ -2230,6 +2281,7 @@ Ps = 720 Move viewing window up by Pt lines, or clear scrollback buffer if Pt = 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 @@ -2297,6 +2349,7 @@ l l . 2 Button3 pressed 3 button released (X11 mouse report) .TE + .PP The upper bits of \fB\f(CB\*(C`\*(C'\fB\fR indicate the modifiers when the button was pressed and are added together (X11 mouse report only): @@ -2310,6 +2363,7 @@ l l . 16 Control 32 Double Click (rxvt extension) .TE + Col = \fB\f(CB\*(C` \- SPACE\*(C'\fB\fR .Sp Row = \fB\f(CB\*(C` \- SPACE\*(C'\fB\fR @@ -2383,6 +2437,7 @@ XK_KP_7 7 ESC O w 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 @@ -2430,6 +2485,7 @@ jp common japanese encodings 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 @@ -2547,29 +2603,29 @@ disable this. 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 @@ -2660,12 +2716,3 @@ Marc Lehmann converted this document to pod and reworked it from the original Rxvt documentation, which was done by Geoff Wing , 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 -.IP "Around line 3048:" 4 -.IX Item "Around line 3048:" -=back doesn't take any parameters, but you said =back X diff --git a/doc/rxvt.7.txt b/doc/rxvt.7.txt index 65d461d7..8bb54c8d 100644 --- a/doc/rxvt.7.txt +++ b/doc/rxvt.7.txt @@ -16,8 +16,7 @@ DESCRIPTION all escape sequences, and other background information. The newest version of this document is also available on the World Wide - Web at - . + Web at . RXVT-UNICODE/URXVT FREQUENTLY ASKED QUESTIONS Meta, Features & Commandline Issues @@ -185,7 +184,7 @@ RXVT-UNICODE/URXVT FREQUENTLY ASKED QUESTIONS 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 :) @@ -795,13 +794,17 @@ RXVT-UNICODE/URXVT FREQUENTLY ASKED QUESTIONS 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 @@ -1004,7 +1007,7 @@ RXVT-UNICODE/URXVT FREQUENTLY ASKED QUESTIONS xprop -root XIM_SERVERS - + * My input method wants but I want UTF-8, what can I do? You can specify separate locales for the input method and the rest of @@ -1261,13 +1264,14 @@ RXVT-UNICODE TECHNICAL REFERENCE 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 @@ -1304,15 +1308,17 @@ RXVT-UNICODE TECHNICAL REFERENCE "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) @@ -1329,9 +1335,10 @@ RXVT-UNICODE TECHNICAL REFERENCE "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) @@ -1361,64 +1368,69 @@ RXVT-UNICODE TECHNICAL REFERENCE "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) @@ -1429,22 +1441,23 @@ RXVT-UNICODE TECHNICAL REFERENCE "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 @@ -1469,89 +1482,115 @@ RXVT-UNICODE TECHNICAL REFERENCE "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 @@ -1562,37 +1601,38 @@ RXVT-UNICODE TECHNICAL REFERENCE 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 @@ -1648,20 +1688,21 @@ Mouse Reporting The lower 2 bits of "" indicate the button: - 0 Button1 pressed - 1 Button2 pressed - 2 Button3 pressed - 3 button released (X11 mouse report) Button = "( - SPACE) & 3" + 0 Button1 pressed + 1 Button2 pressed + 2 Button3 pressed + 3 button released (X11 mouse report) The upper bits of "" 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 = "( - SPACE) & 60" + 4 Shift + 8 Meta + 16 Control + 32 Double Click (rxvt extension) + Col = " - SPACE" Row = " - SPACE" @@ -1674,64 +1715,65 @@ Key Codes 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 @@ -1771,12 +1813,13 @@ CONFIGURE OPTIONS 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 @@ -2004,13 +2047,3 @@ AUTHORS Geoff Wing , 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 - - Around line 3048: - =back doesn't take any parameters, but you said =back X - diff --git a/doc/rxvtd.1.html b/doc/rxvtd.1.html index ab7d0285..41d6c84d 100644 --- a/doc/rxvtd.1.html +++ b/doc/rxvtd.1.html @@ -2,7 +2,7 @@ -urxvtd - urxvt terminal daemon +rxvtd - rxvt terminal daemon @@ -28,40 +28,40 @@

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 +

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 +

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 including all windows it has opened.

+rxvtd instance including all windows it has opened.

OPTIONS

-

urxvtd currently understands a few options only. Bundling of +

rxvtd currently understands a few options only. Bundling of options is not yet supported.

-q, --quiet
-

Normally, urxvtd outputs the message rxvt-unicode daemon +

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

@@ -69,19 +69,19 @@ will suppress this message (errors and warnings will still be logged).

-o, --opendisplay
-

This forces urxvtd to open a connection to the current +

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 +

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.

@@ -90,13 +90,13 @@ socket.

EXAMPLES

-

This is a useful invocation of urxvtd in a .xsession-style +

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.

+rxvtd is killed.

@@ -105,9 +105,9 @@ and forks into the background. When you log-out, the server is reset and
RXVT_SOCKET
-

Both urxvtc and urxvtd use the environment +

Both rxvtc and rxvtd use the environment variable RXVT_SOCKET to create a listening socket and to contact -the urxvtd, respectively. If the variable is missing, +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.

@@ -123,7 +123,7 @@ valid X display name.

SEE ALSO

-

urxvt(7), urxvtc(1)

+

rxvt(7), rxvtc(1)

diff --git a/doc/rxvtd.1.man.in b/doc/rxvtd.1.man.in index f4b4fba5..4e5f4d83 100644 --- a/doc/rxvtd.1.man.in +++ b/doc/rxvtd.1.man.in @@ -1,4 +1,4 @@ -.\" Automatically generated by Pod::Man 2.09 (Pod::Simple 3.04) +.\" Automatically generated by Pod::Man v1.37, Pod::Parser v1.32 .\" .\" Standard preamble: .\" ======================================================================== @@ -129,7 +129,7 @@ .\" ======================================================================== .\" .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" @@ -180,7 +180,7 @@ This is a useful invocation of \fB@@RXVT_NAME@@d\fR in a \fI.xsession\fR\-style 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 @@ -193,24 +193,14 @@ and forks into the background. When you log\-out, the server is reset and 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\fI\fR is used. The variable must +\&\fI$HOME/.rxvt\-unicode\-\fI\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' diff --git a/doc/rxvtd.1.txt b/doc/rxvtd.1.txt index e8584493..3b59fbab 100644 --- a/doc/rxvtd.1.txt +++ b/doc/rxvtd.1.txt @@ -1,78 +1,68 @@ 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 " 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 -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-** 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-** 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) diff --git a/doc/rxvtperl.3.html b/doc/rxvtperl.3.html index 3e88d27f..c4542ed7 100644 --- a/doc/rxvtperl.3.html +++ b/doc/rxvtperl.3.html @@ -345,13 +345,35 @@ following four resources (shown with defaults):

indices.

-
mark-urls +
matcher
-

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.

+

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 @@ -491,6 +513,12 @@ for the filename):

    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 @@ -547,11 +575,12 @@ locale-specific way.

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.

It has the following methods and data members:

diff --git a/doc/rxvtperl.3.man.in b/doc/rxvtperl.3.man.in index 05f20e98..c9903d31 100644 --- a/doc/rxvtperl.3.man.in +++ b/doc/rxvtperl.3.man.in @@ -1,4 +1,4 @@ -.\" Automatically generated by Pod::Man 2.09 (Pod::Simple 3.04) +.\" Automatically generated by Pod::Man v1.37, Pod::Parser v1.32 .\" .\" Standard preamble: .\" ======================================================================== @@ -129,22 +129,28 @@ .\" ======================================================================== .\" .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" @@ -164,13 +170,13 @@ find them in \fI@@RXVT_LIBDIR@@/urxvt/perl/\fR. You can activate them like this: .PP .Vb 1 -\& @@RXVT_NAME@@ \-pe +\& @@RXVT_NAME@@ -pe .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)" @@ -188,8 +194,8 @@ them in increasing order of length. You can add your own regexes by 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 @@ -199,7 +205,7 @@ the match. For example, the following adds a regex that matches everything 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 @@ -208,7 +214,7 @@ pattern matches the filename (note, there is a single space at the very 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 @@ -221,7 +227,7 @@ This extension also offers following bindable keyboard commands: 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 @@ -245,8 +251,8 @@ The following will add an entry \f(CW\*(C`myoption\*(C'\fR that changes \&\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 @@ -270,7 +276,7 @@ the selection to \f(CW\*(C`b\*(C'\fRs, but only if the selection currently conta \&\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 } \& : () \& }; @@ -330,8 +336,8 @@ It works by specifying perl snippets (most useful is a single \f(CW\*(C`s///\*(C 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 @@ -340,14 +346,14 @@ For example, the following will transform selections of the form $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 :) @@ -356,8 +362,8 @@ To expand the example above to typical perl error messages (\*(L"\s-1XXX\s0 at \&\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 @@ -379,20 +385,40 @@ with a resource class of \f(CW\*(C`URxvt.tabbed\*(C'\fR. In addition, it support following four resources (shown with defaults): .Sp .Vb 4 -\& URxvt.tabbed.tabbar\-fg: -\& URxvt.tabbed.tabbar\-bg: -\& URxvt.tabbed.tab\-fg: -\& URxvt.tabbed.tab\-bg: +\& URxvt.tabbed.tabbar-fg: +\& URxvt.tabbed.tabbar-bg: +\& URxvt.tabbed.tab-fg: +\& URxvt.tabbed.tab-bg: .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 @@ -404,7 +430,7 @@ You enable it by specifying this extension and a preedit style of \&\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" 4 .IX Item "kuake" @@ -432,7 +458,7 @@ same effect as pseudo transparency with a custom pixmap. No scaling is 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" @@ -460,8 +486,8 @@ the selection data on \s-1STDOUT\s0 (also in \s-1UTF\-8\s0). 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" @@ -474,14 +500,14 @@ It listens to the \f(CW\*(C`selection\-pastebin:remote\-pastebin\*(C'\fR keyboar 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 @@ -495,8 +521,13 @@ in the \f(CW\*(C`selection\-pastebin\-url\*(C'\fR resource (again, the % is the 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 @@ -519,48 +550,46 @@ terminal is destroyed. .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" @@ -806,26 +835,22 @@ format=32, \s-1WM_PROTOCOLS\s0 or \s-1WM_PROTOCOLS:WM_DELETE_WINDOW\s0). .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 @@ -834,8 +859,7 @@ so references can push themselves onto it again if they so desire. .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 @@ -860,15 +884,13 @@ Using this function has the advantage that its output ends up in the 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 @@ -891,51 +913,48 @@ The following \*(L"macros\*(R" deal with changes in rendition sets. You should 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" @@ -950,8 +969,8 @@ work. .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 @@ -962,14 +981,13 @@ couldn't be created. Returns \f(CW\*(C`undef\*(C'\fR if the new instance didn't 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 @@ -977,8 +995,8 @@ the user environment before exec'ing the command (e.g. \f(CW\*(C`PATH\*(C'\fR) a 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 @@ -990,13 +1008,13 @@ source file \fI/src/optinc.h\fR to see the actual list: .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 @@ -1017,7 +1035,7 @@ Here is a likely non-exhaustive list of resource names, not all of which 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 @@ -1032,8 +1050,8 @@ to see the actual list: \& 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 @@ -1043,13 +1061,13 @@ resource with that pattern exists. 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. @@ -1071,29 +1089,29 @@ set it (which is usually bad as applications don't expect that). .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 @@ -1110,61 +1128,57 @@ as long as the perl object is referenced. .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 @@ -1174,164 +1188,157 @@ string is a normal text string, not in locale-dependent encoding. 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 @@ -1356,8 +1363,8 @@ characters. .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 @@ -1366,49 +1373,49 @@ styles and similar information. See also \f(CW\*(C`$term\->ROW_t\*(C'\fR. 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 @@ -1420,90 +1427,84 @@ Translates a string offset into terminal coordinates again. .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 @@ -1512,27 +1513,24 @@ directory onto the X functions of the same name. .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" @@ -1542,52 +1540,51 @@ This class implements timer watchers/events. Time is represented as a 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. -.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" @@ -1596,44 +1593,43 @@ Stop the timer. 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" @@ -1642,20 +1638,19 @@ Stop watching for events on the given file handle. 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" @@ -1667,28 +1662,27 @@ process exits, after which they stop automatically. .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" @@ -1711,5 +1705,5 @@ numbers indicate more verbose output. .IX Header "AUTHOR" .Vb 2 \& Marc Lehmann -\& http://software.schmorp.de/pkg/rxvt\-unicode +\& http://software.schmorp.de/pkg/rxvt-unicode .Ve diff --git a/doc/rxvtperl.3.txt b/doc/rxvtperl.3.txt index f623d552..72e32c99 100644 --- a/doc/rxvtperl.3.txt +++ b/doc/rxvtperl.3.txt @@ -65,7 +65,7 @@ PREPACKAGED EXTENSIONS 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. @@ -220,11 +220,30 @@ PREPACKAGED EXTENSIONS 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 @@ -319,6 +338,11 @@ PREPACKAGED EXTENSIONS 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 @@ -356,11 +380,12 @@ API DOCUMENTATION 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. @@ -1156,7 +1181,7 @@ API DOCUMENTATION ->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 @@ -1254,7 +1279,7 @@ API DOCUMENTATION ->cb (sub { my ($pw, $exit_status) = @_; ... - }); + }); $pw = new urxvt::pw Create a new process watcher in stopped state. diff --git a/src/Makefile.in b/src/Makefile.in index 2ab233b0..bb6fb22b 100644 --- a/src/Makefile.in +++ b/src/Makefile.in @@ -1632,3 +1632,201 @@ 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 + +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 diff --git a/src/version.h b/src/version.h index 2edb85fe..7e25b251 100644 --- a/src/version.h +++ b/src/version.h @@ -1,3 +1,3 @@ // VERSION _must_ be \d.\d+ -#define VERSION "7.9" -#define DATE "2006-08-07" +#define VERSION "8.0" +#define DATE "2006-11-02" -- 2.34.1