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

Comparing cvsroot/rxvt-unicode/doc/rxvt.1.txt (file contents):
Revision 1.55 by root, Sun Jan 29 22:38:43 2006 UTC vs.
Revision 1.59 by root, Thu Jul 6 18:56:09 2006 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.4, is a colour vt102 terminal emulator intended 9 rxvt-unicode, version 7.7, 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
1088 character codes using the keyboard. It consists of 4 parts. The first 1088 character codes using the keyboard. It consists of 4 parts. The first
1089 part is available rxvt-unicode has been compiled with "--enable-frills", 1089 part is available rxvt-unicode has been compiled with "--enable-frills",
1090 the rest is available when rxvt-unicode was compiled with 1090 the rest is available when rxvt-unicode was compiled with
1091 "--enable-iso14755". 1091 "--enable-iso14755".
1092 1092
1093 * 5.1: Basic method 1093 * 5.1: Basic method
1094
1094 This allows you to enter unicode characters using their hexcode. 1095 This allows you to enter unicode characters using their hexcode.
1095 1096
1096 Start by pressing and holding both "Control" and "Shift", then enter 1097 Start by pressing and holding both "Control" and "Shift", then enter
1097 hex-digits (between one and six). Releasing "Control" and "Shift" 1098 hex-digits (between one and six). Releasing "Control" and "Shift"
1098 will commit the character as if it were typed directly. While 1099 will commit the character as if it were typed directly. While
1104 address, which you cannot type. Fortunately, the card has the e-mail 1105 address, which you cannot type. Fortunately, the card has the e-mail
1105 address printed as hexcodes, e.g. "671d 65e5". You can enter this 1106 address printed as hexcodes, e.g. "671d 65e5". You can enter this
1106 easily by pressing "Control" and "Shift", followed by 1107 easily by pressing "Control" and "Shift", followed by
1107 "6-7-1-D-SPACE-6-5-E-5", followed by releasing the modifier keys. 1108 "6-7-1-D-SPACE-6-5-E-5", followed by releasing the modifier keys.
1108 1109
1109 * 5.2: Keyboard symbols entry method 1110 * 5.2: Keyboard symbols entry method
1111
1110 This mode lets you input characters representing the keycap symbols 1112 This mode lets you input characters representing the keycap symbols
1111 of your keyboard, if representable in the current locale encoding. 1113 of your keyboard, if representable in the current locale encoding.
1112 1114
1113 Start by pressing "Control" and "Shift" together, then releasing 1115 Start by pressing "Control" and "Shift" together, then releasing
1114 them. The next special key (cursor keys, home etc.) you enter will 1116 them. The next special key (cursor keys, home etc.) you enter will
1116 corresponding keycap symbol. The symbol will only be entered when 1118 corresponding keycap symbol. The symbol will only be entered when
1117 the key has been released, otherwise pressing e.g. "Shift" would 1119 the key has been released, otherwise pressing e.g. "Shift" would
1118 enter the symbol for "ISO Level 2 Switch", although your intention 1120 enter the symbol for "ISO Level 2 Switch", although your intention
1119 might have been to enter a reverse tab (Shift-Tab). 1121 might have been to enter a reverse tab (Shift-Tab).
1120 1122
1121 * 5.3: Screen-selection entry method 1123 * 5.3: Screen-selection entry method
1124
1122 While this is implemented already (it's basically the selection 1125 While this is implemented already (it's basically the selection
1123 mechanism), it could be extended by displaying a unicode character 1126 mechanism), it could be extended by displaying a unicode character
1124 map. 1127 map.
1125 1128
1126 * 5.4: Feedback method for identifying displayed characters for later 1129 * 5.4: Feedback method for identifying displayed characters for later
1127 input 1130 input
1131
1128 This method lets you display the unicode character code associated 1132 This method lets you display the unicode character code associated
1129 with characters already displayed. 1133 with characters already displayed.
1130 1134
1131 You enter this mode by holding down "Control" and "Shift" together, 1135 You enter this mode by holding down "Control" and "Shift" together,
1132 then pressing and holding the left mouse button and moving around. 1136 then pressing and holding the left mouse button and moving around.
1151COLORS AND GRAPHICS 1155COLORS AND GRAPHICS
1152 In addition to the default foreground and background colours, rxvt can 1156 In addition to the default foreground and background colours, rxvt can
1153 display up to 16 colours (8 ANSI colours plus high-intensity bold/blink 1157 display up to 16 colours (8 ANSI colours plus high-intensity bold/blink
1154 versions of the same). Here is a list of the colours with their names. 1158 versions of the same). Here is a list of the colours with their names.
1155 1159
1156 color0 (black) = Black 1160 color0 (black) = Black
1157 color1 (red) = Red3 1161 color1 (red) = Red3
1158 color2 (green) = Green3 1162 color2 (green) = Green3
1159 color3 (yellow) = Yellow3 1163 color3 (yellow) = Yellow3
1160 color4 (blue) = Blue3 1164 color4 (blue) = Blue3
1161 color5 (magenta) = Magenta3 1165 color5 (magenta) = Magenta3
1162 color6 (cyan) = Cyan3 1166 color6 (cyan) = Cyan3
1163 color7 (white) = AntiqueWhite 1167 color7 (white) = AntiqueWhite
1164 color8 (bright black) = Grey25 1168 color8 (bright black) = Grey25
1165 color9 (bright red) = Red 1169 color9 (bright red) = Red
1166 color10 (bright green) = Green 1170 color10 (bright green) = Green
1167 color11 (bright yellow) = Yellow 1171 color11 (bright yellow) = Yellow
1168 color12 (bright blue) = Blue 1172 color12 (bright blue) = Blue
1169 color13 (bright magenta) = Magenta 1173 color13 (bright magenta) = Magenta
1170 color14 (bright cyan) = Cyan 1174 color14 (bright cyan) = Cyan
1171 color15 (bright white) = White 1175 color15 (bright white) = White
1172 foreground = Black 1176 foreground = Black
1173 background = White 1177 background = White
1174
1175 It is also possible to specify the colour values of foreground, 1178 It is also possible to specify the colour values of foreground,
1176 background, cursorColor, cursorColor2, colorBD, colorUL as a number 1179 background, cursorColor, cursorColor2, colorBD, colorUL as a number
1177 0-15, as a convenient shorthand to reference the colour name of 1180 0-15, as a convenient shorthand to reference the colour name of
1178 color0-color15. 1181 color0-color15.
1179 1182
1180 If Xft support has been compiled in and as long as Xft/Xrender/X don't 1183 In addition to the colours defined above, rxvt offers an additional 72
1181 get their act together, rxvt-unicode will support 1184 colours. The first 64 of those (with indices 16 to 79) consist of a
1182 "rgba:rrrr/gggg/bbbb/aaaa" (recommended, but MUST have 4 1185 4*4*4 RGB colour cube (i.e. *index = r * 16 + g * 4 + b + 16*), followed
1183 digits/component), "#ARGB", "#AARRGGBB" and "#AAAARRRRGGGGBBBB" colour 1186 by 8 additional shades of gray (with indices 80 to 87).
1184 specifications, in addition to the ones provided by X, where the
1185 additional A component specifies alpha (opacity) values (0 is completely
1186 transparent and the maximum is opaque). You probably need to specify
1187 "-depth 32", too, and have the luck that your X-server uses ARGB pixel
1188 layout, as X is far from just supporting ARGB visuals out of the box,
1189 and rxvt-unicode just fudges around.
1190 1187
1191 *Please note that transparency of any kind if completely unsupported by 1188 Together, all those colours implement the 88 colour xterm colours. Only
1192 the author. Don't bug him with installation questions!* 1189 the first 16 can be changed using resources currently, the rest can only
1190 be changed via command sequences ("escape codes").
1193 1191
1194 Note that -rv ("reverseVideo: True") simulates reverse video by always 1192 Note that -rv ("reverseVideo: True") simulates reverse video by always
1195 swapping the foreground/background colours. This is in contrast to 1193 swapping the foreground/background colours. This is in contrast to
1196 *xterm*(1) where the colours are only swapped if they have not otherwise 1194 *xterm*(1) where the colours are only swapped if they have not otherwise
1197 been specified. For example, 1195 been specified. For example,
1198 1196
1199 rxvt -fg Black -bg White -rv 1197 rxvt -fg Black -bg White -rv
1200 would yield White on Black, while on *xterm*(1) it would yield Black 1198 would yield White on Black, while on *xterm*(1) it would yield Black
1201 on White. 1199 on White.
1200
1201 ALPHA CHANNEL SUPPORT
1202 If Xft support has been compiled in and as long as Xft/Xrender/X don't
1203 get their act together, rxvt-unicode will support
1204 "rgba:rrrr/gggg/bbbb/aaaa" (recommended, but MUST have 4
1205 digits/component) colour specifications, in addition to the ones
1206 provided by X, where the additional A component specifies opacity
1207 (alpha) values. The minimum value of 0 is completely transparent). You
1208 can also prefix any color with "[a]", where "a" is on to four hex digits
1209 specifiying the opacity value.
1210
1211 You probably need to specify "-depth 32", too, and have the luck that
1212 your X-server uses ARGB pixel layout, as X is far from just supporting
1213 ARGB visuals out of the box, and rxvt-unicode just fudges around.
1214
1215 For example, the following selects an almost completely transparent red
1216 background, and an almost opaque pink foreground:
1217
1218 rxvt -depth 32 -bg rgba:0000/0000/0000/2222 -fg "[e]pink"
1219
1220 *Please note that transparency of any kind if completely unsupported by
1221 the author. Don't bug him with installation questions!*
1202 1222
1203ENVIRONMENT 1223ENVIRONMENT
1204 rxvt sets and/or uses the following environment variables: 1224 rxvt sets and/or uses the following environment variables:
1205 1225
1206 TERM 1226 TERM
1264 1284
1265CURRENT PROJECT COORDINATOR 1285CURRENT PROJECT COORDINATOR
1266 Project Coordinator 1286 Project Coordinator
1267 Marc A. Lehmann <rxvt-unicode@schmorp.de> 1287 Marc A. Lehmann <rxvt-unicode@schmorp.de>
1268 1288
1269 <http://software.schmorp.de/#rxvt-unicode> 1289 <http://software.schmorp.de/pkg/rxvt-unicode.html>
1270 1290
1271AUTHORS 1291AUTHORS
1272 John Bovey 1292 John Bovey
1273 University of Kent, 1992, wrote the original Xvt. 1293 University of Kent, 1992, wrote the original Xvt.
1274 1294

Diff Legend

Removed lines
+ Added lines
< Changed lines
> Changed lines