ViewVC Help
View File | Revision Log | Show Annotations | Download File
/cvs/rxvt-unicode/doc/rxvt.1.man.in
(Generate patch)

Comparing rxvt-unicode/doc/rxvt.1.man.in (file contents):
Revision 1.72 by sasha, Mon Oct 29 13:40:41 2007 UTC vs.
Revision 1.73 by root, Mon Nov 19 12:02:35 2007 UTC

1.\" Automatically generated by Pod::Man v1.37, Pod::Parser v1.3 1.\" Automatically generated by Pod::Man v1.37, Pod::Parser v1.35
2.\" 2.\"
3.\" Standard preamble: 3.\" Standard preamble:
4.\" ======================================================================== 4.\" ========================================================================
5.de Sh \" Subsection heading 5.de Sh \" Subsection heading
6.br 6.br
… …
127.\} 127.\}
128.rm #[ #] #H #V #F C 128.rm #[ #] #H #V #F C
129.\" ======================================================================== 129.\" ========================================================================
130.\" 130.\"
131.IX Title "@@RXVT_NAME@@ 1" 131.IX Title "@@RXVT_NAME@@ 1"
132.TH @@RXVT_NAME@@ 1 "2007-10-29" "8.3" "RXVT-UNICODE" 132.TH @@RXVT_NAME@@ 1 "2007-11-19" "8.4" "RXVT-UNICODE"
133.SH "NAME" 133.SH "NAME"
134rxvt\-unicode (ouR XVT, unicode) \- (a VT102 emulator for the X window system) 134rxvt\-unicode (ouR XVT, unicode) \- (a VT102 emulator for the X window system)
135.SH "SYNOPSIS" 135.SH "SYNOPSIS"
136.IX Header "SYNOPSIS" 136.IX Header "SYNOPSIS"
137\&\fB@@RXVT_NAME@@\fR [options] [\-e command [ args ]] 137\&\fB@@RXVT_NAME@@\fR [options] [\-e command [ args ]]
… …
235.IP "\fB\-tr\fR|\fB+tr\fR" 4 235.IP "\fB\-tr\fR|\fB+tr\fR" 4
236.IX Item "-tr|+tr" 236.IX Item "-tr|+tr"
237Turn on/off illusion of a transparent window background. Obsolete form of it is 237Turn on/off illusion of a transparent window background. Obsolete form of it is
238\&\fB\-ip\fR and it should not be used anymore; resource \fBtransparent\fR. 238\&\fB\-ip\fR and it should not be used anymore; resource \fBtransparent\fR.
239.Sp 239.Sp
240\&\fIPlease note that old resource name of \f(BIinheritPixmap\fI is obsolete and should be 240\&\fIPlease note that old resource name of \f(BIinheritPixmap\fI is obsolete and should be
241changed to \f(BItransparent\fI. Backwards compatibility support for \f(BIinheritPixmap\fI will 241changed to \f(BItransparent\fI. Backwards compatibility support for \f(BIinheritPixmap\fI will
242be phased out in future versions of rxvt!\fR 242be phased out in future versions of rxvt!\fR
243.Sp 243.Sp
244\&\fIPlease address all transparency related issues to Sasha Vasko at 244\&\fIPlease address all transparency related issues to Sasha Vasko at
245sasha@aftercode.net. Read the \s-1FAQ\s0 (man 7 @@RXVT_NAME@@)!\fR 245sasha@aftercode.net. Read the \s-1FAQ\s0 (man 7 @@RXVT_NAME@@)!\fR
246.IP "\fB\-fade\fR \fInumber\fR" 4 246.IP "\fB\-fade\fR \fInumber\fR" 4
247.IX Item "-fade number" 247.IX Item "-fade number"
248Fade the text by the given percentage when focus is lost. Small values 248Fade the text by the given percentage when focus is lost. Small values
249fade a little only, 100 completely replaces all colours by the fade 249fade a little only, 100 completely replaces all colours by the fade
… …
258transparency is enabled with \fB\-tr\fR. This only works for 258transparency is enabled with \fB\-tr\fR. This only works for
259non-tiled backgrounds, currently. See also the \fB\-sh\fR option that can be 259non-tiled backgrounds, currently. See also the \fB\-sh\fR option that can be
260used to brighten or darken the image in addition to tinting it. 260used to brighten or darken the image in addition to tinting it.
261Please note that certain tint colours can be applied on the server\-side, 261Please note that certain tint colours can be applied on the server\-side,
262thus yielding performance gain of two orders of magnitude. These colours are: 262thus yielding performance gain of two orders of magnitude. These colours are:
263blue, red, green, cyan, magenta, yellow, and those close to them. Also 263blue, red, green, cyan, magenta, yellow, and those close to them. Also
264pure black and pure white colors essentialy mean no tinting; resource 264pure black and pure white colors essentially mean no tinting; resource
265\&\fItintColor\fR. Example: 265\&\fItintColor\fR. Example:
266.Sp 266.Sp
267.Vb 1 267.Vb 1
268\& @@RXVT_NAME@@ \-tr \-tint blue \-sh 40 268\& @@RXVT_NAME@@ -tr -tint blue -sh 40
269.Ve 269.Ve
270.IP "\fB\-sh\fR \fInumber\fR" 4 270.IP "\fB\-sh\fR \fInumber\fR" 4
271.IX Item "-sh number" 271.IX Item "-sh number"
272Darken (0 .. 100) or lighten (100 .. 200) the transparent 272Darken (0 .. 100) or lighten (100 .. 200) the transparent
273background image in addition to (or instead of) tinting it; 273background image in addition to (or instead of) tinting it;
… …
293.IX Item "-bg colour" 293.IX Item "-bg colour"
294Window background colour; resource \fBbackground\fR. 294Window background colour; resource \fBbackground\fR.
295.IP "\fB\-fg\fR \fIcolour\fR" 4 295.IP "\fB\-fg\fR \fIcolour\fR" 4
296.IX Item "-fg colour" 296.IX Item "-fg colour"
297Window foreground colour; resource \fBforeground\fR. 297Window foreground colour; resource \fBforeground\fR.
298.IP "\fB\-pixmap\fR \fIfile[;geom]\fR" 4 298.IP "\fB\-pixmap\fR \fIfile[;geom[:op1][:op2][...]]\fR" 4
299.IX Item "-pixmap file[;geom]" 299.IX Item "-pixmap file[;geom[:op1][:op2][...]]"
300Compile \fIafterimage\fR: Specify image file for the background and also 300Compile \fIafterimage\fR: Specify image file for the background and also
301optionally specify its scaling with a geometry string. Note you may need to 301optionally specify its scaling with a geometry string. Note you may need to
302add quotes to avoid special shell interpretation of the \f(CW\*(C`;\*(C'\fR in the 302add quotes to avoid special shell interpretation of the \f(CW\*(C`;\*(C'\fR in the
303command\-line; for more details see resource \fBbackgroundPixmap\fR. 303command\-line; for more details see resource \fBbackgroundPixmap\fR.
304.IP "\fB\-cr\fR \fIcolour\fR" 4 304.IP "\fB\-cr\fR \fIcolour\fR" 4
305.IX Item "-cr colour" 305.IX Item "-cr colour"
… …
325In short, to specify an X11 core font, just specify its name or prefix it 325In short, to specify an X11 core font, just specify its name or prefix it
326with \f(CW\*(C`x:\*(C'\fR. To specify an XFT\-font, you need to prefix it with \f(CW\*(C`xft:\*(C'\fR, 326with \f(CW\*(C`x:\*(C'\fR. To specify an XFT\-font, you need to prefix it with \f(CW\*(C`xft:\*(C'\fR,
327e.g.: 327e.g.:
328.Sp 328.Sp
329.Vb 2 329.Vb 2
330\& @@RXVT_NAME@@ \-fn "xft:Bitstream Vera Sans Mono:pixelsize=15" 330\& @@RXVT_NAME@@ -fn "xft:Bitstream Vera Sans Mono:pixelsize=15"
331\& @@RXVT_NAME@@ \-fn "9x15bold,xft:Bitstream Vera Sans Mono" 331\& @@RXVT_NAME@@ -fn "9x15bold,xft:Bitstream Vera Sans Mono"
332.Ve 332.Ve
333.Sp 333.Sp
334See also the question \*(L"How does rxvt-unicode choose fonts?\*(R" in the \s-1FAQ\s0 334See also the question \*(L"How does rxvt-unicode choose fonts?\*(R" in the \s-1FAQ\s0
335section of @@RXVT_NAME@@(7). 335section of @@RXVT_NAME@@(7).
336.IP "\fB\-fb\fR \fIfontlist\fR" 4 336.IP "\fB\-fb\fR \fIfontlist\fR" 4
… …
455.Sp 455.Sp
456Please note that you must specify a program with arguments. If you want to 456Please note that you must specify a program with arguments. If you want to
457run shell commands, you have to specify the shell, like this: 457run shell commands, you have to specify the shell, like this:
458.Sp 458.Sp
459.Vb 1 459.Vb 1
460\& @@RXVT_NAME@@ \-e sh \-c "shell commands" 460\& @@RXVT_NAME@@ -e sh -c "shell commands"
461.Ve 461.Ve
462.IP "\fB\-title\fR \fItext\fR" 4 462.IP "\fB\-title\fR \fItext\fR" 4
463.IX Item "-title text" 463.IX Item "-title text"
464Window title (\fB\-T\fR still respected); the default title is the basename 464Window title (\fB\-T\fR still respected); the default title is the basename
465of the program specified after the \fB\-e\fR option, if any, otherwise the 465of the program specified after the \fB\-e\fR option, if any, otherwise the
… …
543Here is a short Gtk2\-perl snippet that illustrates how this option can be 543Here is a short Gtk2\-perl snippet that illustrates how this option can be
544used (a longer example is in \fIdoc/embed\fR): 544used (a longer example is in \fIdoc/embed\fR):
545.Sp 545.Sp
546.Vb 5 546.Vb 5
547\& my $rxvt = new Gtk2::Socket; 547\& my $rxvt = new Gtk2::Socket;
548\& $rxvt\->signal_connect_after (realize => sub { 548\& $rxvt->signal_connect_after (realize => sub {
549\& my $xid = $_[0]\->window\->get_xid; 549\& my $xid = $_[0]->window->get_xid;
550\& system "@@RXVT_NAME@@ \-embed $xid &"; 550\& system "@@RXVT_NAME@@ -embed $xid &";
551\& }); 551\& });
552.Ve 552.Ve
553.IP "\fB\-pty\-fd\fR \fIfile descriptor\fR" 4 553.IP "\fB\-pty\-fd\fR \fIfile descriptor\fR" 4
554.IX Item "-pty-fd file descriptor" 554.IX Item "-pty-fd file descriptor"
555Tells @@RXVT_NAME@@ \s-1NOT\s0 to execute any commands or create a new pty/tty 555Tells @@RXVT_NAME@@ \s-1NOT\s0 to execute any commands or create a new pty/tty
… …
572\& use Fcntl; 572\& use Fcntl;
573.Ve 573.Ve
574.Sp 574.Sp
575.Vb 4 575.Vb 4
576\& my $pty = new IO::Pty; 576\& my $pty = new IO::Pty;
577\& fcntl $pty, F_SETFD, 0; # clear close\-on\-exec 577\& fcntl $pty, F_SETFD, 0; # clear close-on-exec
578\& system "@@RXVT_NAME@@ \-pty\-fd " . (fileno $pty) . "&"; 578\& system "@@RXVT_NAME@@ -pty-fd " . (fileno $pty) . "&";
579\& close $pty; 579\& close $pty;
580.Ve 580.Ve
581.Sp 581.Sp
582.Vb 3 582.Vb 3
583\& # now communicate with rxvt 583\& # now communicate with rxvt
584\& my $slave = $pty\->slave; 584\& my $slave = $pty->slave;
585\& while (<$slave>) { print $slave "got <$_>\en" } 585\& while (<$slave>) { print $slave "got <$_>\en" }
586.Ve 586.Ve
587.IP "\fB\-pe\fR \fIstring\fR" 4 587.IP "\fB\-pe\fR \fIstring\fR" 4
588.IX Item "-pe string" 588.IX Item "-pe string"
589Comma-separated list of perl extension scripts to use (or not to use) in 589Comma-separated list of perl extension scripts to use (or not to use) in
… …
597distribution do also load settings from the \fB~/.Xresources\fR file when X 597distribution do also load settings from the \fB~/.Xresources\fR file when X
598starts. @@RXVT_NAME@@ will consult the following files/resources in order, 598starts. @@RXVT_NAME@@ will consult the following files/resources in order,
599with later settings overwriting earlier ones: 599with later settings overwriting earlier ones:
600.PP 600.PP
601.Vb 5 601.Vb 5
602\& 1. system\-wide app\-defaults file, either locale\-dependent OR global 602\& 1. system-wide app-defaults file, either locale-dependent OR global
603\& 2. app\-defaults file in $XAPPLRESDIR 603\& 2. app-defaults file in $XAPPLRESDIR
604\& 3. RESOURCE_MANAGER property on root\-window OR $HOME/.Xdefaults 604\& 3. RESOURCE_MANAGER property on root-window OR $HOME/.Xdefaults
605\& 4. SCREEN_RESOURCES for the current screen 605\& 4. SCREEN_RESOURCES for the current screen
606\& 5. $XENVIRONMENT file OR $HOME/.Xdefaults\-<nodename> 606\& 5. $XENVIRONMENT file OR $HOME/.Xdefaults-<nodename>
607.Ve 607.Ve
608.PP 608.PP
609Note that when reading X resources, \fB@@RXVT_NAME@@\fR recognizes two class 609Note that when reading X resources, \fB@@RXVT_NAME@@\fR recognizes two class
610names: \fBRxvt\fR and \fBURxvt\fR. The class name \fBRxvt\fR allows resources 610names: \fBRxvt\fR and \fBURxvt\fR. The class name \fBRxvt\fR allows resources
611common to both \fB@@RXVT_NAME@@\fR and the original \fIrxvt\fR to be easily 611common to both \fB@@RXVT_NAME@@\fR and the original \fIrxvt\fR to be easily
… …
727.IP "\fBblendType:\fR \fIstring\fR" 4 727.IP "\fBblendType:\fR \fIstring\fR" 4
728.IX Item "blendType: string" 728.IX Item "blendType: string"
729Specify background blending type; option \fB\-blt\fR. 729Specify background blending type; option \fB\-blt\fR.
730.IP "\fBblurRadius:\fR \fInumber\fR" 4 730.IP "\fBblurRadius:\fR \fInumber\fR" 4
731.IX Item "blurRadius: number" 731.IX Item "blurRadius: number"
732Apply Gaussian Blurr with the specified radius to the transparent 732Apply Gaussian Blurr with the specified radius to the transparent
733background image; option \fB\-blr\fR. 733background image; option \fB\-blr\fR.
734.IP "\fBscrollColor:\fR \fIcolour\fR" 4 734.IP "\fBscrollColor:\fR \fIcolour\fR" 4
735.IX Item "scrollColor: colour" 735.IX Item "scrollColor: colour"
736Use the specified colour for the scrollbar [default #B2B2B2]. 736Use the specified colour for the scrollbar [default #B2B2B2].
737.IP "\fBtroughColor:\fR \fIcolour\fR" 4 737.IP "\fBtroughColor:\fR \fIcolour\fR" 4
… …
740#969696]. Only relevant for rxvt (non XTerm/NeXT) scrollbar. 740#969696]. Only relevant for rxvt (non XTerm/NeXT) scrollbar.
741.IP "\fBborderColor:\fR \fIcolour\fR" 4 741.IP "\fBborderColor:\fR \fIcolour\fR" 4
742.IX Item "borderColor: colour" 742.IX Item "borderColor: colour"
743The colour of the border around the text area and between the scrollbar 743The colour of the border around the text area and between the scrollbar
744and the text. 744and the text.
745.IP "\fBbackgroundPixmap:\fR \fIfile[;geom]\fR" 4 745.IP "\fBbackgroundPixmap:\fR \fIfile[;geom[:op1][:op2][...]]\fR" 4
746.IX Item "backgroundPixmap: file[;geom]" 746.IX Item "backgroundPixmap: file[;geom[:op1][:op2][...]]"
747Use the specified image file for the background and also optionally 747Use the specified image file for the background and also
748specify its scaling with a geometry string \fBWxH+X+Y\fR, 748optionally specify its scaling with a geometry string \fBWxH+X+Y\fR,
749in which \fB\*(L"W\*(R" / \*(L"H\*(R"\fR specify the horizontal/vertical scale (percent), 749(default \f(CW\*(C`0x0+50+50\*(C'\fR) in which \fB\*(L"W\*(R" / \*(L"H\*(R"\fR specify the
750and \fB\*(L"X\*(R" / \*(L"Y\*(R"\fR locate the image centre (percent). 750horizontal/vertical scale (percent), and \fB\*(L"X\*(R" / \*(L"Y\*(R"\fR locate the image
751A scale of 0 displays the image with tiling. A scale of 1 displays the 751centre (percent). A scale of 0 displays the image with tiling. A scale
752image without any scaling. A scale of 2 to 9 specifies an integer 752of 1 displays the image without any scaling. A scale of 2 to 9 specifies
753number of images in that direction. No image will be magnified beyond 753an integer number of images in that direction. No image will be magnified
75410 times its original size. The maximum permitted scale is 1000. 754beyond 10 times its original size. The maximum permitted scale is 1000.
755Special string of \fB\*(L"auto\*(R"\fR used as a geometry will cause image to be 755Additional operations can be specified after colon \fB:op1:op2...\fR.
756automatically scaled to match window size. 756Supported operations are:
757.Sp
758.Vb 8
759\& tile force background image to be tiled and not scaled. Equivalent to 0x0,
760\& propscale will scale image keeping proportions,
761\& auto will scale image to match window size. Equivalent to 100x100;
762\& hscale will scale image horizontally to the window size;
763\& vscale will scale image vertically to the window size;
764\& scale will scale image to match window size;
765\& root will tile image as if it was a root window background, auto-adjusting
766\& whenever terminal window moves.
767.Ve
768.Sp
757If used in conjunction with \fB\-tr\fR option \- specified pixmap will be 769If used in conjunction with \fB\-tr\fR option, the specified pixmap will be
758blended over transparency image using either alpha\-blending, or any 770blended over transparency image using either alpha\-blending, or any
759other blending type, specified with \fB\-blt \*(L"type\*(R"\fR option. 771other blending type, specified with \fB\-blt \*(L"type\*(R"\fR option.
760[default 0x0+50+50]
761.IP "\fBpath:\fR \fIpath\fR" 4 772.IP "\fBpath:\fR \fIpath\fR" 4
762.IX Item "path: path" 773.IX Item "path: path"
763Specify the colon-delimited search path for finding background image files. 774Specify the colon-delimited search path for finding background image files.
764.IP "\fBfont:\fR \fIfontlist\fR" 4 775.IP "\fBfont:\fR \fIfontlist\fR" 4
765.IX Item "font: fontlist" 776.IX Item "font: fontlist"
… …
779.Sp 790.Sp
780For example, this font resource 791For example, this font resource
781.Sp 792.Sp
782.Vb 5 793.Vb 5
783\& URxvt.font: 9x15bold,\e 794\& URxvt.font: 9x15bold,\e
784\& \-misc\-fixed\-bold\-r\-normal\-\-15\-140\-75\-75\-c\-90\-iso10646\-1,\e 795\& -misc-fixed-bold-r-normal--15-140-75-75-c-90-iso10646-1,\e
785\& \-misc\-fixed\-medium\-r\-normal\-\-15\-140\-75\-75\-c\-90\-iso10646\-1, \e 796\& -misc-fixed-medium-r-normal--15-140-75-75-c-90-iso10646-1, \e
786\& [codeset=JISX0208]xft:Kochi Gothic:antialias=false, \e 797\& [codeset=JISX0208]xft:Kochi Gothic:antialias=false, \e
787\& xft:Code2000:antialias=false 798\& xft:Code2000:antialias=false
788.Ve 799.Ve
789.Sp 800.Sp
790specifies five fonts to be used. The first one is \f(CW\*(C`9x15bold\*(C'\fR (actually 801specifies five fonts to be used. The first one is \f(CW\*(C`9x15bold\*(C'\fR (actually
… …
883The string will be interpreted as if typed into the shell as\-is. 894The string will be interpreted as if typed into the shell as\-is.
884.Sp 895.Sp
885Example: 896Example:
886.Sp 897.Sp
887.Vb 1 898.Vb 1
888\& URxvt.print\-pipe: cat > $(TMPDIR=$HOME mktemp urxvt.XXXXXX) 899\& URxvt.print-pipe: cat > $(TMPDIR=$HOME mktemp urxvt.XXXXXX)
889.Ve 900.Ve
890.Sp 901.Sp
891This creates a new file in your home directory with the screen contents 902This creates a new file in your home directory with the screen contents
892every time you hit \f(CW\*(C`Print\*(C'\fR. 903every time you hit \f(CW\*(C`Print\*(C'\fR.
893.IP "\fBscrollBar:\fR \fIboolean\fR" 4 904.IP "\fBscrollBar:\fR \fIboolean\fR" 4
… …
1005will be created). In this mode, characters outside \s-1ISO\-8859\-1\s0 can be used. 1016will be created). In this mode, characters outside \s-1ISO\-8859\-1\s0 can be used.
1006.Sp 1017.Sp
1007When the selection extension is not used, only \s-1ISO\-8859\-1\s0 characters can 1018When the selection extension is not used, only \s-1ISO\-8859\-1\s0 characters can
1008be used. If not specified, the built-in default is used: 1019be used. If not specified, the built-in default is used:
1009.Sp 1020.Sp
1010\&\fB\s-1BACKSLASH\s0 `"'&()*,;<=>?@[]{|}\fR 1021\&\fB\s-1BACKSLASH\s0 `"'&()*,;<=>?@[]^{|}\fR
1011.IP "\fBpreeditType:\fR \fIstyle\fR" 4 1022.IP "\fBpreeditType:\fR \fIstyle\fR" 4
1012.IX Item "preeditType: style" 1023.IX Item "preeditType: style"
1013\&\fBOverTheSpot\fR, \fBOffTheSpot\fR, \fBRoot\fR; option \fB\-pt\fR. 1024\&\fBOverTheSpot\fR, \fBOffTheSpot\fR, \fBRoot\fR; option \fB\-pt\fR.
1014.IP "\fBinputMethod:\fR \fIname\fR" 4 1025.IP "\fBinputMethod:\fR \fIname\fR" 4
1015.IX Item "inputMethod: name" 1026.IX Item "inputMethod: name"
… …
1101should be a character not used by the strings. 1112should be a character not used by the strings.
1102.Sp 1113.Sp
1103Its usage can be demonstrated by an example: 1114Its usage can be demonstrated by an example:
1104.Sp 1115.Sp
1105.Vb 1 1116.Vb 1
1106\& URxvt.keysym.M\-C\-0x61: list|\e033<M\-C\-|abc|> 1117\& URxvt.keysym.M-C-0x61: list|\e033<M-C-|abc|>
1107.Ve 1118.Ve
1108.Sp 1119.Sp
1109The above line is equivalent to the following three lines: 1120The above line is equivalent to the following three lines:
1110.Sp 1121.Sp
1111.Vb 3 1122.Vb 3
1112\& URxvt.keysym.Meta\-Control\-0x61: \e033<M\-C\-a> 1123\& URxvt.keysym.Meta-Control-0x61: \e033<M-C-a>
1113\& URxvt.keysym.Meta\-Control\-0x62: \e033<M\-C\-b> 1124\& URxvt.keysym.Meta-Control-0x62: \e033<M-C-b>
1114\& URxvt.keysym.Meta\-Control\-0x63: \e033<M\-C\-c> 1125\& URxvt.keysym.Meta-Control-0x63: \e033<M-C-c>
1115.Ve 1126.Ve
1116.Sp 1127.Sp
1117If \fIstring\fR takes the form of \f(CW\*(C`command:STRING\*(C'\fR, the specified \fB\s-1STRING\s0\fR 1128If \fIstring\fR takes the form of \f(CW\*(C`command:STRING\*(C'\fR, the specified \fB\s-1STRING\s0\fR
1118is interpreted and executed as @@RXVT_NAME@@'s control sequence. For 1129is interpreted and executed as @@RXVT_NAME@@'s control sequence. For
1119example the following means "change the current locale to \f(CW\*(C`zh_CN.GBK\*(C'\fR 1130example the following means "change the current locale to \f(CW\*(C`zh_CN.GBK\*(C'\fR
1120when Control-Meta-c is being pressed": 1131when Control-Meta-c is being pressed":
1121.Sp 1132.Sp
1122.Vb 1 1133.Vb 1
1123\& URxvt.keysym.M\-C\-c: command:\e033]701;zh_CN.GBK\e007 1134\& URxvt.keysym.M-C-c: command:\e033]701;zh_CN.GBK\e007
1124.Ve 1135.Ve
1125.Sp 1136.Sp
1126If \fIstring\fR takes the form \f(CW\*(C`perl:STRING\*(C'\fR, then the specified \fB\s-1STRING\s0\fR 1137If \fIstring\fR takes the form \f(CW\*(C`perl:STRING\*(C'\fR, then the specified \fB\s-1STRING\s0\fR
1127is passed to the \f(CW\*(C`on_keyboard_command\*(C'\fR perl handler. See the @@RXVT_NAME@@\fIperl\fR\|(3) 1138is passed to the \f(CW\*(C`on_keyboard_command\*(C'\fR perl handler. See the @@RXVT_NAME@@\fIperl\fR\|(3)
1128manpage. For example, the \fIselection\fR extension (activated via 1139manpage. For example, the \fIselection\fR extension (activated via
1129\&\f(CW\*(C`@@RXVT_NAME@@ \-pe selection\*(C'\fR) listens for \f(CW\*(C`selection:rot13\*(C'\fR events: 1140\&\f(CW\*(C`@@RXVT_NAME@@ \-pe selection\*(C'\fR) listens for \f(CW\*(C`selection:rot13\*(C'\fR events:
1130.Sp 1141.Sp
1131.Vb 1 1142.Vb 1
1132\& URxvt.keysym.M\-C\-c: perl:selection:rot13 1143\& URxvt.keysym.M-C-c: perl:selection:rot13
1133.Ve 1144.Ve
1134.Sp 1145.Sp
1135Due the the large number of modifier combinations, a defined key mapping 1146Due the the large number of modifier combinations, a defined key mapping
1136will match if at \fIat least\fR the specified identifiers are being set, and 1147will match if at \fIat least\fR the specified identifiers are being set, and
1137no other key mappings with those and more bits are being defined. That 1148no other key mappings with those and more bits are being defined. That
… …
1144\&\f(CW\*(C`Shift\-Insert\*(C'\fR mapping. To re-enable that, you can poke \*(L"holes\*(R" into the 1155\&\f(CW\*(C`Shift\-Insert\*(C'\fR mapping. To re-enable that, you can poke \*(L"holes\*(R" into the
1145user-defined keymap using the \f(CW\*(C`builtin:\*(C'\fR replacement: 1156user-defined keymap using the \f(CW\*(C`builtin:\*(C'\fR replacement:
1146.Sp 1157.Sp
1147.Vb 2 1158.Vb 2
1148\& URxvt.keysym.Insert: <my insert key sequence> 1159\& URxvt.keysym.Insert: <my insert key sequence>
1149\& URxvt.keysym.S\-Insert: builtin: 1160\& URxvt.keysym.S-Insert: builtin:
1150.Ve 1161.Ve
1151.Sp 1162.Sp
1152The first line defines a mapping for \f(CW\*(C`Insert\*(C'\fR and \fIany\fR combination 1163The first line defines a mapping for \f(CW\*(C`Insert\*(C'\fR and \fIany\fR combination
1153of modifiers. The second line re-establishes the default mapping for 1164of modifiers. The second line re-establishes the default mapping for
1154\&\f(CW\*(C`Shift\-Insert\*(C'\fR. 1165\&\f(CW\*(C`Shift\-Insert\*(C'\fR.
… …
1156The following example will map Control\-Meta\-1 and Control\-Meta\-2 to 1167The following example will map Control\-Meta\-1 and Control\-Meta\-2 to
1157the fonts \f(CW\*(C`suxuseuro\*(C'\fR and \f(CW\*(C`9x15bold\*(C'\fR, so you can have some limited 1168the fonts \f(CW\*(C`suxuseuro\*(C'\fR and \f(CW\*(C`9x15bold\*(C'\fR, so you can have some limited
1158font-switching at runtime: 1169font-switching at runtime:
1159.Sp 1170.Sp
1160.Vb 2 1171.Vb 2
1161\& URxvt.keysym.M\-C\-1: command:\e033]50;suxuseuro\e007 1172\& URxvt.keysym.M-C-1: command:\e033]50;suxuseuro\e007
1162\& URxvt.keysym.M\-C\-2: command:\e033]50;9x15bold\e007 1173\& URxvt.keysym.M-C-2: command:\e033]50;9x15bold\e007
1163.Ve 1174.Ve
1164.Sp 1175.Sp
1165Other things are possible, e.g. resizing (see @@RXVT_NAME@@(7) for more 1176Other things are possible, e.g. resizing (see @@RXVT_NAME@@(7) for more
1166info): 1177info):
1167.Sp 1178.Sp
1168.Vb 2 1179.Vb 2
1169\& URxvt.keysym.M\-C\-3: command:\e033[8;25;80t 1180\& URxvt.keysym.M-C-3: command:\e033[8;25;80t
1170\& URxvt.keysym.M\-C\-4: command:\e033[8;48;110t 1181\& URxvt.keysym.M-C-4: command:\e033[8;48;110t
1171.Ve 1182.Ve
1172.IP "\fBperl-ext-common\fR: \fIstring\fR" 4 1183.IP "\fBperl-ext-common\fR: \fIstring\fR" 4
1173.IX Item "perl-ext-common: string" 1184.IX Item "perl-ext-common: string"
1174.PD 0 1185.PD 0
1175.IP "\fBperl-ext\fR: \fIstring\fR" 4 1186.IP "\fBperl-ext\fR: \fIstring\fR" 4
… …
1297.Ve 1308.Ve
1298.PP 1309.PP
1299You can use keyboard shortcuts, too: 1310You can use keyboard shortcuts, too:
1300.PP 1311.PP
1301.Vb 2 1312.Vb 2
1302\& URxvt.keysym.M\-C\-1: command:\e033]710;suxuseuro\e007\e033]711;suxuseuro\e007 1313\& URxvt.keysym.M-C-1: command:\e033]710;suxuseuro\e007\e033]711;suxuseuro\e007
1303\& URxvt.keysym.M\-C\-2: command:\e033]710;9x15bold\e007\e033]711;9x15bold\e007 1314\& URxvt.keysym.M-C-2: command:\e033]710;9x15bold\e007\e033]711;9x15bold\e007
1304.Ve 1315.Ve
1305.PP 1316.PP
1306rxvt-unicode will automatically re-apply these fonts to the output so far. 1317rxvt-unicode will automatically re-apply these fonts to the output so far.
1307.SH "ISO 14755 SUPPORT" 1318.SH "ISO 14755 SUPPORT"
1308.IX Header "ISO 14755 SUPPORT" 1319.IX Header "ISO 14755 SUPPORT"
… …
1435.PP 1446.PP
1436For example, the following selects an almost completely transparent red 1447For example, the following selects an almost completely transparent red
1437background, and an almost opaque pink foreground: 1448background, and an almost opaque pink foreground:
1438.PP 1449.PP
1439.Vb 1 1450.Vb 1
1440\& @@RXVT_NAME@@ \-depth 32 \-bg rgba:0000/0000/0000/aaaa \-fg "[80]pink" 1451\& @@RXVT_NAME@@ -depth 32 -bg rgba:0000/0000/0000/aaaa -fg "[80]pink"
1441.Ve 1452.Ve
1442.PP 1453.PP
1443\&\fIPlease note that transparency of any kind if completely unsupported by 1454\&\fIPlease note that transparency of any kind if completely unsupported by
1444the author. Don't bug him with installation questions!\fR 1455the author. Don't bug him with installation questions!\fR
1445.SH "ENVIRONMENT" 1456.SH "ENVIRONMENT"
… …
1450Normally set to \f(CW\*(C`rxvt\-unicode\*(C'\fR, unless overwritten at configure time, via 1461Normally set to \f(CW\*(C`rxvt\-unicode\*(C'\fR, unless overwritten at configure time, via
1451resources or on the command line. 1462resources or on the command line.
1452.IP "\fB\s-1COLORTERM\s0\fR" 4 1463.IP "\fB\s-1COLORTERM\s0\fR" 4
1453.IX Item "COLORTERM" 1464.IX Item "COLORTERM"
1454Either \f(CW\*(C`rxvt\*(C'\fR, \f(CW\*(C`rxvt\-xpm\*(C'\fR, depending on whether @@RXVT_NAME@@ was 1465Either \f(CW\*(C`rxvt\*(C'\fR, \f(CW\*(C`rxvt\-xpm\*(C'\fR, depending on whether @@RXVT_NAME@@ was
1455compiled with background image support, and optionally with the added 1466compiled with background image support, and optionally with the added
1456extension \f(CW\*(C`\-mono\*(C'\fR to indicate that rxvt-unicode runs on a monochrome 1467extension \f(CW\*(C`\-mono\*(C'\fR to indicate that rxvt-unicode runs on a monochrome
1457screen. 1468screen.
1458.IP "\fB\s-1COLORFGBG\s0\fR" 4 1469.IP "\fB\s-1COLORFGBG\s0\fR" 4
1459.IX Item "COLORFGBG" 1470.IX Item "COLORFGBG"
1460Set to a string of the form \f(CW\*(C`fg;bg\*(C'\fR or \f(CW\*(C`fg;xpm;bg\*(C'\fR, where \f(CW\*(C`fg\*(C'\fR is 1471Set to a string of the form \f(CW\*(C`fg;bg\*(C'\fR or \f(CW\*(C`fg;xpm;bg\*(C'\fR, where \f(CW\*(C`fg\*(C'\fR is
1461the colour code used as default foreground/text colour (or the string 1472the colour code used as default foreground/text colour (or the string
1462\&\f(CW\*(C`default\*(C'\fR to indicate that the default-colour escape sequence is to be 1473\&\f(CW\*(C`default\*(C'\fR to indicate that the default-colour escape sequence is to be
1463used), \f(CW\*(C`bg\*(C'\fR is the colour code used as default background colour (or the 1474used), \f(CW\*(C`bg\*(C'\fR is the colour code used as default background colour (or the
1464string \f(CW\*(C`default\*(C'\fR), and \f(CW\*(C`xpm\*(C'\fR is the string \f(CW\*(C`default\*(C'\fR if @@RXVT_NAME@@ 1475string \f(CW\*(C`default\*(C'\fR), and \f(CW\*(C`xpm\*(C'\fR is the string \f(CW\*(C`default\*(C'\fR if @@RXVT_NAME@@
1465was compiled with background image support. Libraries like \f(CW\*(C`ncurses\*(C'\fR 1476was compiled with background image support. Libraries like \f(CW\*(C`ncurses\*(C'\fR
1466and \f(CW\*(C`slang\*(C'\fR can (and do) use this information to optimize screen output. 1477and \f(CW\*(C`slang\*(C'\fR can (and do) use this information to optimize screen output.
1467.IP "\fB\s-1WINDOWID\s0\fR" 4 1478.IP "\fB\s-1WINDOWID\s0\fR" 4
1468.IX Item "WINDOWID" 1479.IX Item "WINDOWID"
1469Set to the (decimal) X Window \s-1ID\s0 of the @@RXVT_NAME@@ window (the toplevel 1480Set to the (decimal) X Window \s-1ID\s0 of the @@RXVT_NAME@@ window (the toplevel
1470window, which usually has subwindows for the scrollbar, the terminal 1481window, which usually has subwindows for the scrollbar, the terminal

Diff Legend

– Removed lines
+ Added lines
< Changed lines
> Changed lines