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

Comparing rxvt-unicode/doc/rxvt.1.txt (file contents):
Revision 1.62 by root, Mon Aug 7 16:17:30 2006 UTC vs.
Revision 1.68 by root, Wed Aug 1 18:38:15 2007 UTC

… …
4 4
5SYNOPSIS 5SYNOPSIS
6 rxvt [options] [-e command [ args ]] 6 rxvt [options] [-e command [ args ]]
7 7
8DESCRIPTION 8DESCRIPTION
9 rxvt-unicode, version 7.9, is a colour vt102 terminal emulator intended 9 rxvt-unicode, version 8.3, is a colour vt102 terminal emulator intended
10 as an *xterm*(1) replacement for users who do not require features such 10 as an *xterm*(1) replacement for users who do not require features such
11 as Tektronix 4014 emulation and toolkit-style configurability. As a 11 as Tektronix 4014 emulation and toolkit-style configurability. As a
12 result, rxvt-unicode uses much less swap space -- a significant 12 result, rxvt-unicode uses much less swap space -- a significant
13 advantage on a machine serving many X sessions. 13 advantage on a machine serving many X sessions.
14 14
15FREQUENTLY ASKED QUESTIONS 15FREQUENTLY ASKED QUESTIONS
16 See rxvt(7) (try "man 7 rxvt") for a list of frequently asked questions 16 See rxvt(7) (try "man 7 rxvt") for a list of frequently asked questions
17 and answer to them and some common problems. That document is also 17 and answer to them and some common problems. That document is also
18 accessible on the World-Wide-Web at 18 accessible on the World-Wide-Web at
19 <http://cvs.schmorp.de/browse/*checkout*/rxvt-unicode/doc/rxvt.7.html>. 19 <http://cvs.schmorp.de/browse/rxvt-unicode/doc/rxvt.7.html>.
20 20
21RXVT-UNICODE VS. RXVT 21RXVT-UNICODE VS. RXVT
22 Unlike the original rxvt, rxvt-unicode stores all text in Unicode 22 Unlike the original rxvt, rxvt-unicode stores all text in Unicode
23 internally. That means it can store and display most scripts in the 23 internally. That means it can store and display most scripts in the
24 world. Being a terminal emulator, however, some things are very 24 world. Being a terminal emulator, however, some things are very
… …
95 95
96 -rv|+rv 96 -rv|+rv
97 Turn on/off simulated reverse video; resource reverseVideo. 97 Turn on/off simulated reverse video; resource reverseVideo.
98 98
99 -j|+j 99 -j|+j
100 Turn on/off jump scrolling; resource jumpScroll. 100 Turn on/off jump scrolling (allow multiple lines per refresh);
101 resource jumpScroll.
102
103 -ss|+ss
104 Turn on/off skip scrolling (allow multiple screens per refresh);
105 resource skipScroll.
101 106
102 -ip|+ip | -tr|+tr 107 -ip|+ip | -tr|+tr
103 Turn on/off inheriting parent window's pixmap. Alternative form is 108 Turn on/off inheriting parent window's pixmap. Alternative form is
104 -tr; resource inheritPixmap. 109 -tr; resource inheritPixmap.
105 110
… …
118 123
119 -tint *colour* 124 -tint *colour*
120 Tint the transparent background pixmap with the given colour when 125 Tint the transparent background pixmap with the given colour when
121 transparency is enabled with -tr or -ip. This only works for 126 transparency is enabled with -tr or -ip. This only works for
122 non-tiled backgrounds, currently. See also the -sh option that can 127 non-tiled backgrounds, currently. See also the -sh option that can
123 be used to brighten or darken the image in addition to tinting it; 128 be used to brighten or darken the image in addition to tinting it.
124 resource *tintColor*. Example: 129 Please note that certain tint colours can be applied on the
130 server-side, thus yielding performance gain of two orders of
131 magnitude. These colours are: blue, red, green, cyan, magenta,
132 yellow, and those close to them; resource *tintColor*. Example:
125 133
126 rxvt -tr -tint blue -sh 40 134 rxvt -tr -tint blue -sh 40
127 135
136 -sh *number*
128 -sh *number* Darken (0 .. 100) or lighten (-1 .. -100) the transparent 137 Darken (0 .. 100) or lighten (-1 .. -100) the transparent background
129 background image in addition to tinting it (i.e. -tint must be 138 image in addition to (or instead of) tinting it; resource *shading*.
130 specified, too, e.g. "-tint white"). 139
140 -blt *string*
141 Specify background blending type. If background pixmap is specified
142 at the same time as transparency - such pixmap will be blended over
143 transparency image, using method specified. Supported values are :
144 add, alphablend, allanon - color values averaging, colorize, darken,
145 diff, dissipate, hue, lighten, overlay, saturate, screen, sub, tint,
146 value. The default is alpha-blending; resource *blendType*.
147
148 -blr *HxV*
149 Apply Gaussian Blur with the specified radii to the transparent
150 background image. If single number is specified - both vertical and
151 horizontal radii are considered to be the same. Setting one of the
152 radii to 1 and another to a large number creates interesting effects
153 on some backgrounds. Maximum radius value is 128; resource
154 *blurRadius*.
131 155
132 -bg *colour* 156 -bg *colour*
133 Window background colour; resource background. 157 Window background colour; resource background.
134 158
135 -fg *colour* 159 -fg *colour*
136 Window foreground colour; resource foreground. 160 Window foreground colour; resource foreground.
137 161
138 -pixmap *file[;geom]* 162 -pixmap *file[;geom]*
139 Compile *XPM*: Specify XPM file for the background and also 163 Compile *afterimage*: Specify image file for the background and also
140 optionally specify its scaling with a geometry string. Note you may 164 optionally specify its scaling with a geometry string. Note you may
141 need to add quotes to avoid special shell interpretation of the ";" 165 need to add quotes to avoid special shell interpretation of the ";"
142 in the command-line; resource backgroundPixmap. 166 in the command-line; for more details see resource backgroundPixmap.
143 167
144 -cr *colour* 168 -cr *colour*
145 The cursor colour; resource cursorColor. 169 The cursor colour; resource cursorColor.
146 170
147 -pr *colour* 171 -pr *colour*
… …
327 Set the font set to use for the X Input Method, see resource imFont 351 Set the font set to use for the X Input Method, see resource imFont
328 for more info. 352 for more info.
329 353
330 -tcw 354 -tcw
331 Change the meaning of triple-click selection with the left mouse 355 Change the meaning of triple-click selection with the left mouse
356 button. Only effective when the original (non-perl) selection code
332 button. Instead of selecting a full line it will extend the 357 is in-use. Instead of selecting a full line it will extend the
333 selection the end of the logical line only. resource 358 selection the end of the logical line only. resource
334 tripleclickwords. 359 tripleclickwords.
335 360
336 -insecure 361 -insecure
337 Enable "insecure" mode, which currently enables most of the escape 362 Enable "insecure" mode, which currently enables most of the escape
… …
484 Use the specified colour to display underlined characters when the 509 Use the specified colour to display underlined characters when the
485 foreground colour is the default. 510 foreground colour is the default.
486 511
487 colorRV: *colour* 512 colorRV: *colour*
488 Use the specified colour as the background for reverse video 513 Use the specified colour as the background for reverse video
489 characters. 514 characters when OPTION_HC is disabled (--disable-frills).
490 515
491 underlineColor: *colour* 516 underlineColor: *colour*
492 If set, use the specified colour as the colour for the underline 517 If set, use the specified colour as the colour for the underline
493 itself. If unset, use the foreground colour. 518 itself. If unset, use the foreground colour.
494 519
… …
505 True: simulate reverse video by foreground and background colours; 530 True: simulate reverse video by foreground and background colours;
506 option -rv. False: regular screen colours [default]; option +rv. See 531 option -rv. False: regular screen colours [default]; option +rv. See
507 note in COLORS AND GRAPHICS section. 532 note in COLORS AND GRAPHICS section.
508 533
509 jumpScroll: *boolean* 534 jumpScroll: *boolean*
510 True: specify that jump scrolling should be used. When scrolling 535 True: specify that jump scrolling should be used. When receiving
511 quickly, fewer screen updates are performed [default]; option -j. 536 lots of lines, rxvt will only scroll once a whole screen height of
537 lines has been read, resulting in fewer updates while still
538 displaying every received line; option -j.
539
512 False: specify that smooth scrolling should be used; option +j. 540 False: specify that smooth scrolling should be used. rxvt will force
541 a screen refresh on each new line it received; option +j.
542
543 skipScroll: *boolean*
544 True: (the default) specify that skip scrolling should be used. When
545 receiving lots of lines, rxvt will only scroll once in a while
546 (around 60 times per second), resulting in far fewer updates. This
547 can result in rxvt not ever displaying some of the lines it
548 receives; option -ss.
549
550 False: specify that everything is to be displayed, even if the
551 refresh is too fast for the human eye to read anything (or the
552 monitor to display anything); option +ss.
513 553
514 inheritPixmap: *boolean* 554 inheritPixmap: *boolean*
515 True: make the background inherit the parent windows' pixmap, giving 555 True: make the background inherit the parent windows' pixmap, giving
516 artificial transparency. False: do not inherit the parent windows' 556 artificial transparency. False: do not inherit the parent windows'
517 pixmap. 557 pixmap.
… …
531 Tint the transparent background pixmap with the given colour; option 571 Tint the transparent background pixmap with the given colour; option
532 -tint. 572 -tint.
533 573
534 shading: *number* 574 shading: *number*
535 Darken (0 .. 100) or lighten (-1 .. -100) the transparent background 575 Darken (0 .. 100) or lighten (-1 .. -100) the transparent background
536 image in addition to tinting it. 576 image in addition to tinting it; option -sh.
577
578 blendType: *string*
579 Specify background blending type; option -blt.
580
581 blurRadius: *number*
582 Apply Gaussian Blurr with the specified radius to the transparent
583 background image; option -blr.
537 584
538 scrollColor: *colour* 585 scrollColor: *colour*
539 Use the specified colour for the scrollbar [default #B2B2B2]. 586 Use the specified colour for the scrollbar [default #B2B2B2].
540 587
541 troughColor: *colour* 588 troughColor: *colour*
… …
545 borderColor: *colour* 592 borderColor: *colour*
546 The colour of the border around the text area and between the 593 The colour of the border around the text area and between the
547 scrollbar and the text. 594 scrollbar and the text.
548 595
549 backgroundPixmap: *file[;geom]* 596 backgroundPixmap: *file[;geom]*
550 Use the specified XPM file (note the `.xpm' extension is optional) 597 Use the specified image file for the background and also optionally
551 for the background and also optionally specify its scaling with a 598 specify its scaling with a geometry string WxH+X+Y, in which "W" /
552 geometry string WxH+X+Y, in which "W" / "H" specify the
553 horizontal/vertical scale (percent) and "X" / "Y" locate the image 599 "H" specify the horizontal/vertical scale (percent), and "X" / "Y"
554 centre (percent). A scale of 0 displays the image with tiling. A 600 locate the image centre (percent). A scale of 0 displays the image
555 scale of 1 displays the image without any scaling. A scale of 2 to 9 601 with tiling. A scale of 1 displays the image without any scaling. A
556 specifies an integer number of images in that direction. No image 602 scale of 2 to 9 specifies an integer number of images in that
557 will be magnified beyond 10 times its original size. The maximum 603 direction. No image will be magnified beyond 10 times its original
558 permitted scale is 1000. [default 0x0+50+50] 604 size. The maximum permitted scale is 1000. Special string of "auto"
605 used as a geometry will cause image to be automatically scaled to
606 match window size. If used in conjunction with -tr option -
607 specified pixmap will be blended over transparency image using
608 either alpha-blending, or any other blending type, specified with
609 -blt "type" option. [default 0x0+50+50]
559 610
560 path: *path* 611 path: *path*
561 Specify the colon-delimited search path for finding XPM files. 612 Specify the colon-delimited search path for finding XPM files.
562 613
563 font: *fontlist* 614 font: *fontlist*
… …
630 colours are not reachable. 681 colours are not reachable.
631 682
632 selectstyle: *mode* 683 selectstyle: *mode*
633 Set mouse selection style to old which is 2.20, oldword which is 684 Set mouse selection style to old which is 2.20, oldword which is
634 xterm style with 2.20 old word selection, or anything else which 685 xterm style with 2.20 old word selection, or anything else which
635 gives xterm style selection. 686 gives xterm style selection. Only effective when the original
687 (non-perl) selection code is in use.
636 688
637 scrollstyle: *mode* 689 scrollstyle: *mode*
638 Set scrollbar style to rxvt, plain, next or xterm. plain is the 690 Set scrollbar style to rxvt, plain, next or xterm. plain is the
639 author's favourite. 691 author's favourite.
640 692
… …
649 explicitly set; option -n. 701 explicitly set; option -n.
650 702
651 mapAlert: *boolean* 703 mapAlert: *boolean*
652 True: de-iconify (map) on receipt of a bell character. False: no 704 True: de-iconify (map) on receipt of a bell character. False: no
653 de-iconify (map) on receipt of a bell character [default]. 705 de-iconify (map) on receipt of a bell character [default].
706
707 urgentOnBell: *boolean*
708 True: set the urgency hint for the wm on receipt of a bell
709 character. False: do not set the urgency hint [default].
654 710
655 visualBell: *boolean* 711 visualBell: *boolean*
656 True: use visual bell on receipt of a bell character; option -vb. 712 True: use visual bell on receipt of a bell character; option -vb.
657 False: no visual bell [default]; option +vb. 713 False: no visual bell [default]; option +vb.
658 714
… …
787 843
788 cutchars: *string* 844 cutchars: *string*
789 The characters used as delimiters for double-click word selection 845 The characters used as delimiters for double-click word selection
790 (whitespace delimiting is added automatically if resource is given). 846 (whitespace delimiting is added automatically if resource is given).
791 847
792 When the selection extension is in use (the default if compiled in, 848 When the perl selection extension is in use (the default if compiled
793 see the rxvtperl(3) manpage), a suitable regex using these 849 in, see the rxvtperl(3) manpage), a suitable regex using these
794 characters will be created (if the resource exists, otherwise, no 850 characters will be created (if the resource exists, otherwise, no
795 regex will be created). In this mode, characters outside ISO-8859-1 851 regex will be created). In this mode, characters outside ISO-8859-1
796 can be used. 852 can be used.
797 853
798 When the selection extension is not used, only ISO-8859-1 characters 854 When the selection extension is not used, only ISO-8859-1 characters
… …
850 906
851 secondaryScreen: *boolean* 907 secondaryScreen: *boolean*
852 Turn on/off secondary screen (default enabled). 908 Turn on/off secondary screen (default enabled).
853 909
854 secondaryScroll: *boolean* 910 secondaryScroll: *boolean*
855 Turn on/off secondary screen scroll (default enabled). If the this 911 Turn on/off secondary screen scroll (default enabled). If this
856 option is enabled, scrolls on the secondary screen will change the 912 option is enabled, scrolls on the secondary screen will change the
857 scrollback buffer and switching to/from the secondary screen will 913 scrollback buffer and switching to/from the secondary screen will
858 instead scroll the screen up. 914 instead scroll the screen up.
859 915
860 hold: *boolean* 916 hold: *boolean*
… …
886 942
887 *string* may contain escape values ("\a": bell, "\b": backspace, 943 *string* may contain escape values ("\a": bell, "\b": backspace,
888 "\e", "\E": escape, "\n": newline, "\r": carriage return, "\t": tab, 944 "\e", "\E": escape, "\n": newline, "\r": carriage return, "\t": tab,
889 "\000": octal number) or verbatim control characters ("^?": delete, 945 "\000": octal number) or verbatim control characters ("^?": delete,
890 "^@": null, "^A" ...) and may be enclosed with double quotes so that 946 "^@": null, "^A" ...) and may be enclosed with double quotes so that
891 it can start or end with whitespace. 947 it can start or end with whitespace. This feature is deprecated and
948 will be removed.
892 949
893 Please note that you need to double the "\" in resource files, as 950 Please note that you need to double the "\" in resource files, as
894 Xlib itself does its own de-escaping (you can use "\033" instead of 951 Xlib itself does its own de-escaping (you can use "\033" instead of
895 "\e" (and so on), which will work with both Xt and rxvt's own 952 "\e" (and so on), which will work with both Xt and rxvt's own
896 processing). 953 processing).
… …
1007 Sets the hotkey that starts the incremental scrollback buffer search 1064 Sets the hotkey that starts the incremental scrollback buffer search
1008 (default: "M-s"). 1065 (default: "M-s").
1009 1066
1010 urlLauncher: *string* 1067 urlLauncher: *string*
1011 Specifies the program to be started with a URL argument. Used by the 1068 Specifies the program to be started with a URL argument. Used by the
1012 "selection-popup" and "mark-urls" perl extensions. 1069 "selection-popup" and "matcher" perl extensions.
1013 1070
1014 transient-for: *windowid* 1071 transient-for: *windowid*
1015 Compile *frills*: Sets the WM_TRANSIENT_FOR property to the given 1072 Compile *frills*: Sets the WM_TRANSIENT_FOR property to the given
1016 window id. 1073 window id.
1017 1074
1018 override-redirect: *boolean* 1075 override-redirect: *boolean*
1019 Compile *frills*: Sets override-redirect for the terminal window, 1076 Compile *frills*: Sets override-redirect for the terminal window,
1020 making it almost invisible to window managers; option 1077 making it almost invisible to window managers; option
1021 -override-redirect. 1078 -override-redirect.
1079
1080 iso14755_52: *boolean*
1081 Turn on/off ISO 14755 5.2 mode (default enabled).
1022 1082
1023THE SCROLLBAR 1083THE SCROLLBAR
1024 Lines of text that scroll off the top of the rxvt window (resource: 1084 Lines of text that scroll off the top of the rxvt window (resource:
1025 saveLines) and can be scrolled back using the scrollbar or by 1085 saveLines) and can be scrolled back using the scrollbar or by
1026 keystrokes. The normal rxvt scrollbar has arrows and its behaviour is 1086 keystrokes. The normal rxvt scrollbar has arrows and its behaviour is
… …
1040 disabled -- on the assumption that we are using a fullscreen 1100 disabled -- on the assumption that we are using a fullscreen
1041 application. Instead, pressing Button1 and Button3 sends ESC [ 6 ~ 1101 application. Instead, pressing Button1 and Button3 sends ESC [ 6 ~
1042 (Next) and ESC [ 5 ~ (Prior), respectively. Similarly, clicking on the 1102 (Next) and ESC [ 5 ~ (Prior), respectively. Similarly, clicking on the
1043 up and down arrows sends ESC [ A (Up) and ESC [ B (Down), respectively. 1103 up and down arrows sends ESC [ A (Up) and ESC [ B (Down), respectively.
1044 1104
1045TEXT SELECTION AND INSERTION 1105THE SELECTION: SELECTING AND PASTING TEXT
1046 The behaviour of text selection and insertion mechanism is similar to 1106 The behaviour of text selection and insertion/pasting mechanism is
1047 *xterm*(1). 1107 similar to *xterm*(1).
1048 1108
1049 Selection: 1109 Selecting:
1050 Left click at the beginning of the region, drag to the end of the 1110 Left click at the beginning of the region, drag to the end of the
1051 region and release; Right click to extend the marked region; Left 1111 region and release; Right click to extend the marked region; Left
1052 double-click to select a word; Left triple-click to select the 1112 double-click to select a word; Left triple-click to select the
1053 entire logical line (which can span multiple screen lines), unless 1113 entire logical line (which can span multiple screen lines), unless
1054 modified by resource tripleclickwords. 1114 modified by resource tripleclickwords.
… …
1057 (Compile: *frills*) will create a rectangular selection instead of a 1117 (Compile: *frills*) will create a rectangular selection instead of a
1058 normal one. In this mode, every selected row becomes its own line in 1118 normal one. In this mode, every selected row becomes its own line in
1059 the selection, and trailing whitespace is visually underlined and 1119 the selection, and trailing whitespace is visually underlined and
1060 removed from the selection. 1120 removed from the selection.
1061 1121
1062 Insertion: 1122 Pasting:
1063 Pressing and releasing the Middle mouse button in an rxvt window 1123 Pressing and releasing the Middle mouse button in an rxvt window
1064 causes the value of the PRIMARY selection (or CLIPBOARD with the 1124 causes the value of the PRIMARY selection (or CLIPBOARD with the
1065 Meta modifier) to be inserted as if it had been typed on the 1125 Meta modifier) to be inserted as if it had been typed on the
1066 keyboard. 1126 keyboard.
1067 1127
… …
1085 far. 1145 far.
1086 1146
1087ISO 14755 SUPPORT 1147ISO 14755 SUPPORT
1088 ISO 14755 is a standard for entering and viewing unicode characters and 1148 ISO 14755 is a standard for entering and viewing unicode characters and
1089 character codes using the keyboard. It consists of 4 parts. The first 1149 character codes using the keyboard. It consists of 4 parts. The first
1090 part is available rxvt-unicode has been compiled with "--enable-frills", 1150 part is available if rxvt-unicode has been compiled with
1091 the rest is available when rxvt-unicode was compiled with 1151 "--enable-frills", the rest is available when rxvt-unicode was compiled
1092 "--enable-iso14755". 1152 with "--enable-iso14755".
1093 1153
1094 * 5.1: Basic method 1154 * 5.1: Basic method
1095
1096 This allows you to enter unicode characters using their hexcode. 1155 This allows you to enter unicode characters using their hexcode.
1097 1156
1098 Start by pressing and holding both "Control" and "Shift", then enter 1157 Start by pressing and holding both "Control" and "Shift", then enter
1099 hex-digits (between one and six). Releasing "Control" and "Shift" 1158 hex-digits (between one and six). Releasing "Control" and "Shift"
1100 will commit the character as if it were typed directly. While 1159 will commit the character as if it were typed directly. While
… …
1106 address, which you cannot type. Fortunately, the card has the e-mail 1165 address, which you cannot type. Fortunately, the card has the e-mail
1107 address printed as hexcodes, e.g. "671d 65e5". You can enter this 1166 address printed as hexcodes, e.g. "671d 65e5". You can enter this
1108 easily by pressing "Control" and "Shift", followed by 1167 easily by pressing "Control" and "Shift", followed by
1109 "6-7-1-D-SPACE-6-5-E-5", followed by releasing the modifier keys. 1168 "6-7-1-D-SPACE-6-5-E-5", followed by releasing the modifier keys.
1110 1169
1111 * 5.2: Keyboard symbols entry method 1170 * 5.2: Keyboard symbols entry method
1112
1113 This mode lets you input characters representing the keycap symbols 1171 This mode lets you input characters representing the keycap symbols
1114 of your keyboard, if representable in the current locale encoding. 1172 of your keyboard, if representable in the current locale encoding.
1115 1173
1116 Start by pressing "Control" and "Shift" together, then releasing 1174 Start by pressing "Control" and "Shift" together, then releasing
1117 them. The next special key (cursor keys, home etc.) you enter will 1175 them. The next special key (cursor keys, home etc.) you enter will
… …
1119 corresponding keycap symbol. The symbol will only be entered when 1177 corresponding keycap symbol. The symbol will only be entered when
1120 the key has been released, otherwise pressing e.g. "Shift" would 1178 the key has been released, otherwise pressing e.g. "Shift" would
1121 enter the symbol for "ISO Level 2 Switch", although your intention 1179 enter the symbol for "ISO Level 2 Switch", although your intention
1122 might have been to enter a reverse tab (Shift-Tab). 1180 might have been to enter a reverse tab (Shift-Tab).
1123 1181
1124 * 5.3: Screen-selection entry method 1182 * 5.3: Screen-selection entry method
1125
1126 While this is implemented already (it's basically the selection 1183 While this is implemented already (it's basically the selection
1127 mechanism), it could be extended by displaying a unicode character 1184 mechanism), it could be extended by displaying a unicode character
1128 map. 1185 map.
1129 1186
1130 * 5.4: Feedback method for identifying displayed characters for later 1187 * 5.4: Feedback method for identifying displayed characters for later
1131 input 1188 input
1132
1133 This method lets you display the unicode character code associated 1189 This method lets you display the unicode character code associated
1134 with characters already displayed. 1190 with characters already displayed.
1135 1191
1136 You enter this mode by holding down "Control" and "Shift" together, 1192 You enter this mode by holding down "Control" and "Shift" together,
1137 then pressing and holding the left mouse button and moving around. 1193 then pressing and holding the left mouse button and moving around.
… …
1156COLORS AND GRAPHICS 1212COLORS AND GRAPHICS
1157 In addition to the default foreground and background colours, rxvt can 1213 In addition to the default foreground and background colours, rxvt can
1158 display up to 16 colours (8 ANSI colours plus high-intensity bold/blink 1214 display up to 16 colours (8 ANSI colours plus high-intensity bold/blink
1159 versions of the same). Here is a list of the colours with their names. 1215 versions of the same). Here is a list of the colours with their names.
1160 1216
1161 color0 (black) = Black 1217 color0 (black) = Black
1162 color1 (red) = Red3 1218 color1 (red) = Red3
1163 color2 (green) = Green3 1219 color2 (green) = Green3
1164 color3 (yellow) = Yellow3 1220 color3 (yellow) = Yellow3
1165 color4 (blue) = Blue3 1221 color4 (blue) = Blue3
1166 color5 (magenta) = Magenta3 1222 color5 (magenta) = Magenta3
1167 color6 (cyan) = Cyan3 1223 color6 (cyan) = Cyan3
1168 color7 (white) = AntiqueWhite 1224 color7 (white) = AntiqueWhite
1169 color8 (bright black) = Grey25 1225 color8 (bright black) = Grey25
1170 color9 (bright red) = Red 1226 color9 (bright red) = Red
1171 color10 (bright green) = Green 1227 color10 (bright green) = Green
1172 color11 (bright yellow) = Yellow 1228 color11 (bright yellow) = Yellow
1173 color12 (bright blue) = Blue 1229 color12 (bright blue) = Blue
1174 color13 (bright magenta) = Magenta 1230 color13 (bright magenta) = Magenta
1175 color14 (bright cyan) = Cyan 1231 color14 (bright cyan) = Cyan
1176 color15 (bright white) = White 1232 color15 (bright white) = White
1177 foreground = Black 1233 foreground = Black
1178 background = White 1234 background = White
1235
1179 It is also possible to specify the colour values of foreground, 1236 It is also possible to specify the colour values of foreground,
1180 background, cursorColor, cursorColor2, colorBD, colorUL as a number 1237 background, cursorColor, cursorColor2, colorBD, colorUL as a number
1181 0-15, as a convenient shorthand to reference the colour name of 1238 0-15, as a convenient shorthand to reference the colour name of
1182 color0-color15. 1239 color0-color15.
1183 1240
… …
1204 get their act together, rxvt-unicode will support 1261 get their act together, rxvt-unicode will support
1205 "rgba:rrrr/gggg/bbbb/aaaa" (recommended, but MUST have 4 1262 "rgba:rrrr/gggg/bbbb/aaaa" (recommended, but MUST have 4
1206 digits/component) colour specifications, in addition to the ones 1263 digits/component) colour specifications, in addition to the ones
1207 provided by X, where the additional A component specifies opacity 1264 provided by X, where the additional A component specifies opacity
1208 (alpha) values. The minimum value of 0 is completely transparent). You 1265 (alpha) values. The minimum value of 0 is completely transparent). You
1209 can also prefix any color with "[a]", where "a" is on to four hex digits 1266 can also prefix any color with "[percent]", where "percent" is a decimal
1210 specifiying the opacity value. 1267 percentage (0-100) that specifies the opacity of the color, where 0 is
1268 completely transparent and 100 is completelxy opaque.
1211 1269
1212 You probably need to specify "-depth 32", too, and have the luck that 1270 You probably need to specify "-depth 32", too, and have the luck that
1213 your X-server uses ARGB pixel layout, as X is far from just supporting 1271 your X-server uses ARGB pixel layout, as X is far from just supporting
1214 ARGB visuals out of the box, and rxvt-unicode just fudges around. 1272 ARGB visuals out of the box, and rxvt-unicode just fudges around.
1215 1273
1216 For example, the following selects an almost completely transparent red 1274 For example, the following selects an almost completely transparent red
1217 background, and an almost opaque pink foreground: 1275 background, and an almost opaque pink foreground:
1218 1276
1219 rxvt -depth 32 -bg rgba:0000/0000/0000/2222 -fg "[e]pink" 1277 rxvt -depth 32 -bg rgba:0000/0000/0000/aaaa -fg "[80]pink"
1220 1278
1221 *Please note that transparency of any kind if completely unsupported by 1279 *Please note that transparency of any kind if completely unsupported by
1222 the author. Don't bug him with installation questions!* 1280 the author. Don't bug him with installation questions!*
1223 1281
1224ENVIRONMENT 1282ENVIRONMENT

Diff Legend

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