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" |
134 | rxvt\-unicode (ouR XVT, unicode) \- (a VT102 emulator for the X window system) |
134 | rxvt\-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" |
237 | Turn on/off illusion of a transparent window background. Obsolete form of it is |
237 | Turn 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 |
241 | changed to \f(BItransparent\fI. Backwards compatibility support for \f(BIinheritPixmap\fI will |
241 | changed to \f(BItransparent\fI. Backwards compatibility support for \f(BIinheritPixmap\fI will |
242 | be phased out in future versions of rxvt!\fR |
242 | be 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 |
245 | sasha@aftercode.net. Read the \s-1FAQ\s0 (man 7 @@RXVT_NAME@@)!\fR |
245 | sasha@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" |
248 | Fade the text by the given percentage when focus is lost. Small values |
248 | Fade the text by the given percentage when focus is lost. Small values |
249 | fade a little only, 100 completely replaces all colours by the fade |
249 | fade a little only, 100 completely replaces all colours by the fade |
… | |
… | |
258 | transparency is enabled with \fB\-tr\fR. This only works for |
258 | transparency is enabled with \fB\-tr\fR. This only works for |
259 | non-tiled backgrounds, currently. See also the \fB\-sh\fR option that can be |
259 | non-tiled backgrounds, currently. See also the \fB\-sh\fR option that can be |
260 | used to brighten or darken the image in addition to tinting it. |
260 | used to brighten or darken the image in addition to tinting it. |
261 | Please note that certain tint colours can be applied on the server\-side, |
261 | Please note that certain tint colours can be applied on the server\-side, |
262 | thus yielding performance gain of two orders of magnitude. These colours are: |
262 | thus yielding performance gain of two orders of magnitude. These colours are: |
263 | blue, red, green, cyan, magenta, yellow, and those close to them. Also |
263 | blue, red, green, cyan, magenta, yellow, and those close to them. Also |
264 | pure black and pure white colors essentialy mean no tinting; resource |
264 | pure 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" |
272 | Darken (0 .. 100) or lighten (100 .. 200) the transparent |
272 | Darken (0 .. 100) or lighten (100 .. 200) the transparent |
273 | background image in addition to (or instead of) tinting it; |
273 | background image in addition to (or instead of) tinting it; |
… | |
… | |
293 | .IX Item "-bg colour" |
293 | .IX Item "-bg colour" |
294 | Window background colour; resource \fBbackground\fR. |
294 | Window 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" |
297 | Window foreground colour; resource \fBforeground\fR. |
297 | Window 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][...]]" |
300 | Compile \fIafterimage\fR: Specify image file for the background and also |
300 | Compile \fIafterimage\fR: Specify image file for the background and also |
301 | optionally specify its scaling with a geometry string. Note you may need to |
301 | optionally specify its scaling with a geometry string. Note you may need to |
302 | add quotes to avoid special shell interpretation of the \f(CW\*(C`;\*(C'\fR in the |
302 | add quotes to avoid special shell interpretation of the \f(CW\*(C`;\*(C'\fR in the |
303 | command\-line; for more details see resource \fBbackgroundPixmap\fR. |
303 | command\-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" |
… | |
… | |
325 | In short, to specify an X11 core font, just specify its name or prefix it |
325 | In short, to specify an X11 core font, just specify its name or prefix it |
326 | with \f(CW\*(C`x:\*(C'\fR. To specify an XFT\-font, you need to prefix it with \f(CW\*(C`xft:\*(C'\fR, |
326 | with \f(CW\*(C`x:\*(C'\fR. To specify an XFT\-font, you need to prefix it with \f(CW\*(C`xft:\*(C'\fR, |
327 | e.g.: |
327 | e.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 |
334 | See also the question \*(L"How does rxvt-unicode choose fonts?\*(R" in the \s-1FAQ\s0 |
334 | See also the question \*(L"How does rxvt-unicode choose fonts?\*(R" in the \s-1FAQ\s0 |
335 | section of @@RXVT_NAME@@(7). |
335 | section of @@RXVT_NAME@@(7). |
336 | .IP "\fB\-fb\fR \fIfontlist\fR" 4 |
336 | .IP "\fB\-fb\fR \fIfontlist\fR" 4 |
… | |
… | |
455 | .Sp |
455 | .Sp |
456 | Please note that you must specify a program with arguments. If you want to |
456 | Please note that you must specify a program with arguments. If you want to |
457 | run shell commands, you have to specify the shell, like this: |
457 | run 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" |
464 | Window title (\fB\-T\fR still respected); the default title is the basename |
464 | Window title (\fB\-T\fR still respected); the default title is the basename |
465 | of the program specified after the \fB\-e\fR option, if any, otherwise the |
465 | of the program specified after the \fB\-e\fR option, if any, otherwise the |
… | |
… | |
543 | Here is a short Gtk2\-perl snippet that illustrates how this option can be |
543 | Here is a short Gtk2\-perl snippet that illustrates how this option can be |
544 | used (a longer example is in \fIdoc/embed\fR): |
544 | used (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" |
555 | Tells @@RXVT_NAME@@ \s-1NOT\s0 to execute any commands or create a new pty/tty |
555 | Tells @@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" |
589 | Comma-separated list of perl extension scripts to use (or not to use) in |
589 | Comma-separated list of perl extension scripts to use (or not to use) in |
… | |
… | |
597 | distribution do also load settings from the \fB~/.Xresources\fR file when X |
597 | distribution do also load settings from the \fB~/.Xresources\fR file when X |
598 | starts. @@RXVT_NAME@@ will consult the following files/resources in order, |
598 | starts. @@RXVT_NAME@@ will consult the following files/resources in order, |
599 | with later settings overwriting earlier ones: |
599 | with 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 |
609 | Note that when reading X resources, \fB@@RXVT_NAME@@\fR recognizes two class |
609 | Note that when reading X resources, \fB@@RXVT_NAME@@\fR recognizes two class |
610 | names: \fBRxvt\fR and \fBURxvt\fR. The class name \fBRxvt\fR allows resources |
610 | names: \fBRxvt\fR and \fBURxvt\fR. The class name \fBRxvt\fR allows resources |
611 | common to both \fB@@RXVT_NAME@@\fR and the original \fIrxvt\fR to be easily |
611 | common 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" |
729 | Specify background blending type; option \fB\-blt\fR. |
729 | Specify 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" |
732 | Apply Gaussian Blurr with the specified radius to the transparent |
732 | Apply Gaussian Blurr with the specified radius to the transparent |
733 | background image; option \fB\-blr\fR. |
733 | background 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" |
736 | Use the specified colour for the scrollbar [default #B2B2B2]. |
736 | Use 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" |
743 | The colour of the border around the text area and between the scrollbar |
743 | The colour of the border around the text area and between the scrollbar |
744 | and the text. |
744 | and 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][...]]" |
747 | Use the specified image file for the background and also optionally |
747 | Use the specified image file for the background and also |
748 | specify its scaling with a geometry string \fBWxH+X+Y\fR, |
748 | optionally specify its scaling with a geometry string \fBWxH+X+Y\fR, |
749 | in 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 |
750 | and \fB\*(L"X\*(R" / \*(L"Y\*(R"\fR locate the image centre (percent). |
750 | horizontal/vertical scale (percent), and \fB\*(L"X\*(R" / \*(L"Y\*(R"\fR locate the image |
751 | A scale of 0 displays the image with tiling. A scale of 1 displays the |
751 | centre (percent). A scale of 0 displays the image with tiling. A scale |
752 | image without any scaling. A scale of 2 to 9 specifies an integer |
752 | of 1 displays the image without any scaling. A scale of 2 to 9 specifies |
753 | number of images in that direction. No image will be magnified beyond |
753 | an integer number of images in that direction. No image will be magnified |
754 | 10 times its original size. The maximum permitted scale is 1000. |
754 | beyond 10 times its original size. The maximum permitted scale is 1000. |
755 | Special string of \fB\*(L"auto\*(R"\fR used as a geometry will cause image to be |
755 | Additional operations can be specified after colon \fB:op1:op2...\fR. |
756 | automatically scaled to match window size. |
756 | Supported 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 |
757 | If used in conjunction with \fB\-tr\fR option \- specified pixmap will be |
769 | If used in conjunction with \fB\-tr\fR option, the specified pixmap will be |
758 | blended over transparency image using either alpha\-blending, or any |
770 | blended over transparency image using either alpha\-blending, or any |
759 | other blending type, specified with \fB\-blt \*(L"type\*(R"\fR option. |
771 | other 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" |
763 | Specify the colon-delimited search path for finding background image files. |
774 | Specify 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 |
780 | For example, this font resource |
791 | For 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 |
790 | specifies five fonts to be used. The first one is \f(CW\*(C`9x15bold\*(C'\fR (actually |
801 | specifies five fonts to be used. The first one is \f(CW\*(C`9x15bold\*(C'\fR (actually |
… | |
… | |
883 | The string will be interpreted as if typed into the shell as\-is. |
894 | The string will be interpreted as if typed into the shell as\-is. |
884 | .Sp |
895 | .Sp |
885 | Example: |
896 | Example: |
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 |
891 | This creates a new file in your home directory with the screen contents |
902 | This creates a new file in your home directory with the screen contents |
892 | every time you hit \f(CW\*(C`Print\*(C'\fR. |
903 | every time you hit \f(CW\*(C`Print\*(C'\fR. |
893 | .IP "\fBscrollBar:\fR \fIboolean\fR" 4 |
904 | .IP "\fBscrollBar:\fR \fIboolean\fR" 4 |
… | |
… | |
1005 | will be created). In this mode, characters outside \s-1ISO\-8859\-1\s0 can be used. |
1016 | will be created). In this mode, characters outside \s-1ISO\-8859\-1\s0 can be used. |
1006 | .Sp |
1017 | .Sp |
1007 | When the selection extension is not used, only \s-1ISO\-8859\-1\s0 characters can |
1018 | When the selection extension is not used, only \s-1ISO\-8859\-1\s0 characters can |
1008 | be used. If not specified, the built-in default is used: |
1019 | be 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" |
… | |
… | |
1101 | should be a character not used by the strings. |
1112 | should be a character not used by the strings. |
1102 | .Sp |
1113 | .Sp |
1103 | Its usage can be demonstrated by an example: |
1114 | Its 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 |
1109 | The above line is equivalent to the following three lines: |
1120 | The 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 |
1117 | If \fIstring\fR takes the form of \f(CW\*(C`command:STRING\*(C'\fR, the specified \fB\s-1STRING\s0\fR |
1128 | If \fIstring\fR takes the form of \f(CW\*(C`command:STRING\*(C'\fR, the specified \fB\s-1STRING\s0\fR |
1118 | is interpreted and executed as @@RXVT_NAME@@'s control sequence. For |
1129 | is interpreted and executed as @@RXVT_NAME@@'s control sequence. For |
1119 | example the following means "change the current locale to \f(CW\*(C`zh_CN.GBK\*(C'\fR |
1130 | example the following means "change the current locale to \f(CW\*(C`zh_CN.GBK\*(C'\fR |
1120 | when Control-Meta-c is being pressed": |
1131 | when 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 |
1126 | If \fIstring\fR takes the form \f(CW\*(C`perl:STRING\*(C'\fR, then the specified \fB\s-1STRING\s0\fR |
1137 | If \fIstring\fR takes the form \f(CW\*(C`perl:STRING\*(C'\fR, then the specified \fB\s-1STRING\s0\fR |
1127 | is passed to the \f(CW\*(C`on_keyboard_command\*(C'\fR perl handler. See the @@RXVT_NAME@@\fIperl\fR\|(3) |
1138 | is passed to the \f(CW\*(C`on_keyboard_command\*(C'\fR perl handler. See the @@RXVT_NAME@@\fIperl\fR\|(3) |
1128 | manpage. For example, the \fIselection\fR extension (activated via |
1139 | manpage. 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 |
1135 | Due the the large number of modifier combinations, a defined key mapping |
1146 | Due the the large number of modifier combinations, a defined key mapping |
1136 | will match if at \fIat least\fR the specified identifiers are being set, and |
1147 | will match if at \fIat least\fR the specified identifiers are being set, and |
1137 | no other key mappings with those and more bits are being defined. That |
1148 | no 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 |
1145 | user-defined keymap using the \f(CW\*(C`builtin:\*(C'\fR replacement: |
1156 | user-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 |
1152 | The first line defines a mapping for \f(CW\*(C`Insert\*(C'\fR and \fIany\fR combination |
1163 | The first line defines a mapping for \f(CW\*(C`Insert\*(C'\fR and \fIany\fR combination |
1153 | of modifiers. The second line re-establishes the default mapping for |
1164 | of 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. |
… | |
… | |
1156 | The following example will map Control\-Meta\-1 and Control\-Meta\-2 to |
1167 | The following example will map Control\-Meta\-1 and Control\-Meta\-2 to |
1157 | the fonts \f(CW\*(C`suxuseuro\*(C'\fR and \f(CW\*(C`9x15bold\*(C'\fR, so you can have some limited |
1168 | the fonts \f(CW\*(C`suxuseuro\*(C'\fR and \f(CW\*(C`9x15bold\*(C'\fR, so you can have some limited |
1158 | font-switching at runtime: |
1169 | font-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 |
1165 | Other things are possible, e.g. resizing (see @@RXVT_NAME@@(7) for more |
1176 | Other things are possible, e.g. resizing (see @@RXVT_NAME@@(7) for more |
1166 | info): |
1177 | info): |
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 |
1299 | You can use keyboard shortcuts, too: |
1310 | You 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 |
1306 | rxvt-unicode will automatically re-apply these fonts to the output so far. |
1317 | rxvt-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 |
1436 | For example, the following selects an almost completely transparent red |
1447 | For example, the following selects an almost completely transparent red |
1437 | background, and an almost opaque pink foreground: |
1448 | background, 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 |
1444 | the author. Don't bug him with installation questions!\fR |
1455 | the author. Don't bug him with installation questions!\fR |
1445 | .SH "ENVIRONMENT" |
1456 | .SH "ENVIRONMENT" |
… | |
… | |
1450 | Normally set to \f(CW\*(C`rxvt\-unicode\*(C'\fR, unless overwritten at configure time, via |
1461 | Normally set to \f(CW\*(C`rxvt\-unicode\*(C'\fR, unless overwritten at configure time, via |
1451 | resources or on the command line. |
1462 | resources 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" |
1454 | Either \f(CW\*(C`rxvt\*(C'\fR, \f(CW\*(C`rxvt\-xpm\*(C'\fR, depending on whether @@RXVT_NAME@@ was |
1465 | Either \f(CW\*(C`rxvt\*(C'\fR, \f(CW\*(C`rxvt\-xpm\*(C'\fR, depending on whether @@RXVT_NAME@@ was |
1455 | compiled with background image support, and optionally with the added |
1466 | compiled with background image support, and optionally with the added |
1456 | extension \f(CW\*(C`\-mono\*(C'\fR to indicate that rxvt-unicode runs on a monochrome |
1467 | extension \f(CW\*(C`\-mono\*(C'\fR to indicate that rxvt-unicode runs on a monochrome |
1457 | screen. |
1468 | screen. |
1458 | .IP "\fB\s-1COLORFGBG\s0\fR" 4 |
1469 | .IP "\fB\s-1COLORFGBG\s0\fR" 4 |
1459 | .IX Item "COLORFGBG" |
1470 | .IX Item "COLORFGBG" |
1460 | Set to a string of the form \f(CW\*(C`fg;bg\*(C'\fR or \f(CW\*(C`fg;xpm;bg\*(C'\fR, where \f(CW\*(C`fg\*(C'\fR is |
1471 | Set to a string of the form \f(CW\*(C`fg;bg\*(C'\fR or \f(CW\*(C`fg;xpm;bg\*(C'\fR, where \f(CW\*(C`fg\*(C'\fR is |
1461 | the colour code used as default foreground/text colour (or the string |
1472 | the 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 |
1463 | used), \f(CW\*(C`bg\*(C'\fR is the colour code used as default background colour (or the |
1474 | used), \f(CW\*(C`bg\*(C'\fR is the colour code used as default background colour (or the |
1464 | string \f(CW\*(C`default\*(C'\fR), and \f(CW\*(C`xpm\*(C'\fR is the string \f(CW\*(C`default\*(C'\fR if @@RXVT_NAME@@ |
1475 | string \f(CW\*(C`default\*(C'\fR), and \f(CW\*(C`xpm\*(C'\fR is the string \f(CW\*(C`default\*(C'\fR if @@RXVT_NAME@@ |
1465 | was compiled with background image support. Libraries like \f(CW\*(C`ncurses\*(C'\fR |
1476 | was compiled with background image support. Libraries like \f(CW\*(C`ncurses\*(C'\fR |
1466 | and \f(CW\*(C`slang\*(C'\fR can (and do) use this information to optimize screen output. |
1477 | and \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" |
1469 | Set to the (decimal) X Window \s-1ID\s0 of the @@RXVT_NAME@@ window (the toplevel |
1480 | Set to the (decimal) X Window \s-1ID\s0 of the @@RXVT_NAME@@ window (the toplevel |
1470 | window, which usually has subwindows for the scrollbar, the terminal |
1481 | window, which usually has subwindows for the scrollbar, the terminal |