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.46 by root, Fri Jan 13 12:40:46 2006 UTC vs.
Revision 1.57 by root, Tue Jan 31 00:25:16 2006 UTC

… …
127.\} 127.\}
128.rm #[ #] #H #V #F C 128.rm #[ #] #H #V #F C
129.\" ======================================================================== 129.\" ========================================================================
130.\" 130.\"
131.IX Title "rxvt 1" 131.IX Title "rxvt 1"
132.TH rxvt 1 "2006-01-13" "7.0" "RXVT-UNICODE" 132.TH rxvt 1 "2006-01-31" "7.5" "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 ]]
… …
214.IP "\fB\-display\fR \fIdisplayname\fR" 4 214.IP "\fB\-display\fR \fIdisplayname\fR" 4
215.IX Item "-display displayname" 215.IX Item "-display displayname"
216Attempt to open a window on the named X display (\fB\-d\fR still 216Attempt to open a window on the named X display (\fB\-d\fR still
217respected). In the absence of this option, the display specified by the 217respected). In the absence of this option, the display specified by the
218\&\fB\s-1DISPLAY\s0\fR environment variable is used. 218\&\fB\s-1DISPLAY\s0\fR environment variable is used.
219.IP "\fB\-depth\fR \fIbitdepth\fR" 4
220.IX Item "-depth bitdepth"
221Compile \fIxft\fR: Attempt to find a visual with the given bit depth;
222resource \fBdepth\fR.
219.IP "\fB\-geometry\fR \fIgeom\fR" 4 223.IP "\fB\-geometry\fR \fIgeom\fR" 4
220.IX Item "-geometry geom" 224.IX Item "-geometry geom"
221Window geometry (\fB\-g\fR still respected); resource \fBgeometry\fR. 225Window geometry (\fB\-g\fR still respected); resource \fBgeometry\fR.
222.IP "\fB\-rv\fR|\fB+rv\fR" 4 226.IP "\fB\-rv\fR|\fB+rv\fR" 4
223.IX Item "-rv|+rv" 227.IX Item "-rv|+rv"
… …
227Turn on/off jump scrolling; resource \fBjumpScroll\fR. 231Turn on/off jump scrolling; resource \fBjumpScroll\fR.
228.IP "\fB\-ip\fR|\fB+ip\fR | \fB\-tr\fR|\fB+tr\fR" 4 232.IP "\fB\-ip\fR|\fB+ip\fR | \fB\-tr\fR|\fB+tr\fR" 4
229.IX Item "-ip|+ip | -tr|+tr" 233.IX Item "-ip|+ip | -tr|+tr"
230Turn on/off inheriting parent window's pixmap. Alternative form is 234Turn on/off inheriting parent window's pixmap. Alternative form is
231\&\fB\-tr\fR; resource \fBinheritPixmap\fR. 235\&\fB\-tr\fR; resource \fBinheritPixmap\fR.
236.Sp
237\&\fIPlease note that transparency of any kind if completely unsupported by
238the author. Don't bug him with installation questions!\fR
232.IP "\fB\-fade\fR \fInumber\fR" 4 239.IP "\fB\-fade\fR \fInumber\fR" 4
233.IX Item "-fade number" 240.IX Item "-fade number"
234Fade the text by the given percentage when focus is lost. Small values 241Fade the text by the given percentage when focus is lost. Small values
235fade a little only, 100 completely replaces all colours by the fade 242fade a little only, 100 completely replaces all colours by the fade
236colour; resource \fBfading\fR. 243colour; resource \fBfading\fR.
237.IP "\fB\-fadecolor\fR \fIcolour\fR" 4 244.IP "\fB\-fadecolor\fR \fIcolour\fR" 4
238.IX Item "-fadecolor colour" 245.IX Item "-fadecolor colour"
239Fade to this colour when fading is used (see \fB\-fade\fR). The default colour 246Fade to this colour when fading is used (see \fB\-fade\fR). The default colour
240is black. resource \fBfadeColor\fR. 247is opaque black. resource \fBfadeColor\fR.
241.IP "\fB\-tint\fR \fIcolour\fR" 4 248.IP "\fB\-tint\fR \fIcolour\fR" 4
242.IX Item "-tint colour" 249.IX Item "-tint colour"
243Tint the transparent background pixmap with the given colour when 250Tint the transparent background pixmap with the given colour when
244transparency is enabled with \fB\-tr\fR or \fB\-ip\fR. This only works for 251transparency is enabled with \fB\-tr\fR or \fB\-ip\fR. This only works for
245non-tiled backgrounds, currently. See also the \fB\-sh\fR option that can be 252non-tiled backgrounds, currently. See also the \fB\-sh\fR option that can be
… …
385.IP "\fB\-bl\fR" 4 392.IP "\fB\-bl\fR" 4
386.IX Item "-bl" 393.IX Item "-bl"
387Compile \fIfrills\fR: Set \s-1MWM\s0 hints to request a borderless window, i.e. 394Compile \fIfrills\fR: Set \s-1MWM\s0 hints to request a borderless window, i.e.
388if honoured by the \s-1WM\s0, the rxvt-unicode window will not have window 395if honoured by the \s-1WM\s0, the rxvt-unicode window will not have window
389decorations; resource \fBborderLess\fR. 396decorations; resource \fBborderLess\fR.
397.IP "\fB\-override\-redirect\fR" 4
398.IX Item "-override-redirect"
399Compile \fIfrills\fR: Sets override-redirect on the window; resource
400\&\fBoverride-redirect\fR.
390.IP "\fB\-sbg\fR" 4 401.IP "\fB\-sbg\fR" 4
391.IX Item "-sbg" 402.IX Item "-sbg"
392Compile \fIfrills\fR: Disable the usage of the built-in block graphics/line 403Compile \fIfrills\fR: Disable the usage of the built-in block graphics/line
393drawing characters and just rely on what the specified fonts provide. Use 404drawing characters and just rely on what the specified fonts provide. Use
394this if you have a good font and want to use its block graphic glyphs; 405this if you have a good font and want to use its block graphic glyphs;
… …
574configurations. If no resources are specified, suitable defaults will 585configurations. If no resources are specified, suitable defaults will
575be used. Command-line arguments can be used to override resource 586be used. Command-line arguments can be used to override resource
576settings. The following resources are supported (you might want to 587settings. The following resources are supported (you might want to
577check the @@RXVT_NAME@@\fIperl\fR\|(3) manpage for additional settings by perl 588check the @@RXVT_NAME@@\fIperl\fR\|(3) manpage for additional settings by perl
578extensions not documented here): 589extensions not documented here):
590.IP "\fBdepth:\fR \fIbitdepth\fR" 4
591.IX Item "depth: bitdepth"
592Compile \fIxft\fR: Attempt to find a visual with the given bit depth;
593option \fB\-depth\fR.
579.IP "\fBgeometry:\fR \fIgeom\fR" 4 594.IP "\fBgeometry:\fR \fIgeom\fR" 4
580.IX Item "geometry: geom" 595.IX Item "geometry: geom"
581Create the window with the specified X window geometry [default 80x24]; 596Create the window with the specified X window geometry [default 80x24];
582option \fB\-geometry\fR. 597option \fB\-geometry\fR.
583.IP "\fBbackground:\fR \fIcolour\fR" 4 598.IP "\fBbackground:\fR \fIcolour\fR" 4
… …
645.IP "\fBinheritPixmap:\fR \fIboolean\fR" 4 660.IP "\fBinheritPixmap:\fR \fIboolean\fR" 4
646.IX Item "inheritPixmap: boolean" 661.IX Item "inheritPixmap: boolean"
647\&\fBTrue\fR: make the background inherit the parent windows' pixmap, giving 662\&\fBTrue\fR: make the background inherit the parent windows' pixmap, giving
648artificial transparency. \fBFalse\fR: do not inherit the parent windows' 663artificial transparency. \fBFalse\fR: do not inherit the parent windows'
649pixmap. 664pixmap.
665.Sp
666\&\fIPlease note that transparency of any kind if completely unsupported by
667the author. Don't bug him with installation questions!\fR
650.IP "\fBfading:\fR \fInumber\fR" 4 668.IP "\fBfading:\fR \fInumber\fR" 4
651.IX Item "fading: number" 669.IX Item "fading: number"
652Fade the text by the given percentage when focus is lost; option \fB\-fade\fR. 670Fade the text by the given percentage when focus is lost; option \fB\-fade\fR.
653.IP "\fBfadeColor:\fR \fIcolour\fR" 4 671.IP "\fBfadeColor:\fR \fIcolour\fR" 4
654.IX Item "fadeColor: colour" 672.IX Item "fadeColor: colour"
… …
682centre (percent). A scale of 0 displays the image with tiling. A scale 700centre (percent). A scale of 0 displays the image with tiling. A scale
683of 1 displays the image without any scaling. A scale of 2 to 9 701of 1 displays the image without any scaling. A scale of 2 to 9
684specifies an integer number of images in that direction. No image will 702specifies an integer number of images in that direction. No image will
685be magnified beyond 10 times its original size. The maximum permitted 703be magnified beyond 10 times its original size. The maximum permitted
686scale is 1000. [default 0x0+50+50] 704scale is 1000. [default 0x0+50+50]
687.IP "\fBmenu:\fR \fIfile[;tag]\fR" 4
688.IX Item "menu: file[;tag]"
689Read in the specified menu file (note the `.menu' extension is
690optional) and also optionally specify a starting tag to find. See the
691reference documentation for details on the syntax for the menuBar.
692.IP "\fBpath:\fR \fIpath\fR" 4 705.IP "\fBpath:\fR \fIpath\fR" 4
693.IX Item "path: path" 706.IX Item "path: path"
694Specify the colon-delimited search path for finding files (\s-1XPM\s0 and 707Specify the colon-delimited search path for finding \s-1XPM\s0 files.
695menus), in addition to the paths specified by the \fB\s-1RXVTPATH\s0\fR and
696\&\fB\s-1PATH\s0\fR environment variables.
697.IP "\fBfont:\fR \fIfontlist\fR" 4 708.IP "\fBfont:\fR \fIfontlist\fR" 4
698.IX Item "font: fontlist" 709.IX Item "font: fontlist"
699Select the fonts to be used. This is a comma separated list of font names 710Select the fonts to be used. This is a comma separated list of font names
700that are checked in order when trying to find glyphs for characters. The 711that are checked in order when trying to find glyphs for characters. The
701first font defines the cell size for characters; other fonts might be 712first font defines the cell size for characters; other fonts might be
… …
711fonts. 722fonts.
712.Sp 723.Sp
713For example, this font resource 724For example, this font resource
714.Sp 725.Sp
715.Vb 5 726.Vb 5
716\& URxvt*font: 9x15bold,\e 727\& URxvt.font: 9x15bold,\e
717\& -misc-fixed-bold-r-normal--15-140-75-75-c-90-iso10646-1,\e 728\& -misc-fixed-bold-r-normal--15-140-75-75-c-90-iso10646-1,\e
718\& -misc-fixed-medium-r-normal--15-140-75-75-c-90-iso10646-1, \e 729\& -misc-fixed-medium-r-normal--15-140-75-75-c-90-iso10646-1, \e
719\& [codeset=JISX0208]xft:Kochi Gothic:antialias=false, \e 730\& [codeset=JISX0208]xft:Kochi Gothic:antialias=false, \e
720\& xft:Code2000:antialias=false 731\& xft:Code2000:antialias=false
721.Ve 732.Ve
… …
811The string will be interpreted as if typed into the shell as\-is. 822The string will be interpreted as if typed into the shell as\-is.
812.Sp 823.Sp
813Example: 824Example:
814.Sp 825.Sp
815.Vb 1 826.Vb 1
816\& URxvt*print-pipe: cat > $(TMPDIR=$HOME mktemp urxvt.XXXXXX) 827\& URxvt.print-pipe: cat > $(TMPDIR=$HOME mktemp urxvt.XXXXXX)
817.Ve 828.Ve
818.Sp 829.Sp
819This creates a new file in your home directory with the screen contents 830This creates a new file in your home directory with the screen contents
820everytime you hit \f(CW\*(C`Print\*(C'\fR. 831everytime you hit \f(CW\*(C`Print\*(C'\fR.
821.IP "\fBscrollBar:\fR \fIboolean\fR" 4 832.IP "\fBscrollBar:\fR \fIboolean\fR" 4
… …
922The string to send when the delete key (not the keypad delete key) is 933The string to send when the delete key (not the keypad delete key) is
923pressed. If unset it will send the sequence traditionally associated 934pressed. If unset it will send the sequence traditionally associated
924with the \fBExecute\fR key. 935with the \fBExecute\fR key.
925.IP "\fBcutchars:\fR \fIstring\fR" 4 936.IP "\fBcutchars:\fR \fIstring\fR" 4
926.IX Item "cutchars: string" 937.IX Item "cutchars: string"
927The characters used as delimiters for double-click word selection. The 938The characters used as delimiters for double-click word selection
928built-in default: 939(whitespace delimiting is added automatically if resource is given).
940.Sp
941When the selection extension is in use (the default if compiled in, see
942the @@RXVT_NAME@@\fIperl\fR\|(3) manpage), a suitable regex using these characters
943will be created (if the resource exists, otherwise, no regex will be
944created). In this mode, characters outside \s-1ISO\-8859\-1\s0 can be used.
945.Sp
946When the selection extension is not used, only \s-1ISO\-8859\-1\s0 characters can
947be used. If not specified, the built-in default is used:
929.Sp 948.Sp
930\&\fB\s-1BACKSLASH\s0 `"'&()*,;<=>?@[]{|}\fR 949\&\fB\s-1BACKSLASH\s0 `"'&()*,;<=>?@[]{|}\fR
931.IP "\fBpreeditType:\fR \fIstyle\fR" 4 950.IP "\fBpreeditType:\fR \fIstyle\fR" 4
932.IX Item "preeditType: style" 951.IX Item "preeditType: style"
933\&\fBOverTheSpot\fR, \fBOffTheSpot\fR, \fBRoot\fR; option \fB\-pt\fR. 952\&\fBOverTheSpot\fR, \fBOffTheSpot\fR, \fBRoot\fR; option \fB\-pt\fR.
… …
963default. (Note that many other terminals, including xterm, have these 982default. (Note that many other terminals, including xterm, have these
964sequences enabled by default, which doesn't make it safer, though). 983sequences enabled by default, which doesn't make it safer, though).
965.Sp 984.Sp
966You can enable them by setting this boolean resource or specifying 985You can enable them by setting this boolean resource or specifying
967\&\fB\-insecure\fR as an option. At the moment, this enables display\-answer, 986\&\fB\-insecure\fR as an option. At the moment, this enables display\-answer,
968locale, findfont, icon label and window title requests as well as dynamic 987locale, findfont, icon label and window title requests.
969menubar dispatch.
970.IP "\fBmodifier:\fR \fImodifier\fR" 4 988.IP "\fBmodifier:\fR \fImodifier\fR" 4
971.IX Item "modifier: modifier" 989.IX Item "modifier: modifier"
972Set the key to be interpreted as the Meta key to: \fBalt\fR, \fBmeta\fR, 990Set the key to be interpreted as the Meta key to: \fBalt\fR, \fBmeta\fR,
973\&\fBhyper\fR, \fBsuper\fR, \fBmod1\fR, \fBmod2\fR, \fBmod3\fR, \fBmod4\fR, \fBmod5\fR; option 991\&\fBhyper\fR, \fBsuper\fR, \fBmod1\fR, \fBmod2\fR, \fBmod3\fR, \fBmod4\fR, \fBmod5\fR; option
974\&\fB\-mod\fR. 992\&\fB\-mod\fR.
975.IP "\fBanswerbackString:\fR \fIstring\fR" 4 993.IP "\fBanswerbackString:\fR \fIstring\fR" 4
976.IX Item "answerbackString: string" 994.IX Item "answerbackString: string"
977Specify the reply rxvt-unicode sends to the shell when an \s-1ENQ\s0 (control\-E) 995Specify the reply rxvt-unicode sends to the shell when an \s-1ENQ\s0 (control\-E)
978character is passed through. It may contain escape values as described 996character is passed through. It may contain escape values as described
979in the entry on \fBkeysym\fR following. 997in the entry on \fBkeysym\fR following.
980.IP "\fBsecondaryScreen:\fR \fIbool\fR" 4 998.IP "\fBsecondaryScreen:\fR \fIboolean\fR" 4
981.IX Item "secondaryScreen: bool" 999.IX Item "secondaryScreen: boolean"
982Turn on/off secondary screen (default enabled). 1000Turn on/off secondary screen (default enabled).
983.IP "\fBsecondaryScroll:\fR \fIbool\fR" 4 1001.IP "\fBsecondaryScroll:\fR \fIboolean\fR" 4
984.IX Item "secondaryScroll: bool" 1002.IX Item "secondaryScroll: boolean"
985Turn on/off secondary screen scroll (default enabled). If the this 1003Turn on/off secondary screen scroll (default enabled). If the this
986option is enabled, scrolls on the secondary screen will change the 1004option is enabled, scrolls on the secondary screen will change the
987scrollback buffer and switching to/from the secondary screen will 1005scrollback buffer and switching to/from the secondary screen will
988instead scroll the screen up. 1006instead scroll the screen up.
989.IP "\fBhold\fR: \fIbool\fR" 4 1007.IP "\fBhold\fR: \fIboolean\fR" 4
990.IX Item "hold: bool" 1008.IX Item "hold: boolean"
991Turn on/off hold window after exit support. If enabled, @@RXVT_NAME@@ 1009Turn on/off hold window after exit support. If enabled, @@RXVT_NAME@@
992will not immediately destroy its window when the program executed within 1010will not immediately destroy its window when the program executed within
993it exits. Instead, it will wait till it is being killed or closed by the 1011it exits. Instead, it will wait till it is being killed or closed by the
994user. 1012user.
995.IP "\fBkeysym.\fR\fIsym\fR: \fIstring\fR" 4 1013.IP "\fBkeysym.\fR\fIsym\fR: \fIstring\fR" 4
… …
1156.IX Item "urlLauncher: string" 1174.IX Item "urlLauncher: string"
1157Specifies the program to be started with a \s-1URL\s0 argument. Used by the 1175Specifies the program to be started with a \s-1URL\s0 argument. Used by the
1158\&\f(CW\*(C`selection\-popup\*(C'\fR and \f(CW\*(C`mark\-urls\*(C'\fR perl extensions. 1176\&\f(CW\*(C`selection\-popup\*(C'\fR and \f(CW\*(C`mark\-urls\*(C'\fR perl extensions.
1159.IP "\fBtransient-for\fR: \fIwindowid\fR" 4 1177.IP "\fBtransient-for\fR: \fIwindowid\fR" 4
1160.IX Item "transient-for: windowid" 1178.IX Item "transient-for: windowid"
1161Sets the \s-1WM_TRANSIENT_FOR\s0 property to the given window iw. 1179Compile \fIfrills\fR: Sets the \s-1WM_TRANSIENT_FOR\s0 property to the given window id.
1180.IP "\fBoverride-redirect\fR: \fIboolean\fR" 4
1181.IX Item "override-redirect: boolean"
1182Compile \fIfrills\fR: Sets override-redirect for the terminal window, making
1183it almost invisible to window managers; option \fB\-override\-redirect\fR.
1162.SH "THE SCROLLBAR" 1184.SH "THE SCROLLBAR"
1163.IX Header "THE SCROLLBAR" 1185.IX Header "THE SCROLLBAR"
1164Lines of text that scroll off the top of the \fB@@RXVT_NAME@@\fR window 1186Lines of text that scroll off the top of the \fB@@RXVT_NAME@@\fR window
1165(resource: \fBsaveLines\fR) and can be scrolled back using the scrollbar 1187(resource: \fBsaveLines\fR) and can be scrolled back using the scrollbar
1166or by keystrokes. The normal \fB@@RXVT_NAME@@\fR scrollbar has arrows and 1188or by keystrokes. The normal \fB@@RXVT_NAME@@\fR scrollbar has arrows and
… …
1199normal one. In this mode, every selected row becomes its own line in the 1221normal one. In this mode, every selected row becomes its own line in the
1200selection, and trailing whitespace is visually underlined and removed from 1222selection, and trailing whitespace is visually underlined and removed from
1201the selection. 1223the selection.
1202.IP "\fBInsertion\fR:" 4 1224.IP "\fBInsertion\fR:" 4
1203.IX Item "Insertion:" 1225.IX Item "Insertion:"
1204Pressing and releasing the Middle mouse button (or \fBShift-Insert\fR) in 1226Pressing and releasing the Middle mouse button in an \fB@@RXVT_NAME@@\fR
1205an \fB@@RXVT_NAME@@\fR window causes the current text selection to be 1227window causes the value of the \s-1PRIMARY\s0 selection (or \s-1CLIPBOARD\s0 with the
1206inserted as if it had been typed on the keyboard. 1228Meta modifier) to be inserted as if it had been typed on the keyboard.
1229.Sp
1230Pressing \fBShift-Insert\fR causes the value of the \s-1PRIMARY\s0 selection to be
1231inserted too.
1207.SH "CHANGING FONTS" 1232.SH "CHANGING FONTS"
1208.IX Header "CHANGING FONTS" 1233.IX Header "CHANGING FONTS"
1209Changing fonts (or font sizes, respectively) via the keypad is not yet 1234Changing fonts (or font sizes, respectively) via the keypad is not yet
1210supported in rxvt\-unicode. Bug me if you need this. 1235supported in rxvt\-unicode. Bug me if you need this.
1211.PP 1236.PP
1212You can, however, switch fonts at runtime using escape sequences (and 1237You can, however, switch fonts at runtime using escape sequences, e.g.:
1213therefore using the menubar), e.g.:
1214.PP 1238.PP
1215.Vb 1 1239.Vb 1
1216\& printf '\ee]710;%s\e007' "9x15bold,xft:Kochi Gothic" 1240\& printf '\ee]710;%s\e007' "9x15bold,xft:Kochi Gothic"
1241.Ve
1242.PP
1243You can use keyboard shortcuts, too:
1244.PP
1245.Vb 2
1246\& URxvt.keysym.M-C-1: command:\e033]710;suxuseuro\e007\e033]711;suxuseuro\e007
1247\& URxvt.keysym.M-C-2: command:\e033]710;9x15bold\e007\e033]711;9x15bold\e007
1217.Ve 1248.Ve
1218.PP 1249.PP
1219rxvt-unicode will automatically re-apply these fonts to the output so far. 1250rxvt-unicode will automatically re-apply these fonts to the output so far.
1220.SH "ISO 14755 SUPPORT" 1251.SH "ISO 14755 SUPPORT"
1221.IX Header "ISO 14755 SUPPORT" 1252.IX Header "ISO 14755 SUPPORT"
… …
1282.SH "COLORS AND GRAPHICS" 1313.SH "COLORS AND GRAPHICS"
1283.IX Header "COLORS AND GRAPHICS" 1314.IX Header "COLORS AND GRAPHICS"
1284In addition to the default foreground and background colours, 1315In addition to the default foreground and background colours,
1285\&\fB@@RXVT_NAME@@\fR can display up to 16 colours (8 \s-1ANSI\s0 colours plus 1316\&\fB@@RXVT_NAME@@\fR can display up to 16 colours (8 \s-1ANSI\s0 colours plus
1286high-intensity bold/blink versions of the same). Here is a list of the 1317high-intensity bold/blink versions of the same). Here is a list of the
1287colours with their \fBrgb.txt\fR names. 1318colours with their names.
1288.TS 1319.TS
1289l l l . 1320l l l .
1290color0 (black) = Black 1321color0 (black) = Black
1291color1 (red) = Red3 1322color1 (red) = Red3
1292color2 (green) = Green3 1323color2 (green) = Green3
… …
1319been specified. For example, 1350been specified. For example,
1320.IP "\fB@@RXVT_NAME@@ \-fg Black \-bg White \-rv\fR" 4 1351.IP "\fB@@RXVT_NAME@@ \-fg Black \-bg White \-rv\fR" 4
1321.IX Item "@@RXVT_NAME@@ -fg Black -bg White -rv" 1352.IX Item "@@RXVT_NAME@@ -fg Black -bg White -rv"
1322would yield White on Black, while on \fIxterm\fR(1) it would yield Black 1353would yield White on Black, while on \fIxterm\fR(1) it would yield Black
1323on White. 1354on White.
1355.Sh "\s-1ALPHA\s0 \s-1CHANNEL\s0 \s-1SUPPORT\s0"
1356.IX Subsection "ALPHA CHANNEL SUPPORT"
1357If Xft support has been compiled in and as long as Xft/Xrender/X don't get
1358their act together, rxvt-unicode will support \f(CW\*(C`rgba:rrrr/gggg/bbbb/aaaa\*(C'\fR
1359(recommended, but \fB\s-1MUST\s0\fR have 4 digits/component) colour specifications,
1360in addition to the ones provided by X, where the additional A component
1361specifies opacity (alpha) values. The minimum value of \f(CW0\fR is completely
1362transparent). You can also prefix any color with \f(CW\*(C`[a]\*(C'\fR, where \f(CW\*(C`a\*(C'\fR is on
1363to four hex digits specifiying the opacity value.
1364.PP
1365You probably need to specify \fB\*(L"\-depth 32\*(R"\fR, too, and have the luck that
1366your X\-server uses \s-1ARGB\s0 pixel layout, as X is far from just supporting
1367\&\s-1ARGB\s0 visuals out of the box, and rxvt-unicode just fudges around.
1368.PP
1369For example, the following selects an almost completely transparent red
1370background, and an almost opaque pink foreground:
1371.PP
1372.Vb 1
1373\& @@RXVT_NAME@@ -depth 32 -bg rgba:0000/0000/0000/2222 -fg "[e]pink"
1374.Ve
1375.PP
1376\&\fIPlease note that transparency of any kind if completely unsupported by
1377the author. Don't bug him with installation questions!\fR
1324.SH "ENVIRONMENT" 1378.SH "ENVIRONMENT"
1325.IX Header "ENVIRONMENT" 1379.IX Header "ENVIRONMENT"
1326\&\fB@@RXVT_NAME@@\fR sets and/or uses the following environment variables: 1380\&\fB@@RXVT_NAME@@\fR sets and/or uses the following environment variables:
1327.IP "\fB\s-1TERM\s0\fR" 4 1381.IP "\fB\s-1TERM\s0\fR" 4
1328.IX Item "TERM" 1382.IX Item "TERM"
… …
1356Used by @@RXVT_NAME@@ to connect to the display and set to the correct 1410Used by @@RXVT_NAME@@ to connect to the display and set to the correct
1357display in it's child processes. 1411display in it's child processes.
1358.IP "\fB\s-1SHELL\s0\fR" 4 1412.IP "\fB\s-1SHELL\s0\fR" 4
1359.IX Item "SHELL" 1413.IX Item "SHELL"
1360The shell to be used for command execution, defaults to \f(CW\*(C`/bin/sh\*(C'\fR. 1414The shell to be used for command execution, defaults to \f(CW\*(C`/bin/sh\*(C'\fR.
1361.IP "\fB\s-1RXVTPATH\s0\fR" 4
1362.IX Item "RXVTPATH"
1363The path where @@RXVT_NAME@@ looks for support files such as menu and xpm
1364files.
1365.IP "\fB\s-1PATH\s0\fR" 4
1366.IX Item "PATH"
1367Used in the same way as \f(CW\*(C`RXVTPATH\*(C'\fR.
1368.IP "\fB\s-1RXVT_SOCKET\s0\fR" 4 1415.IP "\fB\s-1RXVT_SOCKET\s0\fR" 4
1369.IX Item "RXVT_SOCKET" 1416.IX Item "RXVT_SOCKET"
1370The unix domain socket path used by @@RXVT_NAME@@c(1) and 1417The unix domain socket path used by @@RXVT_NAME@@c(1) and
1371@@RXVT_NAME@@d(1). 1418@@RXVT_NAME@@d(1).
1372.Sp 1419.Sp
… …
1417.IP "Oezguer Kesim <kesim@math.fu\-berlin.de>" 4 1464.IP "Oezguer Kesim <kesim@math.fu\-berlin.de>" 4
1418.IX Item "Oezguer Kesim <kesim@math.fu-berlin.de>" 1465.IX Item "Oezguer Kesim <kesim@math.fu-berlin.de>"
1419Project Coordinator (changes.txt 2.21a to 2.4.5) 1466Project Coordinator (changes.txt 2.21a to 2.4.5)
1420.IP "Geoff Wing <gcw@pobox.com>" 4 1467.IP "Geoff Wing <gcw@pobox.com>" 4
1421.IX Item "Geoff Wing <gcw@pobox.com>" 1468.IX Item "Geoff Wing <gcw@pobox.com>"
1422Rewrote screen display and text selection routines. Project Coordinator 1469Rewrote screen display and text selection routines.
1470.Sp
1423(changes.txt 2.4.6 \- rxvt\-unicode) 1471Project Coordinator (changes.txt 2.4.6 \- rxvt\-unicode)
1424.IP "Marc Alexander Lehmann <rxvt\-unicode@schmorp.de>" 4 1472.IP "Marc Alexander Lehmann <rxvt\-unicode@schmorp.de>" 4
1425.IX Item "Marc Alexander Lehmann <rxvt-unicode@schmorp.de>" 1473.IX Item "Marc Alexander Lehmann <rxvt-unicode@schmorp.de>"
1426Forked rxvt\-unicode, rewrote most of the display code and internal 1474Forked rxvt\-unicode, unicode support, rewrote almost all the code, perl
1427character handling to store text in unicode, improve xterm 1475extension, random hacks, numerous bugfixes and extensions.
1428compatibility and apply numerous other bugfixes and extensions.
1429.Sp 1476.Sp
1430Project Coordinator (Changes 1.0 \-) 1477Project Coordinator (Changes 1.0 \-)
1478.IP "Emanuele Giaquinta <e.giaquinta@glauco.it>" 4
1479.IX Item "Emanuele Giaquinta <e.giaquinta@glauco.it>"
1480Pty/tty/utmp/wtmp rewrite, lots of random hacking and bugfixing.

Diff Legend

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