« back to all changes in this revision
Viewing changes to doc/rxvt.1.html
- browse files at revision 10
- compare with another revision
- download diff
- download tarball
- view history from revision 10
- Committer: Bazaar Package Importer
- Author(s): Decklin Foster
- Date: 2006-09-01 14:44:58 UTC
- mfrom: (1.1.8 upstream) (3.1.1 etch)
- Revision ID: james.westby@ubuntu.com-20060901144458-98hrz8zg01w8a3vy
Tags: 7.9-2
* Edit the comments in the app-defaults file, and disable all settings by
default. If font autoselection fails, I would prefer to open a new bug
specifically for that. (Closes: #385481)
* Reorganize and edit README.Debian, pushing as much as possible into FAQ
format (with resource setting issues first).
default. If font autoselection fails, I would prefer to open a new bug
specifically for that. (Closes: #385481)
* Reorganize and edit README.Debian, pushing as much as possible into FAQ
format (with resource setting issues first).
- files added:
- debian/patches/select-quoted.patch
- files removed:
- debian/patches/faq-section.patch
- files modified:
- Changes
added
removed
doc/rxvt.1.html
1
<?xml version="1.0" ?>
1
2
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
2
3
<html xmlns="http://www.w3.org/1999/xhtml">
3
4
<head>
4
5
<title>unicode) -</title>
6
<meta http-equiv="content-type" content="text/html; charset=utf-8" />
5
7
<link rev="made" href="mailto:perl-binary@plan9.de" />
6
8
</head>
7
9
53
55
</p>
54
56
<hr />
55
57
<h1><a name="description">DESCRIPTION</a></h1>
56
<p><strong>rxvt-unicode</strong>, version <strong>7.6</strong>, is a colour vt102 terminal
58
<p><strong>rxvt-unicode</strong>, version <strong>7.9</strong>, is a colour vt102 terminal
57
59
emulator intended as an <em>xterm</em>(1) replacement for users who do not
58
60
require features such as Tektronix 4014 emulation and toolkit-style
59
61
configurability. As a result, <strong>rxvt-unicode</strong> uses much less swap space --
77
79
like mongolian or scripts requiring extremely complex combining rules,
78
80
like tibetan or devenagari. Don't expect pretty output when using these
79
81
scripts. Most other scripts, latin, cyrillic, kanji, thai etc. should work
80
fine, though. A somewhat difficult case are left-to-right scripts, such
82
fine, though. A somewhat difficult case are right-to-left scripts, such
81
83
as hebrew: <strong>rxvt-unicode</strong> adopts the view that bidirectional algorithms
82
84
belong into the application, not the terminal emulator (too many things --
83
85
such as cursor-movement while editing -- break otherwise), but that might
84
86
change.</p>
85
87
<p>If you are looking for a terminal that supports more exotic scripts, let
86
me recommend <code>mlterm</code>, which is a very userfriendly, lean and clean
88
me recommend <code>mlterm</code>, which is a very user friendly, lean and clean
87
89
terminal emulator. In fact, the reason rxvt-unicode was born was solely
88
90
because the author couldn't get <code>mlterm</code> to use one font for latin1 and
89
91
another for japanese.</p>
90
92
<p>Therefore another design rationale was the use of multiple fonts to
91
93
display characters: The idea of a single unicode font which many other
92
programs force onto it's users never made sense to me: You should be able
94
programs force onto its users never made sense to me: You should be able
93
95
to choose any font for any script freely.</p>
94
96
<p>Apart from that, rxvt-unicode is also much better internationalised than
95
it's predecessor, supports things such as XFT and ISO 14755 that are handy
96
in i18n-environments, is faster, and has a lot less bugs than the original
97
its predecessor, supports things such as XFT and ISO 14755 that are handy
98
in i18n-environments, is faster, and has a lot bugs less than the original
97
99
rxvt. This all in addition to dozens of other small improvements.</p>
98
100
<p>It is still faithfully following the original rxvt idea of being lean
99
101
and nice on resources: for example, you can still configure rxvt-unicode
100
without most of it's features to get a lean binary. It also comes with
102
without most of its features to get a lean binary. It also comes with
101
103
a client/daemon pair that lets you open any number of terminal windows
102
104
from within a single process, which makes startup time very fast and
103
105
drastically reduces memory usage. See <code>rxvtd(1)</code> (daemon) and
104
106
<code>rxvtc(1)</code> (client).</p>
105
107
<p>It also makes technical information about escape sequences (which have
106
been extended) easier accessible: see <code>rxvt(7)</code> for technical
108
been extended) more accessible: see <code>rxvt(7)</code> for technical
107
109
reference documentation (escape sequences etc.).</p>
108
110
<p>
109
111
</p>
124
126
Orange'.</p>
125
127
<p>The following options are available:</p>
126
128
<dl>
127
<dt><strong><a name="item__2dhelp_2c__2d_2dhelp"><strong>-help</strong>, <strong>--help</strong></a></strong><br />
128
</dt>
129
<dt><strong><a name="item__2dhelp_2c__2d_2dhelp"><strong>-help</strong>, <strong>--help</strong></a></strong>
130
129
131
<dd>
130
Print out a message describing available options.
132
<p>Print out a message describing available options.</p>
131
133
</dd>
132
<p></p>
133
<dt><strong><a name="item__2ddisplay_displayname"><strong>-display</strong> <em>displayname</em></a></strong><br />
134
</dt>
134
</li>
135
<dt><strong><a name="item__2ddisplay_displayname"><strong>-display</strong> <em>displayname</em></a></strong>
136
135
137
<dd>
136
Attempt to open a window on the named X display (<strong>-d</strong> still
138
<p>Attempt to open a window on the named X display (<strong>-d</strong> still
137
139
respected). In the absence of this option, the display specified by the
138
<strong>DISPLAY</strong> environment variable is used.
139
</dd>
140
<p></p>
141
<dt><strong><a name="item__2ddepth_bitdepth"><strong>-depth</strong> <em>bitdepth</em></a></strong><br />
142
</dt>
143
<dd>
144
Compile <em>xft</em>: Attempt to find a visual with the given bit depth;
145
resource <strong>depth</strong>.
146
</dd>
147
<p></p>
148
<dt><strong><a name="item__2dgeometry_geom"><strong>-geometry</strong> <em>geom</em></a></strong><br />
149
</dt>
150
<dd>
151
Window geometry (<strong>-g</strong> still respected); resource <strong>geometry</strong>.
152
</dd>
153
<p></p>
154
<dt><strong><a name="item__2drv_7c_2brv"><strong>-rv</strong>|<strong>+rv</strong></a></strong><br />
155
</dt>
156
<dd>
157
Turn on/off simulated reverse video; resource <strong>reverseVideo</strong>.
158
</dd>
159
<p></p>
160
<dt><strong><a name="item__2dj_7c_2bj"><strong>-j</strong>|<strong>+j</strong></a></strong><br />
161
</dt>
162
<dd>
163
Turn on/off jump scrolling; resource <strong>jumpScroll</strong>.
164
</dd>
165
<p></p>
166
<dt><strong><a name="item__2dip_7c_2bip__7c__2dtr_7c_2btr"><strong>-ip</strong>|<strong>+ip</strong> | <strong>-tr</strong>|<strong>+tr</strong></a></strong><br />
167
</dt>
168
<dd>
169
Turn on/off inheriting parent window's pixmap. Alternative form is
170
<strong>-tr</strong>; resource <strong>inheritPixmap</strong>.
140
<strong>DISPLAY</strong> environment variable is used.</p>
141
</dd>
142
</li>
143
<dt><strong><a name="item__2ddepth_bitdepth"><strong>-depth</strong> <em>bitdepth</em></a></strong>
144
145
<dd>
146
<p>Compile <em>xft</em>: Attempt to find a visual with the given bit depth;
147
resource <strong>depth</strong>.</p>
148
</dd>
149
</li>
150
<dt><strong><a name="item__2dgeometry_geom"><strong>-geometry</strong> <em>geom</em></a></strong>
151
152
<dd>
153
<p>Window geometry (<strong>-g</strong> still respected); resource <strong>geometry</strong>.</p>
154
</dd>
155
</li>
156
<dt><strong><a name="item__2drv_7c_2brv"><strong>-rv</strong>|<strong>+rv</strong></a></strong>
157
158
<dd>
159
<p>Turn on/off simulated reverse video; resource <strong>reverseVideo</strong>.</p>
160
</dd>
161
</li>
162
<dt><strong><a name="item__2dj_7c_2bj"><strong>-j</strong>|<strong>+j</strong></a></strong>
163
164
<dd>
165
<p>Turn on/off jump scrolling; resource <strong>jumpScroll</strong>.</p>
166
</dd>
167
</li>
168
<dt><strong><a name="item__2dip_7c_2bip__7c__2dtr_7c_2btr"><strong>-ip</strong>|<strong>+ip</strong> | <strong>-tr</strong>|<strong>+tr</strong></a></strong>
169
170
<dd>
171
<p>Turn on/off inheriting parent window's pixmap. Alternative form is
172
<strong>-tr</strong>; resource <strong>inheritPixmap</strong>.</p>
171
173
</dd>
172
174
<dd>
173
175
<p><em>Please note that transparency of any kind if completely unsupported by
174
the author. Don't bug him with installation questions!</em></p>
176
the author. Don't bug him with installation questions! Read the FAQ (man 7
177
rxvt)!</em></p>
175
178
</dd>
176
<p></p>
177
<dt><strong><a name="item__2dfade_number"><strong>-fade</strong> <em>number</em></a></strong><br />
178
</dt>
179
</li>
180
<dt><strong><a name="item__2dfade_number"><strong>-fade</strong> <em>number</em></a></strong>
181
179
182
<dd>
180
Fade the text by the given percentage when focus is lost. Small values
183
<p>Fade the text by the given percentage when focus is lost. Small values
181
184
fade a little only, 100 completely replaces all colours by the fade
182
colour; resource <strong>fading</strong>.
183
</dd>
184
<p></p>
185
<dt><strong><a name="item__2dfadecolor_colour"><strong>-fadecolor</strong> <em>colour</em></a></strong><br />
186
</dt>
187
<dd>
188
Fade to this colour when fading is used (see <strong>-fade</strong>). The default colour
189
is opaque black. resource <strong>fadeColor</strong>.
190
</dd>
191
<p></p>
192
<dt><strong><a name="item__2dtint_colour"><strong>-tint</strong> <em>colour</em></a></strong><br />
193
</dt>
194
<dd>
195
Tint the transparent background pixmap with the given colour when
185
colour; resource <strong>fading</strong>.</p>
186
</dd>
187
</li>
188
<dt><strong><a name="item__2dfadecolor_colour"><strong>-fadecolor</strong> <em>colour</em></a></strong>
189
190
<dd>
191
<p>Fade to this colour when fading is used (see <strong>-fade</strong>). The default colour
192
is opaque black. resource <strong>fadeColor</strong>.</p>
193
</dd>
194
</li>
195
<dt><strong><a name="item__2dtint_colour"><strong>-tint</strong> <em>colour</em></a></strong>
196
197
<dd>
198
<p>Tint the transparent background pixmap with the given colour when
196
199
transparency is enabled with <strong>-tr</strong> or <strong>-ip</strong>. This only works for
197
200
non-tiled backgrounds, currently. See also the <strong>-sh</strong> option that can be
198
201
used to brighten or darken the image in addition to tinting it; resource
199
<em>tintColor</em>. Example:
202
<em>tintColor</em>. Example:</p>
200
203
</dd>
201
204
<dd>
202
205
<pre>
203
206
rxvt -tr -tint blue -sh 40</pre>
204
207
</dd>
205
<p></p>
206
<dt><strong><a name="item__2dsh"><strong>-sh</strong></a></strong><br />
207
</dt>
208
</li>
209
<dt><strong><a name="item__2dsh"><strong>-sh</strong></a></strong>
210
208
211
<dd>
209
<em>number</em> Darken (0 .. 100) or lighten (-1 .. -100) the transparent
212
<p><em>number</em> Darken (0 .. 100) or lighten (-1 .. -100) the transparent
210
213
background image in addition to tinting it (i.e. <strong>-tint</strong> must be
211
specified, too, e.g. <code>-tint white</code>).
212
</dd>
213
<p></p>
214
<dt><strong><a name="item__2dbg_colour"><strong>-bg</strong> <em>colour</em></a></strong><br />
215
</dt>
216
<dd>
217
Window background colour; resource <strong>background</strong>.
218
</dd>
219
<p></p>
220
<dt><strong><a name="item__2dfg_colour"><strong>-fg</strong> <em>colour</em></a></strong><br />
221
</dt>
222
<dd>
223
Window foreground colour; resource <strong>foreground</strong>.
224
</dd>
225
<p></p>
226
<dt><strong><a name="item__2dpixmap_file_5b_3bgeom_5d"><strong>-pixmap</strong> <em>file[;geom]</em></a></strong><br />
227
</dt>
228
<dd>
229
Compile <em>XPM</em>: Specify XPM file for the background and also optionally
214
specified, too, e.g. <code>-tint white</code>).</p>
215
</dd>
216
</li>
217
<dt><strong><a name="item__2dbg_colour"><strong>-bg</strong> <em>colour</em></a></strong>
218
219
<dd>
220
<p>Window background colour; resource <strong>background</strong>.</p>
221
</dd>
222
</li>
223
<dt><strong><a name="item__2dfg_colour"><strong>-fg</strong> <em>colour</em></a></strong>
224
225
<dd>
226
<p>Window foreground colour; resource <strong>foreground</strong>.</p>
227
</dd>
228
</li>
229
<dt><strong><a name="item__2dpixmap_file_5b_3bgeom_5d"><strong>-pixmap</strong> <em>file[;geom]</em></a></strong>
230
231
<dd>
232
<p>Compile <em>XPM</em>: Specify XPM file for the background and also optionally
230
233
specify its scaling with a geometry string. Note you may need to
231
234
add quotes to avoid special shell interpretation of the <code>;</code> in the
232
command-line; resource <strong>backgroundPixmap</strong>.
233
</dd>
234
<p></p>
235
<dt><strong><a name="item__2dcr_colour"><strong>-cr</strong> <em>colour</em></a></strong><br />
236
</dt>
237
<dd>
238
The cursor colour; resource <strong>cursorColor</strong>.
239
</dd>
240
<p></p>
241
<dt><strong><a name="item__2dpr_colour"><strong>-pr</strong> <em>colour</em></a></strong><br />
242
</dt>
243
<dd>
244
The mouse pointer foreground colour; resource <strong>pointerColor</strong>.
245
</dd>
246
<p></p>
247
<dt><strong><a name="item__2dpr2_colour"><strong>-pr2</strong> <em>colour</em></a></strong><br />
248
</dt>
249
<dd>
250
The mouse pointer background colour; resource <strong>pointerColor2</strong>.
251
</dd>
252
<p></p>
253
<dt><strong><a name="item__2dbd_colour"><strong>-bd</strong> <em>colour</em></a></strong><br />
254
</dt>
255
<dd>
256
The colour of the border around the text area and between the scrollbar and the text;
257
resource <strong>borderColor</strong>.
258
</dd>
259
<p></p>
260
<dt><strong><a name="item__2dfn_fontlist"><strong>-fn</strong> <em>fontlist</em></a></strong><br />
261
</dt>
262
<dd>
263
Select the fonts to be used. This is a comma separated list of font names
235
command-line; resource <strong>backgroundPixmap</strong>.</p>
236
</dd>
237
</li>
238
<dt><strong><a name="item__2dcr_colour"><strong>-cr</strong> <em>colour</em></a></strong>
239
240
<dd>
241
<p>The cursor colour; resource <strong>cursorColor</strong>.</p>
242
</dd>
243
</li>
244
<dt><strong><a name="item__2dpr_colour"><strong>-pr</strong> <em>colour</em></a></strong>
245
246
<dd>
247
<p>The mouse pointer foreground colour; resource <strong>pointerColor</strong>.</p>
248
</dd>
249
</li>
250
<dt><strong><a name="item__2dpr2_colour"><strong>-pr2</strong> <em>colour</em></a></strong>
251
252
<dd>
253
<p>The mouse pointer background colour; resource <strong>pointerColor2</strong>.</p>
254
</dd>
255
</li>
256
<dt><strong><a name="item__2dbd_colour"><strong>-bd</strong> <em>colour</em></a></strong>
257
258
<dd>
259
<p>The colour of the border around the text area and between the scrollbar and the text;
260
resource <strong>borderColor</strong>.</p>
261
</dd>
262
</li>
263
<dt><strong><a name="item__2dfn_fontlist"><strong>-fn</strong> <em>fontlist</em></a></strong>
264
265
<dd>
266
<p>Select the fonts to be used. This is a comma separated list of font names
264
267
that are checked in order when trying to find glyphs for characters. The
265
268
first font defines the cell size for characters; other fonts might be
266
269
smaller, but not (in general) larger. A (hopefully) reasonable default
267
font list is always appended to it. See resource <strong>font</strong> for more details.
270
font list is always appended to it. See resource <strong>font</strong> for more details.</p>
268
271
</dd>
269
272
<dd>
270
<p>In short, to specify an X11 core font, just specify it's name or prefix it
273
<p>In short, to specify an X11 core font, just specify its name or prefix it
271
274
with <code>x:</code>. To specify an XFT-font, you need to prefix it with <code>xft:</code>,
272
275
e.g.:</p>
273
276
</dd>
280
283
<p>See also the question ``How does rxvt-unicode choose fonts?'' in the FAQ
281
284
section of rxvt(7).</p>
282
285
</dd>
283
<p></p>
284
<dt><strong><a name="item__2dfb_fontlist"><strong>-fb</strong> <em>fontlist</em></a></strong><br />
285
</dt>
286
<dd>
287
Compile <em>font-styles</em>: The bold font list to use when <strong>bold</strong> characters
288
are to be printed. See resource <strong>boldFont</strong> for details.
289
</dd>
290
<p></p>
291
<dt><strong><a name="item__2dfi_fontlist"><strong>-fi</strong> <em>fontlist</em></a></strong><br />
292
</dt>
293
<dd>
294
Compile <em>font-styles</em>: The italic font list to use when <em>italic</em>
295
characters are to be printed. See resource <strong>italicFont</strong> for details.
296
</dd>
297
<p></p>
298
<dt><strong><a name="item__2dfbi_fontlist"><strong>-fbi</strong> <em>fontlist</em></a></strong><br />
299
</dt>
300
<dd>
301
Compile <em>font-styles</em>: The bold italic font list to use when <strong><em>bold
286
</li>
287
<dt><strong><a name="item__2dfb_fontlist"><strong>-fb</strong> <em>fontlist</em></a></strong>
288
289
<dd>
290
<p>Compile <em>font-styles</em>: The bold font list to use when <strong>bold</strong> characters
291
are to be printed. See resource <strong>boldFont</strong> for details.</p>
292
</dd>
293
</li>
294
<dt><strong><a name="item__2dfi_fontlist"><strong>-fi</strong> <em>fontlist</em></a></strong>
295
296
<dd>
297
<p>Compile <em>font-styles</em>: The italic font list to use when <em>italic</em>
298
characters are to be printed. See resource <strong>italicFont</strong> for details.</p>
299
</dd>
300
</li>
301
<dt><strong><a name="item__2dfbi_fontlist"><strong>-fbi</strong> <em>fontlist</em></a></strong>
302
303
<dd>
304
<p>Compile <em>font-styles</em>: The bold italic font list to use when <strong><em>bold
302
305
italic</em> </strong>> characters are to be printed. See resource <strong>boldItalicFont</strong>
303
for details.
306
for details.</p>
304
307
</dd>
305
<p></p>
306
<dt><strong><a name="item__2dis_7c_2bis"><strong>-is</strong>|<strong>+is</strong></a></strong><br />
307
</dt>
308
</li>
309
<dt><strong><a name="item__2dis_7c_2bis"><strong>-is</strong>|<strong>+is</strong></a></strong>
310
308
311
<dd>
309
Compile <em>font-styles</em>: Bold/Italic font styles imply high intensity
312
<p>Compile <em>font-styles</em>: Bold/Italic font styles imply high intensity
310
313
foreground/background (default). See resource <strong>intensityStyles</strong> for
311
details.
314
details.</p>
312
315
</dd>
313
<p></p>
314
<dt><strong><a name="item__2dname_name"><strong>-name</strong> <em>name</em></a></strong><br />
315
</dt>
316
</li>
317
<dt><strong><a name="item__2dname_name"><strong>-name</strong> <em>name</em></a></strong>
318
316
319
<dd>
317
Specify the application name under which resources are to be obtained,
320
<p>Specify the application name under which resources are to be obtained,
318
321
rather than the default executable file name. Name should not contain
319
`.' or `*' characters. Also sets the icon and title name.
320
</dd>
321
<p></p>
322
<dt><strong><a name="item__2dls_7c_2bls"><strong>-ls</strong>|<strong>+ls</strong></a></strong><br />
323
</dt>
324
<dd>
325
Start as a login-shell/sub-shell; resource <strong>loginShell</strong>.
326
</dd>
327
<p></p>
328
<dt><strong><a name="item__2dut_7c_2but"><strong>-ut</strong>|<strong>+ut</strong></a></strong><br />
329
</dt>
330
<dd>
331
Compile <em>utmp</em>: Inhibit/enable writing a utmp entry; resource
332
<strong>utmpInhibit</strong>.
333
</dd>
334
<p></p>
335
<dt><strong><a name="item__2dvb_7c_2bvb"><strong>-vb</strong>|<strong>+vb</strong></a></strong><br />
336
</dt>
337
<dd>
338
Turn on/off visual bell on receipt of a bell character; resource
339
<strong>visualBell</strong>.
340
</dd>
341
<p></p>
342
<dt><strong><a name="item__2dsb_7c_2bsb"><strong>-sb</strong>|<strong>+sb</strong></a></strong><br />
343
</dt>
344
<dd>
345
Turn on/off scrollbar; resource <strong>scrollBar</strong>.
346
</dd>
347
<p></p>
348
<dt><strong><a name="item__2dsi_7c_2bsi"><strong>-si</strong>|<strong>+si</strong></a></strong><br />
349
</dt>
350
<dd>
351
Turn on/off scroll-to-bottom on TTY output inhibit; resource
352
<strong>scrollTtyOutput</strong> has opposite effect.
353
</dd>
354
<p></p>
355
<dt><strong><a name="item__2dsk_7c_2bsk"><strong>-sk</strong>|<strong>+sk</strong></a></strong><br />
356
</dt>
357
<dd>
358
Turn on/off scroll-to-bottom on keypress; resource
359
<strong>scrollTtyKeypress</strong>.
360
</dd>
361
<p></p>
362
<dt><strong><a name="item__2dsw_7c_2bsw"><strong>-sw</strong>|<strong>+sw</strong></a></strong><br />
363
</dt>
364
<dd>
365
Turn on/off scrolling with the scrollback buffer as new lines appear.
322
`.' or `*' characters. Also sets the icon and title name.</p>
323
</dd>
324
</li>
325
<dt><strong><a name="item__2dls_7c_2bls"><strong>-ls</strong>|<strong>+ls</strong></a></strong>
326
327
<dd>
328
<p>Start as a login-shell/sub-shell; resource <strong>loginShell</strong>.</p>
329
</dd>
330
</li>
331
<dt><strong><a name="item__2dut_7c_2but"><strong>-ut</strong>|<strong>+ut</strong></a></strong>
332
333
<dd>
334
<p>Compile <em>utmp</em>: Inhibit/enable writing a utmp entry; resource
335
<strong>utmpInhibit</strong>.</p>
336
</dd>
337
</li>
338
<dt><strong><a name="item__2dvb_7c_2bvb"><strong>-vb</strong>|<strong>+vb</strong></a></strong>
339
340
<dd>
341
<p>Turn on/off visual bell on receipt of a bell character; resource
342
<strong>visualBell</strong>.</p>
343
</dd>
344
</li>
345
<dt><strong><a name="item__2dsb_7c_2bsb"><strong>-sb</strong>|<strong>+sb</strong></a></strong>
346
347
<dd>
348
<p>Turn on/off scrollbar; resource <strong>scrollBar</strong>.</p>
349
</dd>
350
</li>
351
<dt><strong><a name="item__2dsi_7c_2bsi"><strong>-si</strong>|<strong>+si</strong></a></strong>
352
353
<dd>
354
<p>Turn on/off scroll-to-bottom on TTY output inhibit; resource
355
<strong>scrollTtyOutput</strong> has opposite effect.</p>
356
</dd>
357
</li>
358
<dt><strong><a name="item__2dsk_7c_2bsk"><strong>-sk</strong>|<strong>+sk</strong></a></strong>
359
360
<dd>
361
<p>Turn on/off scroll-to-bottom on keypress; resource
362
<strong>scrollTtyKeypress</strong>.</p>
363
</dd>
364
</li>
365
<dt><strong><a name="item__2dsw_7c_2bsw"><strong>-sw</strong>|<strong>+sw</strong></a></strong>
366
367
<dd>
368
<p>Turn on/off scrolling with the scrollback buffer as new lines appear.
366
369
This only takes effect if <strong>-si</strong> is also given; resource
367
<strong>scrollWithBuffer</strong>.
368
</dd>
369
<p></p>
370
<dt><strong><a name="item__2dsr_7c_2bsr"><strong>-sr</strong>|<strong>+sr</strong></a></strong><br />
371
</dt>
372
<dd>
373
Put scrollbar on right/left; resource <strong>scrollBar_right</strong>.
374
</dd>
375
<p></p>
376
<dt><strong><a name="item__2dst_7c_2bst"><strong>-st</strong>|<strong>+st</strong></a></strong><br />
377
</dt>
378
<dd>
379
Display rxvt (non XTerm/NeXT) scrollbar without/with a trough;
380
resource <strong>scrollBar_floating</strong>.
381
</dd>
382
<p></p>
383
<dt><strong><a name="item__2dptab_7c_2bptab"><strong>-ptab</strong>|<strong>+ptab</strong></a></strong><br />
384
</dt>
385
<dd>
386
If enabled (default), ``Horizontal Tab'' characters are being stored as
370
<strong>scrollWithBuffer</strong>.</p>
371
</dd>
372
</li>
373
<dt><strong><a name="item__2dsr_7c_2bsr"><strong>-sr</strong>|<strong>+sr</strong></a></strong>
374
375
<dd>
376
<p>Put scrollbar on right/left; resource <strong>scrollBar_right</strong>.</p>
377
</dd>
378
</li>
379
<dt><strong><a name="item__2dst_7c_2bst"><strong>-st</strong>|<strong>+st</strong></a></strong>
380
381
<dd>
382
<p>Display rxvt (non XTerm/NeXT) scrollbar without/with a trough;
383
resource <strong>scrollBar_floating</strong>.</p>
384
</dd>
385
</li>
386
<dt><strong><a name="item__2dptab_7c_2bptab"><strong>-ptab</strong>|<strong>+ptab</strong></a></strong>
387
388
<dd>
389
<p>If enabled (default), ``Horizontal Tab'' characters are being stored as
387
390
actual wide characters in the screen buffer, which makes it possible to
388
391
select and paste them. Since a horizontal tab is a cursor movement and
389
392
not an actual glyph, this can sometimes be visually annoying as the cursor
390
on a tab character is displayed as a wide cursor; resource <strong>pastableTabs</strong>.
391
</dd>
392
<p></p>
393
<dt><strong><a name="item__2dbc_7c_2bbc"><strong>-bc</strong>|<strong>+bc</strong></a></strong><br />
394
</dt>
395
<dd>
396
Blink the cursor; resource <strong>cursorBlink</strong>.
397
</dd>
398
<p></p>
399
<dt><strong><a name="item__2diconic"><strong>-iconic</strong></a></strong><br />
400
</dt>
401
<dd>
402
Start iconified, if the window manager supports that option.
403
Alternative form is <strong>-ic</strong>.
404
</dd>
405
<p></p>
406
<dt><strong><a name="item__2dsl_number"><strong>-sl</strong> <em>number</em></a></strong><br />
407
</dt>
408
<dd>
409
Save <em>number</em> lines in the scrollback buffer. See resource entry for
410
limits; resource <strong>saveLines</strong>.
411
</dd>
412
<p></p>
413
<dt><strong><a name="item__2db_number"><strong>-b</strong> <em>number</em></a></strong><br />
414
</dt>
415
<dd>
416
Compile <em>frills</em>: Internal border of <em>number</em> pixels. See resource
417
entry for limits; resource <strong>internalBorder</strong>.
418
</dd>
419
<p></p>
420
<dt><strong><a name="item__2dw_number"><strong>-w</strong> <em>number</em></a></strong><br />
421
</dt>
422
<dd>
423
Compile <em>frills</em>: External border of <em>number</em> pixels. Also, <strong>-bw</strong>
393
on a tab character is displayed as a wide cursor; resource <strong>pastableTabs</strong>.</p>
394
</dd>
395
</li>
396
<dt><strong><a name="item__2dbc_7c_2bbc"><strong>-bc</strong>|<strong>+bc</strong></a></strong>
397
398
<dd>
399
<p>Blink the cursor; resource <strong>cursorBlink</strong>.</p>
400
</dd>
401
</li>
402
<dt><strong><a name="item__2diconic"><strong>-iconic</strong></a></strong>
403
404
<dd>
405
<p>Start iconified, if the window manager supports that option.
406
Alternative form is <strong>-ic</strong>.</p>
407
</dd>
408
</li>
409
<dt><strong><a name="item__2dsl_number"><strong>-sl</strong> <em>number</em></a></strong>
410
411
<dd>
412
<p>Save <em>number</em> lines in the scrollback buffer. See resource entry for
413
limits; resource <strong>saveLines</strong>.</p>
414
</dd>
415
</li>
416
<dt><strong><a name="item__2db_number"><strong>-b</strong> <em>number</em></a></strong>
417
418
<dd>
419
<p>Compile <em>frills</em>: Internal border of <em>number</em> pixels. See resource
420
entry for limits; resource <strong>internalBorder</strong>.</p>
421
</dd>
422
</li>
423
<dt><strong><a name="item__2dw_number"><strong>-w</strong> <em>number</em></a></strong>
424
425
<dd>
426
<p>Compile <em>frills</em>: External border of <em>number</em> pixels. Also, <strong>-bw</strong>
424
427
and <strong>-borderwidth</strong>. See resource entry for limits; resource
425
<strong>externalBorder</strong>.
428
<strong>externalBorder</strong>.</p>
426
429
</dd>
427
<p></p>
428
<dt><strong><a name="item__2dbl"><strong>-bl</strong></a></strong><br />
429
</dt>
430
</li>
431
<dt><strong><a name="item__2dbl"><strong>-bl</strong></a></strong>
432
430
433
<dd>
431
Compile <em>frills</em>: Set MWM hints to request a borderless window, i.e.
434
<p>Compile <em>frills</em>: Set MWM hints to request a borderless window, i.e.
432
435
if honoured by the WM, the rxvt-unicode window will not have window
433
decorations; resource <strong>borderLess</strong>.
434
</dd>
435
<p></p>
436
<dt><strong><a name="item__2doverride_2dredirect"><strong>-override-redirect</strong></a></strong><br />
437
</dt>
438
<dd>
439
Compile <em>frills</em>: Sets override-redirect on the window; resource
440
<strong>override-redirect</strong>.
441
</dd>
442
<p></p>
443
<dt><strong><a name="item__2dsbg"><strong>-sbg</strong></a></strong><br />
444
</dt>
445
<dd>
446
Compile <em>frills</em>: Disable the usage of the built-in block graphics/line
436
decorations; resource <strong>borderLess</strong>.</p>
437
</dd>
438
</li>
439
<dt><strong><a name="item__2doverride_2dredirect"><strong>-override-redirect</strong></a></strong>
440
441
<dd>
442
<p>Compile <em>frills</em>: Sets override-redirect on the window; resource
443
<strong>override-redirect</strong>.</p>
444
</dd>
445
</li>
446
<dt><strong><a name="item__2dsbg"><strong>-sbg</strong></a></strong>
447
448
<dd>
449
<p>Compile <em>frills</em>: Disable the usage of the built-in block graphics/line
447
450
drawing characters and just rely on what the specified fonts provide. Use
448
451
this if you have a good font and want to use its block graphic glyphs;
449
resource <strong>skipBuiltinGlyphs</strong>.
452
resource <strong>skipBuiltinGlyphs</strong>.</p>
450
453
</dd>
451
<p></p>
452
<dt><strong><a name="item__2dlsp_number"><strong>-lsp</strong> <em>number</em></a></strong><br />
453
</dt>
454
</li>
455
<dt><strong><a name="item__2dlsp_number"><strong>-lsp</strong> <em>number</em></a></strong>
456
454
457
<dd>
455
Compile <em>frills</em>: Lines (pixel height) to insert between each row of
458
<p>Compile <em>frills</em>: Lines (pixel height) to insert between each row of
456
459
the display. Useful to work around font rendering problems; resource
457
<strong>linespace</strong>.
460
<strong>linespace</strong>.</p>
458
461
</dd>
459
<p></p>
460
<dt><strong><a name="item__2dtn_termname"><strong>-tn</strong> <em>termname</em></a></strong><br />
461
</dt>
462
</li>
463
<dt><strong><a name="item__2dtn_termname"><strong>-tn</strong> <em>termname</em></a></strong>
464
462
465
<dd>
463
This option specifies the name of the terminal type to be set in the
466
<p>This option specifies the name of the terminal type to be set in the
464
467
<strong>TERM</strong> environment variable. This terminal type must exist in the
465
468
<em>termcap(5)</em> database and should have <em>li#</em> and <em>co#</em> entries;
466
resource <strong>termName</strong>.
469
resource <strong>termName</strong>.</p>
467
470
</dd>
468
<p></p>
469
<dt><strong><a name="item__2de_command__5barguments_5d"><strong>-e</strong> <em>command [arguments]</em></a></strong><br />
470
</dt>
471
</li>
472
<dt><strong><a name="item__2de_command__5barguments_5d"><strong>-e</strong> <em>command [arguments]</em></a></strong>
473
471
474
<dd>
472
Run the command with its command-line arguments in the <strong>rxvt</strong>
475
<p>Run the command with its command-line arguments in the <strong>rxvt</strong>
473
476
window; also sets the window title and icon name to be the basename of
474
477
the program being executed if neither <em>-title</em> (<em>-T</em>) nor <em>-n</em> are
475
478
given on the command line. If this option is used, it must be the last
476
479
on the command-line. If there is no <strong>-e</strong> option then the default is to
477
480
run the program specified by the <strong>SHELL</strong> environment variable or,
478
failing that, <em>sh(1)</em>.
481
failing that, <em>sh(1)</em>.</p>
479
482
</dd>
480
483
<dd>
481
484
<p>Please note that you must specify a program with arguments. If you want to
485
488
<pre>
486
489
rxvt -e sh -c "shell commands"</pre>
487
490
</dd>
488
<p></p>
489
<dt><strong><a name="item__2dtitle_text"><strong>-title</strong> <em>text</em></a></strong><br />
490
</dt>
491
</li>
492
<dt><strong><a name="item__2dtitle_text"><strong>-title</strong> <em>text</em></a></strong>
493
491
494
<dd>
492
Window title (<strong>-T</strong> still respected); the default title is the basename
495
<p>Window title (<strong>-T</strong> still respected); the default title is the basename
493
496
of the program specified after the <strong>-e</strong> option, if any, otherwise the
494
application name; resource <strong>title</strong>.
497
application name; resource <strong>title</strong>.</p>
495
498
</dd>
496
<p></p>
497
<dt><strong><a name="item__2dn_text"><strong>-n</strong> <em>text</em></a></strong><br />
498
</dt>
499
</li>
500
<dt><strong><a name="item__2dn_text"><strong>-n</strong> <em>text</em></a></strong>
501
499
502
<dd>
500
Icon name; the default name is the basename of the program specified
503
<p>Icon name; the default name is the basename of the program specified
501
504
after the <strong>-e</strong> option, if any, otherwise the application name;
502
resource <strong>iconName</strong>.
503
</dd>
504
<p></p>
505
<dt><strong><a name="item__2dc"><strong>-C</strong></a></strong><br />
506
</dt>
507
<dd>
508
Capture system console messages.
509
</dd>
510
<p></p>
511
<dt><strong><a name="item__2dpt_style"><strong>-pt</strong> <em>style</em></a></strong><br />
512
</dt>
513
<dd>
514
Compile <em>XIM</em>: input style for input method; <strong>OverTheSpot</strong>,
515
<strong>OffTheSpot</strong>, <strong>Root</strong>; resource <strong>preeditType</strong>.
516
</dd>
517
<p></p>
518
<dt><strong><a name="item__2dim_text"><strong>-im</strong> <em>text</em></a></strong><br />
519
</dt>
520
<dd>
521
Compile <em>XIM</em>: input method name. resource <strong>inputMethod</strong>.
522
</dd>
523
<p></p>
524
<dt><strong><a name="item__2dimlocale_string"><strong>-imlocale</strong> <em>string</em></a></strong><br />
525
</dt>
526
<dd>
527
The locale to use for opening the IM. You can use an <code>LC_CTYPE</code> of e.g.
505
resource <strong>iconName</strong>.</p>
506
</dd>
507
</li>
508
<dt><strong><a name="item__2dc"><strong>-C</strong></a></strong>
509
510
<dd>
511
<p>Capture system console messages.</p>
512
</dd>
513
</li>
514
<dt><strong><a name="item__2dpt_style"><strong>-pt</strong> <em>style</em></a></strong>
515
516
<dd>
517
<p>Compile <em>XIM</em>: input style for input method; <strong>OverTheSpot</strong>,
518
<strong>OffTheSpot</strong>, <strong>Root</strong>; resource <strong>preeditType</strong>.</p>
519
</dd>
520
</li>
521
<dt><strong><a name="item__2dim_text"><strong>-im</strong> <em>text</em></a></strong>
522
523
<dd>
524
<p>Compile <em>XIM</em>: input method name. resource <strong>inputMethod</strong>.</p>
525
</dd>
526
</li>
527
<dt><strong><a name="item__2dimlocale_string"><strong>-imlocale</strong> <em>string</em></a></strong>
528
529
<dd>
530
<p>The locale to use for opening the IM. You can use an <code>LC_CTYPE</code> of e.g.
528
531
<code>de_DE.UTF-8</code> for normal text processing but <code>ja_JP.EUC-JP</code> for the
529
532
input extension to be able to input japanese characters while staying in
530
another locale. resource <strong>imLocale</strong>.
531
</dd>
532
<p></p>
533
<dt><strong><a name="item__2dimfont_fontset"><strong>-imfont</strong> <em>fontset</em></a></strong><br />
534
</dt>
535
<dd>
536
Set the font set to use for the X Input Method, see resource <strong>imFont</strong>
537
for more info.
538
</dd>
539
<p></p>
540
<dt><strong><a name="item__2dtcw"><strong>-tcw</strong></a></strong><br />
541
</dt>
542
<dd>
543
Change the meaning of triple-click selection with the left mouse
533
another locale. resource <strong>imLocale</strong>.</p>
534
</dd>
535
</li>
536
<dt><strong><a name="item__2dimfont_fontset"><strong>-imfont</strong> <em>fontset</em></a></strong>
537
538
<dd>
539
<p>Set the font set to use for the X Input Method, see resource <strong>imFont</strong>
540
for more info.</p>
541
</dd>
542
</li>
543
<dt><strong><a name="item__2dtcw"><strong>-tcw</strong></a></strong>
544
545
<dd>
546
<p>Change the meaning of triple-click selection with the left mouse
544
547
button. Instead of selecting a full line it will extend the selection the
545
end of the logical line only. resource <strong>tripleclickwords</strong>.
548
end of the logical line only. resource <strong>tripleclickwords</strong>.</p>
546
549
</dd>
547
<p></p>
548
<dt><strong><a name="item__2dinsecure"><strong>-insecure</strong></a></strong><br />
549
</dt>
550
</li>
551
<dt><strong><a name="item__2dinsecure"><strong>-insecure</strong></a></strong>
552
550
553
<dd>
551
Enable ``insecure'' mode, which currently enables most of the escape
554
<p>Enable ``insecure'' mode, which currently enables most of the escape
552
555
sequences that echo strings. See the resource <strong>insecure</strong> for more
553
info.
556
info.</p>
554
557
</dd>
555
<p></p>
556
<dt><strong><a name="item__2dmod_modifier"><strong>-mod</strong> <em>modifier</em></a></strong><br />
557
</dt>
558
</li>
559
<dt><strong><a name="item__2dmod_modifier"><strong>-mod</strong> <em>modifier</em></a></strong>
560
558
561
<dd>
559
Override detection of Meta modifier with specified key: <strong>alt</strong>,
562
<p>Override detection of Meta modifier with specified key: <strong>alt</strong>,
560
563
<strong>meta</strong>, <strong>hyper</strong>, <strong>super</strong>, <strong>mod1</strong>, <strong>mod2</strong>, <strong>mod3</strong>, <strong>mod4</strong>,
561
<strong>mod5</strong>; resource <em>modifier</em>.
562
</dd>
563
<p></p>
564
<dt><strong><a name="item__2dssc_7c_2bssc"><strong>-ssc</strong>|<strong>+ssc</strong></a></strong><br />
565
</dt>
566
<dd>
567
Turn on/off secondary screen (default enabled); resource
568
<strong>secondaryScreen</strong>.
569
</dd>
570
<p></p>
571
<dt><strong><a name="item__2dssr_7c_2bssr"><strong>-ssr</strong>|<strong>+ssr</strong></a></strong><br />
572
</dt>
573
<dd>
574
Turn on/off secondary screen scroll (default enabled); resource
575
<strong>secondaryScroll</strong>.
576
</dd>
577
<p></p>
578
<dt><strong><a name="item__2dhold_7c_2bhold"><strong>-hold</strong>|<strong>+hold</strong></a></strong><br />
579
</dt>
580
<dd>
581
Turn on/off hold window after exit support. If enabled, rxvt
564
<strong>mod5</strong>; resource <em>modifier</em>.</p>
565
</dd>
566
</li>
567
<dt><strong><a name="item__2dssc_7c_2bssc"><strong>-ssc</strong>|<strong>+ssc</strong></a></strong>
568
569
<dd>
570
<p>Turn on/off secondary screen (default enabled); resource
571
<strong>secondaryScreen</strong>.</p>
572
</dd>
573
</li>
574
<dt><strong><a name="item__2dssr_7c_2bssr"><strong>-ssr</strong>|<strong>+ssr</strong></a></strong>
575
576
<dd>
577
<p>Turn on/off secondary screen scroll (default enabled); resource
578
<strong>secondaryScroll</strong>.</p>
579
</dd>
580
</li>
581
<dt><strong><a name="item__2dhold_7c_2bhold"><strong>-hold</strong>|<strong>+hold</strong></a></strong>
582
583
<dd>
584
<p>Turn on/off hold window after exit support. If enabled, rxvt
582
585
will not immediately destroy its window when the program executed within
583
586
it exits. Instead, it will wait till it is being killed or closed by the
584
user; resource <strong>hold</strong>.
585
</dd>
586
<p></p>
587
<dt><strong><a name="item__2dkeysym_2esym_string"><strong>-keysym.</strong><em>sym</em> <em>string</em></a></strong><br />
588
</dt>
589
<dd>
590
Remap a key symbol. See resource <strong>keysym</strong>.
591
</dd>
592
<p></p>
593
<dt><strong><a name="item__2dembed_windowid"><strong>-embed</strong> <em>windowid</em></a></strong><br />
594
</dt>
595
<dd>
596
Tells rxvt to embed it's windows into an already-existing window,
597
which enables applications to easily embed a terminal.
587
user; resource <strong>hold</strong>.</p>
588
</dd>
589
</li>
590
<dt><strong><a name="item__2dkeysym_2esym_string"><strong>-keysym.</strong><em>sym</em> <em>string</em></a></strong>
591
592
<dd>
593
<p>Remap a key symbol. See resource <strong>keysym</strong>.</p>
594
</dd>
595
</li>
596
<dt><strong><a name="item__2dembed_windowid"><strong>-embed</strong> <em>windowid</em></a></strong>
597
598
<dd>
599
<p>Tells rxvt to embed its windows into an already-existing window,
600
which enables applications to easily embed a terminal.</p>
598
601
</dd>
599
602
<dd>
600
603
<p>Right now, rxvt will first unmap/map the specified window, so it
609
612
<p>It might be useful to know that rxvt will not close file
610
613
descriptors passed to it (except for stdin/out/err, of course), so you
611
614
can use file descriptors to communicate with the programs within the
612
terminal. This works regardless of wether the <code>-embed</code> option was used or
615
terminal. This works regardless of whether the <code>-embed</code> option was used or
613
616
not.</p>
614
617
</dd>
615
618
<dd>
624
627
system "rxvt -embed $xid &";
625
628
});</pre>
626
629
</dd>
627
<p></p>
628
<dt><strong><a name="item__2dpty_2dfd_file_descriptor"><strong>-pty-fd</strong> <em>file descriptor</em></a></strong><br />
629
</dt>
630
</li>
631
<dt><strong><a name="item__2dpty_2dfd_file_descriptor"><strong>-pty-fd</strong> <em>file descriptor</em></a></strong>
632
630
633
<dd>
631
Tells rxvt NOT to execute any commands or create a new pty/tty
632
pair but instead use the given filehandle as the tty master. This is
634
<p>Tells rxvt NOT to execute any commands or create a new pty/tty
635
pair but instead use the given file descriptor as the tty master. This is
633
636
useful if you want to drive rxvt as a generic terminal emulator
634
without having to run a program within it.
637
without having to run a program within it.</p>
635
638
</dd>
636
639
<dd>
637
640
<p>If this switch is given, rxvt will not create any utmp/wtmp
664
667
my $slave = $pty->slave;
665
668
while (<$slave>) { print $slave "got <$_>\n" }</pre>
666
669
</dd>
667
<p></p>
668
<dt><strong><a name="item__2dpe_string"><strong>-pe</strong> <em>string</em></a></strong><br />
669
</dt>
670
</li>
671
<dt><strong><a name="item__2dpe_string"><strong>-pe</strong> <em>string</em></a></strong>
672
670
673
<dd>
671
Comma-separated list of perl extension scripts to use (or not to use) in
672
this terminal instance. See resource <strong>perl-ext</strong> for details.
674
<p>Comma-separated list of perl extension scripts to use (or not to use) in
675
this terminal instance. See resource <strong>perl-ext</strong> for details.</p>
673
676
</dd>
674
<p></p></dl>
677
</li>
678
</dl>
675
679
<p>
676
680
</p>
677
681
<hr />
699
703
check the <code>rxvtperl(3)</code> manpage for additional settings by perl
700
704
extensions not documented here):</p>
701
705
<dl>
702
<dt><strong><a name="item_depth_3a_bitdepth"><strong>depth:</strong> <em>bitdepth</em></a></strong><br />
703
</dt>
704
<dd>
705
Compile <em>xft</em>: Attempt to find a visual with the given bit depth;
706
option <strong>-depth</strong>.
707
</dd>
708
<p></p>
709
<dt><strong><a name="item_geometry_3a_geom"><strong>geometry:</strong> <em>geom</em></a></strong><br />
710
</dt>
711
<dd>
712
Create the window with the specified X window geometry [default 80x24];
713
option <strong>-geometry</strong>.
714
</dd>
715
<p></p>
716
<dt><strong><a name="item_background_3a_colour"><strong>background:</strong> <em>colour</em></a></strong><br />
717
</dt>
718
<dd>
719
Use the specified colour as the window's background colour [default
720
White]; option <strong>-bg</strong>.
721
</dd>
722
<p></p>
723
<dt><strong><a name="item_foreground_3a_colour"><strong>foreground:</strong> <em>colour</em></a></strong><br />
724
</dt>
725
<dd>
726
Use the specified colour as the window's foreground colour [default
727
Black]; option <strong>-fg</strong>.
728
</dd>
729
<p></p>
730
<dt><strong><a name="item_colorn_3a_colour"><strong>color</strong><em>n</em><strong>:</strong> <em>colour</em></a></strong><br />
731
</dt>
732
<dd>
733
Use the specified colour for the colour value <em>n</em>, where 0-7
706
<dt><strong><a name="item_depth_3a_bitdepth"><strong>depth:</strong> <em>bitdepth</em></a></strong>
707
708
<dd>
709
<p>Compile <em>xft</em>: Attempt to find a visual with the given bit depth;
710
option <strong>-depth</strong>.</p>
711
</dd>
712
</li>
713
<dt><strong><a name="item_geometry_3a_geom"><strong>geometry:</strong> <em>geom</em></a></strong>
714
715
<dd>
716
<p>Create the window with the specified X window geometry [default 80x24];
717
option <strong>-geometry</strong>.</p>
718
</dd>
719
</li>
720
<dt><strong><a name="item_background_3a_colour"><strong>background:</strong> <em>colour</em></a></strong>
721
722
<dd>
723
<p>Use the specified colour as the window's background colour [default
724
White]; option <strong>-bg</strong>.</p>
725
</dd>
726
</li>
727
<dt><strong><a name="item_foreground_3a_colour"><strong>foreground:</strong> <em>colour</em></a></strong>
728
729
<dd>
730
<p>Use the specified colour as the window's foreground colour [default
731
Black]; option <strong>-fg</strong>.</p>
732
</dd>
733
</li>
734
<dt><strong><a name="item_colorn_3a_colour"><strong>color</strong><em>n</em><strong>:</strong> <em>colour</em></a></strong>
735
736
<dd>
737
<p>Use the specified colour for the colour value <em>n</em>, where 0-7
734
738
corresponds to low-intensity (normal) colours and 8-15 corresponds to
735
739
high-intensity (bold = bright foreground, blink = bright background)
736
740
colours. The canonical names are as follows: 0=black, 1=red, 2=green,
737
741
3=yellow, 4=blue, 5=magenta, 6=cyan, 7=white, but the actual colour
738
names used are listed in the <strong>COLORS AND GRAPHICS</strong> section.
742
names used are listed in the <strong>COLORS AND GRAPHICS</strong> section.</p>
739
743
</dd>
740
744
<dd>
741
745
<p>Colours higher than 15 cannot be set using resources (yet), but can be
745
749
<p>Colours 16-79 form a standard 4x4x4 colour cube (the same as xterm with
746
750
88 colour support). Colours 80-87 are evenly spaces grey steps.</p>
747
751
</dd>
748
<p></p>
749
<dt><strong><a name="item_colorbd_3a_colour"><strong>colorBD:</strong> <em>colour</em></a></strong><br />
750
</dt>
751
<dt><strong><a name="item_colorit_3a_colour"><strong>colorIT:</strong> <em>colour</em></a></strong><br />
752
</dt>
752
</li>
753
<dt><strong><a name="item_colorbd_3a_colour"><strong>colorBD:</strong> <em>colour</em></a></strong>
754
755
<dt><strong><a name="item_colorit_3a_colour"><strong>colorIT:</strong> <em>colour</em></a></strong>
756
753
757
<dd>
754
Use the specified colour to display bold or italic characters when the
758
<p>Use the specified colour to display bold or italic characters when the
755
759
foreground colour is the default. If font styles are not available
756
(Compile <em>styles</em>) and this option is unset, reverse video is used instead.
757
</dd>
758
<p></p>
759
<dt><strong><a name="item_colorul_3a_colour"><strong>colorUL:</strong> <em>colour</em></a></strong><br />
760
</dt>
761
<dd>
762
Use the specified colour to display underlined characters when the
763
foreground colour is the default.
764
</dd>
765
<p></p>
766
<dt><strong><a name="item_colorrv_3a_colour"><strong>colorRV:</strong> <em>colour</em></a></strong><br />
767
</dt>
768
<dd>
769
Use the specified colour as the background for reverse video
770
characters.
771
</dd>
772
<p></p>
773
<dt><strong><a name="item_underlinecolor_3a_colour"><strong>underlineColor:</strong> <em>colour</em></a></strong><br />
774
</dt>
775
<dd>
776
If set, use the specified colour as the colour for the underline
777
itself. If unset, use the foreground colour.
778
</dd>
779
<p></p>
780
<dt><strong><a name="item_cursorcolor_3a_colour"><strong>cursorColor:</strong> <em>colour</em></a></strong><br />
781
</dt>
782
<dd>
783
Use the specified colour for the cursor. The default is to use the
784
foreground colour; option <strong>-cr</strong>.
785
</dd>
786
<p></p>
787
<dt><strong><a name="item_cursorcolor2_3a_colour"><strong>cursorColor2:</strong> <em>colour</em></a></strong><br />
788
</dt>
789
<dd>
790
Use the specified colour for the colour of the cursor text. For this to
760
(Compile <em>styles</em>) and this option is unset, reverse video is used instead.</p>
761
</dd>
762
</li>
763
<dt><strong><a name="item_colorul_3a_colour"><strong>colorUL:</strong> <em>colour</em></a></strong>
764
765
<dd>
766
<p>Use the specified colour to display underlined characters when the
767
foreground colour is the default.</p>
768
</dd>
769
</li>
770
<dt><strong><a name="item_colorrv_3a_colour"><strong>colorRV:</strong> <em>colour</em></a></strong>
771
772
<dd>
773
<p>Use the specified colour as the background for reverse video
774
characters.</p>
775
</dd>
776
</li>
777
<dt><strong><a name="item_underlinecolor_3a_colour"><strong>underlineColor:</strong> <em>colour</em></a></strong>
778
779
<dd>
780
<p>If set, use the specified colour as the colour for the underline
781
itself. If unset, use the foreground colour.</p>
782
</dd>
783
</li>
784
<dt><strong><a name="item_cursorcolor_3a_colour"><strong>cursorColor:</strong> <em>colour</em></a></strong>
785
786
<dd>
787
<p>Use the specified colour for the cursor. The default is to use the
788
foreground colour; option <strong>-cr</strong>.</p>
789
</dd>
790
</li>
791
<dt><strong><a name="item_cursorcolor2_3a_colour"><strong>cursorColor2:</strong> <em>colour</em></a></strong>
792
793
<dd>
794
<p>Use the specified colour for the colour of the cursor text. For this to
791
795
take effect, <strong>cursorColor</strong> must also be specified. The default is to
792
use the background colour.
796
use the background colour.</p>
793
797
</dd>
794
<p></p>
795
<dt><strong><a name="item_reversevideo_3a_boolean"><strong>reverseVideo:</strong> <em>boolean</em></a></strong><br />
796
</dt>
798
</li>
799
<dt><strong><a name="item_reversevideo_3a_boolean"><strong>reverseVideo:</strong> <em>boolean</em></a></strong>
800
797
801
<dd>
798
<strong>True</strong>: simulate reverse video by foreground and background colours;
802
<p><strong>True</strong>: simulate reverse video by foreground and background colours;
799
803
option <strong>-rv</strong>. <strong>False</strong>: regular screen colours [default]; option
800
<strong>+rv</strong>. See note in <strong>COLORS AND GRAPHICS</strong> section.
804
<strong>+rv</strong>. See note in <strong>COLORS AND GRAPHICS</strong> section.</p>
801
805
</dd>
802
<p></p>
803
<dt><strong><a name="item_jumpscroll_3a_boolean"><strong>jumpScroll:</strong> <em>boolean</em></a></strong><br />
804
</dt>
806
</li>
807
<dt><strong><a name="item_jumpscroll_3a_boolean"><strong>jumpScroll:</strong> <em>boolean</em></a></strong>
808
805
809
<dd>
806
<strong>True</strong>: specify that jump scrolling should be used. When scrolling
810
<p><strong>True</strong>: specify that jump scrolling should be used. When scrolling
807
811
quickly, fewer screen updates are performed [default]; option <strong>-j</strong>.
808
<strong>False</strong>: specify that smooth scrolling should be used; option <strong>+j</strong>.
812
<strong>False</strong>: specify that smooth scrolling should be used; option <strong>+j</strong>.</p>
809
813
</dd>
810
<p></p>
811
<dt><strong><a name="item_inheritpixmap_3a_boolean"><strong>inheritPixmap:</strong> <em>boolean</em></a></strong><br />
812
</dt>
814
</li>
815
<dt><strong><a name="item_inheritpixmap_3a_boolean"><strong>inheritPixmap:</strong> <em>boolean</em></a></strong>
816
813
817
<dd>
814
<strong>True</strong>: make the background inherit the parent windows' pixmap, giving
818
<p><strong>True</strong>: make the background inherit the parent windows' pixmap, giving
815
819
artificial transparency. <strong>False</strong>: do not inherit the parent windows'
816
pixmap.
820
pixmap.</p>
817
821
</dd>
818
822
<dd>
819
823
<p><em>Please note that transparency of any kind if completely unsupported by
820
824
the author. Don't bug him with installation questions!</em></p>
821
825
</dd>
822
<p></p>
823
<dt><strong><a name="item_fading_3a_number"><strong>fading:</strong> <em>number</em></a></strong><br />
824
</dt>
825
<dd>
826
Fade the text by the given percentage when focus is lost; option <strong>-fade</strong>.
827
</dd>
828
<p></p>
829
<dt><strong><a name="item_fadecolor_3a_colour"><strong>fadeColor:</strong> <em>colour</em></a></strong><br />
830
</dt>
831
<dd>
832
Fade to this colour, when fading is used (see <strong>fading:</strong>). The default
833
colour is black; option <strong>-fadecolor</strong>.
834
</dd>
835
<p></p>
836
<dt><strong><a name="item_tintcolor_3a_colour"><strong>tintColor:</strong> <em>colour</em></a></strong><br />
837
</dt>
838
<dd>
839
Tint the transparent background pixmap with the given colour; option
840
<strong>-tint</strong>.
841
</dd>
842
<p></p>
843
<dt><strong><a name="item_shading_3a_number"><strong>shading:</strong> <em>number</em></a></strong><br />
844
</dt>
845
<dd>
846
Darken (0 .. 100) or lighten (-1 .. -100) the transparent background
847
image in addition to tinting it.
848
</dd>
849
<p></p>
850
<dt><strong><a name="item_scrollcolor_3a_colour"><strong>scrollColor:</strong> <em>colour</em></a></strong><br />
851
</dt>
852
<dd>
853
Use the specified colour for the scrollbar [default #B2B2B2].
854
</dd>
855
<p></p>
856
<dt><strong><a name="item_troughcolor_3a_colour"><strong>troughColor:</strong> <em>colour</em></a></strong><br />
857
</dt>
858
<dd>
859
Use the specified colour for the scrollbar's trough area [default
860
#969696]. Only relevant for rxvt (non XTerm/NeXT) scrollbar.
861
</dd>
862
<p></p>
863
<dt><strong><a name="item_bordercolor_3a_colour"><strong>borderColor:</strong> <em>colour</em></a></strong><br />
864
</dt>
865
<dd>
866
The colour of the border around the text area and between the scrollbar
867
and the text.
868
</dd>
869
<p></p>
870
<dt><strong><a name="item_backgroundpixmap_3a_file_5b_3bgeom_5d"><strong>backgroundPixmap:</strong> <em>file[;geom]</em></a></strong><br />
871
</dt>
872
<dd>
873
Use the specified XPM file (note the `.xpm' extension is optional) for
826
</li>
827
<dt><strong><a name="item_fading_3a_number"><strong>fading:</strong> <em>number</em></a></strong>
828
829
<dd>
830
<p>Fade the text by the given percentage when focus is lost; option <strong>-fade</strong>.</p>
831
</dd>
832
</li>
833
<dt><strong><a name="item_fadecolor_3a_colour"><strong>fadeColor:</strong> <em>colour</em></a></strong>
834
835
<dd>
836
<p>Fade to this colour, when fading is used (see <strong>fading:</strong>). The default
837
colour is black; option <strong>-fadecolor</strong>.</p>
838
</dd>
839
</li>
840
<dt><strong><a name="item_tintcolor_3a_colour"><strong>tintColor:</strong> <em>colour</em></a></strong>
841
842
<dd>
843
<p>Tint the transparent background pixmap with the given colour; option
844
<strong>-tint</strong>.</p>
845
</dd>
846
</li>
847
<dt><strong><a name="item_shading_3a_number"><strong>shading:</strong> <em>number</em></a></strong>
848
849
<dd>
850
<p>Darken (0 .. 100) or lighten (-1 .. -100) the transparent background
851
image in addition to tinting it.</p>
852
</dd>
853
</li>
854
<dt><strong><a name="item_scrollcolor_3a_colour"><strong>scrollColor:</strong> <em>colour</em></a></strong>
855
856
<dd>
857
<p>Use the specified colour for the scrollbar [default #B2B2B2].</p>
858
</dd>
859
</li>
860
<dt><strong><a name="item_troughcolor_3a_colour"><strong>troughColor:</strong> <em>colour</em></a></strong>
861
862
<dd>
863
<p>Use the specified colour for the scrollbar's trough area [default
864
#969696]. Only relevant for rxvt (non XTerm/NeXT) scrollbar.</p>
865
</dd>
866
</li>
867
<dt><strong><a name="item_bordercolor_3a_colour"><strong>borderColor:</strong> <em>colour</em></a></strong>
868
869
<dd>
870
<p>The colour of the border around the text area and between the scrollbar
871
and the text.</p>
872
</dd>
873
</li>
874
<dt><strong><a name="item_backgroundpixmap_3a_file_5b_3bgeom_5d"><strong>backgroundPixmap:</strong> <em>file[;geom]</em></a></strong>
875
876
<dd>
877
<p>Use the specified XPM file (note the `.xpm' extension is optional) for
874
878
the background and also optionally specify its scaling with a geometry
875
879
string <strong>WxH+X+Y</strong>, in which <strong>``W'' / ``H''</strong> specify the
876
880
horizontal/vertical scale (percent) and <strong>``X'' / ``Y''</strong> locate the image
878
882
of 1 displays the image without any scaling. A scale of 2 to 9
879
883
specifies an integer number of images in that direction. No image will
880
884
be magnified beyond 10 times its original size. The maximum permitted
881
scale is 1000. [default 0x0+50+50]
882
</dd>
883
<p></p>
884
<dt><strong><a name="item_path_3a_path"><strong>path:</strong> <em>path</em></a></strong><br />
885
</dt>
886
<dd>
887
Specify the colon-delimited search path for finding XPM files.
888
</dd>
889
<p></p>
890
<dt><strong><a name="item_font_3a_fontlist"><strong>font:</strong> <em>fontlist</em></a></strong><br />
891
</dt>
892
<dd>
893
Select the fonts to be used. This is a comma separated list of font names
885
scale is 1000. [default 0x0+50+50]</p>
886
</dd>
887
</li>
888
<dt><strong><a name="item_path_3a_path"><strong>path:</strong> <em>path</em></a></strong>
889
890
<dd>
891
<p>Specify the colon-delimited search path for finding XPM files.</p>
892
</dd>
893
</li>
894
<dt><strong><a name="item_font_3a_fontlist"><strong>font:</strong> <em>fontlist</em></a></strong>
895
896
<dd>
897
<p>Select the fonts to be used. This is a comma separated list of font names
894
898
that are checked in order when trying to find glyphs for characters. The
895
899
first font defines the cell size for characters; other fonts might be
896
900
smaller, but not (in general) larger. A (hopefully) reasonable default
897
font list is always appended to it; option <strong>-fn</strong>.
901
font list is always appended to it; option <strong>-fn</strong>.</p>
898
902
</dd>
899
903
<dd>
900
904
<p>Each font can either be a standard X11 core font (XLFD) name, with
938
942
<p>The last font is a useful catch-all font that supplies most of the
939
943
remaining unicode characters.</p>
940
944
</dd>
941
<p></p>
942
<dt><strong><a name="item_boldfont_3a_fontlist"><strong>boldFont:</strong> <em>fontlist</em></a></strong><br />
943
</dt>
944
<dt><strong><a name="item_italicfont_3a_fontlist"><strong>italicFont:</strong> <em>fontlist</em></a></strong><br />
945
</dt>
946
<dt><strong><a name="item_bolditalicfont_3a_fontlist"><strong>boldItalicFont:</strong> <em>fontlist</em></a></strong><br />
947
</dt>
945
</li>
946
<dt><strong><a name="item_boldfont_3a_fontlist"><strong>boldFont:</strong> <em>fontlist</em></a></strong>
947
948
<dt><strong><a name="item_italicfont_3a_fontlist"><strong>italicFont:</strong> <em>fontlist</em></a></strong>
949
950
<dt><strong><a name="item_bolditalicfont_3a_fontlist"><strong>boldItalicFont:</strong> <em>fontlist</em></a></strong>
951
948
952
<dd>
949
The font list to use for displaying <strong>bold</strong>, <em>italic</em> or <strong><em>bold
950
italic</em> </strong>> characters, respectively.
953
<p>The font list to use for displaying <strong>bold</strong>, <em>italic</em> or <strong><em>bold
954
italic</em> </strong>> characters, respectively.</p>
951
955
</dd>
952
956
<dd>
953
957
<p>If specified and non-empty, then the syntax is the same as for the
964
968
<p>If set, but empty, then this specific style is disabled and the normal
965
969
text font will being used for the given style.</p>
966
970
</dd>
967
<p></p>
968
<dt><strong><a name="item_intensitystyles_3a_boolean"><strong>intensityStyles:</strong> <em>boolean</em></a></strong><br />
969
</dt>
971
</li>
972
<dt><strong><a name="item_intensitystyles_3a_boolean"><strong>intensityStyles:</strong> <em>boolean</em></a></strong>
973
970
974
<dd>
971
When font styles are not enabled, or this option is enabled (<strong>True</strong>,
975
<p>When font styles are not enabled, or this option is enabled (<strong>True</strong>,
972
976
option <strong>-is</strong>, the default), bold and italic font styles imply high
973
intensity foreground/backround colours. Disabling this option (<strong>False</strong>,
977
intensity foreground/background colours. Disabling this option (<strong>False</strong>,
974
978
option <strong>+is</strong>) disables this behaviour, the high intensity colours are not
975
reachable.
979
reachable.</p>
976
980
</dd>
977
<p></p>
978
<dt><strong><a name="item_selectstyle_3a_mode"><strong>selectstyle:</strong> <em>mode</em></a></strong><br />
979
</dt>
981
</li>
982
<dt><strong><a name="item_selectstyle_3a_mode"><strong>selectstyle:</strong> <em>mode</em></a></strong>
983
980
984
<dd>
981
Set mouse selection style to <strong>old</strong> which is 2.20, <strong>oldword</strong> which is
985
<p>Set mouse selection style to <strong>old</strong> which is 2.20, <strong>oldword</strong> which is
982
986
xterm style with 2.20 old word selection, or anything else which gives
983
xterm style selection.
984
</dd>
985
<p></p>
986
<dt><strong><a name="item_scrollstyle_3a_mode"><strong>scrollstyle:</strong> <em>mode</em></a></strong><br />
987
</dt>
988
<dd>
989
Set scrollbar style to <strong>rxvt</strong>, <strong>plain</strong>, <strong>next</strong> or <strong>xterm</strong>. <strong>plain</strong> is
990
the author's favourite.
991
</dd>
992
<p></p>
993
<dt><strong><a name="item_title_3a_string"><strong>title:</strong> <em>string</em></a></strong><br />
994
</dt>
995
<dd>
996
Set window title string, the default title is the command-line
987
xterm style selection.</p>
988
</dd>
989
</li>
990
<dt><strong><a name="item_scrollstyle_3a_mode"><strong>scrollstyle:</strong> <em>mode</em></a></strong>
991
992
<dd>
993
<p>Set scrollbar style to <strong>rxvt</strong>, <strong>plain</strong>, <strong>next</strong> or <strong>xterm</strong>. <strong>plain</strong> is
994
the author's favourite.</p>
995
</dd>
996
</li>
997
<dt><strong><a name="item_title_3a_string"><strong>title:</strong> <em>string</em></a></strong>
998
999
<dd>
1000
<p>Set window title string, the default title is the command-line
997
1001
specified after the <strong>-e</strong> option, if any, otherwise the application
998
name; option <strong>-title</strong>.
1002
name; option <strong>-title</strong>.</p>
999
1003
</dd>
1000
<p></p>
1001
<dt><strong><a name="item_iconname_3a_string"><strong>iconName:</strong> <em>string</em></a></strong><br />
1002
</dt>
1004
</li>
1005
<dt><strong><a name="item_iconname_3a_string"><strong>iconName:</strong> <em>string</em></a></strong>
1006
1003
1007
<dd>
1004
Set the name used to label the window's icon or displayed in an icon
1008
<p>Set the name used to label the window's icon or displayed in an icon
1005
1009
manager window, it also sets the window's title unless it is explicitly
1006
set; option <strong>-n</strong>.
1007
</dd>
1008
<p></p>
1009
<dt><strong><a name="item_mapalert_3a_boolean"><strong>mapAlert:</strong> <em>boolean</em></a></strong><br />
1010
</dt>
1011
<dd>
1012
<strong>True</strong>: de-iconify (map) on receipt of a bell character. <strong>False</strong>: no
1013
de-iconify (map) on receipt of a bell character [default].
1014
</dd>
1015
<p></p>
1016
<dt><strong><a name="item_visualbell_3a_boolean"><strong>visualBell:</strong> <em>boolean</em></a></strong><br />
1017
</dt>
1018
<dd>
1019
<strong>True</strong>: use visual bell on receipt of a bell character; option <strong>-vb</strong>.
1020
<strong>False</strong>: no visual bell [default]; option <strong>+vb</strong>.
1021
</dd>
1022
<p></p>
1023
<dt><strong><a name="item_loginshell_3a_boolean"><strong>loginShell:</strong> <em>boolean</em></a></strong><br />
1024
</dt>
1025
<dd>
1026
<strong>True</strong>: start as a login shell by prepending a `-' to <strong>argv[0]</strong> of
1010
set; option <strong>-n</strong>.</p>
1011
</dd>
1012
</li>
1013
<dt><strong><a name="item_mapalert_3a_boolean"><strong>mapAlert:</strong> <em>boolean</em></a></strong>
1014
1015
<dd>
1016
<p><strong>True</strong>: de-iconify (map) on receipt of a bell character. <strong>False</strong>: no
1017
de-iconify (map) on receipt of a bell character [default].</p>
1018
</dd>
1019
</li>
1020
<dt><strong><a name="item_visualbell_3a_boolean"><strong>visualBell:</strong> <em>boolean</em></a></strong>
1021
1022
<dd>
1023
<p><strong>True</strong>: use visual bell on receipt of a bell character; option <strong>-vb</strong>.
1024
<strong>False</strong>: no visual bell [default]; option <strong>+vb</strong>.</p>
1025
</dd>
1026
</li>
1027
<dt><strong><a name="item_loginshell_3a_boolean"><strong>loginShell:</strong> <em>boolean</em></a></strong>
1028
1029
<dd>
1030
<p><strong>True</strong>: start as a login shell by prepending a `-' to <strong>argv[0]</strong> of
1027
1031
the shell; option <strong>-ls</strong>. <strong>False</strong>: start as a normal sub-shell
1028
[default]; option <strong>+ls</strong>.
1032
[default]; option <strong>+ls</strong>.</p>
1029
1033
</dd>
1030
<p></p>
1031
<dt><strong><a name="item_utmpinhibit_3a_boolean"><strong>utmpInhibit:</strong> <em>boolean</em></a></strong><br />
1032
</dt>
1034
</li>
1035
<dt><strong><a name="item_utmpinhibit_3a_boolean"><strong>utmpInhibit:</strong> <em>boolean</em></a></strong>
1036
1033
1037
<dd>
1034
<strong>True</strong>: inhibit writing record into the system log file <strong>utmp</strong>;
1038
<p><strong>True</strong>: inhibit writing record into the system log file <strong>utmp</strong>;
1035
1039
option <strong>-ut</strong>. <strong>False</strong>: write record into the system log file <strong>utmp</strong>
1036
[default]; option <strong>+ut</strong>.
1040
[default]; option <strong>+ut</strong>.</p>
1037
1041
</dd>
1038
<p></p>
1039
<dt><strong><a name="item_print_2dpipe_3a_string"><strong>print-pipe:</strong> <em>string</em></a></strong><br />
1040
</dt>
1042
</li>
1043
<dt><strong><a name="item_print_2dpipe_3a_string"><strong>print-pipe:</strong> <em>string</em></a></strong>
1044
1041
1045
<dd>
1042
Specify a command pipe for vt100 printer [default <em>lpr(1)</em>]. Use
1046
<p>Specify a command pipe for vt100 printer [default <em>lpr(1)</em>]. Use
1043
1047
<strong>Print</strong> to initiate a screen dump to the printer and <strong>Ctrl-Print</strong> or
1044
<strong>Shift-Print</strong> to include the scrollback as well.
1048
<strong>Shift-Print</strong> to include the scrollback as well.</p>
1045
1049
</dd>
1046
1050
<dd>
1047
1051
<p>The string will be interpreted as if typed into the shell as-is.</p>
1055
1059
</dd>
1056
1060
<dd>
1057
1061
<p>This creates a new file in your home directory with the screen contents
1058
everytime you hit <code>Print</code>.</p>
1059
</dd>
1060
<p></p>
1061
<dt><strong><a name="item_scrollbar_3a_boolean"><strong>scrollBar:</strong> <em>boolean</em></a></strong><br />
1062
</dt>
1063
<dd>
1064
<strong>True</strong>: enable the scrollbar [default]; option <strong>-sb</strong>. <strong>False</strong>:
1065
disable the scrollbar; option <strong>+sb</strong>.
1066
</dd>
1067
<p></p>
1068
<dt><strong><a name="item_scrollbar_right_3a_boolean"><strong>scrollBar_right:</strong> <em>boolean</em></a></strong><br />
1069
</dt>
1070
<dd>
1071
<strong>True</strong>: place the scrollbar on the right of the window; option <strong>-sr</strong>.
1072
<strong>False</strong>: place the scrollbar on the left of the window; option <strong>+sr</strong>.
1073
</dd>
1074
<p></p>
1075
<dt><strong><a name="item_scrollbar_floating_3a_boolean"><strong>scrollBar_floating:</strong> <em>boolean</em></a></strong><br />
1076
</dt>
1077
<dd>
1078
<strong>True</strong>: display an rxvt scrollbar without a trough; option <strong>-st</strong>.
1079
<strong>False</strong>: display an rxvt scrollbar with a trough; option <strong>+st</strong>.
1080
</dd>
1081
<p></p>
1082
<dt><strong><a name="item_scrollbar_align_3a_mode"><strong>scrollBar_align:</strong> <em>mode</em></a></strong><br />
1083
</dt>
1084
<dd>
1085
Align the <strong>top</strong>, <strong>bottom</strong> or <strong>centre</strong> [default] of the scrollbar
1086
thumb with the pointer on middle button press/drag.
1087
</dd>
1088
<p></p>
1089
<dt><strong><a name="item_scrollttyoutput_3a_boolean"><strong>scrollTtyOutput:</strong> <em>boolean</em></a></strong><br />
1090
</dt>
1091
<dd>
1092
<strong>True</strong>: scroll to bottom when tty receives output; option <strong>-si</strong>.
1062
every time you hit <code>Print</code>.</p>
1063
</dd>
1064
</li>
1065
<dt><strong><a name="item_scrollbar_3a_boolean"><strong>scrollBar:</strong> <em>boolean</em></a></strong>
1066
1067
<dd>
1068
<p><strong>True</strong>: enable the scrollbar [default]; option <strong>-sb</strong>. <strong>False</strong>:
1069
disable the scrollbar; option <strong>+sb</strong>.</p>
1070
</dd>
1071
</li>
1072
<dt><strong><a name="item_scrollbar_right_3a_boolean"><strong>scrollBar_right:</strong> <em>boolean</em></a></strong>
1073
1074
<dd>
1075
<p><strong>True</strong>: place the scrollbar on the right of the window; option <strong>-sr</strong>.
1076
<strong>False</strong>: place the scrollbar on the left of the window; option <strong>+sr</strong>.</p>
1077
</dd>
1078
</li>
1079
<dt><strong><a name="item_scrollbar_floating_3a_boolean"><strong>scrollBar_floating:</strong> <em>boolean</em></a></strong>
1080
1081
<dd>
1082
<p><strong>True</strong>: display an rxvt scrollbar without a trough; option <strong>-st</strong>.
1083
<strong>False</strong>: display an rxvt scrollbar with a trough; option <strong>+st</strong>.</p>
1084
</dd>
1085
</li>
1086
<dt><strong><a name="item_scrollbar_align_3a_mode"><strong>scrollBar_align:</strong> <em>mode</em></a></strong>
1087
1088
<dd>
1089
<p>Align the <strong>top</strong>, <strong>bottom</strong> or <strong>centre</strong> [default] of the scrollbar
1090
thumb with the pointer on middle button press/drag.</p>
1091
</dd>
1092
</li>
1093
<dt><strong><a name="item_scrollttyoutput_3a_boolean"><strong>scrollTtyOutput:</strong> <em>boolean</em></a></strong>
1094
1095
<dd>
1096
<p><strong>True</strong>: scroll to bottom when tty receives output; option <strong>-si</strong>.
1093
1097
<strong>False</strong>: do not scroll to bottom when tty receives output; option
1094
<strong>+si</strong>.
1098
<strong>+si</strong>.</p>
1095
1099
</dd>
1096
<p></p>
1097
<dt><strong><a name="item_scrollwithbuffer_3a_boolean"><strong>scrollWithBuffer:</strong> <em>boolean</em></a></strong><br />
1098
</dt>
1100
</li>
1101
<dt><strong><a name="item_scrollwithbuffer_3a_boolean"><strong>scrollWithBuffer:</strong> <em>boolean</em></a></strong>
1102
1099
1103
<dd>
1100
<strong>True</strong>: scroll with scrollback buffer when tty receives new lines (and
1104
<p><strong>True</strong>: scroll with scrollback buffer when tty receives new lines (and
1101
1105
<strong>scrollTtyOutput</strong> is False); option <strong>-sw</strong>. <strong>False</strong>: do not scroll
1102
with scrollback buffer when tty recieves new lines; option <strong>+sw</strong>.
1106
with scrollback buffer when tty receives new lines; option <strong>+sw</strong>.</p>
1103
1107
</dd>
1104
<p></p>
1105
<dt><strong><a name="item_scrollttykeypress_3a_boolean"><strong>scrollTtyKeypress:</strong> <em>boolean</em></a></strong><br />
1106
</dt>
1108
</li>
1109
<dt><strong><a name="item_scrollttykeypress_3a_boolean"><strong>scrollTtyKeypress:</strong> <em>boolean</em></a></strong>
1110
1107
1111
<dd>
1108
<strong>True</strong>: scroll to bottom when a non-special key is pressed. Special keys
1112
<p><strong>True</strong>: scroll to bottom when a non-special key is pressed. Special keys
1109
1113
are those which are intercepted by rxvt-unicode for special handling and
1110
1114
are not passed onto the shell; option <strong>-sk</strong>. <strong>False</strong>: do not scroll to
1111
bottom when a non-special key is pressed; option <strong>+sk</strong>.
1112
</dd>
1113
<p></p>
1114
<dt><strong><a name="item_savelines_3a_number"><strong>saveLines:</strong> <em>number</em></a></strong><br />
1115
</dt>
1116
<dd>
1117
Save <em>number</em> lines in the scrollback buffer [default 64]. This
1118
resource is limited on most machines to 65535; option <strong>-sl</strong>.
1119
</dd>
1120
<p></p>
1121
<dt><strong><a name="item_internalborder_3a_number"><strong>internalBorder:</strong> <em>number</em></a></strong><br />
1122
</dt>
1123
<dd>
1124
Internal border of <em>number</em> pixels. This resource is limited to 100;
1125
option <strong>-b</strong>.
1126
</dd>
1127
<p></p>
1128
<dt><strong><a name="item_externalborder_3a_number"><strong>externalBorder:</strong> <em>number</em></a></strong><br />
1129
</dt>
1130
<dd>
1131
External border of <em>number</em> pixels. This resource is limited to 100;
1132
option <strong>-w</strong>, <strong>-bw</strong>, <strong>-borderwidth</strong>.
1133
</dd>
1134
<p></p>
1135
<dt><strong><a name="item_borderless_3a_boolean"><strong>borderLess:</strong> <em>boolean</em></a></strong><br />
1136
</dt>
1137
<dd>
1138
Set MWM hints to request a borderless window, i.e. if honoured by the
1139
WM, the rxvt-unicode window will not have window decorations; option <strong>-bl</strong>.
1140
</dd>
1141
<p></p>
1142
<dt><strong><a name="item_skipbuiltinglyphs_3a_boolean"><strong>skipBuiltinGlyphs:</strong> <em>boolean</em></a></strong><br />
1143
</dt>
1144
<dd>
1145
Compile <em>frills</em>: Disable the usage of the built-in block graphics/line
1115
bottom when a non-special key is pressed; option <strong>+sk</strong>.</p>
1116
</dd>
1117
</li>
1118
<dt><strong><a name="item_savelines_3a_number"><strong>saveLines:</strong> <em>number</em></a></strong>
1119
1120
<dd>
1121
<p>Save <em>number</em> lines in the scrollback buffer [default 64]. This
1122
resource is limited on most machines to 65535; option <strong>-sl</strong>.</p>
1123
</dd>
1124
</li>
1125
<dt><strong><a name="item_internalborder_3a_number"><strong>internalBorder:</strong> <em>number</em></a></strong>
1126
1127
<dd>
1128
<p>Internal border of <em>number</em> pixels. This resource is limited to 100;
1129
option <strong>-b</strong>.</p>
1130
</dd>
1131
</li>
1132
<dt><strong><a name="item_externalborder_3a_number"><strong>externalBorder:</strong> <em>number</em></a></strong>
1133
1134
<dd>
1135
<p>External border of <em>number</em> pixels. This resource is limited to 100;
1136
option <strong>-w</strong>, <strong>-bw</strong>, <strong>-borderwidth</strong>.</p>
1137
</dd>
1138
</li>
1139
<dt><strong><a name="item_borderless_3a_boolean"><strong>borderLess:</strong> <em>boolean</em></a></strong>
1140
1141
<dd>
1142
<p>Set MWM hints to request a borderless window, i.e. if honoured by the
1143
WM, the rxvt-unicode window will not have window decorations; option <strong>-bl</strong>.</p>
1144
</dd>
1145
</li>
1146
<dt><strong><a name="item_skipbuiltinglyphs_3a_boolean"><strong>skipBuiltinGlyphs:</strong> <em>boolean</em></a></strong>
1147
1148
<dd>
1149
<p>Compile <em>frills</em>: Disable the usage of the built-in block graphics/line
1146
1150
drawing characters and just rely on what the specified fonts provide. Use
1147
1151
this if you have a good font and want to use its block graphic glyphs;
1148
option <strong>-sbg</strong>.
1149
</dd>
1150
<p></p>
1151
<dt><strong><a name="item_termname_3a_termname"><strong>termName:</strong> <em>termname</em></a></strong><br />
1152
</dt>
1153
<dd>
1154
Specifies the terminal type name to be set in the <strong>TERM</strong> environment
1155
variable; option <strong>-tn</strong>.
1156
</dd>
1157
<p></p>
1158
<dt><strong><a name="item_linespace_3a_number"><strong>linespace:</strong> <em>number</em></a></strong><br />
1159
</dt>
1160
<dd>
1161
Specifies number of lines (pixel height) to insert between each row of
1162
the display [default 0]; option <strong>-lsp</strong>.
1163
</dd>
1164
<p></p>
1165
<dt><strong><a name="item_meta8_3a_boolean"><strong>meta8:</strong> <em>boolean</em></a></strong><br />
1166
</dt>
1167
<dd>
1168
<strong>True</strong>: handle Meta (Alt) + keypress to set the 8th bit. <strong>False</strong>:
1169
handle Meta (Alt) + keypress as an escape prefix [default].
1170
</dd>
1171
<p></p>
1172
<dt><strong><a name="item_mousewheelscrollpage_3a_boolean"><strong>mouseWheelScrollPage:</strong> <em>boolean</em></a></strong><br />
1173
</dt>
1174
<dd>
1175
<strong>True</strong>: the mouse wheel scrolls a page full. <strong>False</strong>: the mouse wheel
1176
scrolls five lines [default].
1177
</dd>
1178
<p></p>
1179
<dt><strong><a name="item_pastabletabs_3a_boolean"><strong>pastableTabs:</strong> <em>boolean</em></a></strong><br />
1180
</dt>
1181
<dd>
1182
<strong>True</strong>: store tabs as wide characters. <strong>False</strong>: interpret tabs as cursor
1183
movement only; option <code>-ptab</code>.
1184
</dd>
1185
<p></p>
1186
<dt><strong><a name="item_cursorblink_3a_boolean"><strong>cursorBlink:</strong> <em>boolean</em></a></strong><br />
1187
</dt>
1188
<dd>
1189
<strong>True</strong>: blink the cursor. <strong>False</strong>: do not blink the cursor [default];
1190
option <strong>-bc</strong>.
1191
</dd>
1192
<p></p>
1193
<dt><strong><a name="item_pointerblank_3a_boolean"><strong>pointerBlank:</strong> <em>boolean</em></a></strong><br />
1194
</dt>
1195
<dd>
1196
<strong>True</strong>: blank the pointer when a key is pressed or after a set number
1152
option <strong>-sbg</strong>.</p>
1153
</dd>
1154
</li>
1155
<dt><strong><a name="item_termname_3a_termname"><strong>termName:</strong> <em>termname</em></a></strong>
1156
1157
<dd>
1158
<p>Specifies the terminal type name to be set in the <strong>TERM</strong> environment
1159
variable; option <strong>-tn</strong>.</p>
1160
</dd>
1161
</li>
1162
<dt><strong><a name="item_linespace_3a_number"><strong>linespace:</strong> <em>number</em></a></strong>
1163
1164
<dd>
1165
<p>Specifies number of lines (pixel height) to insert between each row of
1166
the display [default 0]; option <strong>-lsp</strong>.</p>
1167
</dd>
1168
</li>
1169
<dt><strong><a name="item_meta8_3a_boolean"><strong>meta8:</strong> <em>boolean</em></a></strong>
1170
1171
<dd>
1172
<p><strong>True</strong>: handle Meta (Alt) + keypress to set the 8th bit. <strong>False</strong>:
1173
handle Meta (Alt) + keypress as an escape prefix [default].</p>
1174
</dd>
1175
</li>
1176
<dt><strong><a name="item_mousewheelscrollpage_3a_boolean"><strong>mouseWheelScrollPage:</strong> <em>boolean</em></a></strong>
1177
1178
<dd>
1179
<p><strong>True</strong>: the mouse wheel scrolls a page full. <strong>False</strong>: the mouse wheel
1180
scrolls five lines [default].</p>
1181
</dd>
1182
</li>
1183
<dt><strong><a name="item_pastabletabs_3a_boolean"><strong>pastableTabs:</strong> <em>boolean</em></a></strong>
1184
1185
<dd>
1186
<p><strong>True</strong>: store tabs as wide characters. <strong>False</strong>: interpret tabs as cursor
1187
movement only; option <code>-ptab</code>.</p>
1188
</dd>
1189
</li>
1190
<dt><strong><a name="item_cursorblink_3a_boolean"><strong>cursorBlink:</strong> <em>boolean</em></a></strong>
1191
1192
<dd>
1193
<p><strong>True</strong>: blink the cursor. <strong>False</strong>: do not blink the cursor [default];
1194
option <strong>-bc</strong>.</p>
1195
</dd>
1196
</li>
1197
<dt><strong><a name="item_pointerblank_3a_boolean"><strong>pointerBlank:</strong> <em>boolean</em></a></strong>
1198
1199
<dd>
1200
<p><strong>True</strong>: blank the pointer when a key is pressed or after a set number
1197
1201
of seconds of inactivity. <strong>False</strong>: the pointer is always visible
1198
[default].
1199
</dd>
1200
<p></p>
1201
<dt><strong><a name="item_pointercolor_3a_colour"><strong>pointerColor:</strong> <em>colour</em></a></strong><br />
1202
</dt>
1203
<dd>
1204
Mouse pointer foreground colour.
1205
</dd>
1206
<p></p>
1207
<dt><strong><a name="item_pointercolor2_3a_colour"><strong>pointerColor2:</strong> <em>colour</em></a></strong><br />
1208
</dt>
1209
<dd>
1210
Mouse pointer background colour.
1211
</dd>
1212
<p></p>
1213
<dt><strong><a name="item_pointerblankdelay_3a_number"><strong>pointerBlankDelay:</strong> <em>number</em></a></strong><br />
1214
</dt>
1215
<dd>
1216
Specifies number of seconds before blanking the pointer [default 2]. Use a
1217
large number (e.g. <code>987654321</code>) to effectively disable the timeout.
1218
</dd>
1219
<p></p>
1220
<dt><strong><a name="item_backspacekey_3a_string"><strong>backspacekey:</strong> <em>string</em></a></strong><br />
1221
</dt>
1222
<dd>
1223
The string to send when the backspace key is pressed. If set to <strong>DEC</strong>
1202
[default].</p>
1203
</dd>
1204
</li>
1205
<dt><strong><a name="item_pointercolor_3a_colour"><strong>pointerColor:</strong> <em>colour</em></a></strong>
1206
1207
<dd>
1208
<p>Mouse pointer foreground colour.</p>
1209
</dd>
1210
</li>
1211
<dt><strong><a name="item_pointercolor2_3a_colour"><strong>pointerColor2:</strong> <em>colour</em></a></strong>
1212
1213
<dd>
1214
<p>Mouse pointer background colour.</p>
1215
</dd>
1216
</li>
1217
<dt><strong><a name="item_pointerblankdelay_3a_number"><strong>pointerBlankDelay:</strong> <em>number</em></a></strong>
1218
1219
<dd>
1220
<p>Specifies number of seconds before blanking the pointer [default 2]. Use a
1221
large number (e.g. <code>987654321</code>) to effectively disable the timeout.</p>
1222
</dd>
1223
</li>
1224
<dt><strong><a name="item_backspacekey_3a_string"><strong>backspacekey:</strong> <em>string</em></a></strong>
1225
1226
<dd>
1227
<p>The string to send when the backspace key is pressed. If set to <strong>DEC</strong>
1224
1228
or unset it will send <strong>Delete</strong> (code 127) or, if shifted, <strong>Backspace</strong>
1225
1229
(code 8) - which can be reversed with the appropriate DEC private mode
1226
escape sequence.
1230
escape sequence.</p>
1227
1231
</dd>
1228
<p></p>
1229
<dt><strong><a name="item_deletekey_3a_string"><strong>deletekey:</strong> <em>string</em></a></strong><br />
1230
</dt>
1232
</li>
1233
<dt><strong><a name="item_deletekey_3a_string"><strong>deletekey:</strong> <em>string</em></a></strong>
1234
1231
1235
<dd>
1232
The string to send when the delete key (not the keypad delete key) is
1236
<p>The string to send when the delete key (not the keypad delete key) is
1233
1237
pressed. If unset it will send the sequence traditionally associated
1234
with the <strong>Execute</strong> key.
1238
with the <strong>Execute</strong> key.</p>
1235
1239
</dd>
1236
<p></p>
1237
<dt><strong><a name="item_cutchars_3a_string"><strong>cutchars:</strong> <em>string</em></a></strong><br />
1238
</dt>
1240
</li>
1241
<dt><strong><a name="item_cutchars_3a_string"><strong>cutchars:</strong> <em>string</em></a></strong>
1242
1239
1243
<dd>
1240
The characters used as delimiters for double-click word selection
1241
(whitespace delimiting is added automatically if resource is given).
1244
<p>The characters used as delimiters for double-click word selection
1245
(whitespace delimiting is added automatically if resource is given).</p>
1242
1246
</dd>
1243
1247
<dd>
1244
1248
<p>When the selection extension is in use (the default if compiled in, see
1253
1257
<dd>
1254
1258
<p><strong>BACKSLASH ```'&()*,;<=</strong>?@[]{|} >></p>
1255
1259
</dd>
1256
<p></p>
1257
<dt><strong><a name="item_preedittype_3a_style"><strong>preeditType:</strong> <em>style</em></a></strong><br />
1258
</dt>
1259
<dd>
1260
<strong>OverTheSpot</strong>, <strong>OffTheSpot</strong>, <strong>Root</strong>; option <strong>-pt</strong>.
1261
</dd>
1262
<p></p>
1263
<dt><strong><a name="item_inputmethod_3a_name"><strong>inputMethod:</strong> <em>name</em></a></strong><br />
1264
</dt>
1265
<dd>
1266
<em>name</em> of inputMethod to use; option <strong>-im</strong>.
1267
</dd>
1268
<p></p>
1269
<dt><strong><a name="item_imlocale_3a_name"><strong>imLocale:</strong> <em>name</em></a></strong><br />
1270
</dt>
1271
<dd>
1272
The locale to use for opening the IM. You can use an <code>LC_CTYPE</code> of e.g.
1260
</li>
1261
<dt><strong><a name="item_preedittype_3a_style"><strong>preeditType:</strong> <em>style</em></a></strong>
1262
1263
<dd>
1264
<p><strong>OverTheSpot</strong>, <strong>OffTheSpot</strong>, <strong>Root</strong>; option <strong>-pt</strong>.</p>
1265
</dd>
1266
</li>
1267
<dt><strong><a name="item_inputmethod_3a_name"><strong>inputMethod:</strong> <em>name</em></a></strong>
1268
1269
<dd>
1270
<p><em>name</em> of inputMethod to use; option <strong>-im</strong>.</p>
1271
</dd>
1272
</li>
1273
<dt><strong><a name="item_imlocale_3a_name"><strong>imLocale:</strong> <em>name</em></a></strong>
1274
1275
<dd>
1276
<p>The locale to use for opening the IM. You can use an <code>LC_CTYPE</code> of e.g.
1273
1277
<code>de_DE.UTF-8</code> for normal text processing but <code>ja_JP.EUC-JP</code> for the
1274
1278
input extension to be able to input japanese characters while staying in
1275
another locale; option <strong>-imlocale</strong>.
1279
another locale; option <strong>-imlocale</strong>.</p>
1276
1280
</dd>
1277
<p></p>
1278
<dt><strong><a name="item_imfont_3a_fontset"><strong>imFont:</strong> <em>fontset</em></a></strong><br />
1279
</dt>
1281
</li>
1282
<dt><strong><a name="item_imfont_3a_fontset"><strong>imFont:</strong> <em>fontset</em></a></strong>
1283
1280
1284
<dd>
1281
Specify the font-set used for XIM styles <code>OverTheSpot</code> or
1285
<p>Specify the font-set used for XIM styles <code>OverTheSpot</code> or
1282
1286
<code>OffTheSpot</code>. It must be a standard X font set (XLFD patterns separated
1283
1287
by commas), i.e. it's not in the same format as the other font lists used
1284
1288
in rxvt. The default will be set-up to chose *any* suitable found
1285
1289
found, preferably one or two pixels differing in size to the base font.
1286
option <strong>-imfont</strong>.
1290
option <strong>-imfont</strong>.</p>
1287
1291
</dd>
1288
<p></p>
1289
<dt><strong><a name="item_tripleclickwords_3a_boolean"><strong>tripleclickwords:</strong> <em>boolean</em></a></strong><br />
1290
</dt>
1292
</li>
1293
<dt><strong><a name="item_tripleclickwords_3a_boolean"><strong>tripleclickwords:</strong> <em>boolean</em></a></strong>
1294
1291
1295
<dd>
1292
Change the meaning of triple-click selection with the left mouse
1296
<p>Change the meaning of triple-click selection with the left mouse
1293
1297
button. Instead of selecting a full line it will extend the selection to
1294
the end of the logical line only; option <strong>-tcw</strong>.
1298
the end of the logical line only; option <strong>-tcw</strong>.</p>
1295
1299
</dd>
1296
<p></p>
1297
<dt><strong><a name="item_insecure_3a_boolean"><strong>insecure:</strong> <em>boolean</em></a></strong><br />
1298
</dt>
1300
</li>
1301
<dt><strong><a name="item_insecure_3a_boolean"><strong>insecure:</strong> <em>boolean</em></a></strong>
1302
1299
1303
<dd>
1300
Enables ``insecure'' mode. Rxvt-unicode offers some escape sequences that
1304
<p>Enables ``insecure'' mode. Rxvt-unicode offers some escape sequences that
1301
1305
echo arbitrary strings like the icon name or the locale. This could be
1302
1306
abused if somebody gets 8-bit-clean access to your display, whether
1303
1307
through a mail client displaying mail bodies unfiltered or through
1304
1308
<code>write(1)</code> or any other means. Therefore, these sequences are disabled by
1305
1309
default. (Note that many other terminals, including xterm, have these
1306
sequences enabled by default, which doesn't make it safer, though).
1310
sequences enabled by default, which doesn't make it safer, though).</p>
1307
1311
</dd>
1308
1312
<dd>
1309
1313
<p>You can enable them by setting this boolean resource or specifying
1310
1314
<strong>-insecure</strong> as an option. At the moment, this enables display-answer,
1311
1315
locale, findfont, icon label and window title requests.</p>
1312
1316
</dd>
1313
<p></p>
1314
<dt><strong><a name="item_modifier_3a_modifier"><strong>modifier:</strong> <em>modifier</em></a></strong><br />
1315
</dt>
1317
</li>
1318
<dt><strong><a name="item_modifier_3a_modifier"><strong>modifier:</strong> <em>modifier</em></a></strong>
1319
1316
1320
<dd>
1317
Set the key to be interpreted as the Meta key to: <strong>alt</strong>, <strong>meta</strong>,
1321
<p>Set the key to be interpreted as the Meta key to: <strong>alt</strong>, <strong>meta</strong>,
1318
1322
<strong>hyper</strong>, <strong>super</strong>, <strong>mod1</strong>, <strong>mod2</strong>, <strong>mod3</strong>, <strong>mod4</strong>, <strong>mod5</strong>; option
1319
<strong>-mod</strong>.
1323
<strong>-mod</strong>.</p>
1320
1324
</dd>
1321
<p></p>
1322
<dt><strong><a name="item_answerbackstring_3a_string"><strong>answerbackString:</strong> <em>string</em></a></strong><br />
1323
</dt>
1325
</li>
1326
<dt><strong><a name="item_answerbackstring_3a_string"><strong>answerbackString:</strong> <em>string</em></a></strong>
1327
1324
1328
<dd>
1325
Specify the reply rxvt-unicode sends to the shell when an ENQ (control-E)
1329
<p>Specify the reply rxvt-unicode sends to the shell when an ENQ (control-E)
1326
1330
character is passed through. It may contain escape values as described
1327
in the entry on <strong>keysym</strong> following.
1328
</dd>
1329
<p></p>
1330
<dt><strong><a name="item_secondaryscreen_3a_boolean"><strong>secondaryScreen:</strong> <em>boolean</em></a></strong><br />
1331
</dt>
1332
<dd>
1333
Turn on/off secondary screen (default enabled).
1334
</dd>
1335
<p></p>
1336
<dt><strong><a name="item_secondaryscroll_3a_boolean"><strong>secondaryScroll:</strong> <em>boolean</em></a></strong><br />
1337
</dt>
1338
<dd>
1339
Turn on/off secondary screen scroll (default enabled). If the this
1331
in the entry on <strong>keysym</strong> following.</p>
1332
</dd>
1333
</li>
1334
<dt><strong><a name="item_secondaryscreen_3a_boolean"><strong>secondaryScreen:</strong> <em>boolean</em></a></strong>
1335
1336
<dd>
1337
<p>Turn on/off secondary screen (default enabled).</p>
1338
</dd>
1339
</li>
1340
<dt><strong><a name="item_secondaryscroll_3a_boolean"><strong>secondaryScroll:</strong> <em>boolean</em></a></strong>
1341
1342
<dd>
1343
<p>Turn on/off secondary screen scroll (default enabled). If the this
1340
1344
option is enabled, scrolls on the secondary screen will change the
1341
1345
scrollback buffer and switching to/from the secondary screen will
1342
instead scroll the screen up.
1346
instead scroll the screen up.</p>
1343
1347
</dd>
1344
<p></p>
1345
<dt><strong><a name="item_hold_3a_boolean"><strong>hold</strong>: <em>boolean</em></a></strong><br />
1346
</dt>
1348
</li>
1349
<dt><strong><a name="item_hold_3a_boolean"><strong>hold</strong>: <em>boolean</em></a></strong>
1350
1347
1351
<dd>
1348
Turn on/off hold window after exit support. If enabled, rxvt
1352
<p>Turn on/off hold window after exit support. If enabled, rxvt
1349
1353
will not immediately destroy its window when the program executed within
1350
1354
it exits. Instead, it will wait till it is being killed or closed by the
1351
user.
1355
user.</p>
1352
1356
</dd>
1353
<p></p>
1354
<dt><strong><a name="item_keysym_2esym_3a_string"><strong>keysym.</strong><em>sym</em>: <em>string</em></a></strong><br />
1355
</dt>
1357
</li>
1358
<dt><strong><a name="item_keysym_2esym_3a_string"><strong>keysym.</strong><em>sym</em>: <em>string</em></a></strong>
1359
1356
1360
<dd>
1357
Compile <em>frills</em>: Associate <em>string</em> with keysym <em>sym</em>. The
1358
intervening resource name <strong>keysym.</strong> cannot be omitted.
1361
<p>Compile <em>frills</em>: Associate <em>string</em> with keysym <em>sym</em>. The
1362
intervening resource name <strong>keysym.</strong> cannot be omitted.</p>
1359
1363
</dd>
1360
1364
<dd>
1361
1365
<p>The format of <em>sym</em> is ``<em>(modifiers-)key</em>'', where <em>modifiers</em> can be
1386
1390
</dd>
1387
1391
<dd>
1388
1392
<p>Please note that you need to double the <code>\</code> in resource files, as
1389
Xlib itself does it's own de-escaping (you can use <code>\033</code> instead of
1393
Xlib itself does its own de-escaping (you can use <code>\033</code> instead of
1390
1394
<code>\e</code> (and so on), which will work with both Xt and rxvt's own
1391
1395
processing).</p>
1392
1396
</dd>
1393
1397
<dd>
1394
1398
<p>You can define a range of keysyms in one shot by providing a <em>string</em>
1395
with pattern <strong>list/PREFIX/MIDDLE/SUFFIX</strong>, where the delimeter `/'
1399
with pattern <strong>list/PREFIX/MIDDLE/SUFFIX</strong>, where the delimiter `/'
1396
1400
should be a character not used by the strings.</p>
1397
1401
</dd>
1398
1402
<dd>
1474
1478
URxvt.keysym.M-C-3: command:\033[8;25;80t
1475
1479
URxvt.keysym.M-C-4: command:\033[8;48;110t</pre>
1476
1480
</dd>
1477
<p></p>
1478
<dt><strong><a name="item_perl_2dext_2dcommon_3a_string"><strong>perl-ext-common</strong>: <em>string</em></a></strong><br />
1479
</dt>
1480
<dt><strong><a name="item_perl_2dext_3a_string"><strong>perl-ext</strong>: <em>string</em></a></strong><br />
1481
</dt>
1481
</li>
1482
<dt><strong><a name="item_perl_2dext_2dcommon_3a_string"><strong>perl-ext-common</strong>: <em>string</em></a></strong>
1483
1484
<dt><strong><a name="item_perl_2dext_3a_string"><strong>perl-ext</strong>: <em>string</em></a></strong>
1485
1482
1486
<dd>
1483
Comma-separated <code>list(s)</code> of perl extension scripts (default: <code>default</code>) to
1484
use in this terminal instance; option <strong>-pe</strong>.
1487
<p>Comma-separated <code>list(s)</code> of perl extension scripts (default: <code>default</code>) to
1488
use in this terminal instance; option <strong>-pe</strong>.</p>
1485
1489
</dd>
1486
1490
<dd>
1487
1491
<p>Extension names can be prefixed with a <code>-</code> sign to prohibit using
1493
1497
<dd>
1494
1498
<p>Extension names can also be followed by an argument in angle brackets
1495
1499
(e.g. <code>searchable-scrollback<M-s></code>, which binds the hotkey for
1496
searchable scorllback to Alt/Meta-s). Mentioning the same extension
1500
searchable scrollback to Alt/Meta-s). Mentioning the same extension
1497
1501
multiple times with different arguments will pass multiple arguments to
1498
1502
the extension.</p>
1499
1503
</dd>
1507
1511
<strong>perl-ext-common</strong> will be used for extensions that should be available to
1508
1512
all instances, while <strong>perl-ext</strong> is used for specific instances.</p>
1509
1513
</dd>
1510
<p></p>
1511
<dt><strong><a name="item_perl_2deval_3a_string"><strong>perl-eval</strong>: <em>string</em></a></strong><br />
1512
</dt>
1514
</li>
1515
<dt><strong><a name="item_perl_2deval_3a_string"><strong>perl-eval</strong>: <em>string</em></a></strong>
1516
1513
1517
<dd>
1514
Perl code to be evaluated when all extensions have been registered. See
1518
<p>Perl code to be evaluated when all extensions have been registered. See
1515
1519
the <code>rxvtperl(3)</code> manpage. Due to security reasons, this resource
1516
will be ignored when running setuid/setgid.
1520
will be ignored when running setuid/setgid.</p>
1517
1521
</dd>
1518
<p></p>
1519
<dt><strong><a name="item_perl_2dlib_3a_path"><strong>perl-lib</strong>: <em>path</em></a></strong><br />
1520
</dt>
1522
</li>
1523
<dt><strong><a name="item_perl_2dlib_3a_path"><strong>perl-lib</strong>: <em>path</em></a></strong>
1524
1521
1525
<dd>
1522
Colon-separated list of additional directories that hold extension
1526
<p>Colon-separated list of additional directories that hold extension
1523
1527
scripts. When looking for extensions specified by the <code>perl</code> resource,
1524
1528
rxvt will first look in these directories and then in
1525
1529
<em>/opt/rxvt/lib/urxvt/perl/</em>. Due to security reasons, this resource
1526
will be ignored when running setuid/setgid.
1530
will be ignored when running setuid/setgid.</p>
1527
1531
</dd>
1528
1532
<dd>
1529
1533
<p>See the <code>rxvtperl(3)</code> manpage.</p>
1530
1534
</dd>
1531
<p></p>
1532
<dt><strong><a name="item_selection_2epattern_2didx_3a_perl_2dregex"><strong>selection.pattern-<em>idx</em> </strong>>: <em>perl-regex</em></a></strong><br />
1533
</dt>
1534
<dd>
1535
Additional selection patterns, see the <code>rxvtperl(3)</code> manpage for
1536
details.
1537
</dd>
1538
<p></p>
1539
<dt><strong><a name="item_selection_2dautotransform_2eidx_3a_perl_2dtransfor"><strong>selection-autotransform.<em>idx</em> </strong>>: <em>perl-transform</em></a></strong><br />
1540
</dt>
1541
<dd>
1542
Selection auto-transform patterns, see the <code>rxvtperl(3)</code> manpage
1543
for details.
1544
</dd>
1545
<p></p>
1546
<dt><strong><a name="item_searchable_2dscrollback_3a_keysym"><strong>searchable-scrollback:</strong> <em>keysym</em></a></strong><br />
1547
</dt>
1548
<dd>
1549
Sets the hotkey that starts the incremental scrollback buffer search
1550
(default: <code>M-s</code>).
1551
</dd>
1552
<p></p>
1553
<dt><strong><a name="item_urllauncher_3a_string"><strong>urlLauncher</strong>: <em>string</em></a></strong><br />
1554
</dt>
1555
<dd>
1556
Specifies the program to be started with a URL argument. Used by the
1557
<code>selection-popup</code> and <code>mark-urls</code> perl extensions.
1558
</dd>
1559
<p></p>
1560
<dt><strong><a name="item_transient_2dfor_3a_windowid"><strong>transient-for</strong>: <em>windowid</em></a></strong><br />
1561
</dt>
1562
<dd>
1563
Compile <em>frills</em>: Sets the WM_TRANSIENT_FOR property to the given window id.
1564
</dd>
1565
<p></p>
1566
<dt><strong><a name="item_override_2dredirect_3a_boolean"><strong>override-redirect</strong>: <em>boolean</em></a></strong><br />
1567
</dt>
1568
<dd>
1569
Compile <em>frills</em>: Sets override-redirect for the terminal window, making
1570
it almost invisible to window managers; option <strong>-override-redirect</strong>.
1571
</dd>
1572
<p></p></dl>
1535
</li>
1536
<dt><strong><a name="item_selection_2epattern_2didx_3a_perl_2dregex"><strong>selection.pattern-<em>idx</em> </strong>>: <em>perl-regex</em></a></strong>
1537
1538
<dd>
1539
<p>Additional selection patterns, see the <code>rxvtperl(3)</code> manpage for
1540
details.</p>
1541
</dd>
1542
</li>
1543
<dt><strong><a name="item_selection_2dautotransform_2eidx_3a_perl_2dtransfor"><strong>selection-autotransform.<em>idx</em> </strong>>: <em>perl-transform</em></a></strong>
1544
1545
<dd>
1546
<p>Selection auto-transform patterns, see the <code>rxvtperl(3)</code> manpage
1547
for details.</p>
1548
</dd>
1549
</li>
1550
<dt><strong><a name="item_searchable_2dscrollback_3a_keysym"><strong>searchable-scrollback:</strong> <em>keysym</em></a></strong>
1551
1552
<dd>
1553
<p>Sets the hotkey that starts the incremental scrollback buffer search
1554
(default: <code>M-s</code>).</p>
1555
</dd>
1556
</li>
1557
<dt><strong><a name="item_urllauncher_3a_string"><strong>urlLauncher</strong>: <em>string</em></a></strong>
1558
1559
<dd>
1560
<p>Specifies the program to be started with a URL argument. Used by the
1561
<code>selection-popup</code> and <code>mark-urls</code> perl extensions.</p>
1562
</dd>
1563
</li>
1564
<dt><strong><a name="item_transient_2dfor_3a_windowid"><strong>transient-for</strong>: <em>windowid</em></a></strong>
1565
1566
<dd>
1567
<p>Compile <em>frills</em>: Sets the WM_TRANSIENT_FOR property to the given window id.</p>
1568
</dd>
1569
</li>
1570
<dt><strong><a name="item_override_2dredirect_3a_boolean"><strong>override-redirect</strong>: <em>boolean</em></a></strong>
1571
1572
<dd>
1573
<p>Compile <em>frills</em>: Sets override-redirect for the terminal window, making
1574
it almost invisible to window managers; option <strong>-override-redirect</strong>.</p>
1575
</dd>
1576
</li>
1577
</dl>
1573
1578
<p>
1574
1579
</p>
1575
1580
<hr />
1602
1607
<p>The behaviour of text selection and insertion mechanism is similar to
1603
1608
<em>xterm</em>(1).</p>
1604
1609
<dl>
1605
<dt><strong><a name="item_selection_3a"><strong>Selection</strong>:</a></strong><br />
1606
</dt>
1610
<dt><strong><a name="item_selection_3a"><strong>Selection</strong>:</a></strong>
1611
1607
1612
<dd>
1608
Left click at the beginning of the region, drag to the end of the region
1613
<p>Left click at the beginning of the region, drag to the end of the region
1609
1614
and release; Right click to extend the marked region; Left double-click
1610
1615
to select a word; Left triple-click to select the entire logical line
1611
1616
(which can span multiple screen lines), unless modified by resource
1612
<strong>tripleclickwords</strong>.
1617
<strong>tripleclickwords</strong>.</p>
1613
1618
</dd>
1614
1619
<dd>
1615
1620
<p>Starting a selection while pressing the <strong>Meta</strong> key (or <strong>Meta+Ctrl</strong> keys)
1618
1623
selection, and trailing whitespace is visually underlined and removed from
1619
1624
the selection.</p>
1620
1625
</dd>
1621
<p></p>
1622
<dt><strong><a name="item_insertion_3a"><strong>Insertion</strong>:</a></strong><br />
1623
</dt>
1626
</li>
1627
<dt><strong><a name="item_insertion_3a"><strong>Insertion</strong>:</a></strong>
1628
1624
1629
<dd>
1625
Pressing and releasing the Middle mouse button in an <strong>rxvt</strong>
1630
<p>Pressing and releasing the Middle mouse button in an <strong>rxvt</strong>
1626
1631
window causes the value of the PRIMARY selection (or CLIPBOARD with the
1627
Meta modifier) to be inserted as if it had been typed on the keyboard.
1632
Meta modifier) to be inserted as if it had been typed on the keyboard.</p>
1628
1633
</dd>
1629
1634
<dd>
1630
1635
<p>Pressing <strong>Shift-Insert</strong> causes the value of the PRIMARY selection to be
1631
1636
inserted too.</p>
1632
1637
</dd>
1633
<p></p></dl>
1638
</li>
1639
</dl>
1634
1640
<p>
1635
1641
</p>
1636
1642
<hr />
1655
1661
<code>--enable-frills</code>, the rest is available when rxvt-unicode was compiled
1656
1662
with <code>--enable-iso14755</code>.</p>
1657
1663
<ul>
1658
<li><strong><a name="item_5_2e1_3a_basic_method">5.1: Basic method</a></strong><br />
1659
</li>
1660
This allows you to enter unicode characters using their hexcode.
1664
<li><strong><a name="item_5_2e1_3a_basic_method">5.1: Basic method</a></strong>
1665
1666
<p>This allows you to enter unicode characters using their hexcode.</p>
1661
1667
<p>Start by pressing and holding both <code>Control</code> and <code>Shift</code>, then enter
1662
1668
hex-digits (between one and six). Releasing <code>Control</code> and <code>Shift</code> will
1663
1669
commit the character as if it were typed directly. While holding down
1669
1675
address printed as hexcodes, e.g. <code>671d 65e5</code>. You can enter this easily
1670
1676
by pressing <code>Control</code> and <code>Shift</code>, followed by <code>6-7-1-D-SPACE-6-5-E-5</code>,
1671
1677
followed by releasing the modifier keys.</p>
1672
<p></p>
1673
<li><strong><a name="item_5_2e2_3a_keyboard_symbols_entry_method">5.2: Keyboard symbols entry method</a></strong><br />
1674
1678
</li>
1675
This mode lets you input characters representing the keycap symbols of
1676
your keyboard, if representable in the current locale encoding.
1679
<li><strong><a name="item_5_2e2_3a_keyboard_symbols_entry_method">5.2: Keyboard symbols entry method</a></strong>
1680
1681
<p>This mode lets you input characters representing the keycap symbols of
1682
your keyboard, if representable in the current locale encoding.</p>
1677
1683
<p>Start by pressing <code>Control</code> and <code>Shift</code> together, then releasing
1678
1684
them. The next special key (cursor keys, home etc.) you enter will not
1679
invoke it's usual function but instead will insert the corresponding
1685
invoke its usual function but instead will insert the corresponding
1680
1686
keycap symbol. The symbol will only be entered when the key has been
1681
1687
released, otherwise pressing e.g. <code>Shift</code> would enter the symbol for
1682
1688
<code>ISO Level 2 Switch</code>, although your intention might have been to enter a
1683
1689
reverse tab (Shift-Tab).</p>
1684
<p></p>
1685
<li><strong><a name="item_5_2e3_3a_screen_2dselection_entry_method">5.3: Screen-selection entry method</a></strong><br />
1686
</li>
1687
While this is implemented already (it's basically the selection
1688
mechanism), it could be extended by displaying a unicode character map.
1689
<p></p>
1690
<li><strong><a name="item_5_2e4_3a_feedback_method_for_identifying_displayed">5.4: Feedback method for identifying displayed characters for later input</a></strong><br />
1691
</li>
1692
This method lets you display the unicode character code associated with
1693
characters already displayed.
1690
</li>
1691
<li><strong><a name="item_5_2e3_3a_screen_2dselection_entry_method">5.3: Screen-selection entry method</a></strong>
1692
1693
<p>While this is implemented already (it's basically the selection
1694
mechanism), it could be extended by displaying a unicode character map.</p>
1695
</li>
1696
<li><strong><a name="item_5_2e4_3a_feedback_method_for_identifying_displayed">5.4: Feedback method for identifying displayed characters for later input</a></strong>
1697
1698
<p>This method lets you display the unicode character code associated with
1699
characters already displayed.</p>
1694
1700
<p>You enter this mode by holding down <code>Control</code> and <code>Shift</code> together, then
1695
1701
pressing and holding the left mouse button and moving around. The unicode
1696
1702
hex <code>code(s)</code> (it might be a combining character) of the character under the
1699
1705
character - due to implementation reasons, characters combined with
1700
1706
combining characters, line drawing characters and unknown characters will
1701
1707
always be drawn using the built-in support font.</p>
1702
<p></p></ul>
1708
</li>
1709
</ul>
1703
1710
<p>With respect to conformance, rxvt-unicode is supposed to be compliant to
1704
1711
both scenario A and B of ISO 14755, including part 5.2.</p>
1705
1712
<p>
1753
1760
<em>xterm</em>(1) where the colours are only swapped if they have not otherwise
1754
1761
been specified. For example,</p>
1755
1762
<dl>
1756
<dt><strong><a name="item_rxvt__2dfg_black__2dbg_white__2drv"><strong>rxvt -fg Black -bg White -rv</strong></a></strong><br />
1757
</dt>
1763
<dt><strong><a name="item_rxvt__2dfg_black__2dbg_white__2drv"><strong>rxvt -fg Black -bg White -rv</strong></a></strong>
1764
1758
1765
<dd>
1759
would yield White on Black, while on <em>xterm</em>(1) it would yield Black
1760
on White.
1766
<p>would yield White on Black, while on <em>xterm</em>(1) it would yield Black
1767
on White.</p>
1761
1768
</dd>
1762
<p></p></dl>
1769
</li>
1770
</dl>
1763
1771
<p>
1764
1772
</p>
1765
1773
<h2><a name="alpha_channel_support">ALPHA CHANNEL SUPPORT</a></h2>
1785
1793
<h1><a name="environment">ENVIRONMENT</a></h1>
1786
1794
<p><strong>rxvt</strong> sets and/or uses the following environment variables:</p>
1787
1795
<dl>
1788
<dt><strong><a name="item_term"><strong>TERM</strong></a></strong><br />
1789
</dt>
1796
<dt><strong><a name="item_term"><strong>TERM</strong></a></strong>
1797
1790
1798
<dd>
1791
Normally set to <code>rxvt-unicode</code>, unless overwritten at configure time, via
1792
resources or on the commandline.
1799
<p>Normally set to <code>rxvt-unicode</code>, unless overwritten at configure time, via
1800
resources or on the command line.</p>
1793
1801
</dd>
1794
<p></p>
1795
<dt><strong><a name="item_colorterm"><strong>COLORTERM</strong></a></strong><br />
1796
</dt>
1802
</li>
1803
<dt><strong><a name="item_colorterm"><strong>COLORTERM</strong></a></strong>
1804
1797
1805
<dd>
1798
Either <code>rxvt</code>, <code>rxvt-xpm</code>, depending on wether rxvt was
1806
<p>Either <code>rxvt</code>, <code>rxvt-xpm</code>, depending on whether rxvt was
1799
1807
compiled with XPM support, and optionally with the added extension
1800
<code>-mono</code> to indicate that rxvt-unicode runs on a monochrome screen.
1808
<code>-mono</code> to indicate that rxvt-unicode runs on a monochrome screen.</p>
1801
1809
</dd>
1802
<p></p>
1803
<dt><strong><a name="item_colorfgbg"><strong>COLORFGBG</strong></a></strong><br />
1804
</dt>
1810
</li>
1811
<dt><strong><a name="item_colorfgbg"><strong>COLORFGBG</strong></a></strong>
1812
1805
1813
<dd>
1806
Set to a string of the form <code>fg;bg</code> or <code>fg;xpm;bg</code>, where <code>fg</code> is
1814
<p>Set to a string of the form <code>fg;bg</code> or <code>fg;xpm;bg</code>, where <code>fg</code> is
1807
1815
the colour code used as default foreground/text colour (or the string
1808
1816
<code>default</code> to indicate that the default-colour escape sequence is to be
1809
1817
used), <code>bg</code> is the colour code used as default background colour (or the
1810
1818
string <code>default</code>), and <code>xpm</code> is the string <code>default</code> if rxvt
1811
1819
was compiled with XPM support. Libraries like <code>ncurses</code> and <code>slang</code> can
1812
(and do) use this information to optimize screen output.
1820
(and do) use this information to optimize screen output.</p>
1813
1821
</dd>
1814
<p></p>
1815
<dt><strong><a name="item_windowid"><strong>WINDOWID</strong></a></strong><br />
1816
</dt>
1822
</li>
1823
<dt><strong><a name="item_windowid"><strong>WINDOWID</strong></a></strong>
1824
1817
1825
<dd>
1818
Set to the (decimal) X Window ID of the rxvt window (the toplevel
1826
<p>Set to the (decimal) X Window ID of the rxvt window (the toplevel
1819
1827
window, which usually has subwindows for the scrollbar, the terminal
1820
window and so on).
1821
</dd>
1822
<p></p>
1823
<dt><strong><a name="item_terminfo"><strong>TERMINFO</strong></a></strong><br />
1824
</dt>
1825
<dd>
1826
Set to the terminfo directory iff rxvt was configured with
1827
<code>--with-terminfo=PATH</code>.
1828
</dd>
1829
<p></p>
1830
<dt><strong><a name="item_display"><strong>DISPLAY</strong></a></strong><br />
1831
</dt>
1832
<dd>
1833
Used by rxvt to connect to the display and set to the correct
1834
display in it's child processes.
1835
</dd>
1836
<p></p>
1837
<dt><strong><a name="item_shell"><strong>SHELL</strong></a></strong><br />
1838
</dt>
1839
<dd>
1840
The shell to be used for command execution, defaults to <code>/bin/sh</code>.
1841
</dd>
1842
<p></p>
1843
<dt><strong><a name="item_rxvt_socket"><strong>RXVT_SOCKET</strong></a></strong><br />
1844
</dt>
1845
<dd>
1846
The unix domain socket path used by <code>rxvtc(1)</code> and
1847
rxvtd(1).
1828
window and so on).</p>
1829
</dd>
1830
</li>
1831
<dt><strong><a name="item_terminfo"><strong>TERMINFO</strong></a></strong>
1832
1833
<dd>
1834
<p>Set to the terminfo directory iff rxvt was configured with
1835
<code>--with-terminfo=PATH</code>.</p>
1836
</dd>
1837
</li>
1838
<dt><strong><a name="item_display"><strong>DISPLAY</strong></a></strong>
1839
1840
<dd>
1841
<p>Used by rxvt to connect to the display and set to the correct
1842
display in its child processes.</p>
1843
</dd>
1844
</li>
1845
<dt><strong><a name="item_shell"><strong>SHELL</strong></a></strong>
1846
1847
<dd>
1848
<p>The shell to be used for command execution, defaults to <code>/bin/sh</code>.</p>
1849
</dd>
1850
</li>
1851
<dt><strong><a name="item_rxvt_socket"><strong>RXVT_SOCKET</strong></a></strong>
1852
1853
<dd>
1854
<p>The unix domain socket path used by <code>rxvtc(1)</code> and
1855
rxvtd(1).</p>
1848
1856
</dd>
1849
1857
<dd>
1850
1858
<p>Default <em>$HOME/.rxvt-unicode-<em><nodename </em></em> >>>.</p>
1851
1859
</dd>
1852
<p></p>
1853
<dt><strong><a name="item_home"><strong>HOME</strong></a></strong><br />
1854
</dt>
1860
</li>
1861
<dt><strong><a name="item_home"><strong>HOME</strong></a></strong>
1862
1855
1863
<dd>
1856
Used to locate the default directory for the unix domain socket for
1864
<p>Used to locate the default directory for the unix domain socket for
1857
1865
daemon communications and to locate various resource files (such as
1858
<code>.Xdefaults</code>)
1859
</dd>
1860
<p></p>
1861
<dt><strong><a name="item_xapplresdir"><strong>XAPPLRESDIR</strong></a></strong><br />
1862
</dt>
1863
<dd>
1864
Directory where various X resource files are being located.
1865
</dd>
1866
<p></p>
1867
<dt><strong><a name="item_xenvironment"><strong>XENVIRONMENT</strong></a></strong><br />
1868
</dt>
1869
<dd>
1870
If set and accessible, gives the name of a X resource file to be loaded by
1871
rxvt.
1872
</dd>
1873
<p></p></dl>
1866
<code>.Xdefaults</code>)</p>
1867
</dd>
1868
</li>
1869
<dt><strong><a name="item_xapplresdir"><strong>XAPPLRESDIR</strong></a></strong>
1870
1871
<dd>
1872
<p>Directory where various X resource files are being located.</p>
1873
</dd>
1874
</li>
1875
<dt><strong><a name="item_xenvironment"><strong>XENVIRONMENT</strong></a></strong>
1876
1877
<dd>
1878
<p>If set and accessible, gives the name of a X resource file to be loaded by
1879
rxvt.</p>
1880
</dd>
1881
</li>
1882
</dl>
1874
1883
<p>
1875
1884
</p>
1876
1885
<hr />
1877
1886
<h1><a name="files">FILES</a></h1>
1878
1887
<dl>
1879
<dt><strong><a name="item__2fusr_2flib_2fx11_2frgb_2etxt"><strong>/usr/lib/X11/rgb.txt</strong></a></strong><br />
1880
</dt>
1888
<dt><strong><a name="item__2fusr_2flib_2fx11_2frgb_2etxt"><strong>/usr/lib/X11/rgb.txt</strong></a></strong>
1889
1881
1890
<dd>
1882
Color names.
1891
<p>Color names.</p>
1883
1892
</dd>
1884
<p></p></dl>
1893
</li>
1894
</dl>
1885
1895
<p>
1886
1896
</p>
1887
1897
<hr />
1892
1902
<hr />
1893
1903
<h1><a name="current_project_coordinator">CURRENT PROJECT COORDINATOR</a></h1>
1894
1904
<dl>
1895
<dt><strong><a name="item_project_coordinator">Project Coordinator</a></strong><br />
1896
</dt>
1897
<dd>
1898
Marc A. Lehmann <em><a href="mailto:<rxvt-unicode@schmorp.de"><rxvt-unicode@schmorp.de</a></em>>
1899
</dd>
1900
<dd>
1901
<p><a href="http://software.schmorp.de/#rxvt-unicode">http://software.schmorp.de/#rxvt-unicode</a></p>
1902
</dd>
1903
<p></p></dl>
1905
<dt><strong><a name="item_project_coordinator">Project Coordinator</a></strong>
1906
1907
<dd>
1908
<p>Marc A. Lehmann <em><a href="mailto:<rxvt-unicode@schmorp.de"><rxvt-unicode@schmorp.de</a></em>></p>
1909
</dd>
1910
<dd>
1911
<p><a href="http://software.schmorp.de/pkg/rxvt-unicode.html">http://software.schmorp.de/pkg/rxvt-unicode.html</a></p>
1912
</dd>
1913
</li>
1914
</dl>
1904
1915
<p>
1905
1916
</p>
1906
1917
<hr />
1907
1918
<h1><a name="authors">AUTHORS</a></h1>
1908
1919
<dl>
1909
<dt><strong><a name="item_john_bovey">John Bovey</a></strong><br />
1910
</dt>
1911
<dd>
1912
University of Kent, 1992, wrote the original Xvt.
1913
</dd>
1914
<p></p>
1915
<dt><strong><a name="item_rob_nation__3cnation_40rocket_2esanders_2elockheed">Rob Nation <em><a href="mailto:<nation@rocket.sanders.lockheed.com"><nation@rocket.sanders.lockheed.com</a></em>></a></strong><br />
1916
</dt>
1917
<dd>
1918
very heavily modified Xvt and came up with Rxvt
1919
</dd>
1920
<p></p>
1921
<dt><strong><a name="item_angelo_haritsis__3cah_40doc_2eic_2eac_2euk_3e">Angelo Haritsis <em><a href="mailto:<ah@doc.ic.ac.uk"><ah@doc.ic.ac.uk</a></em>></a></strong><br />
1922
</dt>
1923
<dd>
1924
wrote the Greek Keyboard Input (no longer in code)
1925
</dd>
1926
<p></p>
1927
<dt><strong><a name="item_mj_olesen__3colesen_40me_2equeensu_2eca_3e">mj olesen <em><a href="mailto:<olesen@me.QueensU.CA"><olesen@me.QueensU.CA</a></em>></a></strong><br />
1928
</dt>
1929
<dd>
1930
Wrote the menu system.
1920
<dt><strong><a name="item_john_bovey">John Bovey</a></strong>
1921
1922
<dd>
1923
<p>University of Kent, 1992, wrote the original Xvt.</p>
1924
</dd>
1925
</li>
1926
<dt><strong><a name="item_rob_nation__3cnation_40rocket_2esanders_2elockheed">Rob Nation <em><a href="mailto:<nation@rocket.sanders.lockheed.com"><nation@rocket.sanders.lockheed.com</a></em>></a></strong>
1927
1928
<dd>
1929
<p>very heavily modified Xvt and came up with Rxvt</p>
1930
</dd>
1931
</li>
1932
<dt><strong><a name="item_angelo_haritsis__3cah_40doc_2eic_2eac_2euk_3e">Angelo Haritsis <em><a href="mailto:<ah@doc.ic.ac.uk"><ah@doc.ic.ac.uk</a></em>></a></strong>
1933
1934
<dd>
1935
<p>wrote the Greek Keyboard Input (no longer in code)</p>
1936
</dd>
1937
</li>
1938
<dt><strong><a name="item_mj_olesen__3colesen_40me_2equeensu_2eca_3e">mj olesen <em><a href="mailto:<olesen@me.QueensU.CA"><olesen@me.QueensU.CA</a></em>></a></strong>
1939
1940
<dd>
1941
<p>Wrote the menu system.</p>
1931
1942
</dd>
1932
1943
<dd>
1933
1944
<p>Project Coordinator (changes.txt 2.11 to 2.21)</p>
1934
1945
</dd>
1935
<p></p>
1936
<dt><strong><a name="item_oezguer_kesim__3ckesim_40math_2efu_2dberlin_2ede_3">Oezguer Kesim <em><a href="mailto:<kesim@math.fu-berlin.de"><kesim@math.fu-berlin.de</a></em>></a></strong><br />
1937
</dt>
1946
</li>
1947
<dt><strong><a name="item_oezguer_kesim__3ckesim_40math_2efu_2dberlin_2ede_3">Oezguer Kesim <em><a href="mailto:<kesim@math.fu-berlin.de"><kesim@math.fu-berlin.de</a></em>></a></strong>
1948
1938
1949
<dd>
1939
Project Coordinator (changes.txt 2.21a to 2.4.5)
1950
<p>Project Coordinator (changes.txt 2.21a to 2.4.5)</p>
1940
1951
</dd>
1941
<p></p>
1942
<dt><strong><a name="item_geoff_wing__3cgcw_40pobox_2ecom_3e">Geoff Wing <em><a href="mailto:<gcw@pobox.com"><gcw@pobox.com</a></em>></a></strong><br />
1943
</dt>
1952
</li>
1953
<dt><strong><a name="item_geoff_wing__3cgcw_40pobox_2ecom_3e">Geoff Wing <em><a href="mailto:<gcw@pobox.com"><gcw@pobox.com</a></em>></a></strong>
1954
1944
1955
<dd>
1945
Rewrote screen display and text selection routines.
1946
1956
<p>Rewrote screen display and text selection routines.
1957
</p>
1947
1958
</dd>
1948
1959
<dd>
1949
1960
<pre>
1950
1961
1951
1962
Project Coordinator (changes.txt 2.4.6 - rxvt-unicode)</pre>
1952
1963
</dd>
1953
<p></p>
1954
<dt><strong><a name="item_marc_alexander_lehmann__3crxvt_2dunicode_40schmorp">Marc Alexander Lehmann <em><a href="mailto:<rxvt-unicode@schmorp.de"><rxvt-unicode@schmorp.de</a></em>></a></strong><br />
1955
</dt>
1964
</li>
1965
<dt><strong><a name="item_marc_alexander_lehmann__3crxvt_2dunicode_40schmorp">Marc Alexander Lehmann <em><a href="mailto:<rxvt-unicode@schmorp.de"><rxvt-unicode@schmorp.de</a></em>></a></strong>
1966
1956
1967
<dd>
1957
Forked rxvt-unicode, unicode support, rewrote almost all the code, perl
1958
extension, random hacks, numerous bugfixes and extensions.
1968
<p>Forked rxvt-unicode, unicode support, rewrote almost all the code, perl
1969
extension, random hacks, numerous bugfixes and extensions.</p>
1959
1970
</dd>
1960
1971
<dd>
1961
1972
<p>Project Coordinator (Changes 1.0 -)</p>
1962
1973
</dd>
1963
<p></p>
1964
<dt><strong><a name="item_emanuele_giaquinta__3ce_2egiaquinta_40glauco_2eit_">Emanuele Giaquinta <em><a href="mailto:<e.giaquinta@glauco.it"><e.giaquinta@glauco.it</a></em>></a></strong><br />
1965
</dt>
1974
</li>
1975
<dt><strong><a name="item_emanuele_giaquinta__3ce_2egiaquinta_40glauco_2eit_">Emanuele Giaquinta <em><a href="mailto:<e.giaquinta@glauco.it"><e.giaquinta@glauco.it</a></em>></a></strong>
1976
1966
1977
<dd>
1967
Pty/tty/utmp/wtmp rewrite, lots of random hacking and bugfixing.
1978
<p>Pty/tty/utmp/wtmp rewrite, lots of random hacking and bugfixing.</p>
1968
1979
</dd>
1969
<p></p></dl>
1980
</li>
1981
</dl>
1970
1982
1971
1983
</body>
1972
1984
Loggerhead is a web-based interface for Breezy
Version: 2.0.1