1 | .if !\n(.g .ab GNU tbl requires GNU troff. |
1 | .if !\n(.g .ab GNU tbl requires GNU troff. |
2 | .if !dTS .ds TS |
2 | .if !dTS .ds TS |
3 | .if !dTE .ds TE |
3 | .if !dTE .ds TE |
4 | .TH "RXVT" "1" "RXVTDATE()" "X Version 11" "X Tools" |
4 | .TH "RXVT" "1" "2004-06-26" "X Version 11" "X Tools" |
5 | .SH "NAME" |
5 | .SH "NAME" |
6 | rxvt (ouR XVT) \- a VT102 emulator for the X window system |
6 | rxvt-unicode (ouR XVT, unicode) \- a VT102 emulator for the X window system |
7 | .PP |
7 | .PP |
8 | .SH "SYNOPSIS" |
8 | .SH "SYNOPSIS" |
9 | .PP |
9 | .PP |
10 | \fBrxvt\fP [options] [-e command [ args ]] |
10 | \fBurxvt\fP [options] [-e command [ args ]] |
11 | .PP |
11 | .PP |
12 | .SH "DESCRIPTION" |
12 | .SH "DESCRIPTION" |
13 | .PP |
13 | .PP |
14 | \fBrxvt\fP, version \fBRXVTVERSION()\fP, is a colour vt102 terminal emulator |
14 | \fBrxvt-unicode\fP, version \fB3\&.1\fP, is a colour vt102 terminal emulator |
15 | intended as an \fIxterm\fP(1) replacement for users who do not require |
15 | intended as an \fIxterm\fP(1) replacement for users who do not require |
16 | features such as Tektronix 4014 emulation and toolkit-style configurability\&. |
16 | features such as Tektronix 4014 emulation and toolkit-style configurability\&. |
17 | As a result, \fBrxvt\fP uses much less swap space -- a significant |
17 | As a result, \fBrxvt-unicode\fP uses much less swap space -- a significant |
18 | advantage on a machine serving many X sessions\&. |
18 | advantage on a machine serving many X sessions\&. |
19 | .PP |
19 | .PP |
20 | .PP |
20 | .PP |
21 | .SH "OPTIONS" |
21 | .SH "OPTIONS" |
22 | .PP |
22 | .PP |
23 | The \fBrxvt\fP options (mostly a subset of \fIxterm\fP\&'s) are listed below\&. |
23 | The \fBurxvt\fP options (mostly a subset of \fIxterm\fP\&'s) are listed below\&. |
24 | In keeping with the smaller-is-better philosophy, options may be eliminated |
24 | In keeping with the smaller-is-better philosophy, options may be eliminated |
25 | or default values chosen at compile-time, so options and defaults listed |
25 | or default values chosen at compile-time, so options and defaults listed |
26 | may not accurately reflect the version installed on your system\&. |
26 | may not accurately reflect the version installed on your system\&. |
27 | `rxvt -h\&' gives a list of major compile-time options on the \fIOptions\fP line\&. |
27 | `rxvt -h\&' gives a list of major compile-time options on the \fIOptions\fP line\&. |
28 | Option descriptions may be prefixed with which compile option each is |
28 | Option descriptions may be prefixed with which compile option each is |
29 | dependent upon\&. e\&.g\&. `Compile \fIXIM\fP:\&' requires \fIXIM\fP on the \fIOptions\fP |
29 | dependent upon\&. e\&.g\&. `Compile \fIXIM\fP:\&' requires \fIXIM\fP on the \fIOptions\fP |
30 | line\&. Note: `rxvt -help\&' gives a list of all command-line options compiled |
30 | line\&. Note: `rxvt -help\&' gives a list of all command-line options compiled |
31 | into your version\&. |
31 | into your version\&. |
32 | .PP |
32 | .PP |
33 | Note that \fBrxvt\fP permits the resource name to be used as a long-option |
33 | Note that \fBurxvt\fP permits the resource name to be used as a long-option |
34 | (--/++ option) so the potential command-line options are far greater than |
34 | (--/++ option) so the potential command-line options are far greater than |
35 | those listed\&. |
35 | those listed\&. |
36 | For example: `rxvt --loginShell --color1 Orange\&'\&. |
36 | For example: `rxvt --loginShell --color1 Orange\&'\&. |
37 | .PP |
37 | .PP |
38 | The following options are available: |
38 | The following options are available: |
… | |
… | |
54 | resource \fBjumpScroll\fP\&. |
54 | resource \fBjumpScroll\fP\&. |
55 | .IP "\fB-ip\fP|\fB+ip\fP" |
55 | .IP "\fB-ip\fP|\fB+ip\fP" |
56 | Turn on/off inheriting parent window\&'s pixmap\&. Alternative form |
56 | Turn on/off inheriting parent window\&'s pixmap\&. Alternative form |
57 | is \fB-tr\fP; |
57 | is \fB-tr\fP; |
58 | resource \fBinheritPixmap\fP\&. |
58 | resource \fBinheritPixmap\fP\&. |
|
|
59 | .IP "\fB-tint\fP \fIcolour\fP" |
|
|
60 | Tint the transparent background pixmap with the given colour\&. |
59 | .IP "\fB-bg\fP \fIcolour\fP" |
61 | .IP "\fB-bg\fP \fIcolour\fP" |
60 | Window background colour; |
62 | Window background colour; |
61 | resource \fBbackground\fP\&. |
63 | resource \fBbackground\fP\&. |
62 | .IP "\fB-fg\fP \fIcolour\fP" |
64 | .IP "\fB-fg\fP \fIcolour\fP" |
63 | Window foreground colour; |
65 | Window foreground colour; |
… | |
… | |
70 | resource \fBbackgroundPixmap\fP\&. |
72 | resource \fBbackgroundPixmap\fP\&. |
71 | .IP "\fB-cr\fP \fIcolour\fP" |
73 | .IP "\fB-cr\fP \fIcolour\fP" |
72 | The cursor colour; |
74 | The cursor colour; |
73 | resource \fBcursorColor\fP\&. |
75 | resource \fBcursorColor\fP\&. |
74 | .IP "\fB-pr\fP \fIcolour\fP" |
76 | .IP "\fB-pr\fP \fIcolour\fP" |
75 | The mouse pointer colour; |
77 | The mouse pointer foreground colour; |
76 | resource \fBpointerColor\fP\&. |
78 | resource \fBpointerColor\fP\&. |
|
|
79 | .IP "\fB-pr2\fP \fIcolour\fP" |
|
|
80 | The mouse pointer background colour; |
|
|
81 | resource \fBpointerColor2\fP\&. |
77 | .IP "\fB-bd\fP \fIcolour\fP" |
82 | .IP "\fB-bd\fP \fIcolour\fP" |
78 | The colour of the border between the xterm scrollbar and the text; |
83 | The colour of the border between the xterm scrollbar and the text; |
79 | resource \fBborderColor\fP\&. |
84 | resource \fBborderColor\fP\&. |
80 | .IP "\fB-fn\fP \fIfontname\fP" |
85 | .IP "\fB-fn\fP \fIfontname\fP" |
81 | Select the fonts to be used used\&. This is a comma seperated |
86 | Select the fonts to be used\&. |
82 | list of font names that are used in turn when trying to display |
87 | This is a comma seperated list of font names that are used in turn when |
83 | unicode characters\&. The first font defines the cell size for characters, |
88 | trying to display Unicode characters\&. |
84 | pther fonts might be smaller, but not larger\&. A reasonable default list |
89 | The first font defines the cell size for characters; other fonts might |
85 | is appended\&. |
90 | be smaller, but not larger\&. |
|
|
91 | A reasonable default font list is always appended to it\&. |
86 | resource \fBfont\fP\&. |
92 | resource \fBfont\fP\&. |
|
|
93 | .IP "\fB-rb\fP|\fB+rb\fP" |
|
|
94 | Enable "real bold" support\&. |
|
|
95 | When this option is on, bold text will be displayed using the first |
|
|
96 | available bold font in the font list\&. |
|
|
97 | Bold fonts should thus be specified in the font list after their |
|
|
98 | corresponding regular fonts\&. |
|
|
99 | If no bold font can be found, a regular font will be used\&. |
|
|
100 | resource \fBrealBold\fP\&. |
87 | .IP "\fB-name\fP \fIname\fP" |
101 | .IP "\fB-name\fP \fIname\fP" |
88 | Specify the application name under which resources |
102 | Specify the application name under which resources |
89 | are to be obtained, rather than the default executable file name\&. |
103 | are to be obtained, rather than the default executable file name\&. |
90 | Name should not contain `\&.\&' or `*\&' characters\&. |
104 | Name should not contain `\&.\&' or `*\&' characters\&. |
91 | Also sets the icon and title name\&. |
105 | Also sets the icon and title name\&. |
… | |
… | |
115 | Put scrollbar on right/left; |
129 | Put scrollbar on right/left; |
116 | resource \fBscrollBar_right\fP\&. |
130 | resource \fBscrollBar_right\fP\&. |
117 | .IP "\fB-st\fP|\fB+st\fP" |
131 | .IP "\fB-st\fP|\fB+st\fP" |
118 | Display normal (non XTerm/NeXT) scrollbar without/with a trough; |
132 | Display normal (non XTerm/NeXT) scrollbar without/with a trough; |
119 | resource \fBscrollBar_floating\fP\&. |
133 | resource \fBscrollBar_floating\fP\&. |
120 | .IP "\fB-mcc\fP|\fB+mcc\fP" |
|
|
121 | Compile \fImultichar_languages\fP: treat multibyte glyphs as single |
|
|
122 | character for backspace, delete and cursor movement keys; |
|
|
123 | resource \fBmultibyte_cursor\fP\&. |
|
|
124 | .IP "\fB-bc\fP|\fB+bc\fP" |
134 | .IP "\fB-bc\fP|\fB+bc\fP" |
125 | Blink the cursor; resource \fBcursorBlink\fP\&. |
135 | Blink the cursor; resource \fBcursorBlink\fP\&. |
126 | .IP "\fB-iconic\fP" |
136 | .IP "\fB-iconic\fP" |
127 | Start iconified, if the window manager supports that option\&. |
137 | Start iconified, if the window manager supports that option\&. |
128 | Alternative form is \fB-ic\fP\&. |
138 | Alternative form is \fB-ic\fP\&. |
… | |
… | |
146 | This option specifies the name of the terminal type to be set in the |
156 | This option specifies the name of the terminal type to be set in the |
147 | \fBTERM\fP environment variable\&. This terminal type must exist in the |
157 | \fBTERM\fP environment variable\&. This terminal type must exist in the |
148 | \fItermcap(5)\fP database and should have \fIli#\fP and \fIco#\fP entries; |
158 | \fItermcap(5)\fP database and should have \fIli#\fP and \fIco#\fP entries; |
149 | resource \fBtermName\fP\&. |
159 | resource \fBtermName\fP\&. |
150 | .IP "\fB-e\fP \fIcommand [arguments]\fP" |
160 | .IP "\fB-e\fP \fIcommand [arguments]\fP" |
151 | Run the command with its command-line arguments in the \fBrxvt\fP |
161 | Run the command with its command-line arguments in the \fBurxvt\fP |
152 | window; also sets the window title and icon name to be the basename |
162 | window; also sets the window title and icon name to be the basename |
153 | of the program being executed if neither \fI-title\fP (\fI-T\fP) nor |
163 | of the program being executed if neither \fI-title\fP (\fI-T\fP) nor |
154 | \fI-n\fP are given on the command line\&. If this option is used, it |
164 | \fI-n\fP are given on the command line\&. If this option is used, it |
155 | must be the last on the command-line\&. If there is no \fB-e\fP option |
165 | must be the last on the command-line\&. If there is no \fB-e\fP option |
156 | then the default is to run the program specified by the \fBSHELL\fP |
166 | then the default is to run the program specified by the \fBSHELL\fP |
… | |
… | |
176 | .IP "\fB-imlocale\fP \fIstring\fP" |
186 | .IP "\fB-imlocale\fP \fIstring\fP" |
177 | The locale to use for opening the IM\&. You can use an LC_CTYPE |
187 | The locale to use for opening the IM\&. You can use an LC_CTYPE |
178 | of e\&.g\&. de_DE\&.UTF-8 for normal text processing but ja_JP\&.EUC-JP |
188 | of e\&.g\&. de_DE\&.UTF-8 for normal text processing but ja_JP\&.EUC-JP |
179 | for the input extension to be able to input japanese characters |
189 | for the input extension to be able to input japanese characters |
180 | while staying in another locale\&. |
190 | while staying in another locale\&. |
|
|
191 | .IP "\fB-insecure\fP" |
|
|
192 | Enable "insecure" mode, which currently enables most of the escape |
|
|
193 | sequences that echo strings\&. See the resource \fBinsecure\fP for |
|
|
194 | more info\&. |
181 | .IP "\fB-mod\fP \fImodifier\fP" |
195 | .IP "\fB-mod\fP \fImodifier\fP" |
182 | Override detection of Meta modifier with specified key: |
196 | Override detection of Meta modifier with specified key: |
183 | \fBalt\fP, \fBmeta\fP, \fBhyper\fP, \fBsuper\fP, \fBmod1\fP, \fBmod2\fP, \fBmod3\fP, |
197 | \fBalt\fP, \fBmeta\fP, \fBhyper\fP, \fBsuper\fP, \fBmod1\fP, \fBmod2\fP, \fBmod3\fP, |
184 | \fBmod4\fP, \fBmod5\fP; |
198 | \fBmod4\fP, \fBmod5\fP; |
185 | resource \fImodifier\fP\&. |
199 | resource \fImodifier\fP\&. |
|
|
200 | .IP "\fB-ssc\fP|\fB+ssc\fP" |
|
|
201 | Turn on/off secondary screen (default enabled); |
|
|
202 | resource \fBsecondaryScreen\fP\&. |
|
|
203 | .IP "\fB-ssr\fP|\fB+ssr\fP" |
|
|
204 | Turn on/off secondary screen scroll (default enabled); |
|
|
205 | resource \fBsecondaryScroll\fP\&. |
186 | .IP "\fB-xrm\fP \fIresourcestring\fP" |
206 | .IP "\fB-xrm\fP \fIresourcestring\fP" |
187 | No effect on rxvt\&. Simply passes through an argument to be made |
207 | No effect on rxvt\&. Simply passes through an argument to be made |
188 | available in the instance\&'s argument list\&. Appears in \fIWM_COMMAND\fP |
208 | available in the instance\&'s argument list\&. Appears in \fIWM_COMMAND\fP |
189 | in some window managers\&. |
209 | in some window managers\&. |
190 | .SH "RESOURCES (available also as long-options)" |
210 | .SH "RESOURCES (available also as long-options)" |
191 | .PP |
211 | .PP |
192 | Note: `rxvt --help\&' gives a list of all resources (long options) compiled |
212 | Note: `rxvt --help\&' gives a list of all resources (long options) compiled |
193 | into your version\&. |
213 | into your version\&. |
194 | If compiled with internal Xresources support (i\&.e\&. \fBrxvt -h\fP lists |
214 | If compiled with internal Xresources support (i\&.e\&. \fBrxvt -h\fP lists |
195 | \fB\&.Xdefaults\fP) then \fBrxvt\fP accepts application defaults set in |
215 | \fB\&.Xdefaults\fP) then \fBurxvt\fP accepts application defaults set in |
196 | XAPPLOADDIR/Rxvt (compile-time defined: usually |
216 | XAPPLOADDIR/Rxvt (compile-time defined: usually |
197 | \fB/usr/lib/X11/app-defaults/Rxvt\fP) and resources set in \fB~/\&.Xdefaults\fP, |
217 | \fB/usr/lib/X11/app-defaults/Rxvt\fP) and resources set in \fB~/\&.Xdefaults\fP, |
198 | or \fB~/\&.Xresources\fP if \fB~/\&.Xdefaults\fP does not exist\&. Note that when |
218 | or \fB~/\&.Xresources\fP if \fB~/\&.Xdefaults\fP does not exist\&. Note that when |
199 | reading X resources, \fBrxvt\fP recognizes two class names: \fBXTerm\fP and |
219 | reading X resources, \fBurxvt\fP recognizes two class names: \fBXTerm\fP and |
200 | \fBRxvt\fP\&. The class name \fBXTerm\fP allows resources common to both |
220 | \fBRxvt\fP\&. The class name \fBXTerm\fP allows resources common to both |
201 | \fBrxvt\fP and \fIxterm\fP to be easily configured, while the class name |
221 | \fBurxvt\fP and \fIxterm\fP to be easily configured, while the class name |
202 | \fBRxvt\fP allows resources unique to \fBrxvt\fP, notably colours and |
222 | \fBRxvt\fP allows resources unique to \fBurxvt\fP, notably colours and |
203 | key-handling, to be shared between different \fBrxvt\fP configurations\&. |
223 | key-handling, to be shared between different \fBurxvt\fP configurations\&. |
204 | If no resources are specified, suitable defaults will be used\&. |
224 | If no resources are specified, suitable defaults will be used\&. |
205 | Command-line arguments can be used to override resource settings\&. The |
225 | Command-line arguments can be used to override resource settings\&. The |
206 | following resources are allowed: |
226 | following resources are allowed: |
207 | .PP |
227 | .PP |
208 | .IP "\fBgeometry:\fP \fIgeom\fP" |
228 | .IP "\fBgeometry:\fP \fIgeom\fP" |
… | |
… | |
226 | but the actual colour names used are listed in the |
246 | but the actual colour names used are listed in the |
227 | \fBCOLORS AND GRAPHICS\fP section\&. |
247 | \fBCOLORS AND GRAPHICS\fP section\&. |
228 | .IP "\fBcolorBD:\fP \fIcolour\fP" |
248 | .IP "\fBcolorBD:\fP \fIcolour\fP" |
229 | Use the specified colour to display bold characters when the |
249 | Use the specified colour to display bold characters when the |
230 | foreground colour is the default\&. |
250 | foreground colour is the default\&. |
|
|
251 | This option will be ignored if \fBrealBold\fP is enabled\&. |
231 | .IP "\fBcolorUL:\fP \fIcolour\fP" |
252 | .IP "\fBcolorUL:\fP \fIcolour\fP" |
232 | Use the specified colour to display underlined characters when the |
253 | Use the specified colour to display underlined characters when the |
233 | foreground colour is the default\&. |
254 | foreground colour is the default\&. |
234 | .IP "\fBcolorRV:\fP \fIcolour\fP" |
255 | .IP "\fBcolorRV:\fP \fIcolour\fP" |
235 | Use the specified colour as the background for reverse video |
256 | Use the specified colour as the background for reverse video |
… | |
… | |
256 | option \fB+j\fP\&. |
277 | option \fB+j\fP\&. |
257 | .IP "\fBinheritPixmap:\fP \fIboolean\fP" |
278 | .IP "\fBinheritPixmap:\fP \fIboolean\fP" |
258 | \fBTrue\fP: make the background inherit the parent windows\&' pixmap, |
279 | \fBTrue\fP: make the background inherit the parent windows\&' pixmap, |
259 | giving artificial transparency\&. |
280 | giving artificial transparency\&. |
260 | \fBFalse\fP: do not inherit the parent windows\&' pixmap\&. |
281 | \fBFalse\fP: do not inherit the parent windows\&' pixmap\&. |
|
|
282 | .IP "\fBtintColor\fP \fIcolour\fP" |
|
|
283 | Tint the transparent background pixmap with the given colour\&. |
261 | .IP "\fBscrollColor:\fP \fIcolour\fP" |
284 | .IP "\fBscrollColor:\fP \fIcolour\fP" |
262 | Use the specified colour for the scrollbar [default #B2B2B2]\&. |
285 | Use the specified colour for the scrollbar [default #B2B2B2]\&. |
263 | .IP "\fBtroughColor:\fP \fIcolour\fP" |
286 | .IP "\fBtroughColor:\fP \fIcolour\fP" |
264 | Use the specified colour for the scrollbar\&'s trough area [default |
287 | Use the specified colour for the scrollbar\&'s trough area [default |
265 | #969696]\&. Only relevant for normal (non XTerm/NeXT) scrollbar\&. |
288 | #969696]\&. Only relevant for normal (non XTerm/NeXT) scrollbar\&. |
… | |
… | |
280 | .IP "\fBpath:\fP \fIpath\fP" |
303 | .IP "\fBpath:\fP \fIpath\fP" |
281 | Specify the colon-delimited search path for finding files (XPM and |
304 | Specify the colon-delimited search path for finding files (XPM and |
282 | menus), in addition to the paths specified by the \fBRXVTPATH\fP and |
305 | menus), in addition to the paths specified by the \fBRXVTPATH\fP and |
283 | \fBPATH\fP environment variables\&. |
306 | \fBPATH\fP environment variables\&. |
284 | .IP "\fBfont:\fP \fIfontname\fP" |
307 | .IP "\fBfont:\fP \fIfontname\fP" |
285 | Select the fonts to be used used\&. This is a comma seperated |
308 | Select the fonts to be used\&. |
286 | list of font names that are used in turn when trying to display |
309 | This is a comma seperated list of font names that are used in turn when |
287 | unicode characters\&. The first font defines the cell size for characters, |
310 | trying to display Unicode characters\&. |
288 | pther fonts might be smaller, but not larger\&. A reasonable default list |
311 | The first font defines the cell size for characters; other fonts might |
289 | is appended\&. |
312 | be smaller, but not larger\&. |
|
|
313 | A reasonable default font list is always appended to it\&. |
290 | option \fB-fn\fP\&. |
314 | option \fB-fn\fP\&. |
|
|
315 | .IP "\fBrealBold:\fP \fIboolean\fP" |
|
|
316 | \fBTrue\fP: Enable "real bold" support\&. |
|
|
317 | When this option is on, bold text will be displayed using the first |
|
|
318 | available bold font in the font list\&. |
|
|
319 | Bold fonts should thus be specified in the font list after their |
|
|
320 | corresponding regular fonts\&. |
|
|
321 | If no bold font can be found, a regular font will be used\&. |
|
|
322 | option \fB-rb\fP\&. |
|
|
323 | \fBFalse\fP: Display bold text in a regular font, using the color |
|
|
324 | specified with \fBcolorBD\fP; |
|
|
325 | option \fB+rb\fP\&. |
291 | .IP "\fBselectstyle:\fP \fImode\fP" |
326 | .IP "\fBselectstyle:\fP \fImode\fP" |
292 | Set mouse selection style to \fBold\fP which is 2\&.20, \fBoldword\fP which |
327 | Set mouse selection style to \fBold\fP which is 2\&.20, \fBoldword\fP which |
293 | is xterm style with 2\&.20 old word selection, or anything else which |
328 | is xterm style with 2\&.20 old word selection, or anything else which |
294 | gives xterm style selection\&. |
329 | gives xterm style selection\&. |
295 | .IP "\fBscrollstyle:\fP \fImode\fP" |
330 | .IP "\fBscrollstyle:\fP \fImode\fP" |
296 | Set scrollbar style to \fBrxvt\fP, \fBnext\fP or \fBxterm\fP |
331 | Set scrollbar style to \fBurxvt\fP, \fBrxvt\fP, \fBplain\fP, \fBnext\fP or \fBxterm\fP |
297 | .IP "\fBtitle:\fP \fIstring\fP" |
332 | .IP "\fBtitle:\fP \fIstring\fP" |
298 | Set window title string, the default title is the command-line |
333 | Set window title string, the default title is the command-line |
299 | specified after the \fB-e\fP option, if any, otherwise the application |
334 | specified after the \fB-e\fP option, if any, otherwise the application |
300 | name; |
335 | name; |
301 | option \fB-title\fP\&. |
336 | option \fB-title\fP\&. |
… | |
… | |
402 | option \fB-bc\fP\&. |
437 | option \fB-bc\fP\&. |
403 | .IP "\fBpointerBlank:\fP \fIboolean\fP" |
438 | .IP "\fBpointerBlank:\fP \fIboolean\fP" |
404 | \fBTrue\fP: blank the pointer when a key is pressed or after a set number |
439 | \fBTrue\fP: blank the pointer when a key is pressed or after a set number |
405 | of seconds of inactivity\&. |
440 | of seconds of inactivity\&. |
406 | \fBFalse\fP: the pointer is always visible [default]\&. |
441 | \fBFalse\fP: the pointer is always visible [default]\&. |
|
|
442 | .IP "\fBpointerColor:\fP \fIcolour\fP" |
|
|
443 | Mouse pointer foreground colour\&. |
|
|
444 | .IP "\fBpointerColor2:\fP \fIcolour\fP" |
|
|
445 | Mouse pointer background colour\&. |
407 | .IP "\fBpointerBlankDelay:\fP \fInumber\fP" |
446 | .IP "\fBpointerBlankDelay:\fP \fInumber\fP" |
408 | Specifies number of seconds before blanking the pointer [default 2]\&. |
447 | Specifies number of seconds before blanking the pointer [default 2]\&. |
409 | .IP "\fBmultibyte_cursor:\fP \fIboolean\fP" |
|
|
410 | \fBTrue\fP: consider multibyte glyphs as single character for backspace, |
|
|
411 | delete and cursor movement keys; |
|
|
412 | option \fB-mcc\fP\&. |
|
|
413 | \fBFalse\fP: move through all components of all glyphs; |
|
|
414 | option \fB+mcc\fP\&. |
|
|
415 | .IP "\fBbackspacekey:\fP \fIstring\fP" |
448 | .IP "\fBbackspacekey:\fP \fIstring\fP" |
416 | The string to send when the backspace key is pressed\&. If set to |
449 | The string to send when the backspace key is pressed\&. If set to |
417 | \fBDEC\fP or unset it will send \fBDelete\fP (code 127) or, if shifted, |
450 | \fBDEC\fP or unset it will send \fBDelete\fP (code 127) or, if shifted, |
418 | \fBBackspace\fP (code 8) - which can be reversed with the appropriate |
451 | \fBBackspace\fP (code 8) - which can be reversed with the appropriate |
419 | DEC private mode escape sequence\&. |
452 | DEC private mode escape sequence\&. |
… | |
… | |
436 | The locale to use for opening the IM\&. You can use an LC_CTYPE |
469 | The locale to use for opening the IM\&. You can use an LC_CTYPE |
437 | of e\&.g\&. de_DE\&.UTF-8 for normal text processing but ja_JP\&.EUC-JP |
470 | of e\&.g\&. de_DE\&.UTF-8 for normal text processing but ja_JP\&.EUC-JP |
438 | for the input extension to be able to input japanese characters |
471 | for the input extension to be able to input japanese characters |
439 | while staying in another locale\&. |
472 | while staying in another locale\&. |
440 | option \fB-imlocale\fP\&. |
473 | option \fB-imlocale\fP\&. |
|
|
474 | .IP "\fBinsecure\fP" |
|
|
475 | Enables "insecure" mode\&. Rxvt-unicode offers some escape sequences |
|
|
476 | that echo arbitrary strings like the icon name or the locale\&. This |
|
|
477 | could be abused if somebody gets 8-bit-clean access to your |
|
|
478 | display, wether throuh a mail client displaying mail bodies |
|
|
479 | unfiltered or though write(1)\&. Therefore, these sequences are |
|
|
480 | disabled by default\&. (Note that other terminals, including xterm, |
|
|
481 | have these sequences enabled by default)\&. You can enable them |
|
|
482 | by setting this boolean resource or specifying \fB-insecure\fP as |
|
|
483 | an option\&. At the moment, this enabled display-answer, locale, |
|
|
484 | findfont, icon label and window title requests as well as dynamic |
|
|
485 | menubar dispatch\&. |
441 | .IP "\fBmodifier:\fP \fImodifier\fP" |
486 | .IP "\fBmodifier:\fP \fImodifier\fP" |
442 | Set the key to be interpreted as the Meta key to: |
487 | Set the key to be interpreted as the Meta key to: |
443 | \fBalt\fP, \fBmeta\fP, \fBhyper\fP, \fBsuper\fP, \fBmod1\fP, \fBmod2\fP, \fBmod3\fP, |
488 | \fBalt\fP, \fBmeta\fP, \fBhyper\fP, \fBsuper\fP, \fBmod1\fP, \fBmod2\fP, \fBmod3\fP, |
444 | \fBmod4\fP, \fBmod5\fP; |
489 | \fBmod4\fP, \fBmod5\fP; |
445 | option \fB-mod\fP\&. |
490 | option \fB-mod\fP\&. |
446 | .IP "\fBanswerbackString:\fP \fIstring\fP" |
491 | .IP "\fBanswerbackString:\fP \fIstring\fP" |
447 | Specify the reply rxvt sends to the shell when an ENQ (control-E) |
492 | Specify the reply rxvt sends to the shell when an ENQ (control-E) |
448 | character is passed through\&. It may contain escape values as |
493 | character is passed through\&. It may contain escape values as |
449 | described in the entry on \fBkeysym\fP following\&. |
494 | described in the entry on \fBkeysym\fP following\&. |
|
|
495 | .IP "\fBsecondaryScreen:\fP \fIbool\fP" |
|
|
496 | Turn on/off secondary screen (default enabled)\&. |
|
|
497 | .IP "\fBsecondaryScroll:\fP \fIbool\fP" |
|
|
498 | Turn on/off secondary screen scroll (default enabled)\&. If |
|
|
499 | the this option is enabled, scrolls on the secondary screen will |
|
|
500 | change the scrollback buffer and switching to/from the secondary screen |
|
|
501 | will instead scroll the screen up\&. |
450 | .IP "\fBkeysym\&.\fP\fIsym\fP: \fIstring\fP" |
502 | .IP "\fBkeysym\&.\fP\fIsym\fP: \fIstring\fP" |
451 | Associate \fIstring\fP with keysym \fIsym\fP (\fB0xFF00 - 0xFFFF\fP)\&. It |
503 | Associate \fIstring\fP with keysym \fIsym\fP (\fB0xFF00 - 0xFFFF\fP)\&. It |
452 | may contain escape values (\ea: bell, \eb: backspace, \ee, \eE: escape, |
504 | may contain escape values (\ea: bell, \eb: backspace, \ee, \eE: escape, |
453 | \en: newline, \er: return, \et: tab, \e000: octal number) or control |
505 | \en: newline, \er: return, \et: tab, \e000: octal number) or control |
454 | characters (^?: delete, ^@: null, ^A \&.\&.\&.) and may enclosed with |
506 | characters (^?: delete, ^@: null, ^A \&.\&.\&.) and may enclosed with |
455 | double quotes so that it can start or end with whitespace\&. The |
507 | double quotes so that it can start or end with whitespace\&. The |
456 | intervening resource name \fBkeysym\&.\fP cannot be omitted\&. This |
508 | intervening resource name \fBkeysym\&.\fP cannot be omitted\&. This |
457 | resource is only available when compiled with KEYSYM_RESOURCE\&. |
509 | resource is only available when compiled with KEYSYM_RESOURCE\&. |
458 | .SH "THE SCROLLBAR" |
510 | .SH "THE SCROLLBAR" |
459 | .PP |
511 | .PP |
460 | Lines of text that scroll off the top of the \fBrxvt\fP window (resource: |
512 | Lines of text that scroll off the top of the \fBurxvt\fP window (resource: |
461 | \fBsaveLines\fP) and can be scrolled back using the scrollbar or by keystrokes\&. |
513 | \fBsaveLines\fP) and can be scrolled back using the scrollbar or by keystrokes\&. |
462 | The normal \fBrxvt\fP scrollbar has arrows and its behaviour is fairly |
514 | The normal \fBurxvt\fP scrollbar has arrows and its behaviour is fairly |
463 | intuitive\&. The \fBxterm-scrollbar\fP is without arrows and its behaviour |
515 | intuitive\&. The \fBxterm-scrollbar\fP is without arrows and its behaviour |
464 | mimics that of \fIxterm\fP |
516 | mimics that of \fIxterm\fP |
465 | .PP |
517 | .PP |
466 | Scroll down with \fBButton1\fP (\fBxterm-scrollbar\fP) or \fBShift-Next\fP\&. |
518 | Scroll down with \fBButton1\fP (\fBxterm-scrollbar\fP) or \fBShift-Next\fP\&. |
467 | Scroll up with \fBButton3\fP (\fBxterm-scrollbar\fP) or \fBShift-Prior\fP\&. |
519 | Scroll up with \fBButton3\fP (\fBxterm-scrollbar\fP) or \fBShift-Prior\fP\&. |
… | |
… | |
488 | region and release; Right click to extend the marked region; |
540 | region and release; Right click to extend the marked region; |
489 | Left double-click to select a word; Left triple-click to select |
541 | Left double-click to select a word; Left triple-click to select |
490 | the entire line\&. |
542 | the entire line\&. |
491 | .IP "\fBInsertion\fP:" |
543 | .IP "\fBInsertion\fP:" |
492 | Pressing and releasing the Middle mouse button (or \fBShift-Insert\fP) |
544 | Pressing and releasing the Middle mouse button (or \fBShift-Insert\fP) |
493 | in an \fBrxvt\fP window causes the current text selection to be inserted |
545 | in an \fBurxvt\fP window causes the current text selection to be inserted |
494 | as if it had been typed on the keyboard\&. |
546 | as if it had been typed on the keyboard\&. |
495 | .SH "CHANGING FONTS" |
547 | .SH "CHANGING FONTS" |
496 | .PP |
548 | .PP |
497 | You can change fonts on-the-fly, which is to say cycle through the default |
549 | You can change fonts on-the-fly, which is to say cycle through the default |
498 | font and others of various sizes, by using \fBShift-KP_Add\fP and |
550 | font and others of various sizes, by using \fBShift-KP_Add\fP and |
499 | \fBShift-KP_Subtract\fP\&. Or, alternatively (if enabled) with |
551 | \fBShift-KP_Subtract\fP\&. Or, alternatively (if enabled) with |
500 | \fBAlt->\fP and \fBAlt-<\fP, where the actual key |
552 | \fBAlt->\fP and \fBAlt-<\fP, where the actual key |
501 | can be selected using resources \fBsmallfont_key\fP/\fBbigfont_key\fP\&. |
553 | can be selected using resources \fBsmallfont_key\fP/\fBbigfont_key\fP\&. |
502 | .SH "LOGIN STAMP" |
554 | .SH "LOGIN STAMP" |
503 | .PP |
555 | .PP |
504 | \fBrxvt\fP tries to write an entry into the \fIutmp\fP(5) file so that it can be |
556 | \fBurxvt\fP tries to write an entry into the \fIutmp\fP(5) file so that it can be |
505 | seen via the \fIwho(1)\fP command, and can accept messages\&. To allow this |
557 | seen via the \fIwho(1)\fP command, and can accept messages\&. To allow this |
506 | feature, \fBrxvt\fP must be installed setuid root on some systems\&. |
558 | feature, \fBurxvt\fP must be installed setuid root on some systems\&. |
507 | .SH "COLORS AND GRAPHICS" |
559 | .SH "COLORS AND GRAPHICS" |
508 | .PP |
560 | .PP |
509 | In addition to the default foreground and background colours, \fBrxvt\fP |
561 | In addition to the default foreground and background colours, \fBurxvt\fP |
510 | can display up to 16 colours (8 ANSI colours plus high-intensity bold/blink |
562 | can display up to 16 colours (8 ANSI colours plus high-intensity bold/blink |
511 | versions of the same)\&. |
563 | versions of the same)\&. |
512 | Here is a list of the colours with their \fBrgb\&.txt\fP names\&. |
564 | Here is a list of the colours with their \fBrgb\&.txt\fP names\&. |
513 | .PP |
565 | .PP |
514 | .TS |
566 | .TS |
… | |
… | |
995 | .IP "\fBrxvt -fg Black -bg White -rv\fP" |
1047 | .IP "\fBrxvt -fg Black -bg White -rv\fP" |
996 | would yield White on Black, while on \fIxterm\fP(1) it would yield |
1048 | would yield White on Black, while on \fIxterm\fP(1) it would yield |
997 | Black on White\&. |
1049 | Black on White\&. |
998 | .SH "ENVIRONMENT" |
1050 | .SH "ENVIRONMENT" |
999 | .PP |
1051 | .PP |
1000 | \fBrxvt\fP sets the environment variables \fBTERM\fP, \fBCOLORTERM\fP and |
1052 | \fBurxvt\fP sets the environment variables \fBTERM\fP, \fBCOLORTERM\fP and |
1001 | \fBCOLORFGBG\fP\&. The environment variable \fBWINDOWID\fP is set to the X window |
1053 | \fBCOLORFGBG\fP\&. The environment variable \fBWINDOWID\fP is set to the X window |
1002 | id number of the \fBrxvt\fP window and it also uses and sets the environment |
1054 | id number of the \fBurxvt\fP window and it also uses and sets the environment |
1003 | variable \fBDISPLAY\fP to specify which display terminal to use\&. \fBrxvt\fP uses |
1055 | variable \fBDISPLAY\fP to specify which display terminal to use\&. \fBurxvt\fP uses |
1004 | the environment variables \fBRXVTPATH\fP and \fBPATH\fP to find XPM files\&. |
1056 | the environment variables \fBRXVTPATH\fP and \fBPATH\fP to find XPM files\&. |
1005 | .SH "FILES" |
1057 | .SH "FILES" |
1006 | .PP |
1058 | .PP |
1007 | .IP "\fB/etc/utmp\fP" |
1059 | .IP "\fB/etc/utmp\fP" |
1008 | System file for login records\&. |
1060 | System file for login records\&. |
… | |
… | |
1025 | .PP |
1077 | .PP |
1026 | Click-and-drag doesn\&'t work with X11 mouse report overriding\&. |
1078 | Click-and-drag doesn\&'t work with X11 mouse report overriding\&. |
1027 | .PP |
1079 | .PP |
1028 | .SH "FTP LOCATION" |
1080 | .SH "FTP LOCATION" |
1029 | .PP |
1081 | .PP |
1030 | rxvt-+RXVTVERSION()\&.tar\&.gz can be found at the following ftp sites |
1082 | rxvt-3\&.1\&.tar\&.gz can be found at the following ftp sites |
1031 | RXVTFTPSITE() |
1083 | ftp://ftp\&.rxvt\&.org/pub/rxvt |
1032 | .PP |
1084 | .PP |
1033 | .SH "CURRENT PROJECT COORDINATOR" |
1085 | .SH "CURRENT PROJECT COORDINATOR" |
1034 | .PP |
1086 | .PP |
1035 | .IP "Project Coordinator" |
1087 | .IP "Project Coordinator" |
1036 | RXVTMAINT() RXVTMAINTEMAIL() |
1088 | Marc A\&. Lehmann <rxvt@schmorp\&.de> |
1037 | .br |
1089 | .br |
1038 | .IP "Web page maintainter" |
1090 | .IP "Web page maintainter" |
1039 | RXVTWEBMAINT() RXVTWEBMAINTEMAIL() |
1091 | Marc A\&. Lehmann <rxvt@schmorp\&.de> |
1040 | .br |
1092 | .br |
1041 | RXVTWEBPAGE() |
1093 | <http://www\&.sourceforge\&.net/projects/rxvt-unicode/> |
1042 | .br |
1094 | .br |
1043 | .IP "Mailing list" |
|
|
1044 | The Rxvt Workers <rxvt-workers@rxvt\&.org> |
|
|
1045 | mailing list has also been established for rxvt development, to |
|
|
1046 | subscribe, email to |
|
|
1047 | <rxvt-workers-subscribe@rxvt\&.org>\&. |
|
|
1048 | There is also a mailing list for announcements of new releases of |
|
|
1049 | rxvt\&. To subscribe, email to |
|
|
1050 | <rxvt-announce-subscribe@rxvt\&.org>\&. |
|
|
1051 | .PP |
1095 | .PP |
1052 | .SH "AUTHORS" |
1096 | .SH "AUTHORS" |
1053 | .PP |
1097 | .PP |
1054 | .IP "John Bovey" |
1098 | .IP "John Bovey" |
1055 | University of Kent, 1992, wrote the original Xvt\&. |
1099 | University of Kent, 1992, wrote the original Xvt\&. |
… | |
… | |
1064 | .IP "Oezguer Kesim <kesim@math\&.fu-berlin\&.de>" |
1108 | .IP "Oezguer Kesim <kesim@math\&.fu-berlin\&.de>" |
1065 | Project Coordinator (changes\&.txt 2\&.21a to 2\&.4\&.5) |
1109 | Project Coordinator (changes\&.txt 2\&.21a to 2\&.4\&.5) |
1066 | .IP "Geoff Wing <gcw@pobox\&.com>" |
1110 | .IP "Geoff Wing <gcw@pobox\&.com>" |
1067 | Rewrote screen display and text selection routines\&. |
1111 | Rewrote screen display and text selection routines\&. |
1068 | Project Coordinator (changes\&.txt 2\&.4\&.6 - rxvt-unicode) |
1112 | Project Coordinator (changes\&.txt 2\&.4\&.6 - rxvt-unicode) |
1069 | .IP "Marc Alexander Lehman <rxvt@schmorp\&.de>" |
1113 | .IP "Marc Alexander Lehmann <rxvt@schmorp\&.de>" |
1070 | Rewrote most of the display code and internal character handling |
1114 | Forked rxvt-unicode, rewrote most of the display code and |
1071 | to store text in unicode\&. Numerous other fixes and extensions\&. |
1115 | internal character handling to store text in unicode, |
|
|
1116 | improve xterm compatibility and apply numerous other bugfixes |
|
|
1117 | and extensions\&. |
1072 | .br |
1118 | .br |
1073 | Project Coordinator (Changes 1\&.0 - ) |
1119 | Project Coordinator (Changes 1\&.0 - ) |
1074 | .PP |
1120 | .PP |