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

Comparing rxvt-unicode/doc/rxvt.1.html (file contents):
Revision 1.1 by root, Tue Jan 11 02:24:59 2005 UTC vs.
Revision 1.56 by root, Tue Jan 31 00:25:16 2006 UTC

… …
24 <li><a href="#text_selection_and_insertion">TEXT SELECTION AND INSERTION</a></li> 24 <li><a href="#text_selection_and_insertion">TEXT SELECTION AND INSERTION</a></li>
25 <li><a href="#changing_fonts">CHANGING FONTS</a></li> 25 <li><a href="#changing_fonts">CHANGING FONTS</a></li>
26 <li><a href="#iso_14755_support">ISO 14755 SUPPORT</a></li> 26 <li><a href="#iso_14755_support">ISO 14755 SUPPORT</a></li>
27 <li><a href="#login_stamp">LOGIN STAMP</a></li> 27 <li><a href="#login_stamp">LOGIN STAMP</a></li>
28 <li><a href="#colors_and_graphics">COLORS AND GRAPHICS</a></li> 28 <li><a href="#colors_and_graphics">COLORS AND GRAPHICS</a></li>
29 <ul>
30
31 <li><a href="#alpha_channel_support">ALPHA CHANNEL SUPPORT</a></li>
32 </ul>
33
29 <li><a href="#environment">ENVIRONMENT</a></li> 34 <li><a href="#environment">ENVIRONMENT</a></li>
30 <li><a href="#files">FILES</a></li> 35 <li><a href="#files">FILES</a></li>
31 <li><a href="#see_also">SEE ALSO</a></li> 36 <li><a href="#see_also">SEE ALSO</a></li>
32 <li><a href="#bugs">BUGS</a></li>
33 <li><a href="#current_project_coordinator">CURRENT PROJECT COORDINATOR</a></li> 37 <li><a href="#current_project_coordinator">CURRENT PROJECT COORDINATOR</a></li>
34 <li><a href="#authors">AUTHORS</a></li> 38 <li><a href="#authors">AUTHORS</a></li>
35</ul> 39</ul>
36<!-- INDEX END --> 40<!-- INDEX END -->
37 41
… …
47<p><strong>rxvt</strong> [options] [-e command [ args ]]</p> 51<p><strong>rxvt</strong> [options] [-e command [ args ]]</p>
48<p> 52<p>
49</p> 53</p>
50<hr /> 54<hr />
51<h1><a name="description">DESCRIPTION</a></h1> 55<h1><a name="description">DESCRIPTION</a></h1>
52<p><strong>rxvt-unicode</strong>, version <strong>4.8</strong>, is a colour vt102 terminal 56<p><strong>rxvt-unicode</strong>, version <strong>7.5</strong>, is a colour vt102 terminal
53emulator intended as an <em>xterm</em>(1) replacement for users who do not 57emulator intended as an <em>xterm</em>(1) replacement for users who do not
54require features such as Tektronix 4014 emulation and toolkit-style 58require features such as Tektronix 4014 emulation and toolkit-style
55configurability. As a result, <strong>rxvt-unicode</strong> uses much less swap space -- 59configurability. As a result, <strong>rxvt-unicode</strong> uses much less swap space --
56a significant advantage on a machine serving many X sessions.</p> 60a significant advantage on a machine serving many X sessions.</p>
57<p> 61<p>
58</p> 62</p>
59<hr /> 63<hr />
60<h1><a name="frequently_asked_questions">FREQUENTLY ASKED QUESTIONS</a></h1> 64<h1><a name="frequently_asked_questions">FREQUENTLY ASKED QUESTIONS</a></h1>
61<p>See <code>rxvt(7)</code> (try <code>man 7 rxvt</code>) for a list of frequently 65<p>See <code>rxvt(7)</code> (try <code>man 7 rxvt</code>) for a list of
62asked questions and answer to them and some common problems.</p> 66frequently asked questions and answer to them and some common
67problems. That document is also accessible on the World-Wide-Web at
68<a href="http://cvs.schmorp.de/browse/*checkout*/rxvt-unicode/doc/rxvt.7.html">http://cvs.schmorp.de/browse/*checkout*/rxvt-unicode/doc/rxvt.7.html</a>.</p>
63<p> 69<p>
64</p> 70</p>
65<hr /> 71<hr />
66<h1><a name="rxvtunicode_vs__rxvt">RXVT-UNICODE VS. RXVT</a></h1> 72<h1><a name="rxvtunicode_vs__rxvt">RXVT-UNICODE VS. RXVT</a></h1>
67<p>Unlike the original rxvt, <strong>rxvt-unicode</strong> stores all text in Unicode 73<p>Unlike the original rxvt, <strong>rxvt-unicode</strong> stores all text in Unicode
… …
130Attempt to open a window on the named X display (<strong>-d</strong> still 136Attempt to open a window on the named X display (<strong>-d</strong> still
131respected). In the absence of this option, the display specified by the 137respected). In the absence of this option, the display specified by the
132<strong>DISPLAY</strong> environment variable is used. 138<strong>DISPLAY</strong> environment variable is used.
133</dd> 139</dd>
134<p></p> 140<p></p>
141<dt><strong><a name="item__2ddepth_bitdepth"><strong>-depth</strong> <em>bitdepth</em></a></strong><br />
142</dt>
143<dd>
144Compile <em>xft</em>: Attempt to find a visual with the given bit depth;
145resource <strong>depth</strong>.
146</dd>
147<p></p>
135<dt><strong><a name="item__2dgeometry_geom"><strong>-geometry</strong> <em>geom</em></a></strong><br /> 148<dt><strong><a name="item__2dgeometry_geom"><strong>-geometry</strong> <em>geom</em></a></strong><br />
136</dt> 149</dt>
137<dd> 150<dd>
138Window geometry (<strong>-g</strong> still respected); resource <strong>geometry</strong>. 151Window geometry (<strong>-g</strong> still respected); resource <strong>geometry</strong>.
139</dd> 152</dd>
… …
148</dt> 161</dt>
149<dd> 162<dd>
150Turn on/off jump scrolling; resource <strong>jumpScroll</strong>. 163Turn on/off jump scrolling; resource <strong>jumpScroll</strong>.
151</dd> 164</dd>
152<p></p> 165<p></p>
153<dt><strong><a name="item__2dip_7c_2bip"><strong>-ip</strong>|<strong>+ip</strong></a></strong><br /> 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 />
154</dt> 167</dt>
155<dd> 168<dd>
156Turn on/off inheriting parent window's pixmap. Alternative form is 169Turn on/off inheriting parent window's pixmap. Alternative form is
157<strong>-tr</strong>; resource <strong>inheritPixmap</strong>. 170<strong>-tr</strong>; resource <strong>inheritPixmap</strong>.
158</dd> 171</dd>
172<dd>
173<p><em>Please note that transparency of any kind if completely unsupported by
174the author. Don't bug him with installation questions!</em></p>
175</dd>
159<p></p> 176<p></p>
160<dt><strong><a name="item__2dfade_number"><strong>-fade</strong> <em>number</em></a></strong><br /> 177<dt><strong><a name="item__2dfade_number"><strong>-fade</strong> <em>number</em></a></strong><br />
161</dt> 178</dt>
162<dd> 179<dd>
163Fade the text by the given percentage when focus is lost. resource <strong>fading</strong>. 180Fade the text by the given percentage when focus is lost. Small values
181fade a little only, 100 completely replaces all colours by the fade
182colour; 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>
188Fade to this colour when fading is used (see <strong>-fade</strong>). The default colour
189is opaque black. resource <strong>fadeColor</strong>.
164</dd> 190</dd>
165<p></p> 191<p></p>
166<dt><strong><a name="item__2dtint_colour"><strong>-tint</strong> <em>colour</em></a></strong><br /> 192<dt><strong><a name="item__2dtint_colour"><strong>-tint</strong> <em>colour</em></a></strong><br />
167</dt> 193</dt>
168<dd> 194<dd>
169Tint the transparent background pixmap with the given colour when 195Tint the transparent background pixmap with the given colour when
170transparency is enabled with <strong>-tr</strong> or <strong>-ip</strong>. See also the <strong>-sh</strong> 196transparency is enabled with <strong>-tr</strong> or <strong>-ip</strong>. This only works for
171option that can be used to brighten or darken the image in addition to 197non-tiled backgrounds, currently. See also the <strong>-sh</strong> option that can be
172tinting it. 198used to brighten or darken the image in addition to tinting it; resource
199<em>tintColor</em>. Example:
200</dd>
201<dd>
202<pre>
203 rxvt -tr -tint blue -sh 40</pre>
173</dd> 204</dd>
174<p></p> 205<p></p>
175<dt><strong><a name="item__2dsh"><strong>-sh</strong></a></strong><br /> 206<dt><strong><a name="item__2dsh"><strong>-sh</strong></a></strong><br />
176</dt> 207</dt>
177<dd> 208<dd>
… …
194<p></p> 225<p></p>
195<dt><strong><a name="item__2dpixmap_file_5b_3bgeom_5d"><strong>-pixmap</strong> <em>file[;geom]</em></a></strong><br /> 226<dt><strong><a name="item__2dpixmap_file_5b_3bgeom_5d"><strong>-pixmap</strong> <em>file[;geom]</em></a></strong><br />
196</dt> 227</dt>
197<dd> 228<dd>
198Compile <em>XPM</em>: Specify XPM file for the background and also optionally 229Compile <em>XPM</em>: Specify XPM file for the background and also optionally
199specify its scaling with a geometry string. Note you may need to add 230specify its scaling with a geometry string. Note you may need to
200quotes to avoid special shell interpretation of the `;' in the 231add quotes to avoid special shell interpretation of the <code>;</code> in the
201command-line; resource <strong>backgroundPixmap</strong>. 232command-line; resource <strong>backgroundPixmap</strong>.
202</dd> 233</dd>
203<p></p> 234<p></p>
204<dt><strong><a name="item__2dcr_colour"><strong>-cr</strong> <em>colour</em></a></strong><br /> 235<dt><strong><a name="item__2dcr_colour"><strong>-cr</strong> <em>colour</em></a></strong><br />
205</dt> 236</dt>
… …
228<p></p> 259<p></p>
229<dt><strong><a name="item__2dfn_fontlist"><strong>-fn</strong> <em>fontlist</em></a></strong><br /> 260<dt><strong><a name="item__2dfn_fontlist"><strong>-fn</strong> <em>fontlist</em></a></strong><br />
230</dt> 261</dt>
231<dd> 262<dd>
232Select the fonts to be used. This is a comma separated list of font names 263Select the fonts to be used. This is a comma separated list of font names
233that are used in turn when trying to display Unicode characters. The 264that are checked in order when trying to find glyphs for characters. The
234first font defines the cell size for characters; other fonts might be 265first font defines the cell size for characters; other fonts might be
235smaller, but not (in general) larger. A (hopefully) reasonable default 266smaller, but not (in general) larger. A (hopefully) reasonable default
236font list is always appended to it. See resource <strong>font</strong> for more details. 267font list is always appended to it. See resource <strong>font</strong> for more details.
237</dd> 268</dd>
238<dd> 269<dd>
… …
251</dd> 282</dd>
252<p></p> 283<p></p>
253<dt><strong><a name="item__2dfb_fontlist"><strong>-fb</strong> <em>fontlist</em></a></strong><br /> 284<dt><strong><a name="item__2dfb_fontlist"><strong>-fb</strong> <em>fontlist</em></a></strong><br />
254</dt> 285</dt>
255<dd> 286<dd>
256Compile font-styles: The bold font list to use when bold characters are to 287Compile <em>font-styles</em>: The bold font list to use when <strong>bold</strong> characters
257be printed. See resource <strong>boldFont</strong> for details. 288are to be printed. See resource <strong>boldFont</strong> for details.
258</dd> 289</dd>
259<p></p> 290<p></p>
260<dt><strong><a name="item__2dfi_fontlist"><strong>-fi</strong> <em>fontlist</em></a></strong><br /> 291<dt><strong><a name="item__2dfi_fontlist"><strong>-fi</strong> <em>fontlist</em></a></strong><br />
261</dt> 292</dt>
262<dd> 293<dd>
263Compile font-styles: The italic font list to use when bold characters are to 294Compile <em>font-styles</em>: The italic font list to use when <em>italic</em>
264be printed. See resource <strong>italicFont</strong> for details. 295characters are to be printed. See resource <strong>italicFont</strong> for details.
265</dd> 296</dd>
266<p></p> 297<p></p>
267<dt><strong><a name="item__2dfbi_fontlist"><strong>-fbi</strong> <em>fontlist</em></a></strong><br /> 298<dt><strong><a name="item__2dfbi_fontlist"><strong>-fbi</strong> <em>fontlist</em></a></strong><br />
268</dt> 299</dt>
269<dd> 300<dd>
270Compile font-styles: The bold italic font list to use when bold characters are to 301Compile <em>font-styles</em>: The bold italic font list to use when <strong><em>bold
271be printed. See resource <strong>boldItalicFont</strong> for details. 302italic</em> </strong>&gt; characters are to be printed. See resource <strong>boldItalicFont</strong>
303for details.
304</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<dd>
309Compile <em>font-styles</em>: Bold/Italic font styles imply high intensity
310foreground/background (default). See resource <strong>intensityStyles</strong> for
311details.
272</dd> 312</dd>
273<p></p> 313<p></p>
274<dt><strong><a name="item__2dname_name"><strong>-name</strong> <em>name</em></a></strong><br /> 314<dt><strong><a name="item__2dname_name"><strong>-name</strong> <em>name</em></a></strong><br />
275</dt> 315</dt>
276<dd> 316<dd>
… …
334</dd> 374</dd>
335<p></p> 375<p></p>
336<dt><strong><a name="item__2dst_7c_2bst"><strong>-st</strong>|<strong>+st</strong></a></strong><br /> 376<dt><strong><a name="item__2dst_7c_2bst"><strong>-st</strong>|<strong>+st</strong></a></strong><br />
337</dt> 377</dt>
338<dd> 378<dd>
339Display normal (non XTerm/NeXT) scrollbar without/with a trough; 379Display rxvt (non XTerm/NeXT) scrollbar without/with a trough;
340resource <strong>scrollBar_floating</strong>. 380resource <strong>scrollBar_floating</strong>.
341</dd> 381</dd>
342<p></p> 382<p></p>
343<dt><strong><a name="item__2dptab_7c_2bptab"><strong>-ptab</strong>|<strong>+ptab</strong></a></strong><br /> 383<dt><strong><a name="item__2dptab_7c_2bptab"><strong>-ptab</strong>|<strong>+ptab</strong></a></strong><br />
344</dt> 384</dt>
… …
389</dt> 429</dt>
390<dd> 430<dd>
391Compile <em>frills</em>: Set MWM hints to request a borderless window, i.e. 431Compile <em>frills</em>: Set MWM hints to request a borderless window, i.e.
392if honoured by the WM, the rxvt-unicode window will not have window 432if honoured by the WM, the rxvt-unicode window will not have window
393decorations; resource <strong>borderLess</strong>. 433decorations; 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>
439Compile <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>
446Compile <em>frills</em>: Disable the usage of the built-in block graphics/line
447drawing characters and just rely on what the specified fonts provide. Use
448this if you have a good font and want to use its block graphic glyphs;
449resource <strong>skipBuiltinGlyphs</strong>.
394</dd> 450</dd>
395<p></p> 451<p></p>
396<dt><strong><a name="item__2dlsp_number"><strong>-lsp</strong> <em>number</em></a></strong><br /> 452<dt><strong><a name="item__2dlsp_number"><strong>-lsp</strong> <em>number</em></a></strong><br />
397</dt> 453</dt>
398<dd> 454<dd>
… …
419given on the command line. If this option is used, it must be the last 475given on the command line. If this option is used, it must be the last
420on the command-line. If there is no <strong>-e</strong> option then the default is to 476on the command-line. If there is no <strong>-e</strong> option then the default is to
421run the program specified by the <strong>SHELL</strong> environment variable or, 477run the program specified by the <strong>SHELL</strong> environment variable or,
422failing that, <em>sh(1)</em>. 478failing that, <em>sh(1)</em>.
423</dd> 479</dd>
480<dd>
481<p>Please note that you must specify a program with arguments. If you want to
482run shell commands, you have to specify the shell, like this:</p>
483</dd>
484<dd>
485<pre>
486 rxvt -e sh -c &quot;shell commands&quot;</pre>
487</dd>
424<p></p> 488<p></p>
425<dt><strong><a name="item__2dtitle_text"><strong>-title</strong> <em>text</em></a></strong><br /> 489<dt><strong><a name="item__2dtitle_text"><strong>-title</strong> <em>text</em></a></strong><br />
426</dt> 490</dt>
427<dd> 491<dd>
428Window title (<strong>-T</strong> still respected); the default title is the basename 492Window title (<strong>-T</strong> still respected); the default title is the basename
… …
458</dd> 522</dd>
459<p></p> 523<p></p>
460<dt><strong><a name="item__2dimlocale_string"><strong>-imlocale</strong> <em>string</em></a></strong><br /> 524<dt><strong><a name="item__2dimlocale_string"><strong>-imlocale</strong> <em>string</em></a></strong><br />
461</dt> 525</dt>
462<dd> 526<dd>
463The locale to use for opening the IM. You can use an LC_CTYPE of e.g. 527The locale to use for opening the IM. You can use an <code>LC_CTYPE</code> of e.g.
464de_DE.UTF-8 for normal text processing but ja_JP.EUC-JP for the input 528<code>de_DE.UTF-8</code> for normal text processing but <code>ja_JP.EUC-JP</code> for the
465extension to be able to input japanese characters while staying in 529input extension to be able to input japanese characters while staying in
466another locale. 530another 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>
536Set the font set to use for the X Input Method, see resource <strong>imFont</strong>
537for more info.
538</dd>
539<p></p>
540<dt><strong><a name="item__2dtcw"><strong>-tcw</strong></a></strong><br />
541</dt>
542<dd>
543Change the meaning of triple-click selection with the left mouse
544button. Instead of selecting a full line it will extend the selection the
545end of the logical line only. resource <strong>tripleclickwords</strong>.
467</dd> 546</dd>
468<p></p> 547<p></p>
469<dt><strong><a name="item__2dinsecure"><strong>-insecure</strong></a></strong><br /> 548<dt><strong><a name="item__2dinsecure"><strong>-insecure</strong></a></strong><br />
470</dt> 549</dt>
471<dd> 550<dd>
… …
494<dd> 573<dd>
495Turn on/off secondary screen scroll (default enabled); resource 574Turn on/off secondary screen scroll (default enabled); resource
496<strong>secondaryScroll</strong>. 575<strong>secondaryScroll</strong>.
497</dd> 576</dd>
498<p></p> 577<p></p>
499<dt><strong><a name="item__2dxrm_resourcestring"><strong>-xrm</strong> <em>resourcestring</em></a></strong><br /> 578<dt><strong><a name="item__2dhold_7c_2bhold"><strong>-hold</strong>|<strong>+hold</strong></a></strong><br />
500</dt> 579</dt>
580<dd>
581Turn on/off hold window after exit support. If enabled, rxvt
582will not immediately destroy its window when the program executed within
583it exits. Instead, it will wait till it is being killed or closed by the
584user; resource <strong>hold</strong>.
501<dd> 585</dd>
502No effect on rxvt-unicode. Simply passes through an argument to be made 586<p></p>
503available in the instance's argument list. Appears in <em>WM_COMMAND</em> in 587<dt><strong><a name="item__2dkeysym_2esym_string"><strong>-keysym.</strong><em>sym</em> <em>string</em></a></strong><br />
504some window managers. 588</dt>
589<dd>
590Remap 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>
596Tells rxvt to embed it's windows into an already-existing window,
597which enables applications to easily embed a terminal.
598</dd>
599<dd>
600<p>Right now, rxvt will first unmap/map the specified window, so it
601shouldn't be a top-level window. rxvt will also reconfigure it
602quite a bit, so don't expect it to keep some specific state. It's best to
603create an extra subwindow for rxvt and leave it alone.</p>
604</dd>
605<dd>
606<p>The window will not be destroyed when rxvt exits.</p>
607</dd>
608<dd>
609<p>It might be useful to know that rxvt will not close file
610descriptors passed to it (except for stdin/out/err, of course), so you
611can use file descriptors to communicate with the programs within the
612terminal. This works regardless of wether the <code>-embed</code> option was used or
613not.</p>
614</dd>
615<dd>
616<p>Here is a short Gtk2-perl snippet that illustrates how this option can be
617used (a longer example is in <em>doc/embed</em>):</p>
618</dd>
619<dd>
620<pre>
621 my $rxvt = new Gtk2::Socket;
622 $rxvt-&gt;signal_connect_after (realize =&gt; sub {
623 my $xid = $_[0]-&gt;window-&gt;get_xid;
624 system &quot;rxvt -embed $xid &amp;&quot;;
625 });</pre>
626</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<dd>
631Tells rxvt NOT to execute any commands or create a new pty/tty
632pair but instead use the given filehandle as the tty master. This is
633useful if you want to drive rxvt as a generic terminal emulator
634without having to run a program within it.
635</dd>
636<dd>
637<p>If this switch is given, rxvt will not create any utmp/wtmp
638entries and will not tinker with pty/tty permissions - you have to do that
639yourself if you want that.</p>
640</dd>
641<dd>
642<p>As an extremely special case, specifying <code>-1</code> will completely suppress
643pty/tty operations.</p>
644</dd>
645<dd>
646<p>Here is a example in perl that illustrates how this option can be used (a
647longer example is in <em>doc/pty-fd</em>):</p>
648</dd>
649<dd>
650<pre>
651 use IO::Pty;
652 use Fcntl;</pre>
653</dd>
654<dd>
655<pre>
656 my $pty = new IO::Pty;
657 fcntl $pty, F_SETFD, 0; # clear close-on-exec
658 system &quot;rxvt -pty-fd &quot; . (fileno $pty) . &quot;&amp;&quot;;
659 close $pty;</pre>
660</dd>
661<dd>
662<pre>
663 # now communicate with rxvt
664 my $slave = $pty-&gt;slave;
665 while (&lt;$slave&gt;) { print $slave &quot;got &lt;$_&gt;\n&quot; }</pre>
666</dd>
667<p></p>
668<dt><strong><a name="item__2dpe_string"><strong>-pe</strong> <em>string</em></a></strong><br />
669</dt>
670<dd>
671Comma-separated list of perl extension scripts to use (or not to use) in
672this terminal instance. See resource <strong>perl-ext</strong> for details.
505</dd> 673</dd>
506<p></p></dl> 674<p></p></dl>
507<p> 675<p>
508</p> 676</p>
509<hr /> 677<hr />
510<h1><a name="resources__available_also_as_longoptions_">RESOURCES (available also as long-options)</a></h1> 678<h1><a name="resources__available_also_as_longoptions_">RESOURCES (available also as long-options)</a></h1>
511<p>Note: `rxvt --help' gives a list of all resources (long 679<p>Note: `rxvt --help' gives a list of all resources (long
512options) compiled into your version.</p> 680options) compiled into your version.</p>
513<p>There are two different methods that rxvt can use to get the 681<p>You can set and change the resources using X11 tools like <strong>xrdb</strong>. Many
514Xresource data: using the X libraries (Xrm*-functions) or internal
515Xresources reader (<strong>~/.Xdefaults</strong>). For the first method (ie.
516<strong>rxvt -h</strong> lists <strong>XGetDefaults</strong>), you can set and change the
517resources using X11 tools like <strong>xset</strong>. Many distribution do also load
518settings from the <strong>~/.Xresources</strong> file when X starts.</p> 682distribution do also load settings from the <strong>~/.Xresources</strong> file when X
519<p>If compiled with internal Xresources support (i.e. <strong>rxvt -h</strong> 683starts. rxvt will consult the following files/resources in order,
520lists <strong>.Xdefaults</strong>) then <strong>rxvt</strong> accepts application defaults 684with later settings overwriting earlier ones:</p>
521set in XAPPLOADDIR/URxvt (compile-time defined: usually 685<pre>
522<strong>/usr/lib/X11/app-defaults/URxvt</strong>) and resources set in 686 1. system-wide app-defaults file, either locale-dependent OR global
523<strong>~/.Xdefaults</strong>, or <strong>~/.Xresources</strong> if <strong>~/.Xdefaults</strong> does not exist. 687 2. app-defaults file in $XAPPLRESDIR
688 3. RESOURCE_MANAGER property on root-window OR $HOME/.Xdefaults
689 4. SCREEN_RESOURCES for the current screen
690 5. $XENVIRONMENT file OR $HOME/.Xdefaults-&lt;nodename&gt;</pre>
524Note that when reading X resources, <strong>rxvt</strong> recognizes two 691<p>Note that when reading X resources, <strong>rxvt</strong> recognizes two class
525class names: <strong>XTerm</strong> and <strong>URxvt</strong>. The class name <strong>Rxvt</strong> allows 692names: <strong>Rxvt</strong> and <strong>URxvt</strong>. The class name <strong>Rxvt</strong> allows resources
526resources common to both <strong>rxvt</strong> and the original <em>rxvt</em> to be 693common to both <strong>rxvt</strong> and the original <em>rxvt</em> to be easily
527easily configured, while the class name <strong>URxvt</strong> allows resources 694configured, while the class name <strong>URxvt</strong> allows resources unique to
528unique to <strong>rxvt</strong>, notably colours and key-handling, to be 695<strong>rxvt</strong>, to be shared between different <strong>rxvt</strong>
529shared between different <strong>rxvt</strong> configurations. If no 696configurations. If no resources are specified, suitable defaults will
530resources are specified, suitable defaults will be used. Command-line 697be used. Command-line arguments can be used to override resource
531arguments can be used to override resource settings. The following 698settings. The following resources are supported (you might want to
532resources are allowed:</p> 699check the <code>rxvtperl(3)</code> manpage for additional settings by perl
700extensions not documented here):</p>
533<dl> 701<dl>
702<dt><strong><a name="item_depth_3a_bitdepth"><strong>depth:</strong> <em>bitdepth</em></a></strong><br />
703</dt>
704<dd>
705Compile <em>xft</em>: Attempt to find a visual with the given bit depth;
706option <strong>-depth</strong>.
707</dd>
708<p></p>
534<dt><strong><a name="item_geometry_3a_geom"><strong>geometry:</strong> <em>geom</em></a></strong><br /> 709<dt><strong><a name="item_geometry_3a_geom"><strong>geometry:</strong> <em>geom</em></a></strong><br />
535</dt> 710</dt>
536<dd> 711<dd>
537Create the window with the specified X window geometry [default 80x24]; 712Create the window with the specified X window geometry [default 80x24];
538option <strong>-geometry</strong>. 713option <strong>-geometry</strong>.
… …
576<dt><strong><a name="item_colorit_3a_colour"><strong>colorIT:</strong> <em>colour</em></a></strong><br /> 751<dt><strong><a name="item_colorit_3a_colour"><strong>colorIT:</strong> <em>colour</em></a></strong><br />
577</dt> 752</dt>
578<dd> 753<dd>
579Use the specified colour to display bold or italic characters when the 754Use the specified colour to display bold or italic characters when the
580foreground colour is the default. If font styles are not available 755foreground colour is the default. If font styles are not available
581(Compile styles) and this option is unset, reverse video is used instead. 756(Compile <em>styles</em>) and this option is unset, reverse video is used instead.
582</dd> 757</dd>
583<p></p> 758<p></p>
584<dt><strong><a name="item_colorul_3a_colour"><strong>colorUL:</strong> <em>colour</em></a></strong><br /> 759<dt><strong><a name="item_colorul_3a_colour"><strong>colorUL:</strong> <em>colour</em></a></strong><br />
585</dt> 760</dt>
586<dd> 761<dd>
… …
638<dd> 813<dd>
639<strong>True</strong>: make the background inherit the parent windows' pixmap, giving 814<strong>True</strong>: make the background inherit the parent windows' pixmap, giving
640artificial transparency. <strong>False</strong>: do not inherit the parent windows' 815artificial transparency. <strong>False</strong>: do not inherit the parent windows'
641pixmap. 816pixmap.
642</dd> 817</dd>
818<dd>
819<p><em>Please note that transparency of any kind if completely unsupported by
820the author. Don't bug him with installation questions!</em></p>
821</dd>
643<p></p> 822<p></p>
644<dt><strong><a name="item_fading_3a_number"><strong>fading:</strong> <em>number</em></a></strong><br /> 823<dt><strong><a name="item_fading_3a_number"><strong>fading:</strong> <em>number</em></a></strong><br />
645</dt> 824</dt>
646<dd> 825<dd>
647Fade the text by the given percentage when focus is lost. 826Fade 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>
832Fade to this colour, when fading is used (see <strong>fading:</strong>). The default
833colour is black; option <strong>-fadecolor</strong>.
648</dd> 834</dd>
649<p></p> 835<p></p>
650<dt><strong><a name="item_tintcolor_3a_colour"><strong>tintColor:</strong> <em>colour</em></a></strong><br /> 836<dt><strong><a name="item_tintcolor_3a_colour"><strong>tintColor:</strong> <em>colour</em></a></strong><br />
651</dt> 837</dt>
652<dd> 838<dd>
653Tint the transparent background pixmap with the given colour. 839Tint the transparent background pixmap with the given colour; option
840<strong>-tint</strong>.
654</dd> 841</dd>
655<p></p> 842<p></p>
656<dt><strong><a name="item_shading_3a_number"><strong>shading:</strong> <em>number</em></a></strong><br /> 843<dt><strong><a name="item_shading_3a_number"><strong>shading:</strong> <em>number</em></a></strong><br />
657</dt> 844</dt>
658<dd> 845<dd>
… …
668<p></p> 855<p></p>
669<dt><strong><a name="item_troughcolor_3a_colour"><strong>troughColor:</strong> <em>colour</em></a></strong><br /> 856<dt><strong><a name="item_troughcolor_3a_colour"><strong>troughColor:</strong> <em>colour</em></a></strong><br />
670</dt> 857</dt>
671<dd> 858<dd>
672Use the specified colour for the scrollbar's trough area [default 859Use the specified colour for the scrollbar's trough area [default
673#969696]. Only relevant for normal (non XTerm/NeXT) scrollbar. 860#969696]. Only relevant for rxvt (non XTerm/NeXT) scrollbar.
674</dd> 861</dd>
675<p></p> 862<p></p>
676<dt><strong><a name="item_bordercolor_3a_colour"><strong>borderColor:</strong> <em>colour</em></a></strong><br /> 863<dt><strong><a name="item_bordercolor_3a_colour"><strong>borderColor:</strong> <em>colour</em></a></strong><br />
677</dt> 864</dt>
678<dd> 865<dd>
… …
692specifies an integer number of images in that direction. No image will 879specifies an integer number of images in that direction. No image will
693be magnified beyond 10 times its original size. The maximum permitted 880be magnified beyond 10 times its original size. The maximum permitted
694scale is 1000. [default 0x0+50+50] 881scale is 1000. [default 0x0+50+50]
695</dd> 882</dd>
696<p></p> 883<p></p>
697<dt><strong><a name="item_menu_3a_file_5b_3btag_5d"><strong>menu:</strong> <em>file[;tag]</em></a></strong><br />
698</dt>
699<dd>
700Read in the specified menu file (note the `.menu' extension is
701optional) and also optionally specify a starting tag to find. See the
702reference documentation for details on the syntax for the menuBar.
703</dd>
704<p></p>
705<dt><strong><a name="item_path_3a_path"><strong>path:</strong> <em>path</em></a></strong><br /> 884<dt><strong><a name="item_path_3a_path"><strong>path:</strong> <em>path</em></a></strong><br />
706</dt> 885</dt>
707<dd> 886<dd>
708Specify the colon-delimited search path for finding files (XPM and 887Specify the colon-delimited search path for finding XPM files.
709menus), in addition to the paths specified by the <strong>RXVTPATH</strong> and
710<strong>PATH</strong> environment variables.
711</dd> 888</dd>
712<p></p> 889<p></p>
713<dt><strong><a name="item_font_3a_fontlist"><strong>font:</strong> <em>fontlist</em></a></strong><br /> 890<dt><strong><a name="item_font_3a_fontlist"><strong>font:</strong> <em>fontlist</em></a></strong><br />
714</dt> 891</dt>
715<dd> 892<dd>
716Select the fonts to be used. This is a comma separated list of font 893Select the fonts to be used. This is a comma separated list of font names
717names that are used in turn when trying to display Unicode characters. 894that are checked in order when trying to find glyphs for characters. The
718The first font defines the cell size for characters; other fonts might 895first font defines the cell size for characters; other fonts might be
719be smaller, but not larger. A reasonable default font list is always 896smaller, but not (in general) larger. A (hopefully) reasonable default
720appended to it. option <strong>-fn</strong>. 897font list is always appended to it; option <strong>-fn</strong>.
721</dd> 898</dd>
722<dd> 899<dd>
723<p>Each font can either be a standard X11 core font (XLFD) name, with 900<p>Each font can either be a standard X11 core font (XLFD) name, with
724optional prefix <code>x:</code> or a Xft font (Compile xft), prefixed with <code>xft:</code>.</p> 901optional prefix <code>x:</code> or a Xft font (Compile <em>xft</em>), prefixed with <code>xft:</code>.</p>
725</dd> 902</dd>
726<dd> 903<dd>
727<p>In addition, each font can be prefixed with additional hints and 904<p>In addition, each font can be prefixed with additional hints and
728specifications enclosed in square brackets (<code>[]</code>). The only available 905specifications enclosed in square brackets (<code>[]</code>). The only available
729hint currently is <code>codeset=codeset-name</code>, and this is only used for Xft 906hint currently is <code>codeset=codeset-name</code>, and this is only used for Xft
… …
732<dd> 909<dd>
733<p>For example, this font resource</p> 910<p>For example, this font resource</p>
734</dd> 911</dd>
735<dd> 912<dd>
736<pre> 913<pre>
737 URxvt*font: 9x15bold,\ 914 URxvt.font: 9x15bold,\
738 -misc-fixed-bold-r-normal--15-140-75-75-c-90-iso10646-1,\ 915 -misc-fixed-bold-r-normal--15-140-75-75-c-90-iso10646-1,\
739 -misc-fixed-medium-r-normal--15-140-75-75-c-90-iso10646-1, \ 916 -misc-fixed-medium-r-normal--15-140-75-75-c-90-iso10646-1, \
740 [codeset=JISX0208]xft:Kochi Gothic:antialias=false, \ 917 [codeset=JISX0208]xft:Kochi Gothic:antialias=false, \
741 xft:Code2000:antialias=false</pre> 918 xft:Code2000:antialias=false</pre>
742</dd> 919</dd>
… …
786<dd> 963<dd>
787<p>If set, but empty, then this specific style is disabled and the normal 964<p>If set, but empty, then this specific style is disabled and the normal
788text font will being used for the given style.</p> 965text font will being used for the given style.</p>
789</dd> 966</dd>
790<p></p> 967<p></p>
968<dt><strong><a name="item_intensitystyles_3a_boolean"><strong>intensityStyles:</strong> <em>boolean</em></a></strong><br />
969</dt>
970<dd>
971When font styles are not enabled, or this option is enabled (<strong>True</strong>,
972option <strong>-is</strong>, the default), bold and italic font styles imply high
973intensity foreground/backround colours. Disabling this option (<strong>False</strong>,
974option <strong>+is</strong>) disables this behaviour, the high intensity colours are not
975reachable.
976</dd>
977<p></p>
791<dt><strong><a name="item_selectstyle_3a_mode"><strong>selectstyle:</strong> <em>mode</em></a></strong><br /> 978<dt><strong><a name="item_selectstyle_3a_mode"><strong>selectstyle:</strong> <em>mode</em></a></strong><br />
792</dt> 979</dt>
793<dd> 980<dd>
794Set mouse selection style to <strong>old</strong> which is 2.20, <strong>oldword</strong> which is 981Set mouse selection style to <strong>old</strong> which is 2.20, <strong>oldword</strong> which is
795xterm style with 2.20 old word selection, or anything else which gives 982xterm style with 2.20 old word selection, or anything else which gives
… …
798<p></p> 985<p></p>
799<dt><strong><a name="item_scrollstyle_3a_mode"><strong>scrollstyle:</strong> <em>mode</em></a></strong><br /> 986<dt><strong><a name="item_scrollstyle_3a_mode"><strong>scrollstyle:</strong> <em>mode</em></a></strong><br />
800</dt> 987</dt>
801<dd> 988<dd>
802Set scrollbar style to <strong>rxvt</strong>, <strong>plain</strong>, <strong>next</strong> or <strong>xterm</strong>. <strong>plain</strong> is 989Set scrollbar style to <strong>rxvt</strong>, <strong>plain</strong>, <strong>next</strong> or <strong>xterm</strong>. <strong>plain</strong> is
803the author's favourite.. 990the author's favourite.
804</dd> 991</dd>
805<p></p> 992<p></p>
806<dt><strong><a name="item_title_3a_string"><strong>title:</strong> <em>string</em></a></strong><br /> 993<dt><strong><a name="item_title_3a_string"><strong>title:</strong> <em>string</em></a></strong><br />
807</dt> 994</dt>
808<dd> 995<dd>
… …
854<dd> 1041<dd>
855Specify a command pipe for vt100 printer [default <em>lpr(1)</em>]. Use 1042Specify a command pipe for vt100 printer [default <em>lpr(1)</em>]. Use
856<strong>Print</strong> to initiate a screen dump to the printer and <strong>Ctrl-Print</strong> or 1043<strong>Print</strong> to initiate a screen dump to the printer and <strong>Ctrl-Print</strong> or
857<strong>Shift-Print</strong> to include the scrollback as well. 1044<strong>Shift-Print</strong> to include the scrollback as well.
858</dd> 1045</dd>
1046<dd>
1047<p>The string will be interpreted as if typed into the shell as-is.</p>
1048</dd>
1049<dd>
1050<p>Example:</p>
1051</dd>
1052<dd>
1053<pre>
1054 URxvt.print-pipe: cat &gt; $(TMPDIR=$HOME mktemp urxvt.XXXXXX)</pre>
1055</dd>
1056<dd>
1057<p>This creates a new file in your home directory with the screen contents
1058everytime you hit <code>Print</code>.</p>
1059</dd>
859<p></p> 1060<p></p>
860<dt><strong><a name="item_scrollbar_3a_boolean"><strong>scrollBar:</strong> <em>boolean</em></a></strong><br /> 1061<dt><strong><a name="item_scrollbar_3a_boolean"><strong>scrollBar:</strong> <em>boolean</em></a></strong><br />
861</dt> 1062</dt>
862<dd> 1063<dd>
863<strong>True</strong>: enable the scrollbar [default]; option <strong>-sb</strong>. <strong>False</strong>: 1064<strong>True</strong>: enable the scrollbar [default]; option <strong>-sb</strong>. <strong>False</strong>:
… …
895<p></p> 1096<p></p>
896<dt><strong><a name="item_scrollwithbuffer_3a_boolean"><strong>scrollWithBuffer:</strong> <em>boolean</em></a></strong><br /> 1097<dt><strong><a name="item_scrollwithbuffer_3a_boolean"><strong>scrollWithBuffer:</strong> <em>boolean</em></a></strong><br />
897</dt> 1098</dt>
898<dd> 1099<dd>
899<strong>True</strong>: scroll with scrollback buffer when tty receives new lines (and 1100<strong>True</strong>: scroll with scrollback buffer when tty receives new lines (and
900<strong>scrollTtyOutput</strong> is False); option <strong>+sw</strong>. <strong>False</strong>: do not scroll 1101<strong>scrollTtyOutput</strong> is False); option <strong>-sw</strong>. <strong>False</strong>: do not scroll
901with scrollback buffer when tty recieves new lines; option <strong>-sw</strong>. 1102with scrollback buffer when tty recieves new lines; option <strong>+sw</strong>.
902</dd> 1103</dd>
903<p></p> 1104<p></p>
904<dt><strong><a name="item_scrollttykeypress_3a_boolean"><strong>scrollTtyKeypress:</strong> <em>boolean</em></a></strong><br /> 1105<dt><strong><a name="item_scrollttykeypress_3a_boolean"><strong>scrollTtyKeypress:</strong> <em>boolean</em></a></strong><br />
905</dt> 1106</dt>
906<dd> 1107<dd>
… …
936<dd> 1137<dd>
937Set MWM hints to request a borderless window, i.e. if honoured by the 1138Set MWM hints to request a borderless window, i.e. if honoured by the
938WM, the rxvt-unicode window will not have window decorations; option <strong>-bl</strong>. 1139WM, the rxvt-unicode window will not have window decorations; option <strong>-bl</strong>.
939</dd> 1140</dd>
940<p></p> 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>
1145Compile <em>frills</em>: Disable the usage of the built-in block graphics/line
1146drawing characters and just rely on what the specified fonts provide. Use
1147this if you have a good font and want to use its block graphic glyphs;
1148option <strong>-sbg</strong>.
1149</dd>
1150<p></p>
941<dt><strong><a name="item_termname_3a_termname"><strong>termName:</strong> <em>termname</em></a></strong><br /> 1151<dt><strong><a name="item_termname_3a_termname"><strong>termName:</strong> <em>termname</em></a></strong><br />
942</dt> 1152</dt>
943<dd> 1153<dd>
944Specifies the terminal type name to be set in the <strong>TERM</strong> environment 1154Specifies the terminal type name to be set in the <strong>TERM</strong> environment
945variable; option <strong>-tn</strong>. 1155variable; option <strong>-tn</strong>.
… …
1001</dd> 1211</dd>
1002<p></p> 1212<p></p>
1003<dt><strong><a name="item_pointerblankdelay_3a_number"><strong>pointerBlankDelay:</strong> <em>number</em></a></strong><br /> 1213<dt><strong><a name="item_pointerblankdelay_3a_number"><strong>pointerBlankDelay:</strong> <em>number</em></a></strong><br />
1004</dt> 1214</dt>
1005<dd> 1215<dd>
1006Specifies number of seconds before blanking the pointer [default 2]. 1216Specifies number of seconds before blanking the pointer [default 2]. Use a
1217large number (e.g. <code>987654321</code>) to effectively disable the timeout.
1007</dd> 1218</dd>
1008<p></p> 1219<p></p>
1009<dt><strong><a name="item_backspacekey_3a_string"><strong>backspacekey:</strong> <em>string</em></a></strong><br /> 1220<dt><strong><a name="item_backspacekey_3a_string"><strong>backspacekey:</strong> <em>string</em></a></strong><br />
1010</dt> 1221</dt>
1011<dd> 1222<dd>
… …
1024</dd> 1235</dd>
1025<p></p> 1236<p></p>
1026<dt><strong><a name="item_cutchars_3a_string"><strong>cutchars:</strong> <em>string</em></a></strong><br /> 1237<dt><strong><a name="item_cutchars_3a_string"><strong>cutchars:</strong> <em>string</em></a></strong><br />
1027</dt> 1238</dt>
1028<dd> 1239<dd>
1029The characters used as delimiters for double-click word selection. The 1240The characters used as delimiters for double-click word selection
1030built-in default: 1241(whitespace delimiting is added automatically if resource is given).
1242</dd>
1243<dd>
1244<p>When the selection extension is in use (the default if compiled in, see
1245the <code>rxvtperl(3)</code> manpage), a suitable regex using these characters
1246will be created (if the resource exists, otherwise, no regex will be
1247created). In this mode, characters outside ISO-8859-1 can be used.</p>
1248</dd>
1249<dd>
1250<p>When the selection extension is not used, only ISO-8859-1 characters can
1251be used. If not specified, the built-in default is used:</p>
1031</dd> 1252</dd>
1032<dd> 1253<dd>
1033<p><strong>BACKSLASH ```'&amp;()*,;&lt;=</strong>?@[]{|} &gt;&gt;</p> 1254<p><strong>BACKSLASH ```'&amp;()*,;&lt;=</strong>?@[]{|} &gt;&gt;</p>
1034</dd> 1255</dd>
1035<p></p> 1256<p></p>
… …
1046</dd> 1267</dd>
1047<p></p> 1268<p></p>
1048<dt><strong><a name="item_imlocale_3a_name"><strong>imLocale:</strong> <em>name</em></a></strong><br /> 1269<dt><strong><a name="item_imlocale_3a_name"><strong>imLocale:</strong> <em>name</em></a></strong><br />
1049</dt> 1270</dt>
1050<dd> 1271<dd>
1051The locale to use for opening the IM. You can use an LC_CTYPE of e.g. 1272The locale to use for opening the IM. You can use an <code>LC_CTYPE</code> of e.g.
1052de_DE.UTF-8 for normal text processing but ja_JP.EUC-JP for the input 1273<code>de_DE.UTF-8</code> for normal text processing but <code>ja_JP.EUC-JP</code> for the
1053extension to be able to input japanese characters while staying in 1274input extension to be able to input japanese characters while staying in
1054another locale. option <strong>-imlocale</strong>. 1275another locale; option <strong>-imlocale</strong>.
1276</dd>
1277<p></p>
1278<dt><strong><a name="item_imfont_3a_fontset"><strong>imFont:</strong> <em>fontset</em></a></strong><br />
1279</dt>
1280<dd>
1281Specify the font-set used for XIM styles <code>OverTheSpot</code> or
1282<code>OffTheSpot</code>. It must be a standard X font set (XLFD patterns separated
1283by commas), i.e. it's not in the same format as the other font lists used
1284in rxvt. The default will be set-up to chose *any* suitable found
1285found, preferably one or two pixels differing in size to the base font.
1286option <strong>-imfont</strong>.
1287</dd>
1288<p></p>
1289<dt><strong><a name="item_tripleclickwords_3a_boolean"><strong>tripleclickwords:</strong> <em>boolean</em></a></strong><br />
1290</dt>
1291<dd>
1292Change the meaning of triple-click selection with the left mouse
1293button. Instead of selecting a full line it will extend the selection to
1294the end of the logical line only; option <strong>-tcw</strong>.
1055</dd> 1295</dd>
1056<p></p> 1296<p></p>
1057<dt><strong><a name="item_insecure_3a_boolean"><strong>insecure:</strong> <em>boolean</em></a></strong><br /> 1297<dt><strong><a name="item_insecure_3a_boolean"><strong>insecure:</strong> <em>boolean</em></a></strong><br />
1058</dt> 1298</dt>
1059<dd> 1299<dd>
1060Enables ``insecure'' mode. Rxvt-unicode offers some escape sequences that 1300Enables ``insecure'' mode. Rxvt-unicode offers some escape sequences that
1061echo arbitrary strings like the icon name or the locale. This could be 1301echo arbitrary strings like the icon name or the locale. This could be
1062abused if somebody gets 8-bit-clean access to your display, whether 1302abused if somebody gets 8-bit-clean access to your display, whether
1063throuh a mail client displaying mail bodies unfiltered or though 1303through a mail client displaying mail bodies unfiltered or through
1064write(1). Therefore, these sequences are disabled by default. (Note 1304<code>write(1)</code> or any other means. Therefore, these sequences are disabled by
1065that other terminals, including xterm, have these sequences 1305default. (Note that many other terminals, including xterm, have these
1066enabled by default). You can enable them by setting this boolean 1306sequences enabled by default, which doesn't make it safer, though).
1067resource or specifying <strong>-insecure</strong> as an option. At the moment, this 1307</dd>
1068enabled display-answer, locale, findfont, icon label and window title 1308<dd>
1069requests as well as dynamic menubar dispatch. 1309<p>You can enable them by setting this boolean resource or specifying
1310<strong>-insecure</strong> as an option. At the moment, this enables display-answer,
1311locale, findfont, icon label and window title requests.</p>
1070</dd> 1312</dd>
1071<p></p> 1313<p></p>
1072<dt><strong><a name="item_modifier_3a_modifier"><strong>modifier:</strong> <em>modifier</em></a></strong><br /> 1314<dt><strong><a name="item_modifier_3a_modifier"><strong>modifier:</strong> <em>modifier</em></a></strong><br />
1073</dt> 1315</dt>
1074<dd> 1316<dd>
… …
1083Specify the reply rxvt-unicode sends to the shell when an ENQ (control-E) 1325Specify the reply rxvt-unicode sends to the shell when an ENQ (control-E)
1084character is passed through. It may contain escape values as described 1326character is passed through. It may contain escape values as described
1085in the entry on <strong>keysym</strong> following. 1327in the entry on <strong>keysym</strong> following.
1086</dd> 1328</dd>
1087<p></p> 1329<p></p>
1088<dt><strong><a name="item_secondaryscreen_3a_bool"><strong>secondaryScreen:</strong> <em>bool</em></a></strong><br /> 1330<dt><strong><a name="item_secondaryscreen_3a_boolean"><strong>secondaryScreen:</strong> <em>boolean</em></a></strong><br />
1089</dt> 1331</dt>
1090<dd> 1332<dd>
1091Turn on/off secondary screen (default enabled). 1333Turn on/off secondary screen (default enabled).
1092</dd> 1334</dd>
1093<p></p> 1335<p></p>
1094<dt><strong><a name="item_secondaryscroll_3a_bool"><strong>secondaryScroll:</strong> <em>bool</em></a></strong><br /> 1336<dt><strong><a name="item_secondaryscroll_3a_boolean"><strong>secondaryScroll:</strong> <em>boolean</em></a></strong><br />
1095</dt> 1337</dt>
1096<dd> 1338<dd>
1097Turn on/off secondary screen scroll (default enabled). If the this 1339Turn on/off secondary screen scroll (default enabled). If the this
1098option is enabled, scrolls on the secondary screen will change the 1340option is enabled, scrolls on the secondary screen will change the
1099scrollback buffer and switching to/from the secondary screen will 1341scrollback buffer and switching to/from the secondary screen will
1100instead scroll the screen up. 1342instead scroll the screen up.
1101</dd> 1343</dd>
1102<p></p> 1344<p></p>
1345<dt><strong><a name="item_hold_3a_boolean"><strong>hold</strong>: <em>boolean</em></a></strong><br />
1346</dt>
1347<dd>
1348Turn on/off hold window after exit support. If enabled, rxvt
1349will not immediately destroy its window when the program executed within
1350it exits. Instead, it will wait till it is being killed or closed by the
1351user.
1352</dd>
1353<p></p>
1103<dt><strong><a name="item_keysym_2esym_3a_string"><strong>keysym.</strong><em>sym</em>: <em>string</em></a></strong><br /> 1354<dt><strong><a name="item_keysym_2esym_3a_string"><strong>keysym.</strong><em>sym</em>: <em>string</em></a></strong><br />
1104</dt> 1355</dt>
1105<dd> 1356<dd>
1106Associate <em>string</em> with keysym <em>sym</em> (<strong>0xFF00 - 0xFFFF</strong>). It may 1357Compile <em>frills</em>: Associate <em>string</em> with keysym <em>sym</em>. The
1107contain escape values (\a: bell, \b: backspace, \e, \E: escape, \n:
1108newline, \r: return, \t:
1109tab, \000: octal number) or control characters (^?: delete, ^@: null,
1110^A ...) and may enclosed with double quotes so that it can start or end
1111with whitespace. The intervening resource name <strong>keysym.</strong> cannot be 1358intervening resource name <strong>keysym.</strong> cannot be omitted.
1112omitted. This resource is only available when compiled with 1359</dd>
1113KEYSYM_RESOURCE. 1360<dd>
1361<p>The format of <em>sym</em> is ``<em>(modifiers-)key</em>'', where <em>modifiers</em> can be
1362any combination of <strong>ISOLevel3</strong>, <strong>AppKeypad</strong>, <strong>Control</strong>, <strong>NumLock</strong>,
1363<strong>Shift</strong>, <strong>Meta</strong>, <strong>Lock</strong>, <strong>Mod1</strong>, <strong>Mod2</strong>, <strong>Mod3</strong>, <strong>Mod4</strong>, <strong>Mod5</strong>,
1364and the abbreviated <strong>I</strong>, <strong>K</strong>, <strong>C</strong>, <strong>N</strong>, <strong>S</strong>, <strong>M</strong>, <strong>A</strong>, <strong>L</strong>, <strong>1</strong>,
1365<strong>2</strong>, <strong>3</strong>, <strong>4</strong>, <strong>5</strong>.</p>
1366</dd>
1367<dd>
1368<p>The <strong>NumLock</strong>, <strong>Meta</strong> and <strong>ISOLevel3</strong> modifiers are usually aliased to
1369whatever modifier the NumLock key, Meta/Alt keys or ISO Level3 Shift/AltGr
1370keys are being mapped. <strong>AppKeypad</strong> is a synthetic modifier mapped to the
1371current application keymap mode state.</p>
1372</dd>
1373<dd>
1374<p>The spellings of <em>key</em> can be obtained by using <strong>xev</strong>(1) command or
1375searching keysym macros from <strong>/usr/X11R6/include/X11/keysymdef.h</strong> and
1376omitting the prefix <strong>XK_</strong>. Alternatively you can specify <em>key</em> by its hex
1377keysym value (<strong>0x0000 - 0xFFFF</strong>). Note that the lookup of <em>sym</em>s is not
1378performed in an exact manner; however, the closest match is assured.</p>
1379</dd>
1380<dd>
1381<p><em>string</em> may contain escape values (<code>\a</code>: bell, <code>\b</code>: backspace,
1382<code>\e</code>, <code>\E</code>: escape, <code>\n</code>: newline, <code>\r</code>: carriage return, <code>\t</code>: tab,
1383<code>\000</code>: octal number) or verbatim control characters (<code>^?</code>: delete,
1384<code>^@</code>: null, <code>^A</code> ...) and may be enclosed with double quotes so that it
1385can start or end with whitespace.</p>
1386</dd>
1387<dd>
1388<p>Please note that you need to double the <code>\</code> in resource files, as
1389Xlib itself does it's own de-escaping (you can use <code>\033</code> instead of
1390<code>\e</code> (and so on), which will work with both Xt and rxvt's own
1391processing).</p>
1392</dd>
1393<dd>
1394<p>You can define a range of keysyms in one shot by providing a <em>string</em>
1395with pattern <strong>list/PREFIX/MIDDLE/SUFFIX</strong>, where the delimeter `/'
1396should be a character not used by the strings.</p>
1397</dd>
1398<dd>
1399<p>Its usage can be demonstrated by an example:</p>
1400</dd>
1401<dd>
1402<pre>
1403 URxvt.keysym.M-C-0x61: list|\033&lt;M-C-|abc|&gt;</pre>
1404</dd>
1405<dd>
1406<p>The above line is equivalent to the following three lines:</p>
1407</dd>
1408<dd>
1409<pre>
1410 URxvt.keysym.Meta-Control-0x61: \033&lt;M-C-a&gt;
1411 URxvt.keysym.Meta-Control-0x62: \033&lt;M-C-b&gt;
1412 URxvt.keysym.Meta-Control-0x63: \033&lt;M-C-c&gt;</pre>
1413</dd>
1414<dd>
1415<p>If <em>string</em> takes the form of <code>command:STRING</code>, the specified <strong>STRING</strong>
1416is interpreted and executed as rxvt's control sequence. For
1417example the following means ``change the current locale to <code>zh_CN.GBK</code>
1418when Control-Meta-c is being pressed'':</p>
1419</dd>
1420<dd>
1421<pre>
1422 URxvt.keysym.M-C-c: command:\033]701;zh_CN.GBK\007</pre>
1423</dd>
1424<dd>
1425<p>If <em>string</em> takes the form <code>perl:STRING</code>, then the specified <strong>STRING</strong>
1426is passed to the <code>on_keyboard_command</code> perl handler. See the <code>rxvtperl(3)</code>
1427manpage. For example, the <em>selection</em> extension (activated via
1428<code>rxvt -pe selection</code>) listens for <code>selection:rot13</code> events:</p>
1429</dd>
1430<dd>
1431<pre>
1432 URxvt.keysym.M-C-c: perl:selection:rot13</pre>
1433</dd>
1434<dd>
1435<p>Due the the large number of modifier combinations, a defined key mapping
1436will match if at <em>at least</em> the specified identifiers are being set, and
1437no other key mappings with those and more bits are being defined. That
1438means that defining a key map for <code>a</code> will automatically provide
1439definitions for <code>Meta-a</code>, <code>Shift-a</code> and so on, unless some of those are defined
1440mappings themselves.</p>
1441</dd>
1442<dd>
1443<p>Unfortunately, this will override built-in key mappings. For example
1444if you overwrite the <code>Insert</code> key you will disable rxvt's
1445<code>Shift-Insert</code> mapping. To re-enable that, you can poke ``holes'' into the
1446user-defined keymap using the <code>builtin:</code> replacement:</p>
1447</dd>
1448<dd>
1449<pre>
1450 URxvt.keysym.Insert: &lt;my insert key sequence&gt;
1451 URxvt.keysym.S-Insert: builtin:</pre>
1452</dd>
1453<dd>
1454<p>The first line defines a mapping for <code>Insert</code> and <em>any</em> combination
1455of modifiers. The second line re-establishes the default mapping for
1456<code>Shift-Insert</code>.</p>
1457</dd>
1458<dd>
1459<p>The following example will map Control-Meta-1 and Control-Meta-2 to
1460the fonts <code>suxuseuro</code> and <code>9x15bold</code>, so you can have some limited
1461font-switching at runtime:</p>
1462</dd>
1463<dd>
1464<pre>
1465 URxvt.keysym.M-C-1: command:\033]50;suxuseuro\007
1466 URxvt.keysym.M-C-2: command:\033]50;9x15bold\007</pre>
1467</dd>
1468<dd>
1469<p>Other things are possible, e.g. resizing (see <code>rxvt(7)</code> for more
1470info):</p>
1471</dd>
1472<dd>
1473<pre>
1474 URxvt.keysym.M-C-3: command:\033[8;25;80t
1475 URxvt.keysym.M-C-4: command:\033[8;48;110t</pre>
1476</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>
1482<dd>
1483Comma-separated <code>list(s)</code> of perl extension scripts (default: <code>default</code>) to
1484use in this terminal instance; option <strong>-pe</strong>.
1485</dd>
1486<dd>
1487<p>Extension names can be prefixed with a <code>-</code> sign to prohibit using
1488them. This can be useful to selectively disable some extensions loaded
1489by default, or specified via the <code>perl-ext-common</code> resource. For
1490example, <code>default,-selection</code> will use all the default extension except
1491<code>selection</code>.</p>
1492</dd>
1493<dd>
1494<p>Extension names can also be followed by an argument in angle brackets
1495(e.g. <code>searchable-scrollback&lt;M-s&gt;</code>, which binds the hotkey for
1496searchable scorllback to Alt/Meta-s). Mentioning the same extension
1497multiple times with different arguments will pass multiple arguments to
1498the extension.</p>
1499</dd>
1500<dd>
1501<p>Each extension is looked up in the library directories, loaded if
1502necessary, and bound to the current terminal instance.</p>
1503</dd>
1504<dd>
1505<p>If both of these resources are the empty string, then the perl
1506interpreter will not be initialized. The idea behind two options is that
1507<strong>perl-ext-common</strong> will be used for extensions that should be available to
1508all instances, while <strong>perl-ext</strong> is used for specific instances.</p>
1509</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>
1513<dd>
1514Perl code to be evaluated when all extensions have been registered. See
1515the <code>rxvtperl(3)</code> manpage. Due to security reasons, this resource
1516will be ignored when running setuid/setgid.
1517</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>
1521<dd>
1522Colon-separated list of additional directories that hold extension
1523scripts. When looking for extensions specified by the <code>perl</code> resource,
1524rxvt will first look in these directories and then in
1525<em>/opt/rxvt/lib/urxvt/perl/</em>. Due to security reasons, this resource
1526will be ignored when running setuid/setgid.
1527</dd>
1528<dd>
1529<p>See the <code>rxvtperl(3)</code> manpage.</p>
1530</dd>
1531<p></p>
1532<dt><strong><a name="item_selection_2epattern_2didx_3a_perl_2dregex"><strong>selection.pattern-<em>idx</em> </strong>&gt;: <em>perl-regex</em></a></strong><br />
1533</dt>
1534<dd>
1535Additional selection patterns, see the <code>rxvtperl(3)</code> manpage for
1536details.
1537</dd>
1538<p></p>
1539<dt><strong><a name="item_selection_2dautotransform_2eidx_3a_perl_2dtransfor"><strong>selection-autotransform.<em>idx</em> </strong>&gt;: <em>perl-transform</em></a></strong><br />
1540</dt>
1541<dd>
1542Selection auto-transform patterns, see the <code>rxvtperl(3)</code> manpage
1543for 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>
1549Sets 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>
1556Specifies 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>
1563Compile <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>
1569Compile <em>frills</em>: Sets override-redirect for the terminal window, making
1570it almost invisible to window managers; option <strong>-override-redirect</strong>.
1114</dd> 1571</dd>
1115<p></p></dl> 1572<p></p></dl>
1116<p> 1573<p>
1117</p> 1574</p>
1118<hr /> 1575<hr />
… …
1132<p>To temporarily override mouse reporting, for either the scrollbar or 1589<p>To temporarily override mouse reporting, for either the scrollbar or
1133the normal text selection/insertion, hold either the Shift or the Meta 1590the normal text selection/insertion, hold either the Shift or the Meta
1134(Alt) key while performing the desired mouse action.</p> 1591(Alt) key while performing the desired mouse action.</p>
1135<p>If mouse reporting mode is active, the normal scrollbar actions are 1592<p>If mouse reporting mode is active, the normal scrollbar actions are
1136disabled -- on the assumption that we are using a fullscreen 1593disabled -- on the assumption that we are using a fullscreen
1137application. Instead, pressing Button1 and Button3 sends <strong>ESC[6~</strong> 1594application. Instead, pressing Button1 and Button3 sends <strong>ESC [ 6 ~</strong>
1138(Next) and <strong>ESC[5~</strong> (Prior), respectively. Similarly, clicking on the 1595(Next) and <strong>ESC [ 5 ~</strong> (Prior), respectively. Similarly, clicking on the
1139up and down arrows sends <strong>ESC[A</strong> (Up) and <strong>ESC[B</strong> (Down), 1596up and down arrows sends <strong>ESC [ A</strong> (Up) and <strong>ESC [ B</strong> (Down),
1140respectively.</p> 1597respectively.</p>
1141<p> 1598<p>
1142</p> 1599</p>
1143<hr /> 1600<hr />
1144<h1><a name="text_selection_and_insertion">TEXT SELECTION AND INSERTION</a></h1> 1601<h1><a name="text_selection_and_insertion">TEXT SELECTION AND INSERTION</a></h1>
… …
1146<em>xterm</em>(1).</p> 1603<em>xterm</em>(1).</p>
1147<dl> 1604<dl>
1148<dt><strong><a name="item_selection_3a"><strong>Selection</strong>:</a></strong><br /> 1605<dt><strong><a name="item_selection_3a"><strong>Selection</strong>:</a></strong><br />
1149</dt> 1606</dt>
1150<dd> 1607<dd>
1151Left click at the beginning of the region, drag to the end of the 1608Left click at the beginning of the region, drag to the end of the region
1152region and release; Right click to extend the marked region; Left 1609and release; Right click to extend the marked region; Left double-click
1153double-click to select a word; Left triple-click to select the entire 1610to select a word; Left triple-click to select the entire logical line
1154line. 1611(which can span multiple screen lines), unless modified by resource
1612<strong>tripleclickwords</strong>.
1155</dd> 1613</dd>
1156<dd> 1614<dd>
1157<p>Starting a selection while pressing the <strong>Meta</strong> key (or <strong>Meta+Ctrl</strong> keys) 1615<p>Starting a selection while pressing the <strong>Meta</strong> key (or <strong>Meta+Ctrl</strong> keys)
1158(Compile: frills) will create a rectangular selection instead of a normal 1616(Compile: <em>frills</em>) will create a rectangular selection instead of a
1159one.</p> 1617normal one. In this mode, every selected row becomes its own line in the
1618selection, and trailing whitespace is visually underlined and removed from
1619the selection.</p>
1160</dd> 1620</dd>
1161<p></p> 1621<p></p>
1162<dt><strong><a name="item_insertion_3a"><strong>Insertion</strong>:</a></strong><br /> 1622<dt><strong><a name="item_insertion_3a"><strong>Insertion</strong>:</a></strong><br />
1163</dt> 1623</dt>
1164<dd> 1624<dd>
1165Pressing and releasing the Middle mouse button (or <strong>Shift-Insert</strong>) in 1625Pressing and releasing the Middle mouse button in an <strong>rxvt</strong>
1166an <strong>rxvt</strong> window causes the current text selection to be 1626window causes the value of the PRIMARY selection (or CLIPBOARD with the
1167inserted as if it had been typed on the keyboard. 1627Meta modifier) to be inserted as if it had been typed on the keyboard.
1628</dd>
1629<dd>
1630<p>Pressing <strong>Shift-Insert</strong> causes the value of the PRIMARY selection to be
1631inserted too.</p>
1168</dd> 1632</dd>
1169<p></p></dl> 1633<p></p></dl>
1170<p> 1634<p>
1171</p> 1635</p>
1172<hr /> 1636<hr />
1173<h1><a name="changing_fonts">CHANGING FONTS</a></h1> 1637<h1><a name="changing_fonts">CHANGING FONTS</a></h1>
1174<p>Changing fonts (or font sizes, respectively) via the keypad is not yet 1638<p>Changing fonts (or font sizes, respectively) via the keypad is not yet
1175supported in rxvt-unicode. Bug me if you need this.</p> 1639supported in rxvt-unicode. Bug me if you need this.</p>
1176<p>You can, however, switch fonts at runtime using escape sequences (and 1640<p>You can, however, switch fonts at runtime using escape sequences, e.g.:</p>
1177therefore using the menubar), e.g.:</p>
1178<pre> 1641<pre>
1179 printf '\e]701;%s\007' &quot;9x15bold,xft:Kochi Gothic&quot;</pre> 1642 printf '\e]710;%s\007' &quot;9x15bold,xft:Kochi Gothic&quot;</pre>
1643<p>You can use keyboard shortcuts, too:</p>
1644<pre>
1645 URxvt.keysym.M-C-1: command:\033]710;suxuseuro\007\033]711;suxuseuro\007
1646 URxvt.keysym.M-C-2: command:\033]710;9x15bold\007\033]711;9x15bold\007</pre>
1180<p>rxvt-unicode will automatically re-apply these fonts to the output so far.</p> 1647<p>rxvt-unicode will automatically re-apply these fonts to the output so far.</p>
1181<p> 1648<p>
1182</p> 1649</p>
1183<hr /> 1650<hr />
1184<h1><a name="iso_14755_support">ISO 14755 SUPPORT</a></h1> 1651<h1><a name="iso_14755_support">ISO 14755 SUPPORT</a></h1>
1185<p>ISO 14755 is a standard for entering and viewing unicode characters 1652<p>ISO 14755 is a standard for entering and viewing unicode characters
1186and character codes using the keyboard. It consists of 4 parts. The 1653and character codes using the keyboard. It consists of 4 parts. The
1187first part is available rxvt-unicode has been compiled with 1654first part is available rxvt-unicode has been compiled with
1188<code>--enable-frills</code>, the rest is available when rxvt-unicode was compiled 1655<code>--enable-frills</code>, the rest is available when rxvt-unicode was compiled
1189with <code>--enable-iso14755</code>.</p> 1656with <code>--enable-iso14755</code>.</p>
1190<ol> 1657<ul>
1191<li><strong><a name="item_1_3a_basic_method">1: Basic method</a></strong><br /> 1658<li><strong><a name="item_5_2e1_3a_basic_method">5.1: Basic method</a></strong><br />
1192</li> 1659</li>
1193This allows you to enter unicode characters using their hexcode. 1660This allows you to enter unicode characters using their hexcode.
1194<p>Start by pressing and holding both <code>Control</code> and <code>Shift</code>, then enter 1661<p>Start by pressing and holding both <code>Control</code> and <code>Shift</code>, then enter
1195hex-digits (between one and six). Releasing <code>Control</code> and <code>Shift</code> will 1662hex-digits (between one and six). Releasing <code>Control</code> and <code>Shift</code> will
1196commit the character as if it were typed directly. While holding down 1663commit the character as if it were typed directly. While holding down
… …
1201address, which you cannot type. Fortunately, the card has the e-mail 1668address, which you cannot type. Fortunately, the card has the e-mail
1202address printed as hexcodes, e.g. <code>671d 65e5</code>. You can enter this easily 1669address printed as hexcodes, e.g. <code>671d 65e5</code>. You can enter this easily
1203by pressing <code>Control</code> and <code>Shift</code>, followed by <code>6-7-1-D-SPACE-6-5-E-5</code>, 1670by pressing <code>Control</code> and <code>Shift</code>, followed by <code>6-7-1-D-SPACE-6-5-E-5</code>,
1204followed by releasing the modifier keys.</p> 1671followed by releasing the modifier keys.</p>
1205<p></p> 1672<p></p>
1206<li><strong><a name="item_2_3a_keyboard_symbols_entry_method">2: Keyboard symbols entry method</a></strong><br /> 1673<li><strong><a name="item_5_2e2_3a_keyboard_symbols_entry_method">5.2: Keyboard symbols entry method</a></strong><br />
1207</li> 1674</li>
1208This mode lets you input characters representing the keycap symbols of 1675This mode lets you input characters representing the keycap symbols of
1209your keyboard, if representable in the current locale encoding. 1676your keyboard, if representable in the current locale encoding.
1210<p>Start by pressing <code>Control</code> and <code>Shift</code> together, then releasing 1677<p>Start by pressing <code>Control</code> and <code>Shift</code> together, then releasing
1211them. The next special key (cursor keys, home etc.) you enter will not 1678them. The next special key (cursor keys, home etc.) you enter will not
… …
1213keycap symbol. The symbol will only be entered when the key has been 1680keycap symbol. The symbol will only be entered when the key has been
1214released, otherwise pressing e.g. <code>Shift</code> would enter the symbol for 1681released, otherwise pressing e.g. <code>Shift</code> would enter the symbol for
1215<code>ISO Level 2 Switch</code>, although your intention might have been to enter a 1682<code>ISO Level 2 Switch</code>, although your intention might have been to enter a
1216reverse tab (Shift-Tab).</p> 1683reverse tab (Shift-Tab).</p>
1217<p></p> 1684<p></p>
1218<li><strong><a name="item_3_3a_screen_2dselection_entry_method">3: Screen-selection entry method</a></strong><br /> 1685<li><strong><a name="item_5_2e3_3a_screen_2dselection_entry_method">5.3: Screen-selection entry method</a></strong><br />
1219</li> 1686</li>
1220While this is implemented already (it's basically the selection 1687While this is implemented already (it's basically the selection
1221mechanism), it could be extended by displaying a unicode character map. 1688mechanism), it could be extended by displaying a unicode character map.
1222<p></p> 1689<p></p>
1223<li><strong><a name="item_4_3a_feedback_method_for_identifying_displayed_cha">4: Feedback method for identifying displayed characters for later input</a></strong><br /> 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 />
1224</li> 1691</li>
1225This method lets you display the unicode character code associated with 1692This method lets you display the unicode character code associated with
1226characters already displayed. 1693characters already displayed.
1227<p>You enter this mode by holding down <code>Control</code> and <code>Shift</code> together, then 1694<p>You enter this mode by holding down <code>Control</code> and <code>Shift</code> together, then
1228pressing and holding the left mouse button and moving around. The unicode 1695pressing and holding the left mouse button and moving around. The unicode
… …
1230pointer is displayed until you release <code>Control</code> and <code>Shift</code>.</p> 1697pointer is displayed until you release <code>Control</code> and <code>Shift</code>.</p>
1231<p>In addition to the hex codes it will display the font used to draw this 1698<p>In addition to the hex codes it will display the font used to draw this
1232character - due to implementation reasons, characters combined with 1699character - due to implementation reasons, characters combined with
1233combining characters, line drawing characters and unknown characters will 1700combining characters, line drawing characters and unknown characters will
1234always be drawn using the built-in support font.</p> 1701always be drawn using the built-in support font.</p>
1235<p></p></ol> 1702<p></p></ul>
1236<p>With respect to conformance, rxvt-unicode is supposed to be compliant to 1703<p>With respect to conformance, rxvt-unicode is supposed to be compliant to
1237both scenario A and B of ISO 14755, including part 5.2.</p> 1704both scenario A and B of ISO 14755, including part 5.2.</p>
1238<p> 1705<p>
1239</p> 1706</p>
1240<hr /> 1707<hr />
1241<h1><a name="login_stamp">LOGIN STAMP</a></h1> 1708<h1><a name="login_stamp">LOGIN STAMP</a></h1>
1242<p><strong>rxvt</strong> tries to write an entry into the <em>utmp</em>(5) file so 1709<p><strong>rxvt</strong> tries to write an entry into the <em>utmp</em>(5) file so that
1243that it can be seen via the <em>who(1)</em> command, and can accept messages. 1710it can be seen via the <em>who(1)</em> command, and can accept messages. To
1244To allow this feature, <strong>rxvt</strong> must be installed setuid root on 1711allow this feature, <strong>rxvt</strong> may need to be installed setuid root
1245some systems.</p> 1712on some systems or setgid to root or to some other group on others.</p>
1246<p> 1713<p>
1247</p> 1714</p>
1248<hr /> 1715<hr />
1249<h1><a name="colors_and_graphics">COLORS AND GRAPHICS</a></h1> 1716<h1><a name="colors_and_graphics">COLORS AND GRAPHICS</a></h1>
1250<p>In addition to the default foreground and background colours, 1717<p>In addition to the default foreground and background colours,
1251<strong>rxvt</strong> can display up to 16 colours (8 ANSI colours plus 1718<strong>rxvt</strong> can display up to 16 colours (8 ANSI colours plus
1252high-intensity bold/blink versions of the same). Here is a list of the 1719high-intensity bold/blink versions of the same). Here is a list of the
1253colours with their <strong>rgb.txt</strong> names.</p> 1720colours with their names.</p>
1254<table> 1721<table>
1255<tr><td>color0</td><td>(black)</td><td>= Black</td></tr> 1722<tr><td>color0</td><td>(black)</td><td>= Black</td></tr>
1256<tr><td>color1</td><td>(red)</td><td>= Red3</td></tr> 1723<tr><td>color1</td><td>(red)</td><td>= Red3</td></tr>
1257<tr><td>color2</td><td>(green)</td><td>= Green3</td></tr> 1724<tr><td>color2</td><td>(green)</td><td>= Green3</td></tr>
1258<tr><td>color3</td><td>(yellow)</td><td>= Yellow3</td></tr> 1725<tr><td>color3</td><td>(yellow)</td><td>= Yellow3</td></tr>
… …
1286on White. 1753on White.
1287</dd> 1754</dd>
1288<p></p></dl> 1755<p></p></dl>
1289<p> 1756<p>
1290</p> 1757</p>
1758<h2><a name="alpha_channel_support">ALPHA CHANNEL SUPPORT</a></h2>
1759<p>If Xft support has been compiled in and as long as Xft/Xrender/X don't get
1760their act together, rxvt-unicode will support <code>rgba:rrrr/gggg/bbbb/aaaa</code>
1761(recommended, but <strong>MUST</strong> have 4 digits/component) colour specifications,
1762in addition to the ones provided by X, where the additional A component
1763specifies opacity (alpha) values. The minimum value of <code>0</code> is completely
1764transparent). You can also prefix any color with <code>[a]</code>, where <code>a</code> is on
1765to four hex digits specifiying the opacity value.</p>
1766<p>You probably need to specify <strong>``-depth 32''</strong>, too, and have the luck that
1767your X-server uses ARGB pixel layout, as X is far from just supporting
1768ARGB visuals out of the box, and rxvt-unicode just fudges around.</p>
1769<p>For example, the following selects an almost completely transparent red
1770background, and an almost opaque pink foreground:</p>
1771<pre>
1772 rxvt -depth 32 -bg rgba:0000/0000/0000/2222 -fg &quot;[e]pink&quot;</pre>
1773<p><em>Please note that transparency of any kind if completely unsupported by
1774the author. Don't bug him with installation questions!</em></p>
1775<p>
1776</p>
1291<hr /> 1777<hr />
1292<h1><a name="environment">ENVIRONMENT</a></h1> 1778<h1><a name="environment">ENVIRONMENT</a></h1>
1293<p><strong>rxvt</strong> sets the environment variables <strong>TERM</strong>, <strong>COLORTERM</strong> 1779<p><strong>rxvt</strong> sets and/or uses the following environment variables:</p>
1294and <strong>COLORFGBG</strong>. The environment variable <strong>WINDOWID</strong> is set to the X 1780<dl>
1295window id number of the <strong>rxvt</strong> window and it also uses and 1781<dt><strong><a name="item_term"><strong>TERM</strong></a></strong><br />
1296sets the environment variable <strong>DISPLAY</strong> to specify which display 1782</dt>
1297terminal to use. <strong>rxvt</strong> uses the environment variables 1783<dd>
1298<strong>RXVTPATH</strong> and <strong>PATH</strong> to find XPM files.</p> 1784Normally set to <code>rxvt-unicode</code>, unless overwritten at configure time, via
1785resources or on the commandline.
1786</dd>
1787<p></p>
1788<dt><strong><a name="item_colorterm"><strong>COLORTERM</strong></a></strong><br />
1789</dt>
1790<dd>
1791Either <code>rxvt</code>, <code>rxvt-xpm</code>, depending on wether rxvt was
1792compiled with XPM support, and optionally with the added extension
1793<code>-mono</code> to indicate that rxvt-unicode runs on a monochrome screen.
1794</dd>
1795<p></p>
1796<dt><strong><a name="item_colorfgbg"><strong>COLORFGBG</strong></a></strong><br />
1797</dt>
1798<dd>
1799Set to a string of the form <code>fg;bg</code> or <code>fg;xpm;bg</code>, where <code>fg</code> is
1800the colour code used as default foreground/text colour (or the string
1801<code>default</code> to indicate that the default-colour escape sequence is to be
1802used), <code>bg</code> is the colour code used as default background colour (or the
1803string <code>default</code>), and <code>xpm</code> is the string <code>default</code> if rxvt
1804was compiled with XPM support. Libraries like <code>ncurses</code> and <code>slang</code> can
1805(and do) use this information to optimize screen output.
1806</dd>
1807<p></p>
1808<dt><strong><a name="item_windowid"><strong>WINDOWID</strong></a></strong><br />
1809</dt>
1810<dd>
1811Set to the (decimal) X Window ID of the rxvt window (the toplevel
1812window, which usually has subwindows for the scrollbar, the terminal
1813window and so on).
1814</dd>
1815<p></p>
1816<dt><strong><a name="item_terminfo"><strong>TERMINFO</strong></a></strong><br />
1817</dt>
1818<dd>
1819Set to the terminfo directory iff rxvt was configured with
1820<code>--with-terminfo=PATH</code>.
1821</dd>
1822<p></p>
1823<dt><strong><a name="item_display"><strong>DISPLAY</strong></a></strong><br />
1824</dt>
1825<dd>
1826Used by rxvt to connect to the display and set to the correct
1827display in it's child processes.
1828</dd>
1829<p></p>
1830<dt><strong><a name="item_shell"><strong>SHELL</strong></a></strong><br />
1831</dt>
1832<dd>
1833The shell to be used for command execution, defaults to <code>/bin/sh</code>.
1834</dd>
1835<p></p>
1836<dt><strong><a name="item_rxvt_socket"><strong>RXVT_SOCKET</strong></a></strong><br />
1837</dt>
1838<dd>
1839The unix domain socket path used by <code>rxvtc(1)</code> and
1840rxvtd(1).
1841</dd>
1842<dd>
1843<p>Default <em>$HOME/.rxvt-unicode-<em>&lt;nodename </em></em> &gt;&gt;&gt;.</p>
1844</dd>
1845<p></p>
1846<dt><strong><a name="item_home"><strong>HOME</strong></a></strong><br />
1847</dt>
1848<dd>
1849Used to locate the default directory for the unix domain socket for
1850daemon communications and to locate various resource files (such as
1851<code>.Xdefaults</code>)
1852</dd>
1853<p></p>
1854<dt><strong><a name="item_xapplresdir"><strong>XAPPLRESDIR</strong></a></strong><br />
1855</dt>
1856<dd>
1857Directory where various X resource files are being located.
1858</dd>
1859<p></p>
1860<dt><strong><a name="item_xenvironment"><strong>XENVIRONMENT</strong></a></strong><br />
1861</dt>
1862<dd>
1863If set and accessible, gives the name of a X resource file to be loaded by
1864rxvt.
1865</dd>
1866<p></p></dl>
1299<p> 1867<p>
1300</p> 1868</p>
1301<hr /> 1869<hr />
1302<h1><a name="files">FILES</a></h1> 1870<h1><a name="files">FILES</a></h1>
1303<dl> 1871<dl>
1304<dt><strong><a name="item__2fetc_2futmp"><strong>/etc/utmp</strong></a></strong><br />
1305</dt>
1306<dd>
1307System file for login records.
1308</dd>
1309<p></p>
1310<dt><strong><a name="item__2fusr_2flib_2fx11_2frgb_2etxt"><strong>/usr/lib/X11/rgb.txt</strong></a></strong><br /> 1872<dt><strong><a name="item__2fusr_2flib_2fx11_2frgb_2etxt"><strong>/usr/lib/X11/rgb.txt</strong></a></strong><br />
1311</dt> 1873</dt>
1312<dd> 1874<dd>
1313Color names. 1875Color names.
1314</dd> 1876</dd>
1315<p></p></dl> 1877<p></p></dl>
1316<p> 1878<p>
1317</p> 1879</p>
1318<hr /> 1880<hr />
1319<h1><a name="see_also">SEE ALSO</a></h1> 1881<h1><a name="see_also">SEE ALSO</a></h1>
1320<p>rxvt(7), xterm(1), sh(1), resize(1), X(1), pty(4), tty(4), <code>utmp(5)</code></p> 1882<p>rxvt(7), rxvtc(1), rxvtd(1), xterm(1), sh(1), resize(1), X(1), pty(4), tty(4), <code>utmp(5)</code></p>
1321<p>
1322</p>
1323<hr />
1324<h1><a name="bugs">BUGS</a></h1>
1325<p>Check the BUGS file for an up-to-date list.</p>
1326<p>Cursor change support is not yet implemented.</p>
1327<p>Click-and-drag doesn't work with X11 mouse report overriding.</p>
1328<p> 1883<p>
1329</p> 1884</p>
1330<hr /> 1885<hr />
1331<h1><a name="current_project_coordinator">CURRENT PROJECT COORDINATOR</a></h1> 1886<h1><a name="current_project_coordinator">CURRENT PROJECT COORDINATOR</a></h1>
1332<dl> 1887<dl>
1333<dt><strong><a name="item_project_coordinator">Project Coordinator</a></strong><br /> 1888<dt><strong><a name="item_project_coordinator">Project Coordinator</a></strong><br />
1334</dt> 1889</dt>
1335<dd> 1890<dd>
1336Marc A. Lehmann <em><a href="mailto:rxvt@schmorp.de">rxvt@schmorp.de</a></em> 1891Marc A. Lehmann <em><a href="mailto:<rxvt-unicode@schmorp.de"><rxvt-unicode@schmorp.de</a></em>&gt;
1337</dd>
1338<p></p>
1339<dt><strong><a name="item_web_page_maintainter">Web page maintainter</a></strong><br />
1340</dt>
1341<dd> 1892</dd>
1342Marc A. Lehmann <em><a href="mailto:rxvt@schmorp.de">rxvt@schmorp.de</a></em>
1343</dd> 1893<dd>
1344<dd>
1345<p><a href="http://software.schmorp.de/">http://software.schmorp.de/</a></p> 1894<p><a href="http://software.schmorp.de/#rxvt-unicode">http://software.schmorp.de/#rxvt-unicode</a></p>
1346</dd> 1895</dd>
1347<p></p></dl> 1896<p></p></dl>
1348<p> 1897<p>
1349</p> 1898</p>
1350<hr /> 1899<hr />
… …
1384</dd> 1933</dd>
1385<p></p> 1934<p></p>
1386<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>&gt;</a></strong><br /> 1935<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>&gt;</a></strong><br />
1387</dt> 1936</dt>
1388<dd> 1937<dd>
1389Rewrote screen display and text selection routines. Project Coordinator 1938Rewrote screen display and text selection routines.
1390(changes.txt 2.4.6 - rxvt-unicode) 1939
1940</dd>
1391</dd> 1941<dd>
1942<pre>
1943
1944Project Coordinator (changes.txt 2.4.6 - rxvt-unicode)</pre>
1945</dd>
1392<p></p> 1946<p></p>
1393<dt><strong><a name="item_marc_alexander_lehmann__3crxvt_40schmorp_2ede_3e">Marc Alexander Lehmann <em><a href="mailto:<rxvt@schmorp.de"><rxvt@schmorp.de</a></em>&gt;</a></strong><br /> 1947<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>&gt;</a></strong><br />
1394</dt> 1948</dt>
1395<dd> 1949<dd>
1396Forked rxvt-unicode, rewrote most of the display code and internal 1950Forked rxvt-unicode, unicode support, rewrote almost all the code, perl
1397character handling to store text in unicode, improve xterm 1951extension, random hacks, numerous bugfixes and extensions.
1398compatibility and apply numerous other bugfixes and extensions.
1399</dd> 1952</dd>
1400<dd> 1953<dd>
1401<p>Project Coordinator (Changes 1.0 -)</p> 1954<p>Project Coordinator (Changes 1.0 -)</p>
1955</dd>
1956<p></p>
1957<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>&gt;</a></strong><br />
1958</dt>
1959<dd>
1960Pty/tty/utmp/wtmp rewrite, lots of random hacking and bugfixing.
1402</dd> 1961</dd>
1403<p></p></dl> 1962<p></p></dl>
1404 1963
1405</body> 1964</body>
1406 1965

Diff Legend

– Removed lines
+ Added lines
< Changed lines
> Changed lines