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-08-06" "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 | \fBrxvt\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\&.4\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 |
… | |
… | |
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-fade\fP \fInumber\fP" |
|
|
60 | Fade the text by the given percentage when focus is lost\&. |
|
|
61 | .IP "\fB-tint\fP \fIcolour\fP" |
|
|
62 | Tint the transparent background pixmap with the given colour when |
|
|
63 | transparency is enabled with \fB-tr\fP or \fB-ip\fP\&. See also |
|
|
64 | the \fB-sh\fP option that can be used to brighten or darken |
|
|
65 | the image in addition to tinting it\&. |
|
|
66 | .IP "\fB-sh\fP" |
|
|
67 | \fInumber\fP |
|
|
68 | Darken (0 \&.\&. 100) or lighten (-1 \&.\&. -100) the transparent background |
|
|
69 | image in addition to tinting it (i\&.e\&. \fB-tint\fP must be specified, too)\&. |
59 | .IP "\fB-bg\fP \fIcolour\fP" |
70 | .IP "\fB-bg\fP \fIcolour\fP" |
60 | Window background colour; |
71 | Window background colour; |
61 | resource \fBbackground\fP\&. |
72 | resource \fBbackground\fP\&. |
62 | .IP "\fB-fg\fP \fIcolour\fP" |
73 | .IP "\fB-fg\fP \fIcolour\fP" |
63 | Window foreground colour; |
74 | Window foreground colour; |
64 | resource \fBforeground\fP\&. |
75 | resource \fBforeground\fP\&. |
65 | .IP "\fB-pixmap:\fP \fIfile[;geom]\fP" |
76 | .IP "\fB-pixmap\fP \fIfile[;geom]\fP" |
66 | Compile \fIXPM\fP: Specify XPM file for the background and also |
77 | Compile \fIXPM\fP: Specify XPM file for the background and also |
67 | optionally specify its scaling with a geometry string\&. Note you |
78 | optionally specify its scaling with a geometry string\&. Note you |
68 | may need to add quotes to avoid special shell interpretation of |
79 | may need to add quotes to avoid special shell interpretation of |
69 | the `;\&' in the command-line; |
80 | the `;\&' in the command-line; |
70 | resource \fBbackgroundPixmap\fP\&. |
81 | resource \fBbackgroundPixmap\fP\&. |
71 | .IP "\fB-cr\fP \fIcolour\fP" |
82 | .IP "\fB-cr\fP \fIcolour\fP" |
72 | The cursor colour; |
83 | The cursor colour; |
73 | resource \fBcursorColor\fP\&. |
84 | resource \fBcursorColor\fP\&. |
74 | .IP "\fB-pr\fP \fIcolour\fP" |
85 | .IP "\fB-pr\fP \fIcolour\fP" |
75 | The mouse pointer colour; |
86 | The mouse pointer foreground colour; |
76 | resource \fBpointerColor\fP\&. |
87 | resource \fBpointerColor\fP\&. |
|
|
88 | .IP "\fB-pr2\fP \fIcolour\fP" |
|
|
89 | The mouse pointer background colour; |
|
|
90 | resource \fBpointerColor2\fP\&. |
77 | .IP "\fB-bd\fP \fIcolour\fP" |
91 | .IP "\fB-bd\fP \fIcolour\fP" |
78 | The colour of the border between the xterm scrollbar and the text; |
92 | The colour of the border between the xterm scrollbar and the text; |
79 | resource \fBborderColor\fP\&. |
93 | resource \fBborderColor\fP\&. |
80 | .IP "\fB-fn\fP \fIfontname\fP" |
94 | .IP "\fB-fn\fP \fIfontname\fP" |
81 | Select the fonts to be used used\&. This is a comma seperated |
95 | Select the fonts to be used\&. |
82 | list of font names that are used in turn when trying to display |
96 | 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, |
97 | trying to display Unicode characters\&. |
84 | pther fonts might be smaller, but not larger\&. A reasonable default list |
98 | The first font defines the cell size for characters; other fonts might |
85 | is appended\&. |
99 | be smaller, but not larger\&. |
|
|
100 | A reasonable default font list is always appended to it\&. |
86 | resource \fBfont\fP\&. |
101 | resource \fBfont\fP\&. |
87 | .IP "\fB-grk\fP \fImode\fP" |
102 | .IP "\fB-rb\fP|\fB+rb\fP" |
88 | Compile \fIGreek\fP: Greek keyboard translation; |
103 | Enable "real bold" support\&. |
89 | \fBiso\fP: ISO-8859 mapping\&. |
104 | When this option is on, bold text will be displayed using the first |
90 | \fBibm\fP: IBM-437 mapping; |
105 | available bold font in the font list\&. |
|
|
106 | Bold fonts should thus be specified in the font list after their |
|
|
107 | corresponding regular fonts\&. |
|
|
108 | If no bold font can be found, a regular font will be used\&. |
91 | resource \fBgreek_keyboard\fP\&. |
109 | resource \fBrealBold\fP\&. |
92 | .IP "\fB-name\fP \fIname\fP" |
110 | .IP "\fB-name\fP \fIname\fP" |
93 | Specify the application name under which resources |
111 | Specify the application name under which resources |
94 | are to be obtained, rather than the default executable file name\&. |
112 | are to be obtained, rather than the default executable file name\&. |
95 | Name should not contain `\&.\&' or `*\&' characters\&. |
113 | Name should not contain `\&.\&' or `*\&' characters\&. |
96 | Also sets the icon and title name\&. |
114 | Also sets the icon and title name\&. |
… | |
… | |
120 | Put scrollbar on right/left; |
138 | Put scrollbar on right/left; |
121 | resource \fBscrollBar_right\fP\&. |
139 | resource \fBscrollBar_right\fP\&. |
122 | .IP "\fB-st\fP|\fB+st\fP" |
140 | .IP "\fB-st\fP|\fB+st\fP" |
123 | Display normal (non XTerm/NeXT) scrollbar without/with a trough; |
141 | Display normal (non XTerm/NeXT) scrollbar without/with a trough; |
124 | resource \fBscrollBar_floating\fP\&. |
142 | resource \fBscrollBar_floating\fP\&. |
125 | .IP "\fB-mcc\fP|\fB+mcc\fP" |
|
|
126 | Compile \fImultichar_languages\fP: treat multibyte glyphs as single |
|
|
127 | character for backspace, delete and cursor movement keys; |
|
|
128 | resource \fBmultibyte_cursor\fP\&. |
|
|
129 | .IP "\fB-bc\fP|\fB+bc\fP" |
143 | .IP "\fB-bc\fP|\fB+bc\fP" |
130 | Blink the cursor; resource \fBcursorBlink\fP\&. |
144 | Blink the cursor; resource \fBcursorBlink\fP\&. |
131 | .IP "\fB-iconic\fP" |
145 | .IP "\fB-iconic\fP" |
132 | Start iconified, if the window manager supports that option\&. |
146 | Start iconified, if the window manager supports that option\&. |
133 | Alternative form is \fB-ic\fP\&. |
147 | Alternative form is \fB-ic\fP\&. |
… | |
… | |
141 | resource \fBinternalBorder\fP\&. |
155 | resource \fBinternalBorder\fP\&. |
142 | .IP "\fB-w\fP \fInumber\fP" |
156 | .IP "\fB-w\fP \fInumber\fP" |
143 | Compile \fIfrills\fP: External border of \fInumber\fP pixels\&. |
157 | Compile \fIfrills\fP: External border of \fInumber\fP pixels\&. |
144 | Also, \fB-bw\fP and \fB-borderwidth\fP\&. See resource entry for limits; |
158 | Also, \fB-bw\fP and \fB-borderwidth\fP\&. See resource entry for limits; |
145 | resource \fBexternalBorder\fP\&. |
159 | resource \fBexternalBorder\fP\&. |
|
|
160 | .IP "\fB-bl\fP" |
|
|
161 | Compile \fIfrills\fP: Set MWM hints to request a borderless window, |
|
|
162 | i\&.e\&. if honoured by the WM, the rxvt window will not have window |
|
|
163 | decorations; resource \fBborderLess\fP\&. |
146 | .IP "\fB-lsp\fP \fInumber\fP" |
164 | .IP "\fB-lsp\fP \fInumber\fP" |
147 | Compile \fIlinespace\fP: Lines (pixel height) to insert between each |
165 | Compile \fIlinespace\fP: Lines (pixel height) to insert between each |
148 | row of the display; |
166 | row of the display; |
149 | resource \fBlinespace\fP\&. |
167 | resource \fBlinespace\fP\&. |
150 | .IP "\fB-tn\fP \fItermname\fP" |
168 | .IP "\fB-tn\fP \fItermname\fP" |
… | |
… | |
181 | .IP "\fB-imlocale\fP \fIstring\fP" |
199 | .IP "\fB-imlocale\fP \fIstring\fP" |
182 | The locale to use for opening the IM\&. You can use an LC_CTYPE |
200 | The locale to use for opening the IM\&. You can use an LC_CTYPE |
183 | of e\&.g\&. de_DE\&.UTF-8 for normal text processing but ja_JP\&.EUC-JP |
201 | of e\&.g\&. de_DE\&.UTF-8 for normal text processing but ja_JP\&.EUC-JP |
184 | for the input extension to be able to input japanese characters |
202 | for the input extension to be able to input japanese characters |
185 | while staying in another locale\&. |
203 | while staying in another locale\&. |
|
|
204 | .IP "\fB-insecure\fP" |
|
|
205 | Enable "insecure" mode, which currently enables most of the escape |
|
|
206 | sequences that echo strings\&. See the resource \fBinsecure\fP for |
|
|
207 | more info\&. |
186 | .IP "\fB-mod\fP \fImodifier\fP" |
208 | .IP "\fB-mod\fP \fImodifier\fP" |
187 | Override detection of Meta modifier with specified key: |
209 | Override detection of Meta modifier with specified key: |
188 | \fBalt\fP, \fBmeta\fP, \fBhyper\fP, \fBsuper\fP, \fBmod1\fP, \fBmod2\fP, \fBmod3\fP, |
210 | \fBalt\fP, \fBmeta\fP, \fBhyper\fP, \fBsuper\fP, \fBmod1\fP, \fBmod2\fP, \fBmod3\fP, |
189 | \fBmod4\fP, \fBmod5\fP; |
211 | \fBmod4\fP, \fBmod5\fP; |
190 | resource \fImodifier\fP\&. |
212 | resource \fImodifier\fP\&. |
|
|
213 | .IP "\fB-ssc\fP|\fB+ssc\fP" |
|
|
214 | Turn on/off secondary screen (default enabled); |
|
|
215 | resource \fBsecondaryScreen\fP\&. |
|
|
216 | .IP "\fB-ssr\fP|\fB+ssr\fP" |
|
|
217 | Turn on/off secondary screen scroll (default enabled); |
|
|
218 | resource \fBsecondaryScroll\fP\&. |
191 | .IP "\fB-xrm\fP \fIresourcestring\fP" |
219 | .IP "\fB-xrm\fP \fIresourcestring\fP" |
192 | No effect on rxvt\&. Simply passes through an argument to be made |
220 | No effect on rxvt\&. Simply passes through an argument to be made |
193 | available in the instance\&'s argument list\&. Appears in \fIWM_COMMAND\fP |
221 | available in the instance\&'s argument list\&. Appears in \fIWM_COMMAND\fP |
194 | in some window managers\&. |
222 | in some window managers\&. |
195 | .SH "RESOURCES (available also as long-options)" |
223 | .SH "RESOURCES (available also as long-options)" |
196 | .PP |
224 | .PP |
197 | Note: `rxvt --help\&' gives a list of all resources (long options) compiled |
225 | Note: `rxvt --help\&' gives a list of all resources (long options) compiled |
198 | into your version\&. |
226 | into your version\&. |
|
|
227 | .PP |
|
|
228 | There are two different methods that rxvt can use to get the |
|
|
229 | Xresource data: using the X libraries (Xrm*-functions) or internal Xresources |
|
|
230 | reader (\fB~/\&.Xdefaults\fP)\&. For the first method (ie\&. \fBrxvt -h\fP lists |
|
|
231 | \fBXGetDefaults\fP), you can set and change the resources using X11 |
|
|
232 | tools like \fBxset\fP\&. Many distribution do also load settings from the |
|
|
233 | \fB~/\&.Xresources\fP file when X starts\&. |
|
|
234 | .PP |
199 | If compiled with internal Xresources support (i\&.e\&. \fBrxvt -h\fP lists |
235 | If compiled with internal Xresources support (i\&.e\&. \fBrxvt |
200 | \fB\&.Xdefaults\fP) then \fBrxvt\fP accepts application defaults set in |
236 | -h\fP lists \fB\&.Xdefaults\fP) then \fBrxvt\fP accepts application |
201 | XAPPLOADDIR/Rxvt (compile-time defined: usually |
237 | defaults set in XAPPLOADDIR/URxvt (compile-time defined: usually |
202 | \fB/usr/lib/X11/app-defaults/Rxvt\fP) and resources set in \fB~/\&.Xdefaults\fP, |
238 | \fB/usr/lib/X11/app-defaults/URxvt\fP) and resources set in |
203 | or \fB~/\&.Xresources\fP if \fB~/\&.Xdefaults\fP does not exist\&. Note that when |
239 | \fB~/\&.Xdefaults\fP, or \fB~/\&.Xresources\fP if \fB~/\&.Xdefaults\fP does not exist\&. |
204 | reading X resources, \fBrxvt\fP recognizes two class names: \fBXTerm\fP and |
240 | Note that when reading X resources, \fBrxvt\fP recognizes two class |
205 | \fBRxvt\fP\&. The class name \fBXTerm\fP allows resources common to both |
241 | names: \fBXTerm\fP and \fBURxvt\fP\&. The class name \fBRxvt\fP allows resources |
206 | \fBrxvt\fP and \fIxterm\fP to be easily configured, while the class name |
242 | common to both \fBrxvt\fP and the original \fIrxvt\fP to be easily configured, |
207 | \fBRxvt\fP allows resources unique to \fBrxvt\fP, notably colours and |
243 | while the class name \fBURxvt\fP allows resources unique to \fBrxvt\fP, |
208 | key-handling, to be shared between different \fBrxvt\fP configurations\&. |
244 | notably colours and key-handling, to be shared between different |
209 | If no resources are specified, suitable defaults will be used\&. |
245 | \fBrxvt\fP configurations\&. If no resources are specified, suitable |
210 | Command-line arguments can be used to override resource settings\&. The |
246 | defaults will be used\&. Command-line arguments can be used to override |
211 | following resources are allowed: |
247 | resource settings\&. The following resources are allowed: |
212 | .PP |
248 | .PP |
213 | .IP "\fBgeometry:\fP \fIgeom\fP" |
249 | .IP "\fBgeometry:\fP \fIgeom\fP" |
214 | Create the window with the specified X window geometry [default |
250 | Create the window with the specified X window geometry [default |
215 | 80x24]; |
251 | 80x24]; |
216 | option \fB-geometry\fP\&. |
252 | option \fB-geometry\fP\&. |
… | |
… | |
231 | but the actual colour names used are listed in the |
267 | but the actual colour names used are listed in the |
232 | \fBCOLORS AND GRAPHICS\fP section\&. |
268 | \fBCOLORS AND GRAPHICS\fP section\&. |
233 | .IP "\fBcolorBD:\fP \fIcolour\fP" |
269 | .IP "\fBcolorBD:\fP \fIcolour\fP" |
234 | Use the specified colour to display bold characters when the |
270 | Use the specified colour to display bold characters when the |
235 | foreground colour is the default\&. |
271 | foreground colour is the default\&. |
|
|
272 | This option will be ignored if \fBrealBold\fP is enabled\&. |
236 | .IP "\fBcolorUL:\fP \fIcolour\fP" |
273 | .IP "\fBcolorUL:\fP \fIcolour\fP" |
237 | Use the specified colour to display underlined characters when the |
274 | Use the specified colour to display underlined characters when the |
238 | foreground colour is the default\&. |
275 | foreground colour is the default\&. |
239 | .IP "\fBcolorRV:\fP \fIcolour\fP" |
276 | .IP "\fBcolorRV:\fP \fIcolour\fP" |
240 | Use the specified colour as the background for reverse video |
277 | Use the specified colour as the background for reverse video |
… | |
… | |
261 | option \fB+j\fP\&. |
298 | option \fB+j\fP\&. |
262 | .IP "\fBinheritPixmap:\fP \fIboolean\fP" |
299 | .IP "\fBinheritPixmap:\fP \fIboolean\fP" |
263 | \fBTrue\fP: make the background inherit the parent windows\&' pixmap, |
300 | \fBTrue\fP: make the background inherit the parent windows\&' pixmap, |
264 | giving artificial transparency\&. |
301 | giving artificial transparency\&. |
265 | \fBFalse\fP: do not inherit the parent windows\&' pixmap\&. |
302 | \fBFalse\fP: do not inherit the parent windows\&' pixmap\&. |
|
|
303 | .IP "\fBfading:\fP \fInumber\fP" |
|
|
304 | Fade the text by the given percentage when focus is lost\&. |
|
|
305 | .IP "\fBtintColor:\fP \fIcolour\fP" |
|
|
306 | Tint the transparent background pixmap with the given colour\&. |
|
|
307 | .IP "\fBshading:\fP \fInumber\fP" |
|
|
308 | Darken (0 \&.\&. 100) or lighten (-1 \&.\&. -100) the transparent background |
|
|
309 | image in addition to tinting it\&. |
|
|
310 | .IP "\fBfading:\fP \fInumber\fP" |
|
|
311 | Scale the tint colour by the given percentage\&. |
266 | .IP "\fBscrollColor:\fP \fIcolour\fP" |
312 | .IP "\fBscrollColor:\fP \fIcolour\fP" |
267 | Use the specified colour for the scrollbar [default #B2B2B2]\&. |
313 | Use the specified colour for the scrollbar [default #B2B2B2]\&. |
268 | .IP "\fBtroughColor:\fP \fIcolour\fP" |
314 | .IP "\fBtroughColor:\fP \fIcolour\fP" |
269 | Use the specified colour for the scrollbar\&'s trough area [default |
315 | Use the specified colour for the scrollbar\&'s trough area [default |
270 | #969696]\&. Only relevant for normal (non XTerm/NeXT) scrollbar\&. |
316 | #969696]\&. Only relevant for normal (non XTerm/NeXT) scrollbar\&. |
… | |
… | |
285 | .IP "\fBpath:\fP \fIpath\fP" |
331 | .IP "\fBpath:\fP \fIpath\fP" |
286 | Specify the colon-delimited search path for finding files (XPM and |
332 | Specify the colon-delimited search path for finding files (XPM and |
287 | menus), in addition to the paths specified by the \fBRXVTPATH\fP and |
333 | menus), in addition to the paths specified by the \fBRXVTPATH\fP and |
288 | \fBPATH\fP environment variables\&. |
334 | \fBPATH\fP environment variables\&. |
289 | .IP "\fBfont:\fP \fIfontname\fP" |
335 | .IP "\fBfont:\fP \fIfontname\fP" |
290 | Select the fonts to be used used\&. This is a comma seperated |
336 | Select the fonts to be used\&. |
291 | list of font names that are used in turn when trying to display |
337 | This is a comma seperated list of font names that are used in turn when |
292 | unicode characters\&. The first font defines the cell size for characters, |
338 | trying to display Unicode characters\&. |
293 | pther fonts might be smaller, but not larger\&. A reasonable default list |
339 | The first font defines the cell size for characters; other fonts might |
294 | is appended\&. |
340 | be smaller, but not larger\&. |
|
|
341 | A reasonable default font list is always appended to it\&. |
295 | option \fB-fn\fP\&. |
342 | option \fB-fn\fP\&. |
296 | .IP "\fBgreek_keyboard:\fP \fImode\fP" |
343 | .IP "\fBrealBold:\fP \fIboolean\fP" |
297 | Set the Greek keyboard translation mode to be used; |
344 | \fBTrue\fP: Enable "real bold" support\&. |
298 | \fBiso\fP: ISO-8859 mapping (elot-928) [default]\&. |
345 | When this option is on, bold text will be displayed using the first |
299 | \fBibm\fP: IBM-437 mapping (DOS codepage 737); |
346 | available bold font in the font list\&. |
|
|
347 | Bold fonts should thus be specified in the font list after their |
|
|
348 | corresponding regular fonts\&. |
|
|
349 | If no bold font can be found, a regular font will be used\&. |
300 | option \fB-grk\fP\&. |
350 | option \fB-rb\fP\&. |
301 | .IP "\fBgreektoggle_key:\fP \fIkeysym\fP" |
351 | \fBFalse\fP: Display bold text in a regular font, using the color |
302 | Set the key to toggle keyboard input between no translation and |
352 | specified with \fBcolorBD\fP; |
303 | Greek translation [default \fBMode_switch\fP]\&. |
353 | option \fB+rb\fP\&. |
304 | For more details, see the distributed file \fBREADME\&.greek\fP\&. |
|
|
305 | .IP "\fBselectstyle:\fP \fImode\fP" |
354 | .IP "\fBselectstyle:\fP \fImode\fP" |
306 | Set mouse selection style to \fBold\fP which is 2\&.20, \fBoldword\fP which |
355 | Set mouse selection style to \fBold\fP which is 2\&.20, \fBoldword\fP which |
307 | is xterm style with 2\&.20 old word selection, or anything else which |
356 | is xterm style with 2\&.20 old word selection, or anything else which |
308 | gives xterm style selection\&. |
357 | gives xterm style selection\&. |
309 | .IP "\fBscrollstyle:\fP \fImode\fP" |
358 | .IP "\fBscrollstyle:\fP \fImode\fP" |
310 | Set scrollbar style to \fBrxvt\fP, \fBnext\fP or \fBxterm\fP |
359 | Set scrollbar style to \fBrxvt\fP, \fBrxvt\fP, \fBplain\fP, \fBnext\fP or \fBxterm\fP |
311 | .IP "\fBtitle:\fP \fIstring\fP" |
360 | .IP "\fBtitle:\fP \fIstring\fP" |
312 | Set window title string, the default title is the command-line |
361 | Set window title string, the default title is the command-line |
313 | specified after the \fB-e\fP option, if any, otherwise the application |
362 | specified after the \fB-e\fP option, if any, otherwise the application |
314 | name; |
363 | name; |
315 | option \fB-title\fP\&. |
364 | option \fB-title\fP\&. |
… | |
… | |
394 | Internal border of \fInumber\fP pixels\&. This resource is limited to 100; |
443 | Internal border of \fInumber\fP pixels\&. This resource is limited to 100; |
395 | option \fB-b\fP\&. |
444 | option \fB-b\fP\&. |
396 | .IP "\fBexternalBorder:\fP \fInumber\fP" |
445 | .IP "\fBexternalBorder:\fP \fInumber\fP" |
397 | External border of \fInumber\fP pixels\&. This resource is limited to 100; |
446 | External border of \fInumber\fP pixels\&. This resource is limited to 100; |
398 | option \fB-w\fP, \fB-bw\fP, \fB-borderwidth\fP\&. |
447 | option \fB-w\fP, \fB-bw\fP, \fB-borderwidth\fP\&. |
|
|
448 | .IP "\fBborderLess:\fP \fIboolean\fP" |
|
|
449 | Set MWM hints to request a borderless window, |
|
|
450 | i\&.e\&. if honoured by the WM, the rxvt window will not have window |
|
|
451 | decorations; option \fB-bl\fP\&. |
399 | .IP "\fBtermName:\fP \fItermname\fP" |
452 | .IP "\fBtermName:\fP \fItermname\fP" |
400 | Specifies the terminal type name to be set in the \fBTERM\fP |
453 | Specifies the terminal type name to be set in the \fBTERM\fP |
401 | environment variable; |
454 | environment variable; |
402 | option \fB-tn\fP\&. |
455 | option \fB-tn\fP\&. |
403 | .IP "\fBlinespace:\fP \fInumber\fP" |
456 | .IP "\fBlinespace:\fP \fInumber\fP" |
… | |
… | |
416 | option \fB-bc\fP\&. |
469 | option \fB-bc\fP\&. |
417 | .IP "\fBpointerBlank:\fP \fIboolean\fP" |
470 | .IP "\fBpointerBlank:\fP \fIboolean\fP" |
418 | \fBTrue\fP: blank the pointer when a key is pressed or after a set number |
471 | \fBTrue\fP: blank the pointer when a key is pressed or after a set number |
419 | of seconds of inactivity\&. |
472 | of seconds of inactivity\&. |
420 | \fBFalse\fP: the pointer is always visible [default]\&. |
473 | \fBFalse\fP: the pointer is always visible [default]\&. |
|
|
474 | .IP "\fBpointerColor:\fP \fIcolour\fP" |
|
|
475 | Mouse pointer foreground colour\&. |
|
|
476 | .IP "\fBpointerColor2:\fP \fIcolour\fP" |
|
|
477 | Mouse pointer background colour\&. |
421 | .IP "\fBpointerBlankDelay:\fP \fInumber\fP" |
478 | .IP "\fBpointerBlankDelay:\fP \fInumber\fP" |
422 | Specifies number of seconds before blanking the pointer [default 2]\&. |
479 | Specifies number of seconds before blanking the pointer [default 2]\&. |
423 | .IP "\fBmultibyte_cursor:\fP \fIboolean\fP" |
|
|
424 | \fBTrue\fP: consider multibyte glyphs as single character for backspace, |
|
|
425 | delete and cursor movement keys; |
|
|
426 | option \fB-mcc\fP\&. |
|
|
427 | \fBFalse\fP: move through all components of all glyphs; |
|
|
428 | option \fB+mcc\fP\&. |
|
|
429 | .IP "\fBbackspacekey:\fP \fIstring\fP" |
480 | .IP "\fBbackspacekey:\fP \fIstring\fP" |
430 | The string to send when the backspace key is pressed\&. If set to |
481 | The string to send when the backspace key is pressed\&. If set to |
431 | \fBDEC\fP or unset it will send \fBDelete\fP (code 127) or, if shifted, |
482 | \fBDEC\fP or unset it will send \fBDelete\fP (code 127) or, if shifted, |
432 | \fBBackspace\fP (code 8) - which can be reversed with the appropriate |
483 | \fBBackspace\fP (code 8) - which can be reversed with the appropriate |
433 | DEC private mode escape sequence\&. |
484 | DEC private mode escape sequence\&. |
… | |
… | |
450 | The locale to use for opening the IM\&. You can use an LC_CTYPE |
501 | The locale to use for opening the IM\&. You can use an LC_CTYPE |
451 | of e\&.g\&. de_DE\&.UTF-8 for normal text processing but ja_JP\&.EUC-JP |
502 | of e\&.g\&. de_DE\&.UTF-8 for normal text processing but ja_JP\&.EUC-JP |
452 | for the input extension to be able to input japanese characters |
503 | for the input extension to be able to input japanese characters |
453 | while staying in another locale\&. |
504 | while staying in another locale\&. |
454 | option \fB-imlocale\fP\&. |
505 | option \fB-imlocale\fP\&. |
|
|
506 | .IP "\fBinsecure\fP" |
|
|
507 | Enables "insecure" mode\&. Rxvt-unicode offers some escape sequences |
|
|
508 | that echo arbitrary strings like the icon name or the locale\&. This |
|
|
509 | could be abused if somebody gets 8-bit-clean access to your |
|
|
510 | display, wether throuh a mail client displaying mail bodies |
|
|
511 | unfiltered or though write(1)\&. Therefore, these sequences are |
|
|
512 | disabled by default\&. (Note that other terminals, including xterm, |
|
|
513 | have these sequences enabled by default)\&. You can enable them |
|
|
514 | by setting this boolean resource or specifying \fB-insecure\fP as |
|
|
515 | an option\&. At the moment, this enabled display-answer, locale, |
|
|
516 | findfont, icon label and window title requests as well as dynamic |
|
|
517 | menubar dispatch\&. |
455 | .IP "\fBmodifier:\fP \fImodifier\fP" |
518 | .IP "\fBmodifier:\fP \fImodifier\fP" |
456 | Set the key to be interpreted as the Meta key to: |
519 | Set the key to be interpreted as the Meta key to: |
457 | \fBalt\fP, \fBmeta\fP, \fBhyper\fP, \fBsuper\fP, \fBmod1\fP, \fBmod2\fP, \fBmod3\fP, |
520 | \fBalt\fP, \fBmeta\fP, \fBhyper\fP, \fBsuper\fP, \fBmod1\fP, \fBmod2\fP, \fBmod3\fP, |
458 | \fBmod4\fP, \fBmod5\fP; |
521 | \fBmod4\fP, \fBmod5\fP; |
459 | option \fB-mod\fP\&. |
522 | option \fB-mod\fP\&. |
460 | .IP "\fBanswerbackString:\fP \fIstring\fP" |
523 | .IP "\fBanswerbackString:\fP \fIstring\fP" |
461 | Specify the reply rxvt sends to the shell when an ENQ (control-E) |
524 | Specify the reply rxvt sends to the shell when an ENQ (control-E) |
462 | character is passed through\&. It may contain escape values as |
525 | character is passed through\&. It may contain escape values as |
463 | described in the entry on \fBkeysym\fP following\&. |
526 | described in the entry on \fBkeysym\fP following\&. |
|
|
527 | .IP "\fBsecondaryScreen:\fP \fIbool\fP" |
|
|
528 | Turn on/off secondary screen (default enabled)\&. |
|
|
529 | .IP "\fBsecondaryScroll:\fP \fIbool\fP" |
|
|
530 | Turn on/off secondary screen scroll (default enabled)\&. If |
|
|
531 | the this option is enabled, scrolls on the secondary screen will |
|
|
532 | change the scrollback buffer and switching to/from the secondary screen |
|
|
533 | will instead scroll the screen up\&. |
464 | .IP "\fBkeysym\&.\fP\fIsym\fP: \fIstring\fP" |
534 | .IP "\fBkeysym\&.\fP\fIsym\fP: \fIstring\fP" |
465 | Associate \fIstring\fP with keysym \fIsym\fP (\fB0xFF00 - 0xFFFF\fP)\&. It |
535 | Associate \fIstring\fP with keysym \fIsym\fP (\fB0xFF00 - 0xFFFF\fP)\&. It |
466 | may contain escape values (\ea: bell, \eb: backspace, \ee, \eE: escape, |
536 | may contain escape values (\ea: bell, \eb: backspace, \ee, \eE: escape, |
467 | \en: newline, \er: return, \et: tab, \e000: octal number) or control |
537 | \en: newline, \er: return, \et: tab, \e000: octal number) or control |
468 | characters (^?: delete, ^@: null, ^A \&.\&.\&.) and may enclosed with |
538 | characters (^?: delete, ^@: null, ^A \&.\&.\&.) and may enclosed with |
… | |
… | |
517 | .PP |
587 | .PP |
518 | \fBrxvt\fP tries to write an entry into the \fIutmp\fP(5) file so that it can be |
588 | \fBrxvt\fP tries to write an entry into the \fIutmp\fP(5) file so that it can be |
519 | seen via the \fIwho(1)\fP command, and can accept messages\&. To allow this |
589 | seen via the \fIwho(1)\fP command, and can accept messages\&. To allow this |
520 | feature, \fBrxvt\fP must be installed setuid root on some systems\&. |
590 | feature, \fBrxvt\fP must be installed setuid root on some systems\&. |
521 | .SH "COLORS AND GRAPHICS" |
591 | .SH "COLORS AND GRAPHICS" |
522 | .PP |
|
|
523 | If graphics support was enabled at compile-time, \fBrxvt\fP can be queried |
|
|
524 | with ANSI escape sequences and can address individual pixels instead of |
|
|
525 | text characters\&. Note the graphics support is still considered beta code\&. |
|
|
526 | .PP |
592 | .PP |
527 | In addition to the default foreground and background colours, \fBrxvt\fP |
593 | In addition to the default foreground and background colours, \fBrxvt\fP |
528 | can display up to 16 colours (8 ANSI colours plus high-intensity bold/blink |
594 | can display up to 16 colours (8 ANSI colours plus high-intensity bold/blink |
529 | versions of the same)\&. |
595 | versions of the same)\&. |
530 | Here is a list of the colours with their \fBrgb\&.txt\fP names\&. |
596 | Here is a list of the colours with their \fBrgb\&.txt\fP names\&. |
… | |
… | |
1041 | .PP |
1107 | .PP |
1042 | Cursor change support is not yet implemented\&. |
1108 | Cursor change support is not yet implemented\&. |
1043 | .PP |
1109 | .PP |
1044 | Click-and-drag doesn\&'t work with X11 mouse report overriding\&. |
1110 | Click-and-drag doesn\&'t work with X11 mouse report overriding\&. |
1045 | .PP |
1111 | .PP |
1046 | Graphics support is fairly crude\&. |
|
|
1047 | .PP |
|
|
1048 | .SH "FTP LOCATION" |
1112 | .SH "FTP LOCATION" |
1049 | .PP |
1113 | .PP |
1050 | rxvt-+RXVTVERSION()\&.tar\&.gz can be found at the following ftp sites |
1114 | rxvt-3\&.4\&.tar\&.gz can be found at the following ftp sites |
1051 | RXVTFTPSITE() |
1115 | ftp://ftp\&.rxvt\&.org/pub/rxvt |
1052 | .PP |
1116 | .PP |
1053 | .SH "CURRENT PROJECT COORDINATOR" |
1117 | .SH "CURRENT PROJECT COORDINATOR" |
1054 | .PP |
1118 | .PP |
1055 | .IP "Project Coordinator" |
1119 | .IP "Project Coordinator" |
1056 | RXVTMAINT() RXVTMAINTEMAIL() |
1120 | Marc A\&. Lehmann <rxvt@schmorp\&.de> |
1057 | .br |
1121 | .br |
1058 | .IP "Web page maintainter" |
1122 | .IP "Web page maintainter" |
1059 | RXVTWEBMAINT() RXVTWEBMAINTEMAIL() |
1123 | Marc A\&. Lehmann <rxvt@schmorp\&.de> |
1060 | .br |
1124 | .br |
1061 | RXVTWEBPAGE() |
1125 | <http://www\&.sourceforge\&.net/projects/rxvt-unicode/> |
1062 | .br |
1126 | .br |
1063 | .IP "Mailing list" |
|
|
1064 | The Rxvt Workers <rxvt-workers@rxvt\&.org> |
|
|
1065 | mailing list has also been established for rxvt development, to |
|
|
1066 | subscribe, email to |
|
|
1067 | <rxvt-workers-subscribe@rxvt\&.org>\&. |
|
|
1068 | There is also a mailing list for announcements of new releases of |
|
|
1069 | rxvt\&. To subscribe, email to |
|
|
1070 | <rxvt-announce-subscribe@rxvt\&.org>\&. |
|
|
1071 | .PP |
1127 | .PP |
1072 | .SH "AUTHORS" |
1128 | .SH "AUTHORS" |
1073 | .PP |
1129 | .PP |
1074 | .IP "John Bovey" |
1130 | .IP "John Bovey" |
1075 | University of Kent, 1992, wrote the original Xvt\&. |
1131 | University of Kent, 1992, wrote the original Xvt\&. |
1076 | .IP "Rob Nation <nation@rocket\&.sanders\&.lockheed\&.com>" |
1132 | .IP "Rob Nation <nation@rocket\&.sanders\&.lockheed\&.com>" |
1077 | very heavily modified Xvt and came up with Rxvt |
1133 | very heavily modified Xvt and came up with Rxvt |
1078 | .IP "Angelo Haritsis <ah@doc\&.ic\&.ac\&.uk>" |
1134 | .IP "Angelo Haritsis <ah@doc\&.ic\&.ac\&.uk>" |
1079 | wrote the Greek Keyboard Input |
1135 | wrote the Greek Keyboard Input (no longer in code) |
1080 | .IP "mj olesen <olesen@me\&.QueensU\&.CA>" |
1136 | .IP "mj olesen <olesen@me\&.QueensU\&.CA>" |
1081 | Wrote the menu system\&. |
1137 | Wrote the menu system\&. |
1082 | .br |
1138 | .br |
1083 | Project Coordinator (changes\&.txt 2\&.11 to 2\&.21) |
1139 | Project Coordinator (changes\&.txt 2\&.11 to 2\&.21) |
1084 | .IP "Oezguer Kesim <kesim@math\&.fu-berlin\&.de>" |
1140 | .IP "Oezguer Kesim <kesim@math\&.fu-berlin\&.de>" |
1085 | Project Coordinator (changes\&.txt 2\&.21a to 2\&.4\&.5) |
1141 | Project Coordinator (changes\&.txt 2\&.21a to 2\&.4\&.5) |
1086 | .IP "Geoff Wing <gcw@pobox\&.com>" |
1142 | .IP "Geoff Wing <gcw@pobox\&.com>" |
1087 | Rewrote screen display and text selection routines\&. |
1143 | Rewrote screen display and text selection routines\&. |
|
|
1144 | Project Coordinator (changes\&.txt 2\&.4\&.6 - rxvt-unicode) |
|
|
1145 | .IP "Marc Alexander Lehmann <rxvt@schmorp\&.de>" |
|
|
1146 | Forked rxvt-unicode, rewrote most of the display code and |
|
|
1147 | internal character handling to store text in unicode, |
|
|
1148 | improve xterm compatibility and apply numerous other bugfixes |
|
|
1149 | and extensions\&. |
1088 | .br |
1150 | .br |
1089 | Project Coordinator (changes\&.txt 2\&.4\&.6 - ) |
1151 | Project Coordinator (Changes 1\&.0 - ) |
|
|
1152 | .PP |