ViewVC Help
View File | Revision Log | Show Annotations | Download File
/cvs/rxvt-unicode/doc/rxvt.1.man.in
Revision: 1.61
Committed: Thu Jul 6 19:43:21 2006 UTC (18 years ago) by root
Branch: MAIN
Changes since 1.60: +10 -10 lines
Log Message:
*** empty log message ***

File Contents

# User Rev Content
1 root 1.60 .\" Automatically generated by Pod::Man 2.09 (Pod::Simple 3.04)
2 root 1.1 .\"
3     .\" Standard preamble:
4     .\" ========================================================================
5     .de Sh \" Subsection heading
6     .br
7     .if t .Sp
8     .ne 5
9     .PP
10     \fB\\$1\fR
11     .PP
12     ..
13     .de Sp \" Vertical space (when we can't use .PP)
14     .if t .sp .5v
15     .if n .sp
16     ..
17     .de Vb \" Begin verbatim text
18     .ft CW
19     .nf
20     .ne \\$1
21     ..
22     .de Ve \" End verbatim text
23     .ft R
24     .fi
25     ..
26     .\" Set up some character translations and predefined strings. \*(-- will
27     .\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
28     .\" double quote, and \*(R" will give a right double quote. | will give a
29     .\" real vertical bar. \*(C+ will give a nicer C++. Capital omega is used to
30     .\" do unbreakable dashes and therefore won't be available. \*(C` and \*(C'
31     .\" expand to `' in nroff, nothing in troff, for use with C<>.
32     .tr \(*W-|\(bv\*(Tr
33     .ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
34     .ie n \{\
35     . ds -- \(*W-
36     . ds PI pi
37     . if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
38     . if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch
39     . ds L" ""
40     . ds R" ""
41 root 1.12 . ds C` ""
42     . ds C' ""
43 root 1.1 'br\}
44     .el\{\
45     . ds -- \|\(em\|
46     . ds PI \(*p
47     . ds L" ``
48     . ds R" ''
49     'br\}
50     .\"
51     .\" If the F register is turned on, we'll generate index entries on stderr for
52     .\" titles (.TH), headers (.SH), subsections (.Sh), items (.Ip), and index
53     .\" entries marked with X<> in POD. Of course, you'll have to process the
54     .\" output yourself in some meaningful fashion.
55     .if \nF \{\
56     . de IX
57     . tm Index:\\$1\t\\n%\t"\\$2"
58     ..
59     . nr % 0
60     . rr F
61     .\}
62     .\"
63     .\" For nroff, turn off justification. Always turn off hyphenation; it makes
64     .\" way too many mistakes in technical documents.
65     .hy 0
66     .if n .na
67     .\"
68     .\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
69     .\" Fear. Run. Save yourself. No user-serviceable parts.
70     . \" fudge factors for nroff and troff
71     .if n \{\
72     . ds #H 0
73     . ds #V .8m
74     . ds #F .3m
75     . ds #[ \f1
76     . ds #] \fP
77     .\}
78     .if t \{\
79     . ds #H ((1u-(\\\\n(.fu%2u))*.13m)
80     . ds #V .6m
81     . ds #F 0
82     . ds #[ \&
83     . ds #] \&
84     .\}
85     . \" simple accents for nroff and troff
86     .if n \{\
87     . ds ' \&
88     . ds ` \&
89     . ds ^ \&
90     . ds , \&
91     . ds ~ ~
92     . ds /
93     .\}
94     .if t \{\
95     . ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
96     . ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
97     . ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
98     . ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
99     . ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
100     . ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
101     .\}
102     . \" troff and (daisy-wheel) nroff accents
103     .ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
104     .ds 8 \h'\*(#H'\(*b\h'-\*(#H'
105     .ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
106     .ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
107     .ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
108     .ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
109     .ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
110     .ds ae a\h'-(\w'a'u*4/10)'e
111     .ds Ae A\h'-(\w'A'u*4/10)'E
112     . \" corrections for vroff
113     .if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
114     .if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
115     . \" for low resolution devices (crt and lpr)
116     .if \n(.H>23 .if \n(.V>19 \
117     \{\
118     . ds : e
119     . ds 8 ss
120     . ds o a
121     . ds d- d\h'-1'\(ga
122     . ds D- D\h'-1'\(hy
123     . ds th \o'bp'
124     . ds Th \o'LP'
125     . ds ae ae
126     . ds Ae AE
127     .\}
128     .rm #[ #] #H #V #F C
129     .\" ========================================================================
130     .\"
131 root 1.61 .IX Title "@@RXVT_NAME@@ 1"
132     .TH @@RXVT_NAME@@ 1 "2006-07-06" "7.7" "RXVT-UNICODE"
133 root 1.1 .SH "NAME"
134     rxvt\-unicode (ouR XVT, unicode) \- (a VT102 emulator for the X window system)
135     .SH "SYNOPSIS"
136     .IX Header "SYNOPSIS"
137     \&\fB@@RXVT_NAME@@\fR [options] [\-e command [ args ]]
138     .SH "DESCRIPTION"
139     .IX Header "DESCRIPTION"
140     \&\fBrxvt-unicode\fR, version \fB@@RXVT_VERSION@@\fR, is a colour vt102 terminal
141     emulator intended as an \fIxterm\fR(1) replacement for users who do not
142     require features such as Tektronix 4014 emulation and toolkit-style
143     configurability. As a result, \fBrxvt-unicode\fR uses much less swap space \*(--
144     a significant advantage on a machine serving many X sessions.
145     .SH "FREQUENTLY ASKED QUESTIONS"
146     .IX Header "FREQUENTLY ASKED QUESTIONS"
147 root 1.12 See @@RXVT_NAME@@(7) (try \f(CW\*(C`man 7 @@RXVT_NAME@@\*(C'\fR) for a list of
148     frequently asked questions and answer to them and some common
149     problems. That document is also accessible on the World-Wide-Web at
150     <http://cvs.schmorp.de/browse/*checkout*/rxvt\-unicode/doc/rxvt.7.html>.
151 root 1.1 .SH "RXVT-UNICODE VS. RXVT"
152     .IX Header "RXVT-UNICODE VS. RXVT"
153     Unlike the original rxvt, \fBrxvt-unicode\fR stores all text in Unicode
154     internally. That means it can store and display most scripts in the
155     world. Being a terminal emulator, however, some things are very difficult,
156     especially cursive scripts such as arabic, vertically written scripts
157     like mongolian or scripts requiring extremely complex combining rules,
158     like tibetan or devenagari. Don't expect pretty output when using these
159     scripts. Most other scripts, latin, cyrillic, kanji, thai etc. should work
160     fine, though. A somewhat difficult case are left-to-right scripts, such
161     as hebrew: \fBrxvt-unicode\fR adopts the view that bidirectional algorithms
162     belong into the application, not the terminal emulator (too many things \*(--
163     such as cursor-movement while editing \*(-- break otherwise), but that might
164     change.
165     .PP
166     If you are looking for a terminal that supports more exotic scripts, let
167     me recommend \f(CW\*(C`mlterm\*(C'\fR, which is a very userfriendly, lean and clean
168     terminal emulator. In fact, the reason rxvt-unicode was born was solely
169     because the author couldn't get \f(CW\*(C`mlterm\*(C'\fR to use one font for latin1 and
170     another for japanese.
171     .PP
172     Therefore another design rationale was the use of multiple fonts to
173     display characters: The idea of a single unicode font which many other
174 root 1.61 programs force onto its users never made sense to me: You should be able
175 root 1.1 to choose any font for any script freely.
176     .PP
177     Apart from that, rxvt-unicode is also much better internationalised than
178 root 1.61 its predecessor, supports things such as \s-1XFT\s0 and \s-1ISO\s0 14755 that are handy
179 root 1.1 in i18n\-environments, is faster, and has a lot less bugs than the original
180     rxvt. This all in addition to dozens of other small improvements.
181     .PP
182     It is still faithfully following the original rxvt idea of being lean
183     and nice on resources: for example, you can still configure rxvt-unicode
184 root 1.61 without most of its features to get a lean binary. It also comes with
185 root 1.1 a client/daemon pair that lets you open any number of terminal windows
186     from within a single process, which makes startup time very fast and
187     drastically reduces memory usage. See @@RXVT_NAME@@d(1) (daemon) and
188     @@RXVT_NAME@@c(1) (client).
189     .PP
190     It also makes technical information about escape sequences (which have
191     been extended) easier accessible: see @@RXVT_NAME@@(7) for technical
192     reference documentation (escape sequences etc.).
193     .SH "OPTIONS"
194     .IX Header "OPTIONS"
195     The \fB@@RXVT_NAME@@\fR options (mostly a subset of \fIxterm\fR's) are listed
196     below. In keeping with the smaller-is-better philosophy, options may be
197     eliminated or default values chosen at compile\-time, so options and
198     defaults listed may not accurately reflect the version installed on
199     your system. `@@RXVT_NAME@@ \-h' gives a list of major compile-time options on
200     the \fIOptions\fR line. Option descriptions may be prefixed with which
201     compile option each is dependent upon. e.g. `Compile \fI\s-1XIM\s0\fR:' requires
202     \&\fI\s-1XIM\s0\fR on the \fIOptions\fR line. Note: `@@RXVT_NAME@@ \-help' gives a list of all
203     command-line options compiled into your version.
204     .PP
205     Note that \fB@@RXVT_NAME@@\fR permits the resource name to be used as a
206     long-option (\-\-/++ option) so the potential command-line options are
207     far greater than those listed. For example: `@@RXVT_NAME@@ \-\-loginShell \-\-color1
208     Orange'.
209     .PP
210     The following options are available:
211     .IP "\fB\-help\fR, \fB\-\-help\fR" 4
212     .IX Item "-help, --help"
213     Print out a message describing available options.
214     .IP "\fB\-display\fR \fIdisplayname\fR" 4
215     .IX Item "-display displayname"
216     Attempt to open a window on the named X display (\fB\-d\fR still
217     respected). In the absence of this option, the display specified by the
218     \&\fB\s-1DISPLAY\s0\fR environment variable is used.
219 root 1.53 .IP "\fB\-depth\fR \fIbitdepth\fR" 4
220     .IX Item "-depth bitdepth"
221 root 1.56 Compile \fIxft\fR: Attempt to find a visual with the given bit depth;
222 root 1.53 resource \fBdepth\fR.
223 root 1.1 .IP "\fB\-geometry\fR \fIgeom\fR" 4
224     .IX Item "-geometry geom"
225     Window geometry (\fB\-g\fR still respected); resource \fBgeometry\fR.
226     .IP "\fB\-rv\fR|\fB+rv\fR" 4
227     .IX Item "-rv|+rv"
228     Turn on/off simulated reverse video; resource \fBreverseVideo\fR.
229     .IP "\fB\-j\fR|\fB+j\fR" 4
230     .IX Item "-j|+j"
231     Turn on/off jump scrolling; resource \fBjumpScroll\fR.
232 root 1.25 .IP "\fB\-ip\fR|\fB+ip\fR | \fB\-tr\fR|\fB+tr\fR" 4
233     .IX Item "-ip|+ip | -tr|+tr"
234 root 1.1 Turn on/off inheriting parent window's pixmap. Alternative form is
235     \&\fB\-tr\fR; resource \fBinheritPixmap\fR.
236 root 1.56 .Sp
237     \&\fIPlease note that transparency of any kind if completely unsupported by
238     the author. Don't bug him with installation questions!\fR
239 root 1.1 .IP "\fB\-fade\fR \fInumber\fR" 4
240     .IX Item "-fade number"
241 root 1.25 Fade the text by the given percentage when focus is lost. Small values
242     fade a little only, 100 completely replaces all colours by the fade
243     colour; resource \fBfading\fR.
244     .IP "\fB\-fadecolor\fR \fIcolour\fR" 4
245     .IX Item "-fadecolor colour"
246     Fade to this colour when fading is used (see \fB\-fade\fR). The default colour
247 root 1.56 is opaque black. resource \fBfadeColor\fR.
248 root 1.1 .IP "\fB\-tint\fR \fIcolour\fR" 4
249     .IX Item "-tint colour"
250     Tint the transparent background pixmap with the given colour when
251 root 1.25 transparency is enabled with \fB\-tr\fR or \fB\-ip\fR. This only works for
252     non-tiled backgrounds, currently. See also the \fB\-sh\fR option that can be
253     used to brighten or darken the image in addition to tinting it; resource
254     \&\fItintColor\fR. Example:
255     .Sp
256     .Vb 1
257 root 1.60 \& @@RXVT_NAME@@ \-tr \-tint blue \-sh 40
258 root 1.25 .Ve
259 root 1.1 .IP "\fB\-sh\fR" 4
260     .IX Item "-sh"
261     \&\fInumber\fR Darken (0 .. 100) or lighten (\-1 .. \-100) the transparent
262     background image in addition to tinting it (i.e. \fB\-tint\fR must be
263     specified, too, e.g. \f(CW\*(C`\-tint white\*(C'\fR).
264     .IP "\fB\-bg\fR \fIcolour\fR" 4
265     .IX Item "-bg colour"
266     Window background colour; resource \fBbackground\fR.
267     .IP "\fB\-fg\fR \fIcolour\fR" 4
268     .IX Item "-fg colour"
269     Window foreground colour; resource \fBforeground\fR.
270     .IP "\fB\-pixmap\fR \fIfile[;geom]\fR" 4
271     .IX Item "-pixmap file[;geom]"
272     Compile \fI\s-1XPM\s0\fR: Specify \s-1XPM\s0 file for the background and also optionally
273 root 1.3 specify its scaling with a geometry string. Note you may need to
274     add quotes to avoid special shell interpretation of the \f(CW\*(C`;\*(C'\fR in the
275 root 1.1 command\-line; resource \fBbackgroundPixmap\fR.
276     .IP "\fB\-cr\fR \fIcolour\fR" 4
277     .IX Item "-cr colour"
278     The cursor colour; resource \fBcursorColor\fR.
279     .IP "\fB\-pr\fR \fIcolour\fR" 4
280     .IX Item "-pr colour"
281     The mouse pointer foreground colour; resource \fBpointerColor\fR.
282     .IP "\fB\-pr2\fR \fIcolour\fR" 4
283     .IX Item "-pr2 colour"
284     The mouse pointer background colour; resource \fBpointerColor2\fR.
285     .IP "\fB\-bd\fR \fIcolour\fR" 4
286     .IX Item "-bd colour"
287     The colour of the border around the text area and between the scrollbar and the text;
288     resource \fBborderColor\fR.
289     .IP "\fB\-fn\fR \fIfontlist\fR" 4
290     .IX Item "-fn fontlist"
291     Select the fonts to be used. This is a comma separated list of font names
292 root 1.46 that are checked in order when trying to find glyphs for characters. The
293 root 1.1 first font defines the cell size for characters; other fonts might be
294     smaller, but not (in general) larger. A (hopefully) reasonable default
295     font list is always appended to it. See resource \fBfont\fR for more details.
296     .Sp
297 root 1.61 In short, to specify an X11 core font, just specify its name or prefix it
298 root 1.1 with \f(CW\*(C`x:\*(C'\fR. To specify an XFT\-font, you need to prefix it with \f(CW\*(C`xft:\*(C'\fR,
299     e.g.:
300     .Sp
301     .Vb 2
302 root 1.60 \& @@RXVT_NAME@@ \-fn "xft:Bitstream Vera Sans Mono:pixelsize=15"
303     \& @@RXVT_NAME@@ \-fn "9x15bold,xft:Bitstream Vera Sans Mono"
304 root 1.1 .Ve
305     .Sp
306     See also the question \*(L"How does rxvt-unicode choose fonts?\*(R" in the \s-1FAQ\s0
307     section of @@RXVT_NAME@@(7).
308     .IP "\fB\-fb\fR \fIfontlist\fR" 4
309     .IX Item "-fb fontlist"
310 root 1.37 Compile \fIfont-styles\fR: The bold font list to use when \fBbold\fR characters
311     are to be printed. See resource \fBboldFont\fR for details.
312 root 1.1 .IP "\fB\-fi\fR \fIfontlist\fR" 4
313     .IX Item "-fi fontlist"
314 root 1.37 Compile \fIfont-styles\fR: The italic font list to use when \fIitalic\fR
315     characters are to be printed. See resource \fBitalicFont\fR for details.
316 root 1.1 .IP "\fB\-fbi\fR \fIfontlist\fR" 4
317     .IX Item "-fbi fontlist"
318 root 1.37 Compile \fIfont-styles\fR: The bold italic font list to use when \fB\f(BIbold
319 root 1.35 italic\fB\fR characters are to be printed. See resource \fBboldItalicFont\fR
320     for details.
321 root 1.30 .IP "\fB\-is\fR|\fB+is\fR" 4
322     .IX Item "-is|+is"
323 root 1.37 Compile \fIfont-styles\fR: Bold/Italic font styles imply high intensity
324 root 1.30 foreground/background (default). See resource \fBintensityStyles\fR for
325     details.
326 root 1.1 .IP "\fB\-name\fR \fIname\fR" 4
327     .IX Item "-name name"
328     Specify the application name under which resources are to be obtained,
329     rather than the default executable file name. Name should not contain
330     `.' or `*' characters. Also sets the icon and title name.
331     .IP "\fB\-ls\fR|\fB+ls\fR" 4
332     .IX Item "-ls|+ls"
333     Start as a login\-shell/sub\-shell; resource \fBloginShell\fR.
334     .IP "\fB\-ut\fR|\fB+ut\fR" 4
335     .IX Item "-ut|+ut"
336     Compile \fIutmp\fR: Inhibit/enable writing a utmp entry; resource
337     \&\fButmpInhibit\fR.
338     .IP "\fB\-vb\fR|\fB+vb\fR" 4
339     .IX Item "-vb|+vb"
340     Turn on/off visual bell on receipt of a bell character; resource
341     \&\fBvisualBell\fR.
342     .IP "\fB\-sb\fR|\fB+sb\fR" 4
343     .IX Item "-sb|+sb"
344     Turn on/off scrollbar; resource \fBscrollBar\fR.
345     .IP "\fB\-si\fR|\fB+si\fR" 4
346     .IX Item "-si|+si"
347     Turn on/off scroll-to-bottom on \s-1TTY\s0 output inhibit; resource
348     \&\fBscrollTtyOutput\fR has opposite effect.
349     .IP "\fB\-sk\fR|\fB+sk\fR" 4
350     .IX Item "-sk|+sk"
351     Turn on/off scroll-to-bottom on keypress; resource
352     \&\fBscrollTtyKeypress\fR.
353     .IP "\fB\-sw\fR|\fB+sw\fR" 4
354     .IX Item "-sw|+sw"
355     Turn on/off scrolling with the scrollback buffer as new lines appear.
356     This only takes effect if \fB\-si\fR is also given; resource
357     \&\fBscrollWithBuffer\fR.
358     .IP "\fB\-sr\fR|\fB+sr\fR" 4
359     .IX Item "-sr|+sr"
360     Put scrollbar on right/left; resource \fBscrollBar_right\fR.
361     .IP "\fB\-st\fR|\fB+st\fR" 4
362     .IX Item "-st|+st"
363 root 1.23 Display rxvt (non XTerm/NeXT) scrollbar without/with a trough;
364 root 1.1 resource \fBscrollBar_floating\fR.
365     .IP "\fB\-ptab\fR|\fB+ptab\fR" 4
366     .IX Item "-ptab|+ptab"
367     If enabled (default), \*(L"Horizontal Tab\*(R" characters are being stored as
368     actual wide characters in the screen buffer, which makes it possible to
369     select and paste them. Since a horizontal tab is a cursor movement and
370     not an actual glyph, this can sometimes be visually annoying as the cursor
371     on a tab character is displayed as a wide cursor; resource \fBpastableTabs\fR.
372     .IP "\fB\-bc\fR|\fB+bc\fR" 4
373     .IX Item "-bc|+bc"
374     Blink the cursor; resource \fBcursorBlink\fR.
375     .IP "\fB\-iconic\fR" 4
376     .IX Item "-iconic"
377     Start iconified, if the window manager supports that option.
378     Alternative form is \fB\-ic\fR.
379     .IP "\fB\-sl\fR \fInumber\fR" 4
380     .IX Item "-sl number"
381     Save \fInumber\fR lines in the scrollback buffer. See resource entry for
382     limits; resource \fBsaveLines\fR.
383     .IP "\fB\-b\fR \fInumber\fR" 4
384     .IX Item "-b number"
385     Compile \fIfrills\fR: Internal border of \fInumber\fR pixels. See resource
386     entry for limits; resource \fBinternalBorder\fR.
387     .IP "\fB\-w\fR \fInumber\fR" 4
388     .IX Item "-w number"
389     Compile \fIfrills\fR: External border of \fInumber\fR pixels. Also, \fB\-bw\fR
390     and \fB\-borderwidth\fR. See resource entry for limits; resource
391     \&\fBexternalBorder\fR.
392     .IP "\fB\-bl\fR" 4
393     .IX Item "-bl"
394     Compile \fIfrills\fR: Set \s-1MWM\s0 hints to request a borderless window, i.e.
395     if honoured by the \s-1WM\s0, the rxvt-unicode window will not have window
396     decorations; resource \fBborderLess\fR.
397 root 1.49 .IP "\fB\-override\-redirect\fR" 4
398     .IX Item "-override-redirect"
399     Compile \fIfrills\fR: Sets override-redirect on the window; resource
400     \&\fBoverride-redirect\fR.
401 root 1.37 .IP "\fB\-sbg\fR" 4
402     .IX Item "-sbg"
403     Compile \fIfrills\fR: Disable the usage of the built-in block graphics/line
404     drawing characters and just rely on what the specified fonts provide. Use
405     this if you have a good font and want to use its block graphic glyphs;
406     resource \fBskipBuiltinGlyphs\fR.
407 root 1.1 .IP "\fB\-lsp\fR \fInumber\fR" 4
408     .IX Item "-lsp number"
409     Compile \fIfrills\fR: Lines (pixel height) to insert between each row of
410     the display. Useful to work around font rendering problems; resource
411     \&\fBlinespace\fR.
412     .IP "\fB\-tn\fR \fItermname\fR" 4
413     .IX Item "-tn termname"
414     This option specifies the name of the terminal type to be set in the
415     \&\fB\s-1TERM\s0\fR environment variable. This terminal type must exist in the
416     \&\fI\fItermcap\fI\|(5)\fR database and should have \fIli#\fR and \fIco#\fR entries;
417     resource \fBtermName\fR.
418     .IP "\fB\-e\fR \fIcommand [arguments]\fR" 4
419     .IX Item "-e command [arguments]"
420     Run the command with its command-line arguments in the \fB@@RXVT_NAME@@\fR
421     window; also sets the window title and icon name to be the basename of
422     the program being executed if neither \fI\-title\fR (\fI\-T\fR) nor \fI\-n\fR are
423     given on the command line. If this option is used, it must be the last
424     on the command\-line. If there is no \fB\-e\fR option then the default is to
425     run the program specified by the \fB\s-1SHELL\s0\fR environment variable or,
426     failing that, \fI\fIsh\fI\|(1)\fR.
427 root 1.28 .Sp
428     Please note that you must specify a program with arguments. If you want to
429     run shell commands, you have to specify the shell, like this:
430     .Sp
431     .Vb 1
432 root 1.60 \& @@RXVT_NAME@@ \-e sh \-c "shell commands"
433 root 1.28 .Ve
434 root 1.1 .IP "\fB\-title\fR \fItext\fR" 4
435     .IX Item "-title text"
436     Window title (\fB\-T\fR still respected); the default title is the basename
437     of the program specified after the \fB\-e\fR option, if any, otherwise the
438     application name; resource \fBtitle\fR.
439     .IP "\fB\-n\fR \fItext\fR" 4
440     .IX Item "-n text"
441     Icon name; the default name is the basename of the program specified
442     after the \fB\-e\fR option, if any, otherwise the application name;
443     resource \fBiconName\fR.
444     .IP "\fB\-C\fR" 4
445     .IX Item "-C"
446     Capture system console messages.
447     .IP "\fB\-pt\fR \fIstyle\fR" 4
448     .IX Item "-pt style"
449     Compile \fI\s-1XIM\s0\fR: input style for input method; \fBOverTheSpot\fR,
450     \&\fBOffTheSpot\fR, \fBRoot\fR; resource \fBpreeditType\fR.
451     .IP "\fB\-im\fR \fItext\fR" 4
452     .IX Item "-im text"
453     Compile \fI\s-1XIM\s0\fR: input method name. resource \fBinputMethod\fR.
454     .IP "\fB\-imlocale\fR \fIstring\fR" 4
455     .IX Item "-imlocale string"
456 root 1.7 The locale to use for opening the \s-1IM\s0. You can use an \f(CW\*(C`LC_CTYPE\*(C'\fR of e.g.
457     \&\f(CW\*(C`de_DE.UTF\-8\*(C'\fR for normal text processing but \f(CW\*(C`ja_JP.EUC\-JP\*(C'\fR for the
458     input extension to be able to input japanese characters while staying in
459     another locale. resource \fBimLocale\fR.
460     .IP "\fB\-imfont\fR \fIfontset\fR" 4
461     .IX Item "-imfont fontset"
462     Set the font set to use for the X Input Method, see resource \fBimFont\fR
463     for more info.
464     .IP "\fB\-tcw\fR" 4
465     .IX Item "-tcw"
466     Change the meaning of triple-click selection with the left mouse
467     button. Instead of selecting a full line it will extend the selection the
468     end of the logical line only. resource \fBtripleclickwords\fR.
469 root 1.1 .IP "\fB\-insecure\fR" 4
470     .IX Item "-insecure"
471     Enable \*(L"insecure\*(R" mode, which currently enables most of the escape
472     sequences that echo strings. See the resource \fBinsecure\fR for more
473     info.
474     .IP "\fB\-mod\fR \fImodifier\fR" 4
475     .IX Item "-mod modifier"
476     Override detection of Meta modifier with specified key: \fBalt\fR,
477     \&\fBmeta\fR, \fBhyper\fR, \fBsuper\fR, \fBmod1\fR, \fBmod2\fR, \fBmod3\fR, \fBmod4\fR,
478     \&\fBmod5\fR; resource \fImodifier\fR.
479     .IP "\fB\-ssc\fR|\fB+ssc\fR" 4
480     .IX Item "-ssc|+ssc"
481     Turn on/off secondary screen (default enabled); resource
482     \&\fBsecondaryScreen\fR.
483     .IP "\fB\-ssr\fR|\fB+ssr\fR" 4
484     .IX Item "-ssr|+ssr"
485     Turn on/off secondary screen scroll (default enabled); resource
486     \&\fBsecondaryScroll\fR.
487 root 1.28 .IP "\fB\-hold\fR|\fB+hold\fR" 4
488     .IX Item "-hold|+hold"
489     Turn on/off hold window after exit support. If enabled, @@RXVT_NAME@@
490     will not immediately destroy its window when the program executed within
491     it exits. Instead, it will wait till it is being killed or closed by the
492     user; resource \fBhold\fR.
493 root 1.18 .IP "\fB\-keysym.\fR\fIsym\fR \fIstring\fR" 4
494     .IX Item "-keysym.sym string"
495 root 1.12 Remap a key symbol. See resource \fBkeysym\fR.
496 root 1.18 .IP "\fB\-embed\fR \fIwindowid\fR" 4
497     .IX Item "-embed windowid"
498 root 1.61 Tells @@RXVT_NAME@@ to embed its windows into an already-existing window,
499 root 1.15 which enables applications to easily embed a terminal.
500     .Sp
501     Right now, @@RXVT_NAME@@ will first unmap/map the specified window, so it
502     shouldn't be a top-level window. @@RXVT_NAME@@ will also reconfigure it
503     quite a bit, so don't expect it to keep some specific state. It's best to
504     create an extra subwindow for @@RXVT_NAME@@ and leave it alone.
505     .Sp
506 root 1.16 The window will not be destroyed when @@RXVT_NAME@@ exits.
507     .Sp
508 root 1.15 It might be useful to know that @@RXVT_NAME@@ will not close file
509     descriptors passed to it (except for stdin/out/err, of course), so you
510     can use file descriptors to communicate with the programs within the
511     terminal. This works regardless of wether the \f(CW\*(C`\-embed\*(C'\fR option was used or
512     not.
513 root 1.18 .Sp
514     Here is a short Gtk2\-perl snippet that illustrates how this option can be
515     used (a longer example is in \fIdoc/embed\fR):
516     .Sp
517 root 1.20 .Vb 5
518     \& my $rxvt = new Gtk2::Socket;
519 root 1.60 \& $rxvt\->signal_connect_after (realize => sub {
520     \& my $xid = $_[0]\->window\->get_xid;
521     \& system "@@RXVT_NAME@@ \-embed $xid &";
522 root 1.20 \& });
523 root 1.18 .Ve
524 root 1.38 .IP "\fB\-pty\-fd\fR \fIfile descriptor\fR" 4
525     .IX Item "-pty-fd file descriptor"
526 root 1.18 Tells @@RXVT_NAME@@ \s-1NOT\s0 to execute any commands or create a new pty/tty
527     pair but instead use the given filehandle as the tty master. This is
528     useful if you want to drive @@RXVT_NAME@@ as a generic terminal emulator
529     without having to run a program within it.
530     .Sp
531     If this switch is given, @@RXVT_NAME@@ will not create any utmp/wtmp
532     entries and will not tinker with pty/tty permissions \- you have to do that
533     yourself if you want that.
534     .Sp
535 root 1.38 As an extremely special case, specifying \f(CW\*(C`\-1\*(C'\fR will completely suppress
536     pty/tty operations.
537     .Sp
538 root 1.18 Here is a example in perl that illustrates how this option can be used (a
539     longer example is in \fIdoc/pty\-fd\fR):
540     .Sp
541     .Vb 2
542     \& use IO::Pty;
543     \& use Fcntl;
544 root 1.60 \&
545 root 1.18 \& my $pty = new IO::Pty;
546 root 1.60 \& fcntl $pty, F_SETFD, 0; # clear close\-on\-exec
547     \& system "@@RXVT_NAME@@ \-pty\-fd " . (fileno $pty) . "&";
548 root 1.19 \& close $pty;
549 root 1.60 \&
550 root 1.18 \& # now communicate with rxvt
551 root 1.60 \& my $slave = $pty\->slave;
552 root 1.18 \& while (<$slave>) { print $slave "got <$_>\en" }
553     .Ve
554 root 1.32 .IP "\fB\-pe\fR \fIstring\fR" 4
555     .IX Item "-pe string"
556 root 1.39 Comma-separated list of perl extension scripts to use (or not to use) in
557     this terminal instance. See resource \fBperl-ext\fR for details.
558 root 1.1 .SH "RESOURCES (available also as long\-options)"
559     .IX Header "RESOURCES (available also as long-options)"
560     Note: `@@RXVT_NAME@@ \-\-help' gives a list of all resources (long
561     options) compiled into your version.
562     .PP
563 root 1.43 You can set and change the resources using X11 tools like \fBxrdb\fR. Many
564     distribution do also load settings from the \fB~/.Xresources\fR file when X
565     starts. @@RXVT_NAME@@ will consult the following files/resources in order,
566     with later settings overwriting earlier ones:
567 root 1.12 .PP
568     .Vb 5
569 root 1.60 \& 1. system\-wide app\-defaults file, either locale\-dependent OR global
570     \& 2. app\-defaults file in $XAPPLRESDIR
571     \& 3. RESOURCE_MANAGER property on root\-window OR $HOME/.Xdefaults
572 root 1.12 \& 4. SCREEN_RESOURCES for the current screen
573 root 1.60 \& 5. $XENVIRONMENT file OR $HOME/.Xdefaults\-<nodename>
574 root 1.12 .Ve
575 root 1.1 .PP
576 root 1.43 Note that when reading X resources, \fB@@RXVT_NAME@@\fR recognizes two class
577     names: \fBRxvt\fR and \fBURxvt\fR. The class name \fBRxvt\fR allows resources
578     common to both \fB@@RXVT_NAME@@\fR and the original \fIrxvt\fR to be easily
579     configured, while the class name \fBURxvt\fR allows resources unique to
580     \&\fB@@RXVT_NAME@@\fR, to be shared between different \fB@@RXVT_NAME@@\fR
581     configurations. If no resources are specified, suitable defaults will
582     be used. Command-line arguments can be used to override resource
583     settings. The following resources are supported (you might want to
584     check the @@RXVT_NAME@@\fIperl\fR\|(3) manpage for additional settings by perl
585     extensions not documented here):
586 root 1.53 .IP "\fBdepth:\fR \fIbitdepth\fR" 4
587     .IX Item "depth: bitdepth"
588 root 1.56 Compile \fIxft\fR: Attempt to find a visual with the given bit depth;
589 root 1.53 option \fB\-depth\fR.
590 root 1.1 .IP "\fBgeometry:\fR \fIgeom\fR" 4
591     .IX Item "geometry: geom"
592     Create the window with the specified X window geometry [default 80x24];
593     option \fB\-geometry\fR.
594     .IP "\fBbackground:\fR \fIcolour\fR" 4
595     .IX Item "background: colour"
596     Use the specified colour as the window's background colour [default
597     White]; option \fB\-bg\fR.
598     .IP "\fBforeground:\fR \fIcolour\fR" 4
599     .IX Item "foreground: colour"
600     Use the specified colour as the window's foreground colour [default
601     Black]; option \fB\-fg\fR.
602     .IP "\fBcolor\fR\fIn\fR\fB:\fR \fIcolour\fR" 4
603     .IX Item "colorn: colour"
604     Use the specified colour for the colour value \fIn\fR, where 0\-7
605     corresponds to low-intensity (normal) colours and 8\-15 corresponds to
606     high-intensity (bold = bright foreground, blink = bright background)
607     colours. The canonical names are as follows: 0=black, 1=red, 2=green,
608     3=yellow, 4=blue, 5=magenta, 6=cyan, 7=white, but the actual colour
609     names used are listed in the \fB\s-1COLORS\s0 \s-1AND\s0 \s-1GRAPHICS\s0\fR section.
610     .Sp
611     Colours higher than 15 cannot be set using resources (yet), but can be
612     changed using an escape command (see @@RXVT_NAME@@(7)).
613     .Sp
614     Colours 16\-79 form a standard 4x4x4 colour cube (the same as xterm with
615     88 colour support). Colours 80\-87 are evenly spaces grey steps.
616     .IP "\fBcolorBD:\fR \fIcolour\fR" 4
617     .IX Item "colorBD: colour"
618     .PD 0
619     .IP "\fBcolorIT:\fR \fIcolour\fR" 4
620     .IX Item "colorIT: colour"
621     .PD
622     Use the specified colour to display bold or italic characters when the
623     foreground colour is the default. If font styles are not available
624 root 1.3 (Compile \fIstyles\fR) and this option is unset, reverse video is used instead.
625 root 1.1 .IP "\fBcolorUL:\fR \fIcolour\fR" 4
626     .IX Item "colorUL: colour"
627     Use the specified colour to display underlined characters when the
628     foreground colour is the default.
629     .IP "\fBcolorRV:\fR \fIcolour\fR" 4
630     .IX Item "colorRV: colour"
631     Use the specified colour as the background for reverse video
632     characters.
633     .IP "\fBunderlineColor:\fR \fIcolour\fR" 4
634     .IX Item "underlineColor: colour"
635     If set, use the specified colour as the colour for the underline
636     itself. If unset, use the foreground colour.
637     .IP "\fBcursorColor:\fR \fIcolour\fR" 4
638     .IX Item "cursorColor: colour"
639     Use the specified colour for the cursor. The default is to use the
640     foreground colour; option \fB\-cr\fR.
641     .IP "\fBcursorColor2:\fR \fIcolour\fR" 4
642     .IX Item "cursorColor2: colour"
643     Use the specified colour for the colour of the cursor text. For this to
644     take effect, \fBcursorColor\fR must also be specified. The default is to
645     use the background colour.
646     .IP "\fBreverseVideo:\fR \fIboolean\fR" 4
647     .IX Item "reverseVideo: boolean"
648     \&\fBTrue\fR: simulate reverse video by foreground and background colours;
649     option \fB\-rv\fR. \fBFalse\fR: regular screen colours [default]; option
650     \&\fB+rv\fR. See note in \fB\s-1COLORS\s0 \s-1AND\s0 \s-1GRAPHICS\s0\fR section.
651     .IP "\fBjumpScroll:\fR \fIboolean\fR" 4
652     .IX Item "jumpScroll: boolean"
653     \&\fBTrue\fR: specify that jump scrolling should be used. When scrolling
654     quickly, fewer screen updates are performed [default]; option \fB\-j\fR.
655     \&\fBFalse\fR: specify that smooth scrolling should be used; option \fB+j\fR.
656     .IP "\fBinheritPixmap:\fR \fIboolean\fR" 4
657     .IX Item "inheritPixmap: boolean"
658     \&\fBTrue\fR: make the background inherit the parent windows' pixmap, giving
659     artificial transparency. \fBFalse\fR: do not inherit the parent windows'
660     pixmap.
661 root 1.56 .Sp
662     \&\fIPlease note that transparency of any kind if completely unsupported by
663     the author. Don't bug him with installation questions!\fR
664 root 1.1 .IP "\fBfading:\fR \fInumber\fR" 4
665     .IX Item "fading: number"
666 root 1.25 Fade the text by the given percentage when focus is lost; option \fB\-fade\fR.
667     .IP "\fBfadeColor:\fR \fIcolour\fR" 4
668     .IX Item "fadeColor: colour"
669     Fade to this colour, when fading is used (see \fBfading:\fR). The default
670     colour is black; option \fB\-fadecolor\fR.
671 root 1.1 .IP "\fBtintColor:\fR \fIcolour\fR" 4
672     .IX Item "tintColor: colour"
673 root 1.25 Tint the transparent background pixmap with the given colour; option
674     \&\fB\-tint\fR.
675 root 1.1 .IP "\fBshading:\fR \fInumber\fR" 4
676     .IX Item "shading: number"
677     Darken (0 .. 100) or lighten (\-1 .. \-100) the transparent background
678     image in addition to tinting it.
679     .IP "\fBscrollColor:\fR \fIcolour\fR" 4
680     .IX Item "scrollColor: colour"
681     Use the specified colour for the scrollbar [default #B2B2B2].
682     .IP "\fBtroughColor:\fR \fIcolour\fR" 4
683     .IX Item "troughColor: colour"
684     Use the specified colour for the scrollbar's trough area [default
685 root 1.23 #969696]. Only relevant for rxvt (non XTerm/NeXT) scrollbar.
686 root 1.1 .IP "\fBborderColor:\fR \fIcolour\fR" 4
687     .IX Item "borderColor: colour"
688     The colour of the border around the text area and between the scrollbar
689     and the text.
690     .IP "\fBbackgroundPixmap:\fR \fIfile[;geom]\fR" 4
691     .IX Item "backgroundPixmap: file[;geom]"
692     Use the specified \s-1XPM\s0 file (note the `.xpm' extension is optional) for
693     the background and also optionally specify its scaling with a geometry
694     string \fBWxH+X+Y\fR, in which \fB\*(L"W\*(R" / \*(L"H\*(R"\fR specify the
695     horizontal/vertical scale (percent) and \fB\*(L"X\*(R" / \*(L"Y\*(R"\fR locate the image
696     centre (percent). A scale of 0 displays the image with tiling. A scale
697     of 1 displays the image without any scaling. A scale of 2 to 9
698     specifies an integer number of images in that direction. No image will
699     be magnified beyond 10 times its original size. The maximum permitted
700     scale is 1000. [default 0x0+50+50]
701     .IP "\fBpath:\fR \fIpath\fR" 4
702     .IX Item "path: path"
703 root 1.47 Specify the colon-delimited search path for finding \s-1XPM\s0 files.
704 root 1.1 .IP "\fBfont:\fR \fIfontlist\fR" 4
705     .IX Item "font: fontlist"
706 root 1.46 Select the fonts to be used. This is a comma separated list of font names
707     that are checked in order when trying to find glyphs for characters. The
708     first font defines the cell size for characters; other fonts might be
709     smaller, but not (in general) larger. A (hopefully) reasonable default
710     font list is always appended to it; option \fB\-fn\fR.
711 root 1.1 .Sp
712     Each font can either be a standard X11 core font (\s-1XLFD\s0) name, with
713 root 1.3 optional prefix \f(CW\*(C`x:\*(C'\fR or a Xft font (Compile \fIxft\fR), prefixed with \f(CW\*(C`xft:\*(C'\fR.
714 root 1.1 .Sp
715     In addition, each font can be prefixed with additional hints and
716     specifications enclosed in square brackets (\f(CW\*(C`[]\*(C'\fR). The only available
717     hint currently is \f(CW\*(C`codeset=codeset\-name\*(C'\fR, and this is only used for Xft
718     fonts.
719     .Sp
720     For example, this font resource
721     .Sp
722     .Vb 5
723 root 1.47 \& URxvt.font: 9x15bold,\e
724 root 1.60 \& \-misc\-fixed\-bold\-r\-normal\-\-15\-140\-75\-75\-c\-90\-iso10646\-1,\e
725     \& \-misc\-fixed\-medium\-r\-normal\-\-15\-140\-75\-75\-c\-90\-iso10646\-1, \e
726 root 1.1 \& [codeset=JISX0208]xft:Kochi Gothic:antialias=false, \e
727     \& xft:Code2000:antialias=false
728     .Ve
729     .Sp
730     specifies five fonts to be used. The first one is \f(CW\*(C`9x15bold\*(C'\fR (actually
731     the iso8859\-1 version of the second font), which is the base font (because
732     it is named first) and thus defines the character cell grid to be 9 pixels
733     wide and 15 pixels high.
734     .Sp
735     The second font is just used to add additional unicode characters not in
736     the base font, likewise the third, which is unfortunately non\-bold, but
737     the bold version of the font does contain less characters, so this is a
738     useful supplement.
739     .Sp
740     The third font is an Xft font with aliasing turned off, and the characters
741     are limited to the \fB\s-1JIS\s0 0208\fR codeset (i.e. japanese kanji). The font
742     contains other characters, but we are not interested in them.
743     .Sp
744     The last font is a useful catch-all font that supplies most of the
745     remaining unicode characters.
746     .IP "\fBboldFont:\fR \fIfontlist\fR" 4
747     .IX Item "boldFont: fontlist"
748     .PD 0
749     .IP "\fBitalicFont:\fR \fIfontlist\fR" 4
750     .IX Item "italicFont: fontlist"
751     .IP "\fBboldItalicFont:\fR \fIfontlist\fR" 4
752     .IX Item "boldItalicFont: fontlist"
753     .PD
754     The font list to use for displaying \fBbold\fR, \fIitalic\fR or \fB\f(BIbold
755     italic\fB\fR characters, respectively.
756     .Sp
757     If specified and non\-empty, then the syntax is the same as for the
758     \&\fBfont\fR\-resource, and the given font list will be used as is, which makes
759     it possible to substitute completely different font styles for bold and
760     italic.
761     .Sp
762     If unset (the default), a suitable font list will be synthesized by
763     \&\*(L"morphing\*(R" the normal text font list into the desired shape. If that is
764     not possible, replacement fonts of the desired shape will be tried.
765     .Sp
766     If set, but empty, then this specific style is disabled and the normal
767     text font will being used for the given style.
768 root 1.30 .IP "\fBintensityStyles:\fR \fIboolean\fR" 4
769     .IX Item "intensityStyles: boolean"
770     When font styles are not enabled, or this option is enabled (\fBTrue\fR,
771     option \fB\-is\fR, the default), bold and italic font styles imply high
772     intensity foreground/backround colours. Disabling this option (\fBFalse\fR,
773     option \fB+is\fR) disables this behaviour, the high intensity colours are not
774     reachable.
775 root 1.1 .IP "\fBselectstyle:\fR \fImode\fR" 4
776     .IX Item "selectstyle: mode"
777     Set mouse selection style to \fBold\fR which is 2.20, \fBoldword\fR which is
778     xterm style with 2.20 old word selection, or anything else which gives
779     xterm style selection.
780     .IP "\fBscrollstyle:\fR \fImode\fR" 4
781     .IX Item "scrollstyle: mode"
782     Set scrollbar style to \fBrxvt\fR, \fBplain\fR, \fBnext\fR or \fBxterm\fR. \fBplain\fR is
783 root 1.23 the author's favourite.
784 root 1.1 .IP "\fBtitle:\fR \fIstring\fR" 4
785     .IX Item "title: string"
786     Set window title string, the default title is the command-line
787     specified after the \fB\-e\fR option, if any, otherwise the application
788     name; option \fB\-title\fR.
789     .IP "\fBiconName:\fR \fIstring\fR" 4
790     .IX Item "iconName: string"
791     Set the name used to label the window's icon or displayed in an icon
792     manager window, it also sets the window's title unless it is explicitly
793     set; option \fB\-n\fR.
794     .IP "\fBmapAlert:\fR \fIboolean\fR" 4
795     .IX Item "mapAlert: boolean"
796     \&\fBTrue\fR: de-iconify (map) on receipt of a bell character. \fBFalse\fR: no
797     de-iconify (map) on receipt of a bell character [default].
798     .IP "\fBvisualBell:\fR \fIboolean\fR" 4
799     .IX Item "visualBell: boolean"
800     \&\fBTrue\fR: use visual bell on receipt of a bell character; option \fB\-vb\fR.
801     \&\fBFalse\fR: no visual bell [default]; option \fB+vb\fR.
802     .IP "\fBloginShell:\fR \fIboolean\fR" 4
803     .IX Item "loginShell: boolean"
804     \&\fBTrue\fR: start as a login shell by prepending a `\-' to \fBargv[0]\fR of
805     the shell; option \fB\-ls\fR. \fBFalse\fR: start as a normal sub-shell
806     [default]; option \fB+ls\fR.
807     .IP "\fButmpInhibit:\fR \fIboolean\fR" 4
808     .IX Item "utmpInhibit: boolean"
809     \&\fBTrue\fR: inhibit writing record into the system log file \fButmp\fR;
810     option \fB\-ut\fR. \fBFalse\fR: write record into the system log file \fButmp\fR
811     [default]; option \fB+ut\fR.
812     .IP "\fBprint\-pipe:\fR \fIstring\fR" 4
813     .IX Item "print-pipe: string"
814     Specify a command pipe for vt100 printer [default \fI\fIlpr\fI\|(1)\fR]. Use
815     \&\fBPrint\fR to initiate a screen dump to the printer and \fBCtrl-Print\fR or
816     \&\fBShift-Print\fR to include the scrollback as well.
817 root 1.24 .Sp
818     The string will be interpreted as if typed into the shell as\-is.
819     .Sp
820     Example:
821     .Sp
822     .Vb 1
823 root 1.60 \& URxvt.print\-pipe: cat > $(TMPDIR=$HOME mktemp urxvt.XXXXXX)
824 root 1.24 .Ve
825     .Sp
826     This creates a new file in your home directory with the screen contents
827     everytime you hit \f(CW\*(C`Print\*(C'\fR.
828 root 1.1 .IP "\fBscrollBar:\fR \fIboolean\fR" 4
829     .IX Item "scrollBar: boolean"
830     \&\fBTrue\fR: enable the scrollbar [default]; option \fB\-sb\fR. \fBFalse\fR:
831     disable the scrollbar; option \fB+sb\fR.
832     .IP "\fBscrollBar_right:\fR \fIboolean\fR" 4
833     .IX Item "scrollBar_right: boolean"
834     \&\fBTrue\fR: place the scrollbar on the right of the window; option \fB\-sr\fR.
835     \&\fBFalse\fR: place the scrollbar on the left of the window; option \fB+sr\fR.
836     .IP "\fBscrollBar_floating:\fR \fIboolean\fR" 4
837     .IX Item "scrollBar_floating: boolean"
838     \&\fBTrue\fR: display an rxvt scrollbar without a trough; option \fB\-st\fR.
839     \&\fBFalse\fR: display an rxvt scrollbar with a trough; option \fB+st\fR.
840     .IP "\fBscrollBar_align:\fR \fImode\fR" 4
841     .IX Item "scrollBar_align: mode"
842     Align the \fBtop\fR, \fBbottom\fR or \fBcentre\fR [default] of the scrollbar
843     thumb with the pointer on middle button press/drag.
844     .IP "\fBscrollTtyOutput:\fR \fIboolean\fR" 4
845     .IX Item "scrollTtyOutput: boolean"
846     \&\fBTrue\fR: scroll to bottom when tty receives output; option \fB\-si\fR.
847     \&\fBFalse\fR: do not scroll to bottom when tty receives output; option
848     \&\fB+si\fR.
849     .IP "\fBscrollWithBuffer:\fR \fIboolean\fR" 4
850     .IX Item "scrollWithBuffer: boolean"
851     \&\fBTrue\fR: scroll with scrollback buffer when tty receives new lines (and
852 root 1.17 \&\fBscrollTtyOutput\fR is False); option \fB\-sw\fR. \fBFalse\fR: do not scroll
853     with scrollback buffer when tty recieves new lines; option \fB+sw\fR.
854 root 1.1 .IP "\fBscrollTtyKeypress:\fR \fIboolean\fR" 4
855     .IX Item "scrollTtyKeypress: boolean"
856     \&\fBTrue\fR: scroll to bottom when a non-special key is pressed. Special keys
857     are those which are intercepted by rxvt-unicode for special handling and
858     are not passed onto the shell; option \fB\-sk\fR. \fBFalse\fR: do not scroll to
859     bottom when a non-special key is pressed; option \fB+sk\fR.
860     .IP "\fBsaveLines:\fR \fInumber\fR" 4
861     .IX Item "saveLines: number"
862     Save \fInumber\fR lines in the scrollback buffer [default 64]. This
863     resource is limited on most machines to 65535; option \fB\-sl\fR.
864     .IP "\fBinternalBorder:\fR \fInumber\fR" 4
865     .IX Item "internalBorder: number"
866     Internal border of \fInumber\fR pixels. This resource is limited to 100;
867     option \fB\-b\fR.
868     .IP "\fBexternalBorder:\fR \fInumber\fR" 4
869     .IX Item "externalBorder: number"
870     External border of \fInumber\fR pixels. This resource is limited to 100;
871     option \fB\-w\fR, \fB\-bw\fR, \fB\-borderwidth\fR.
872     .IP "\fBborderLess:\fR \fIboolean\fR" 4
873     .IX Item "borderLess: boolean"
874     Set \s-1MWM\s0 hints to request a borderless window, i.e. if honoured by the
875     \&\s-1WM\s0, the rxvt-unicode window will not have window decorations; option \fB\-bl\fR.
876 root 1.37 .IP "\fBskipBuiltinGlyphs:\fR \fIboolean\fR" 4
877     .IX Item "skipBuiltinGlyphs: boolean"
878     Compile \fIfrills\fR: Disable the usage of the built-in block graphics/line
879     drawing characters and just rely on what the specified fonts provide. Use
880     this if you have a good font and want to use its block graphic glyphs;
881     option \fB\-sbg\fR.
882 root 1.1 .IP "\fBtermName:\fR \fItermname\fR" 4
883     .IX Item "termName: termname"
884     Specifies the terminal type name to be set in the \fB\s-1TERM\s0\fR environment
885     variable; option \fB\-tn\fR.
886     .IP "\fBlinespace:\fR \fInumber\fR" 4
887     .IX Item "linespace: number"
888     Specifies number of lines (pixel height) to insert between each row of
889     the display [default 0]; option \fB\-lsp\fR.
890     .IP "\fBmeta8:\fR \fIboolean\fR" 4
891     .IX Item "meta8: boolean"
892     \&\fBTrue\fR: handle Meta (Alt) + keypress to set the 8th bit. \fBFalse\fR:
893     handle Meta (Alt) + keypress as an escape prefix [default].
894     .IP "\fBmouseWheelScrollPage:\fR \fIboolean\fR" 4
895     .IX Item "mouseWheelScrollPage: boolean"
896     \&\fBTrue\fR: the mouse wheel scrolls a page full. \fBFalse\fR: the mouse wheel
897     scrolls five lines [default].
898     .IP "\fBpastableTabs:\fR \fIboolean\fR" 4
899     .IX Item "pastableTabs: boolean"
900     \&\fBTrue\fR: store tabs as wide characters. \fBFalse\fR: interpret tabs as cursor
901     movement only; option \f(CW\*(C`\-ptab\*(C'\fR.
902     .IP "\fBcursorBlink:\fR \fIboolean\fR" 4
903     .IX Item "cursorBlink: boolean"
904     \&\fBTrue\fR: blink the cursor. \fBFalse\fR: do not blink the cursor [default];
905     option \fB\-bc\fR.
906     .IP "\fBpointerBlank:\fR \fIboolean\fR" 4
907     .IX Item "pointerBlank: boolean"
908     \&\fBTrue\fR: blank the pointer when a key is pressed or after a set number
909     of seconds of inactivity. \fBFalse\fR: the pointer is always visible
910     [default].
911     .IP "\fBpointerColor:\fR \fIcolour\fR" 4
912     .IX Item "pointerColor: colour"
913     Mouse pointer foreground colour.
914     .IP "\fBpointerColor2:\fR \fIcolour\fR" 4
915     .IX Item "pointerColor2: colour"
916     Mouse pointer background colour.
917     .IP "\fBpointerBlankDelay:\fR \fInumber\fR" 4
918     .IX Item "pointerBlankDelay: number"
919 root 1.21 Specifies number of seconds before blanking the pointer [default 2]. Use a
920     large number (e.g. \f(CW987654321\fR) to effectively disable the timeout.
921 root 1.1 .IP "\fBbackspacekey:\fR \fIstring\fR" 4
922     .IX Item "backspacekey: string"
923     The string to send when the backspace key is pressed. If set to \fB\s-1DEC\s0\fR
924     or unset it will send \fBDelete\fR (code 127) or, if shifted, \fBBackspace\fR
925     (code 8) \- which can be reversed with the appropriate \s-1DEC\s0 private mode
926     escape sequence.
927     .IP "\fBdeletekey:\fR \fIstring\fR" 4
928     .IX Item "deletekey: string"
929     The string to send when the delete key (not the keypad delete key) is
930     pressed. If unset it will send the sequence traditionally associated
931     with the \fBExecute\fR key.
932     .IP "\fBcutchars:\fR \fIstring\fR" 4
933     .IX Item "cutchars: string"
934 root 1.53 The characters used as delimiters for double-click word selection
935     (whitespace delimiting is added automatically if resource is given).
936     .Sp
937     When the selection extension is in use (the default if compiled in, see
938     the @@RXVT_NAME@@\fIperl\fR\|(3) manpage), a suitable regex using these characters
939     will be created (if the resource exists, otherwise, no regex will be
940     created). In this mode, characters outside \s-1ISO\-8859\-1\s0 can be used.
941     .Sp
942     When the selection extension is not used, only \s-1ISO\-8859\-1\s0 characters can
943     be used. If not specified, the built-in default is used:
944 root 1.1 .Sp
945     \&\fB\s-1BACKSLASH\s0 `"'&()*,;<=>?@[]{|}\fR
946     .IP "\fBpreeditType:\fR \fIstyle\fR" 4
947     .IX Item "preeditType: style"
948     \&\fBOverTheSpot\fR, \fBOffTheSpot\fR, \fBRoot\fR; option \fB\-pt\fR.
949     .IP "\fBinputMethod:\fR \fIname\fR" 4
950     .IX Item "inputMethod: name"
951     \&\fIname\fR of inputMethod to use; option \fB\-im\fR.
952     .IP "\fBimLocale:\fR \fIname\fR" 4
953     .IX Item "imLocale: name"
954 root 1.7 The locale to use for opening the \s-1IM\s0. You can use an \f(CW\*(C`LC_CTYPE\*(C'\fR of e.g.
955     \&\f(CW\*(C`de_DE.UTF\-8\*(C'\fR for normal text processing but \f(CW\*(C`ja_JP.EUC\-JP\*(C'\fR for the
956     input extension to be able to input japanese characters while staying in
957 root 1.31 another locale; option \fB\-imlocale\fR.
958 root 1.7 .IP "\fBimFont:\fR \fIfontset\fR" 4
959     .IX Item "imFont: fontset"
960     Specify the font-set used for \s-1XIM\s0 styles \f(CW\*(C`OverTheSpot\*(C'\fR or
961     \&\f(CW\*(C`OffTheSpot\*(C'\fR. It must be a standard X font set (\s-1XLFD\s0 patterns separated
962     by commas), i.e. it's not in the same format as the other font lists used
963     in @@RXVT_NAME@@. The default will be set-up to chose *any* suitable found
964     found, preferably one or two pixels differing in size to the base font.
965     option \fB\-imfont\fR.
966     .IP "\fBtripleclickwords:\fR \fIboolean\fR" 4
967     .IX Item "tripleclickwords: boolean"
968     Change the meaning of triple-click selection with the left mouse
969     button. Instead of selecting a full line it will extend the selection to
970 root 1.31 the end of the logical line only; option \fB\-tcw\fR.
971 root 1.1 .IP "\fBinsecure:\fR \fIboolean\fR" 4
972     .IX Item "insecure: boolean"
973     Enables \*(L"insecure\*(R" mode. Rxvt-unicode offers some escape sequences that
974     echo arbitrary strings like the icon name or the locale. This could be
975     abused if somebody gets 8\-bit\-clean access to your display, whether
976 root 1.27 through a mail client displaying mail bodies unfiltered or through
977     \&\fIwrite\fR\|(1) or any other means. Therefore, these sequences are disabled by
978     default. (Note that many other terminals, including xterm, have these
979     sequences enabled by default, which doesn't make it safer, though).
980     .Sp
981     You can enable them by setting this boolean resource or specifying
982     \&\fB\-insecure\fR as an option. At the moment, this enables display\-answer,
983 root 1.47 locale, findfont, icon label and window title requests.
984 root 1.1 .IP "\fBmodifier:\fR \fImodifier\fR" 4
985     .IX Item "modifier: modifier"
986     Set the key to be interpreted as the Meta key to: \fBalt\fR, \fBmeta\fR,
987     \&\fBhyper\fR, \fBsuper\fR, \fBmod1\fR, \fBmod2\fR, \fBmod3\fR, \fBmod4\fR, \fBmod5\fR; option
988     \&\fB\-mod\fR.
989     .IP "\fBanswerbackString:\fR \fIstring\fR" 4
990     .IX Item "answerbackString: string"
991     Specify the reply rxvt-unicode sends to the shell when an \s-1ENQ\s0 (control\-E)
992     character is passed through. It may contain escape values as described
993     in the entry on \fBkeysym\fR following.
994 root 1.49 .IP "\fBsecondaryScreen:\fR \fIboolean\fR" 4
995     .IX Item "secondaryScreen: boolean"
996 root 1.1 Turn on/off secondary screen (default enabled).
997 root 1.49 .IP "\fBsecondaryScroll:\fR \fIboolean\fR" 4
998     .IX Item "secondaryScroll: boolean"
999 root 1.1 Turn on/off secondary screen scroll (default enabled). If the this
1000     option is enabled, scrolls on the secondary screen will change the
1001     scrollback buffer and switching to/from the secondary screen will
1002     instead scroll the screen up.
1003 root 1.49 .IP "\fBhold\fR: \fIboolean\fR" 4
1004     .IX Item "hold: boolean"
1005 root 1.28 Turn on/off hold window after exit support. If enabled, @@RXVT_NAME@@
1006     will not immediately destroy its window when the program executed within
1007     it exits. Instead, it will wait till it is being killed or closed by the
1008     user.
1009 root 1.1 .IP "\fBkeysym.\fR\fIsym\fR: \fIstring\fR" 4
1010     .IX Item "keysym.sym: string"
1011 root 1.3 Compile \fIfrills\fR: Associate \fIstring\fR with keysym \fIsym\fR. The
1012     intervening resource name \fBkeysym.\fR cannot be omitted.
1013     .Sp
1014     The format of \fIsym\fR is "\fI(modifiers\-)key\fR", where \fImodifiers\fR can be
1015     any combination of \fBISOLevel3\fR, \fBAppKeypad\fR, \fBControl\fR, \fBNumLock\fR,
1016     \&\fBShift\fR, \fBMeta\fR, \fBLock\fR, \fBMod1\fR, \fBMod2\fR, \fBMod3\fR, \fBMod4\fR, \fBMod5\fR,
1017     and the abbreviated \fBI\fR, \fBK\fR, \fBC\fR, \fBN\fR, \fBS\fR, \fBM\fR, \fBA\fR, \fBL\fR, \fB1\fR,
1018     \&\fB2\fR, \fB3\fR, \fB4\fR, \fB5\fR.
1019     .Sp
1020     The \fBNumLock\fR, \fBMeta\fR and \fBISOLevel3\fR modifiers are usually aliased to
1021     whatever modifier the NumLock key, Meta/Alt keys or \s-1ISO\s0 Level3 Shift/AltGr
1022 root 1.7 keys are being mapped. \fBAppKeypad\fR is a synthetic modifier mapped to the
1023 root 1.3 current application keymap mode state.
1024     .Sp
1025     The spellings of \fIkey\fR can be obtained by using \fBxev\fR(1) command or
1026     searching keysym macros from \fB/usr/X11R6/include/X11/keysymdef.h\fR and
1027     omitting the prefix \fB\s-1XK_\s0\fR. Alternatively you can specify \fIkey\fR by its hex
1028     keysym value (\fB0x0000 \- 0xFFFF\fR). Note that the lookup of \fIsym\fRs is not
1029     performed in an exact manner; however, the closest match is assured.
1030     .Sp
1031     \&\fIstring\fR may contain escape values (\f(CW\*(C`\ea\*(C'\fR: bell, \f(CW\*(C`\eb\*(C'\fR: backspace,
1032     \&\f(CW\*(C`\ee\*(C'\fR, \f(CW\*(C`\eE\*(C'\fR: escape, \f(CW\*(C`\en\*(C'\fR: newline, \f(CW\*(C`\er\*(C'\fR: carriage return, \f(CW\*(C`\et\*(C'\fR: tab,
1033     \&\f(CW\*(C`\e000\*(C'\fR: octal number) or verbatim control characters (\f(CW\*(C`^?\*(C'\fR: delete,
1034     \&\f(CW\*(C`^@\*(C'\fR: null, \f(CW\*(C`^A\*(C'\fR ...) and may be enclosed with double quotes so that it
1035     can start or end with whitespace.
1036 root 1.2 .Sp
1037 root 1.43 Please note that you need to double the \f(CW\*(C`\e\*(C'\fR in resource files, as
1038 root 1.61 Xlib itself does its own de-escaping (you can use \f(CW\*(C`\e033\*(C'\fR instead of
1039 root 1.43 \&\f(CW\*(C`\ee\*(C'\fR (and so on), which will work with both Xt and @@RXVT_NAME@@'s own
1040     processing).
1041 root 1.12 .Sp
1042 root 1.2 You can define a range of keysyms in one shot by providing a \fIstring\fR
1043 root 1.3 with pattern \fBlist/PREFIX/MIDDLE/SUFFIX\fR, where the delimeter `/'
1044     should be a character not used by the strings.
1045 root 1.2 .Sp
1046     Its usage can be demonstrated by an example:
1047 root 1.3 .Sp
1048     .Vb 1
1049 root 1.60 \& URxvt.keysym.M\-C\-0x61: list|\e033<M\-C\-|abc|>
1050 root 1.3 .Ve
1051 root 1.2 .Sp
1052     The above line is equivalent to the following three lines:
1053 root 1.3 .Sp
1054     .Vb 3
1055 root 1.60 \& URxvt.keysym.Meta\-Control\-0x61: \e033<M\-C\-a>
1056     \& URxvt.keysym.Meta\-Control\-0x62: \e033<M\-C\-b>
1057     \& URxvt.keysym.Meta\-Control\-0x63: \e033<M\-C\-c>
1058 root 1.3 .Ve
1059     .Sp
1060 root 1.12 If \fIstring\fR takes the form of \f(CW\*(C`command:STRING\*(C'\fR, the specified \fB\s-1STRING\s0\fR
1061 root 1.7 is interpreted and executed as @@RXVT_NAME@@'s control sequence. For
1062     example the following means "change the current locale to \f(CW\*(C`zh_CN.GBK\*(C'\fR
1063     when Control-Meta-c is being pressed":
1064     .Sp
1065     .Vb 1
1066 root 1.60 \& URxvt.keysym.M\-C\-c: command:\e033]701;zh_CN.GBK\e007
1067 root 1.7 .Ve
1068     .Sp
1069 root 1.33 If \fIstring\fR takes the form \f(CW\*(C`perl:STRING\*(C'\fR, then the specified \fB\s-1STRING\s0\fR
1070     is passed to the \f(CW\*(C`on_keyboard_command\*(C'\fR perl handler. See the @@RXVT_NAME@@\fIperl\fR\|(3)
1071     manpage. For example, the \fIselection\fR extension (activated via
1072     \&\f(CW\*(C`@@RXVT_NAME@@ \-pe selection\*(C'\fR) listens for \f(CW\*(C`selection:rot13\*(C'\fR events:
1073     .Sp
1074     .Vb 1
1075 root 1.60 \& URxvt.keysym.M\-C\-c: perl:selection:rot13
1076 root 1.33 .Ve
1077     .Sp
1078 root 1.22 Due the the large number of modifier combinations, a defined key mapping
1079     will match if at \fIat least\fR the specified identifiers are being set, and
1080     no other key mappings with those and more bits are being defined. That
1081     means that defining a key map for \f(CW\*(C`a\*(C'\fR will automatically provide
1082     definitions for \f(CW\*(C`Meta\-a\*(C'\fR, \f(CW\*(C`Shift\-a\*(C'\fR and so on, unless some of those are defined
1083     mappings themselves.
1084     .Sp
1085     Unfortunately, this will override built-in key mappings. For example
1086     if you overwrite the \f(CW\*(C`Insert\*(C'\fR key you will disable @@RXVT_NAME@@'s
1087     \&\f(CW\*(C`Shift\-Insert\*(C'\fR mapping. To re-enable that, you can poke \*(L"holes\*(R" into the
1088     user-defined keymap using the \f(CW\*(C`builtin:\*(C'\fR replacement:
1089     .Sp
1090     .Vb 2
1091     \& URxvt.keysym.Insert: <my insert key sequence>
1092 root 1.60 \& URxvt.keysym.S\-Insert: builtin:
1093 root 1.22 .Ve
1094     .Sp
1095     The first line defines a mapping for \f(CW\*(C`Insert\*(C'\fR and \fIany\fR combination
1096     of modifiers. The second line re-establishes the default mapping for
1097     \&\f(CW\*(C`Shift\-Insert\*(C'\fR.
1098     .Sp
1099 root 1.7 The following example will map Control\-Meta\-1 and Control\-Meta\-2 to
1100 root 1.12 the fonts \f(CW\*(C`suxuseuro\*(C'\fR and \f(CW\*(C`9x15bold\*(C'\fR, so you can have some limited
1101 root 1.7 font-switching at runtime:
1102     .Sp
1103     .Vb 2
1104 root 1.60 \& URxvt.keysym.M\-C\-1: command:\e033]50;suxuseuro\e007
1105     \& URxvt.keysym.M\-C\-2: command:\e033]50;9x15bold\e007
1106 root 1.7 .Ve
1107     .Sp
1108 root 1.12 Other things are possible, e.g. resizing (see @@RXVT_NAME@@(7) for more
1109     info):
1110     .Sp
1111     .Vb 2
1112 root 1.60 \& URxvt.keysym.M\-C\-3: command:\e033[8;25;80t
1113     \& URxvt.keysym.M\-C\-4: command:\e033[8;48;110t
1114 root 1.12 .Ve
1115 root 1.36 .IP "\fBperl-ext-common\fR: \fIstring\fR" 4
1116     .IX Item "perl-ext-common: string"
1117     .PD 0
1118 root 1.32 .IP "\fBperl-ext\fR: \fIstring\fR" 4
1119     .IX Item "perl-ext: string"
1120 root 1.36 .PD
1121 root 1.39 Comma-separated list(s) of perl extension scripts (default: \f(CW\*(C`default\*(C'\fR) to
1122     use in this terminal instance; option \fB\-pe\fR.
1123     .Sp
1124     Extension names can be prefixed with a \f(CW\*(C`\-\*(C'\fR sign to prohibit using
1125 root 1.41 them. This can be useful to selectively disable some extensions loaded
1126 root 1.39 by default, or specified via the \f(CW\*(C`perl\-ext\-common\*(C'\fR resource. For
1127     example, \f(CW\*(C`default,\-selection\*(C'\fR will use all the default extension except
1128     \&\f(CW\*(C`selection\*(C'\fR.
1129     .Sp
1130 root 1.41 Extension names can also be followed by an argument in angle brackets
1131     (e.g. \f(CW\*(C`searchable\-scrollback<M\-s>\*(C'\fR, which binds the hotkey for
1132     searchable scorllback to Alt/Meta\-s). Mentioning the same extension
1133     multiple times with different arguments will pass multiple arguments to
1134     the extension.
1135     .Sp
1136 root 1.39 Each extension is looked up in the library directories, loaded if
1137     necessary, and bound to the current terminal instance.
1138     .Sp
1139     If both of these resources are the empty string, then the perl
1140     interpreter will not be initialized. The idea behind two options is that
1141     \&\fBperl-ext-common\fR will be used for extensions that should be available to
1142     all instances, while \fBperl-ext\fR is used for specific instances.
1143 root 1.31 .IP "\fBperl-eval\fR: \fIstring\fR" 4
1144     .IX Item "perl-eval: string"
1145 root 1.40 Perl code to be evaluated when all extensions have been registered. See
1146     the @@RXVT_NAME@@\fIperl\fR\|(3) manpage. Due to security reasons, this resource
1147     will be ignored when running setuid/setgid.
1148 root 1.31 .IP "\fBperl-lib\fR: \fIpath\fR" 4
1149     .IX Item "perl-lib: path"
1150 root 1.32 Colon-separated list of additional directories that hold extension
1151     scripts. When looking for extensions specified by the \f(CW\*(C`perl\*(C'\fR resource,
1152     @@RXVT_NAME@@ will first look in these directories and then in
1153 root 1.40 \&\fI@@RXVT_LIBDIR@@/urxvt/perl/\fR. Due to security reasons, this resource
1154     will be ignored when running setuid/setgid.
1155 root 1.31 .Sp
1156 root 1.33 See the @@RXVT_NAME@@\fIperl\fR\|(3) manpage.
1157 root 1.45 .IP "\fBselection.pattern\-\f(BIidx\fB\fR: \fIperl-regex\fR" 4
1158     .IX Item "selection.pattern-idx: perl-regex"
1159     Additional selection patterns, see the @@RXVT_NAME@@\fIperl\fR\|(3) manpage for
1160     details.
1161     .IP "\fBselection\-autotransform.\f(BIidx\fB\fR: \fIperl-transform\fR" 4
1162     .IX Item "selection-autotransform.idx: perl-transform"
1163     Selection auto-transform patterns, see the @@RXVT_NAME@@\fIperl\fR\|(3) manpage
1164     for details.
1165 root 1.44 .IP "\fBsearchable\-scrollback:\fR \fIkeysym\fR" 4
1166     .IX Item "searchable-scrollback: keysym"
1167     Sets the hotkey that starts the incremental scrollback buffer search
1168     (default: \f(CW\*(C`M\-s\*(C'\fR).
1169 root 1.42 .IP "\fBurlLauncher\fR: \fIstring\fR" 4
1170     .IX Item "urlLauncher: string"
1171     Specifies the program to be started with a \s-1URL\s0 argument. Used by the
1172     \&\f(CW\*(C`selection\-popup\*(C'\fR and \f(CW\*(C`mark\-urls\*(C'\fR perl extensions.
1173 root 1.40 .IP "\fBtransient-for\fR: \fIwindowid\fR" 4
1174     .IX Item "transient-for: windowid"
1175 root 1.49 Compile \fIfrills\fR: Sets the \s-1WM_TRANSIENT_FOR\s0 property to the given window id.
1176     .IP "\fBoverride-redirect\fR: \fIboolean\fR" 4
1177     .IX Item "override-redirect: boolean"
1178     Compile \fIfrills\fR: Sets override-redirect for the terminal window, making
1179     it almost invisible to window managers; option \fB\-override\-redirect\fR.
1180 root 1.1 .SH "THE SCROLLBAR"
1181     .IX Header "THE SCROLLBAR"
1182     Lines of text that scroll off the top of the \fB@@RXVT_NAME@@\fR window
1183     (resource: \fBsaveLines\fR) and can be scrolled back using the scrollbar
1184     or by keystrokes. The normal \fB@@RXVT_NAME@@\fR scrollbar has arrows and
1185     its behaviour is fairly intuitive. The \fBxterm-scrollbar\fR is without
1186     arrows and its behaviour mimics that of \fIxterm\fR
1187     .PP
1188     Scroll down with \fBButton1\fR (\fBxterm-scrollbar\fR) or \fBShift-Next\fR.
1189     Scroll up with \fBButton3\fR (\fBxterm-scrollbar\fR) or \fBShift-Prior\fR.
1190     Continuous scroll with \fBButton2\fR.
1191     .SH "MOUSE REPORTING"
1192     .IX Header "MOUSE REPORTING"
1193     To temporarily override mouse reporting, for either the scrollbar or
1194     the normal text selection/insertion, hold either the Shift or the Meta
1195     (Alt) key while performing the desired mouse action.
1196     .PP
1197     If mouse reporting mode is active, the normal scrollbar actions are
1198     disabled \*(-- on the assumption that we are using a fullscreen
1199 root 1.12 application. Instead, pressing Button1 and Button3 sends \fB\s-1ESC\s0 [ 6 ~\fR
1200     (Next) and \fB\s-1ESC\s0 [ 5 ~\fR (Prior), respectively. Similarly, clicking on the
1201     up and down arrows sends \fB\s-1ESC\s0 [ A\fR (Up) and \fB\s-1ESC\s0 [ B\fR (Down),
1202 root 1.1 respectively.
1203     .SH "TEXT SELECTION AND INSERTION"
1204     .IX Header "TEXT SELECTION AND INSERTION"
1205     The behaviour of text selection and insertion mechanism is similar to
1206     \&\fIxterm\fR(1).
1207     .IP "\fBSelection\fR:" 4
1208     .IX Item "Selection:"
1209 root 1.7 Left click at the beginning of the region, drag to the end of the region
1210     and release; Right click to extend the marked region; Left double-click
1211     to select a word; Left triple-click to select the entire logical line
1212     (which can span multiple screen lines), unless modified by resource
1213     \&\fBtripleclickwords\fR.
1214 root 1.1 .Sp
1215     Starting a selection while pressing the \fBMeta\fR key (or \fBMeta+Ctrl\fR keys)
1216 root 1.29 (Compile: \fIfrills\fR) will create a rectangular selection instead of a
1217     normal one. In this mode, every selected row becomes its own line in the
1218     selection, and trailing whitespace is visually underlined and removed from
1219     the selection.
1220 root 1.1 .IP "\fBInsertion\fR:" 4
1221     .IX Item "Insertion:"
1222 root 1.52 Pressing and releasing the Middle mouse button in an \fB@@RXVT_NAME@@\fR
1223     window causes the value of the \s-1PRIMARY\s0 selection (or \s-1CLIPBOARD\s0 with the
1224     Meta modifier) to be inserted as if it had been typed on the keyboard.
1225     .Sp
1226     Pressing \fBShift-Insert\fR causes the value of the \s-1PRIMARY\s0 selection to be
1227     inserted too.
1228 root 1.1 .SH "CHANGING FONTS"
1229     .IX Header "CHANGING FONTS"
1230     Changing fonts (or font sizes, respectively) via the keypad is not yet
1231     supported in rxvt\-unicode. Bug me if you need this.
1232     .PP
1233 root 1.47 You can, however, switch fonts at runtime using escape sequences, e.g.:
1234 root 1.1 .PP
1235     .Vb 1
1236 root 1.27 \& printf '\ee]710;%s\e007' "9x15bold,xft:Kochi Gothic"
1237 root 1.1 .Ve
1238     .PP
1239 root 1.47 You can use keyboard shortcuts, too:
1240     .PP
1241     .Vb 2
1242 root 1.60 \& URxvt.keysym.M\-C\-1: command:\e033]710;suxuseuro\e007\e033]711;suxuseuro\e007
1243     \& URxvt.keysym.M\-C\-2: command:\e033]710;9x15bold\e007\e033]711;9x15bold\e007
1244 root 1.47 .Ve
1245     .PP
1246 root 1.1 rxvt-unicode will automatically re-apply these fonts to the output so far.
1247     .SH "ISO 14755 SUPPORT"
1248     .IX Header "ISO 14755 SUPPORT"
1249     \&\s-1ISO\s0 14755 is a standard for entering and viewing unicode characters
1250     and character codes using the keyboard. It consists of 4 parts. The
1251     first part is available rxvt-unicode has been compiled with
1252     \&\f(CW\*(C`\-\-enable\-frills\*(C'\fR, the rest is available when rxvt-unicode was compiled
1253     with \f(CW\*(C`\-\-enable\-iso14755\*(C'\fR.
1254 root 1.60 .IP "\(bu" 4
1255     5.1: Basic method
1256     .Sp
1257 root 1.1 This allows you to enter unicode characters using their hexcode.
1258     .Sp
1259     Start by pressing and holding both \f(CW\*(C`Control\*(C'\fR and \f(CW\*(C`Shift\*(C'\fR, then enter
1260     hex-digits (between one and six). Releasing \f(CW\*(C`Control\*(C'\fR and \f(CW\*(C`Shift\*(C'\fR will
1261     commit the character as if it were typed directly. While holding down
1262     \&\f(CW\*(C`Control\*(C'\fR and \f(CW\*(C`Shift\*(C'\fR you can also enter multiple characters by pressing
1263     \&\f(CW\*(C`Space\*(C'\fR, which will commit the current character and lets you start a new
1264     one.
1265     .Sp
1266     As an example of use, imagine a business card with a japanese e\-mail
1267     address, which you cannot type. Fortunately, the card has the e\-mail
1268     address printed as hexcodes, e.g. \f(CW\*(C`671d 65e5\*(C'\fR. You can enter this easily
1269     by pressing \f(CW\*(C`Control\*(C'\fR and \f(CW\*(C`Shift\*(C'\fR, followed by \f(CW\*(C`6\-7\-1\-D\-SPACE\-6\-5\-E\-5\*(C'\fR,
1270     followed by releasing the modifier keys.
1271 root 1.60 .IP "\(bu" 4
1272     5.2: Keyboard symbols entry method
1273     .Sp
1274 root 1.1 This mode lets you input characters representing the keycap symbols of
1275     your keyboard, if representable in the current locale encoding.
1276     .Sp
1277     Start by pressing \f(CW\*(C`Control\*(C'\fR and \f(CW\*(C`Shift\*(C'\fR together, then releasing
1278     them. The next special key (cursor keys, home etc.) you enter will not
1279 root 1.61 invoke its usual function but instead will insert the corresponding
1280 root 1.1 keycap symbol. The symbol will only be entered when the key has been
1281     released, otherwise pressing e.g. \f(CW\*(C`Shift\*(C'\fR would enter the symbol for
1282     \&\f(CW\*(C`ISO Level 2 Switch\*(C'\fR, although your intention might have been to enter a
1283     reverse tab (Shift\-Tab).
1284 root 1.60 .IP "\(bu" 4
1285     5.3: Screen-selection entry method
1286     .Sp
1287 root 1.1 While this is implemented already (it's basically the selection
1288     mechanism), it could be extended by displaying a unicode character map.
1289 root 1.60 .IP "\(bu" 4
1290     5.4: Feedback method for identifying displayed characters for later input
1291     .Sp
1292 root 1.1 This method lets you display the unicode character code associated with
1293     characters already displayed.
1294     .Sp
1295     You enter this mode by holding down \f(CW\*(C`Control\*(C'\fR and \f(CW\*(C`Shift\*(C'\fR together, then
1296     pressing and holding the left mouse button and moving around. The unicode
1297     hex code(s) (it might be a combining character) of the character under the
1298     pointer is displayed until you release \f(CW\*(C`Control\*(C'\fR and \f(CW\*(C`Shift\*(C'\fR.
1299     .Sp
1300     In addition to the hex codes it will display the font used to draw this
1301     character \- due to implementation reasons, characters combined with
1302     combining characters, line drawing characters and unknown characters will
1303     always be drawn using the built-in support font.
1304     .PP
1305     With respect to conformance, rxvt-unicode is supposed to be compliant to
1306     both scenario A and B of \s-1ISO\s0 14755, including part 5.2.
1307     .SH "LOGIN STAMP"
1308     .IX Header "LOGIN STAMP"
1309 root 1.7 \&\fB@@RXVT_NAME@@\fR tries to write an entry into the \fIutmp\fR(5) file so that
1310     it can be seen via the \fI\fIwho\fI\|(1)\fR command, and can accept messages. To
1311     allow this feature, \fB@@RXVT_NAME@@\fR may need to be installed setuid root
1312     on some systems or setgid to root or to some other group on others.
1313 root 1.1 .SH "COLORS AND GRAPHICS"
1314     .IX Header "COLORS AND GRAPHICS"
1315     In addition to the default foreground and background colours,
1316     \&\fB@@RXVT_NAME@@\fR can display up to 16 colours (8 \s-1ANSI\s0 colours plus
1317     high-intensity bold/blink versions of the same). Here is a list of the
1318 root 1.55 colours with their names.
1319 root 1.1 .TS
1320     l l l .
1321     color0 (black) = Black
1322     color1 (red) = Red3
1323     color2 (green) = Green3
1324     color3 (yellow) = Yellow3
1325     color4 (blue) = Blue3
1326     color5 (magenta) = Magenta3
1327     color6 (cyan) = Cyan3
1328     color7 (white) = AntiqueWhite
1329     color8 (bright black) = Grey25
1330     color9 (bright red) = Red
1331     color10 (bright green) = Green
1332     color11 (bright yellow) = Yellow
1333     color12 (bright blue) = Blue
1334     color13 (bright magenta) = Magenta
1335     color14 (bright cyan) = Cyan
1336     color15 (bright white) = White
1337     foreground = Black
1338     background = White
1339     .TE
1340     .PP
1341     It is also possible to specify the colour values of \fBforeground\fR,
1342     \&\fBbackground\fR, \fBcursorColor\fR, \fBcursorColor2\fR, \fBcolorBD\fR, \fBcolorUL\fR as
1343     a number 0\-15, as a convenient shorthand to reference the colour name of
1344     color0\-color15.
1345     .PP
1346 root 1.58 In addition to the colours defined above, @@RXVT_NAME@@ offers an
1347     additional 72 colours. The first 64 of those (with indices 16 to 79)
1348     consist of a 4*4*4 \s-1RGB\s0 colour cube (i.e. \fIindex = r * 16 + g * 4 + b +
1349     16\fR), followed by 8 additional shades of gray (with indices 80 to 87).
1350     .PP
1351     Together, all those colours implement the 88 colour xterm colours. Only
1352     the first 16 can be changed using resources currently, the rest can only
1353     be changed via command sequences (\*(L"escape codes\*(R").
1354     .PP
1355 root 1.1 Note that \fB\-rv\fR (\fB\*(L"reverseVideo: True\*(R"\fR) simulates reverse video by
1356     always swapping the foreground/background colours. This is in contrast to
1357     \&\fIxterm\fR(1) where the colours are only swapped if they have not otherwise
1358     been specified. For example,
1359     .IP "\fB@@RXVT_NAME@@ \-fg Black \-bg White \-rv\fR" 4
1360     .IX Item "@@RXVT_NAME@@ -fg Black -bg White -rv"
1361     would yield White on Black, while on \fIxterm\fR(1) it would yield Black
1362     on White.
1363 root 1.57 .Sh "\s-1ALPHA\s0 \s-1CHANNEL\s0 \s-1SUPPORT\s0"
1364     .IX Subsection "ALPHA CHANNEL SUPPORT"
1365     If Xft support has been compiled in and as long as Xft/Xrender/X don't get
1366     their act together, rxvt-unicode will support \f(CW\*(C`rgba:rrrr/gggg/bbbb/aaaa\*(C'\fR
1367     (recommended, but \fB\s-1MUST\s0\fR have 4 digits/component) colour specifications,
1368     in addition to the ones provided by X, where the additional A component
1369     specifies opacity (alpha) values. The minimum value of \f(CW0\fR is completely
1370     transparent). You can also prefix any color with \f(CW\*(C`[a]\*(C'\fR, where \f(CW\*(C`a\*(C'\fR is on
1371     to four hex digits specifiying the opacity value.
1372     .PP
1373     You probably need to specify \fB\*(L"\-depth 32\*(R"\fR, too, and have the luck that
1374     your X\-server uses \s-1ARGB\s0 pixel layout, as X is far from just supporting
1375     \&\s-1ARGB\s0 visuals out of the box, and rxvt-unicode just fudges around.
1376     .PP
1377     For example, the following selects an almost completely transparent red
1378     background, and an almost opaque pink foreground:
1379     .PP
1380     .Vb 1
1381 root 1.60 \& @@RXVT_NAME@@ \-depth 32 \-bg rgba:0000/0000/0000/2222 \-fg "[e]pink"
1382 root 1.57 .Ve
1383     .PP
1384     \&\fIPlease note that transparency of any kind if completely unsupported by
1385     the author. Don't bug him with installation questions!\fR
1386 root 1.1 .SH "ENVIRONMENT"
1387     .IX Header "ENVIRONMENT"
1388 root 1.12 \&\fB@@RXVT_NAME@@\fR sets and/or uses the following environment variables:
1389     .IP "\fB\s-1TERM\s0\fR" 4
1390     .IX Item "TERM"
1391     Normally set to \f(CW\*(C`rxvt\-unicode\*(C'\fR, unless overwritten at configure time, via
1392     resources or on the commandline.
1393     .IP "\fB\s-1COLORTERM\s0\fR" 4
1394     .IX Item "COLORTERM"
1395     Either \f(CW\*(C`rxvt\*(C'\fR, \f(CW\*(C`rxvt\-xpm\*(C'\fR, depending on wether @@RXVT_NAME@@ was
1396     compiled with \s-1XPM\s0 support, and optionally with the added extension
1397     \&\f(CW\*(C`\-mono\*(C'\fR to indicate that rxvt-unicode runs on a monochrome screen.
1398     .IP "\fB\s-1COLORFGBG\s0\fR" 4
1399     .IX Item "COLORFGBG"
1400     Set to a string of the form \f(CW\*(C`fg;bg\*(C'\fR or \f(CW\*(C`fg;xpm;bg\*(C'\fR, where \f(CW\*(C`fg\*(C'\fR is
1401     the colour code used as default foreground/text colour (or the string
1402     \&\f(CW\*(C`default\*(C'\fR to indicate that the default-colour escape sequence is to be
1403     used), \f(CW\*(C`bg\*(C'\fR is the colour code used as default background colour (or the
1404     string \f(CW\*(C`default\*(C'\fR), and \f(CW\*(C`xpm\*(C'\fR is the string \f(CW\*(C`default\*(C'\fR if @@RXVT_NAME@@
1405 root 1.13 was compiled with \s-1XPM\s0 support. Libraries like \f(CW\*(C`ncurses\*(C'\fR and \f(CW\*(C`slang\*(C'\fR can
1406     (and do) use this information to optimize screen output.
1407 root 1.12 .IP "\fB\s-1WINDOWID\s0\fR" 4
1408     .IX Item "WINDOWID"
1409     Set to the (decimal) X Window \s-1ID\s0 of the @@RXVT_NAME@@ window (the toplevel
1410     window, which usually has subwindows for the scrollbar, the terminal
1411     window and so on).
1412     .IP "\fB\s-1TERMINFO\s0\fR" 4
1413     .IX Item "TERMINFO"
1414     Set to the terminfo directory iff @@RXVT_NAME@@ was configured with
1415     \&\f(CW\*(C`\-\-with\-terminfo=PATH\*(C'\fR.
1416     .IP "\fB\s-1DISPLAY\s0\fR" 4
1417     .IX Item "DISPLAY"
1418     Used by @@RXVT_NAME@@ to connect to the display and set to the correct
1419 root 1.61 display in its child processes.
1420 root 1.12 .IP "\fB\s-1SHELL\s0\fR" 4
1421     .IX Item "SHELL"
1422     The shell to be used for command execution, defaults to \f(CW\*(C`/bin/sh\*(C'\fR.
1423     .IP "\fB\s-1RXVT_SOCKET\s0\fR" 4
1424     .IX Item "RXVT_SOCKET"
1425     The unix domain socket path used by @@RXVT_NAME@@c(1) and
1426     @@RXVT_NAME@@d(1).
1427     .Sp
1428 root 1.60 Default \fI\f(CI$HOME\fI/.rxvt\-unicode\-\fI<nodename\fI\fR.
1429 root 1.12 .IP "\fB\s-1HOME\s0\fR" 4
1430     .IX Item "HOME"
1431     Used to locate the default directory for the unix domain socket for
1432     daemon communications and to locate various resource files (such as
1433     \&\f(CW\*(C`.Xdefaults\*(C'\fR)
1434     .IP "\fB\s-1XAPPLRESDIR\s0\fR" 4
1435     .IX Item "XAPPLRESDIR"
1436     Directory where various X resource files are being located.
1437     .IP "\fB\s-1XENVIRONMENT\s0\fR" 4
1438     .IX Item "XENVIRONMENT"
1439     If set and accessible, gives the name of a X resource file to be loaded by
1440     @@RXVT_NAME@@.
1441 root 1.1 .SH "FILES"
1442     .IX Header "FILES"
1443     .IP "\fB/usr/lib/X11/rgb.txt\fR" 4
1444     .IX Item "/usr/lib/X11/rgb.txt"
1445     Color names.
1446     .SH "SEE ALSO"
1447     .IX Header "SEE ALSO"
1448 root 1.24 @@RXVT_NAME@@(7), @@RXVT_NAME@@c(1), @@RXVT_NAME@@d(1), \fIxterm\fR\|(1), \fIsh\fR\|(1), \fIresize\fR\|(1), X(1), \fIpty\fR\|(4), \fItty\fR\|(4), \fIutmp\fR\|(5)
1449 root 1.1 .SH "CURRENT PROJECT COORDINATOR"
1450     .IX Header "CURRENT PROJECT COORDINATOR"
1451     .IP "Project Coordinator" 4
1452     .IX Item "Project Coordinator"
1453 root 1.14 Marc A. Lehmann <rxvt\-unicode@schmorp.de>
1454 root 1.1 .Sp
1455 root 1.60 <http://software.schmorp.de/pkg/rxvt\-unicode.html>
1456 root 1.1 .SH "AUTHORS"
1457     .IX Header "AUTHORS"
1458     .IP "John Bovey" 4
1459     .IX Item "John Bovey"
1460     University of Kent, 1992, wrote the original Xvt.
1461     .IP "Rob Nation <nation@rocket.sanders.lockheed.com>" 4
1462     .IX Item "Rob Nation <nation@rocket.sanders.lockheed.com>"
1463     very heavily modified Xvt and came up with Rxvt
1464     .IP "Angelo Haritsis <ah@doc.ic.ac.uk>" 4
1465     .IX Item "Angelo Haritsis <ah@doc.ic.ac.uk>"
1466     wrote the Greek Keyboard Input (no longer in code)
1467     .IP "mj olesen <olesen@me.QueensU.CA>" 4
1468     .IX Item "mj olesen <olesen@me.QueensU.CA>"
1469     Wrote the menu system.
1470     .Sp
1471     Project Coordinator (changes.txt 2.11 to 2.21)
1472     .IP "Oezguer Kesim <kesim@math.fu\-berlin.de>" 4
1473     .IX Item "Oezguer Kesim <kesim@math.fu-berlin.de>"
1474     Project Coordinator (changes.txt 2.21a to 2.4.5)
1475     .IP "Geoff Wing <gcw@pobox.com>" 4
1476     .IX Item "Geoff Wing <gcw@pobox.com>"
1477 root 1.49 Rewrote screen display and text selection routines.
1478     .Sp
1479     Project Coordinator (changes.txt 2.4.6 \- rxvt\-unicode)
1480 root 1.14 .IP "Marc Alexander Lehmann <rxvt\-unicode@schmorp.de>" 4
1481     .IX Item "Marc Alexander Lehmann <rxvt-unicode@schmorp.de>"
1482 root 1.49 Forked rxvt\-unicode, unicode support, rewrote almost all the code, perl
1483     extension, random hacks, numerous bugfixes and extensions.
1484 root 1.1 .Sp
1485     Project Coordinator (Changes 1.0 \-)
1486 root 1.49 .IP "Emanuele Giaquinta <e.giaquinta@glauco.it>" 4
1487     .IX Item "Emanuele Giaquinta <e.giaquinta@glauco.it>"
1488 root 1.50 Pty/tty/utmp/wtmp rewrite, lots of random hacking and bugfixing.