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.23 by root, Thu Jul 7 19:37:46 2005 UTC vs.
Revision 1.55 by root, Sun Jan 29 22:38:43 2006 UTC

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 <li><a href="#environment">ENVIRONMENT</a></li> 29 <li><a href="#environment">ENVIRONMENT</a></li>
30 <li><a href="#files">FILES</a></li> 30 <li><a href="#files">FILES</a></li>
31 <li><a href="#see_also">SEE ALSO</a></li> 31 <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> 32 <li><a href="#current_project_coordinator">CURRENT PROJECT COORDINATOR</a></li>
34 <li><a href="#authors">AUTHORS</a></li> 33 <li><a href="#authors">AUTHORS</a></li>
35</ul> 34</ul>
36<!-- INDEX END --> 35<!-- INDEX END -->
37 36
47<p><strong>rxvt</strong> [options] [-e command [ args ]]</p> 46<p><strong>rxvt</strong> [options] [-e command [ args ]]</p>
48<p> 47<p>
49</p> 48</p>
50<hr /> 49<hr />
51<h1><a name="description">DESCRIPTION</a></h1> 50<h1><a name="description">DESCRIPTION</a></h1>
52<p><strong>rxvt-unicode</strong>, version <strong>5.6</strong>, is a colour vt102 terminal 51<p><strong>rxvt-unicode</strong>, version <strong>7.4</strong>, is a colour vt102 terminal
53emulator intended as an <em>xterm</em>(1) replacement for users who do not 52emulator intended as an <em>xterm</em>(1) replacement for users who do not
54require features such as Tektronix 4014 emulation and toolkit-style 53require features such as Tektronix 4014 emulation and toolkit-style
55configurability. As a result, <strong>rxvt-unicode</strong> uses much less swap space -- 54configurability. As a result, <strong>rxvt-unicode</strong> uses much less swap space --
56a significant advantage on a machine serving many X sessions.</p> 55a significant advantage on a machine serving many X sessions.</p>
57<p> 56<p>
132Attempt to open a window on the named X display (<strong>-d</strong> still 131Attempt to open a window on the named X display (<strong>-d</strong> still
133respected). In the absence of this option, the display specified by the 132respected). In the absence of this option, the display specified by the
134<strong>DISPLAY</strong> environment variable is used. 133<strong>DISPLAY</strong> environment variable is used.
135</dd> 134</dd>
136<p></p> 135<p></p>
136<dt><strong><a name="item__2ddepth_bitdepth"><strong>-depth</strong> <em>bitdepth</em></a></strong><br />
137</dt>
138<dd>
139Compile <em>xft</em>: Attempt to find a visual with the given bit depth;
140resource <strong>depth</strong>.
141</dd>
142<p></p>
137<dt><strong><a name="item__2dgeometry_geom"><strong>-geometry</strong> <em>geom</em></a></strong><br /> 143<dt><strong><a name="item__2dgeometry_geom"><strong>-geometry</strong> <em>geom</em></a></strong><br />
138</dt> 144</dt>
139<dd> 145<dd>
140Window geometry (<strong>-g</strong> still respected); resource <strong>geometry</strong>. 146Window geometry (<strong>-g</strong> still respected); resource <strong>geometry</strong>.
141</dd> 147</dd>
150</dt> 156</dt>
151<dd> 157<dd>
152Turn on/off jump scrolling; resource <strong>jumpScroll</strong>. 158Turn on/off jump scrolling; resource <strong>jumpScroll</strong>.
153</dd> 159</dd>
154<p></p> 160<p></p>
155<dt><strong><a name="item__2dip_7c_2bip"><strong>-ip</strong>|<strong>+ip</strong></a></strong><br /> 161<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 />
156</dt> 162</dt>
157<dd> 163<dd>
158Turn on/off inheriting parent window's pixmap. Alternative form is 164Turn on/off inheriting parent window's pixmap. Alternative form is
159<strong>-tr</strong>; resource <strong>inheritPixmap</strong>. 165<strong>-tr</strong>; resource <strong>inheritPixmap</strong>.
160</dd> 166</dd>
167<dd>
168<p><em>Please note that transparency of any kind if completely unsupported by
169the author. Don't bug him with installation questions!</em></p>
170</dd>
161<p></p> 171<p></p>
162<dt><strong><a name="item__2dfade_number"><strong>-fade</strong> <em>number</em></a></strong><br /> 172<dt><strong><a name="item__2dfade_number"><strong>-fade</strong> <em>number</em></a></strong><br />
163</dt> 173</dt>
164<dd> 174<dd>
165Fade the text by the given percentage when focus is lost. resource <strong>fading</strong>. 175Fade the text by the given percentage when focus is lost. Small values
176fade a little only, 100 completely replaces all colours by the fade
177colour; resource <strong>fading</strong>.
178</dd>
179<p></p>
180<dt><strong><a name="item__2dfadecolor_colour"><strong>-fadecolor</strong> <em>colour</em></a></strong><br />
181</dt>
182<dd>
183Fade to this colour when fading is used (see <strong>-fade</strong>). The default colour
184is opaque black. resource <strong>fadeColor</strong>.
166</dd> 185</dd>
167<p></p> 186<p></p>
168<dt><strong><a name="item__2dtint_colour"><strong>-tint</strong> <em>colour</em></a></strong><br /> 187<dt><strong><a name="item__2dtint_colour"><strong>-tint</strong> <em>colour</em></a></strong><br />
169</dt> 188</dt>
170<dd> 189<dd>
171Tint the transparent background pixmap with the given colour when 190Tint the transparent background pixmap with the given colour when
172transparency is enabled with <strong>-tr</strong> or <strong>-ip</strong>. See also the <strong>-sh</strong> 191transparency is enabled with <strong>-tr</strong> or <strong>-ip</strong>. This only works for
173option that can be used to brighten or darken the image in addition to 192non-tiled backgrounds, currently. See also the <strong>-sh</strong> option that can be
174tinting it. 193used to brighten or darken the image in addition to tinting it; resource
194<em>tintColor</em>. Example:
195</dd>
196<dd>
197<pre>
198 rxvt -tr -tint blue -sh 40</pre>
175</dd> 199</dd>
176<p></p> 200<p></p>
177<dt><strong><a name="item__2dsh"><strong>-sh</strong></a></strong><br /> 201<dt><strong><a name="item__2dsh"><strong>-sh</strong></a></strong><br />
178</dt> 202</dt>
179<dd> 203<dd>
230<p></p> 254<p></p>
231<dt><strong><a name="item__2dfn_fontlist"><strong>-fn</strong> <em>fontlist</em></a></strong><br /> 255<dt><strong><a name="item__2dfn_fontlist"><strong>-fn</strong> <em>fontlist</em></a></strong><br />
232</dt> 256</dt>
233<dd> 257<dd>
234Select the fonts to be used. This is a comma separated list of font names 258Select the fonts to be used. This is a comma separated list of font names
235that are used in turn when trying to display Unicode characters. The 259that are checked in order when trying to find glyphs for characters. The
236first font defines the cell size for characters; other fonts might be 260first font defines the cell size for characters; other fonts might be
237smaller, but not (in general) larger. A (hopefully) reasonable default 261smaller, but not (in general) larger. A (hopefully) reasonable default
238font list is always appended to it. See resource <strong>font</strong> for more details. 262font list is always appended to it. See resource <strong>font</strong> for more details.
239</dd> 263</dd>
240<dd> 264<dd>
253</dd> 277</dd>
254<p></p> 278<p></p>
255<dt><strong><a name="item__2dfb_fontlist"><strong>-fb</strong> <em>fontlist</em></a></strong><br /> 279<dt><strong><a name="item__2dfb_fontlist"><strong>-fb</strong> <em>fontlist</em></a></strong><br />
256</dt> 280</dt>
257<dd> 281<dd>
258Compile font-styles: The bold font list to use when bold characters are to 282Compile <em>font-styles</em>: The bold font list to use when <strong>bold</strong> characters
259be printed. See resource <strong>boldFont</strong> for details. 283are to be printed. See resource <strong>boldFont</strong> for details.
260</dd> 284</dd>
261<p></p> 285<p></p>
262<dt><strong><a name="item__2dfi_fontlist"><strong>-fi</strong> <em>fontlist</em></a></strong><br /> 286<dt><strong><a name="item__2dfi_fontlist"><strong>-fi</strong> <em>fontlist</em></a></strong><br />
263</dt> 287</dt>
264<dd> 288<dd>
265Compile font-styles: The italic font list to use when bold characters are to 289Compile <em>font-styles</em>: The italic font list to use when <em>italic</em>
266be printed. See resource <strong>italicFont</strong> for details. 290characters are to be printed. See resource <strong>italicFont</strong> for details.
267</dd> 291</dd>
268<p></p> 292<p></p>
269<dt><strong><a name="item__2dfbi_fontlist"><strong>-fbi</strong> <em>fontlist</em></a></strong><br /> 293<dt><strong><a name="item__2dfbi_fontlist"><strong>-fbi</strong> <em>fontlist</em></a></strong><br />
270</dt> 294</dt>
271<dd> 295<dd>
272Compile font-styles: The bold italic font list to use when bold characters are to 296Compile <em>font-styles</em>: The bold italic font list to use when <strong><em>bold
273be printed. See resource <strong>boldItalicFont</strong> for details. 297italic</em> </strong>&gt; characters are to be printed. See resource <strong>boldItalicFont</strong>
298for details.
299</dd>
300<p></p>
301<dt><strong><a name="item__2dis_7c_2bis"><strong>-is</strong>|<strong>+is</strong></a></strong><br />
302</dt>
303<dd>
304Compile <em>font-styles</em>: Bold/Italic font styles imply high intensity
305foreground/background (default). See resource <strong>intensityStyles</strong> for
306details.
274</dd> 307</dd>
275<p></p> 308<p></p>
276<dt><strong><a name="item__2dname_name"><strong>-name</strong> <em>name</em></a></strong><br /> 309<dt><strong><a name="item__2dname_name"><strong>-name</strong> <em>name</em></a></strong><br />
277</dt> 310</dt>
278<dd> 311<dd>
391</dt> 424</dt>
392<dd> 425<dd>
393Compile <em>frills</em>: Set MWM hints to request a borderless window, i.e. 426Compile <em>frills</em>: Set MWM hints to request a borderless window, i.e.
394if honoured by the WM, the rxvt-unicode window will not have window 427if honoured by the WM, the rxvt-unicode window will not have window
395decorations; resource <strong>borderLess</strong>. 428decorations; resource <strong>borderLess</strong>.
429</dd>
430<p></p>
431<dt><strong><a name="item__2doverride_2dredirect"><strong>-override-redirect</strong></a></strong><br />
432</dt>
433<dd>
434Compile <em>frills</em>: Sets override-redirect on the window; resource
435<strong>override-redirect</strong>.
436</dd>
437<p></p>
438<dt><strong><a name="item__2dsbg"><strong>-sbg</strong></a></strong><br />
439</dt>
440<dd>
441Compile <em>frills</em>: Disable the usage of the built-in block graphics/line
442drawing characters and just rely on what the specified fonts provide. Use
443this if you have a good font and want to use its block graphic glyphs;
444resource <strong>skipBuiltinGlyphs</strong>.
396</dd> 445</dd>
397<p></p> 446<p></p>
398<dt><strong><a name="item__2dlsp_number"><strong>-lsp</strong> <em>number</em></a></strong><br /> 447<dt><strong><a name="item__2dlsp_number"><strong>-lsp</strong> <em>number</em></a></strong><br />
399</dt> 448</dt>
400<dd> 449<dd>
421given on the command line. If this option is used, it must be the last 470given on the command line. If this option is used, it must be the last
422on the command-line. If there is no <strong>-e</strong> option then the default is to 471on the command-line. If there is no <strong>-e</strong> option then the default is to
423run the program specified by the <strong>SHELL</strong> environment variable or, 472run the program specified by the <strong>SHELL</strong> environment variable or,
424failing that, <em>sh(1)</em>. 473failing that, <em>sh(1)</em>.
425</dd> 474</dd>
475<dd>
476<p>Please note that you must specify a program with arguments. If you want to
477run shell commands, you have to specify the shell, like this:</p>
478</dd>
479<dd>
480<pre>
481 rxvt -e sh -c &quot;shell commands&quot;</pre>
482</dd>
426<p></p> 483<p></p>
427<dt><strong><a name="item__2dtitle_text"><strong>-title</strong> <em>text</em></a></strong><br /> 484<dt><strong><a name="item__2dtitle_text"><strong>-title</strong> <em>text</em></a></strong><br />
428</dt> 485</dt>
429<dd> 486<dd>
430Window title (<strong>-T</strong> still respected); the default title is the basename 487Window title (<strong>-T</strong> still respected); the default title is the basename
509<dt><strong><a name="item__2dssr_7c_2bssr"><strong>-ssr</strong>|<strong>+ssr</strong></a></strong><br /> 566<dt><strong><a name="item__2dssr_7c_2bssr"><strong>-ssr</strong>|<strong>+ssr</strong></a></strong><br />
510</dt> 567</dt>
511<dd> 568<dd>
512Turn on/off secondary screen scroll (default enabled); resource 569Turn on/off secondary screen scroll (default enabled); resource
513<strong>secondaryScroll</strong>. 570<strong>secondaryScroll</strong>.
571</dd>
572<p></p>
573<dt><strong><a name="item__2dhold_7c_2bhold"><strong>-hold</strong>|<strong>+hold</strong></a></strong><br />
574</dt>
575<dd>
576Turn on/off hold window after exit support. If enabled, rxvt
577will not immediately destroy its window when the program executed within
578it exits. Instead, it will wait till it is being killed or closed by the
579user; resource <strong>hold</strong>.
514</dd> 580</dd>
515<p></p> 581<p></p>
516<dt><strong><a name="item__2dkeysym_2esym_string"><strong>-keysym.</strong><em>sym</em> <em>string</em></a></strong><br /> 582<dt><strong><a name="item__2dkeysym_2esym_string"><strong>-keysym.</strong><em>sym</em> <em>string</em></a></strong><br />
517</dt> 583</dt>
518<dd> 584<dd>
552 my $xid = $_[0]-&gt;window-&gt;get_xid; 618 my $xid = $_[0]-&gt;window-&gt;get_xid;
553 system &quot;rxvt -embed $xid &amp;&quot;; 619 system &quot;rxvt -embed $xid &amp;&quot;;
554 });</pre> 620 });</pre>
555</dd> 621</dd>
556<p></p> 622<p></p>
557<dt><strong><a name="item__2dpty_2dfd_fileno"><strong>-pty-fd</strong> <em>fileno</em></a></strong><br /> 623<dt><strong><a name="item__2dpty_2dfd_file_descriptor"><strong>-pty-fd</strong> <em>file descriptor</em></a></strong><br />
558</dt> 624</dt>
559<dd> 625<dd>
560Tells rxvt NOT to execute any commands or create a new pty/tty 626Tells rxvt NOT to execute any commands or create a new pty/tty
561pair but instead use the given filehandle as the tty master. This is 627pair but instead use the given filehandle as the tty master. This is
562useful if you want to drive rxvt as a generic terminal emulator 628useful if you want to drive rxvt as a generic terminal emulator
564</dd> 630</dd>
565<dd> 631<dd>
566<p>If this switch is given, rxvt will not create any utmp/wtmp 632<p>If this switch is given, rxvt will not create any utmp/wtmp
567entries and will not tinker with pty/tty permissions - you have to do that 633entries and will not tinker with pty/tty permissions - you have to do that
568yourself if you want that.</p> 634yourself if you want that.</p>
635</dd>
636<dd>
637<p>As an extremely special case, specifying <code>-1</code> will completely suppress
638pty/tty operations.</p>
569</dd> 639</dd>
570<dd> 640<dd>
571<p>Here is a example in perl that illustrates how this option can be used (a 641<p>Here is a example in perl that illustrates how this option can be used (a
572longer example is in <em>doc/pty-fd</em>):</p> 642longer example is in <em>doc/pty-fd</em>):</p>
573</dd> 643</dd>
586<dd> 656<dd>
587<pre> 657<pre>
588 # now communicate with rxvt 658 # now communicate with rxvt
589 my $slave = $pty-&gt;slave; 659 my $slave = $pty-&gt;slave;
590 while (&lt;$slave&gt;) { print $slave &quot;got &lt;$_&gt;\n&quot; }</pre> 660 while (&lt;$slave&gt;) { print $slave &quot;got &lt;$_&gt;\n&quot; }</pre>
661</dd>
662<p></p>
663<dt><strong><a name="item__2dpe_string"><strong>-pe</strong> <em>string</em></a></strong><br />
664</dt>
665<dd>
666Comma-separated list of perl extension scripts to use (or not to use) in
667this terminal instance. See resource <strong>perl-ext</strong> for details.
591</dd> 668</dd>
592<p></p></dl> 669<p></p></dl>
593<p> 670<p>
594</p> 671</p>
595<hr /> 672<hr />
596<h1><a name="resources__available_also_as_longoptions_">RESOURCES (available also as long-options)</a></h1> 673<h1><a name="resources__available_also_as_longoptions_">RESOURCES (available also as long-options)</a></h1>
597<p>Note: `rxvt --help' gives a list of all resources (long 674<p>Note: `rxvt --help' gives a list of all resources (long
598options) compiled into your version.</p> 675options) compiled into your version.</p>
599<p>There are two different methods that rxvt can use to get the 676<p>You can set and change the resources using X11 tools like <strong>xrdb</strong>. Many
600Xresource data: using the X libraries (Xrm*-functions) or internal
601Xresources reader (<strong>~/.Xdefaults</strong>). For the first method (ie.
602<strong>rxvt -h</strong> lists <strong>XGetDefaults</strong>), you can set and change the
603resources using X11 tools like <strong>xrdb</strong>. Many distribution do also load
604settings from the <strong>~/.Xresources</strong> file when X starts. rxvt 677distribution do also load settings from the <strong>~/.Xresources</strong> file when X
605will consult the following files/resources in order, with later settings 678starts. rxvt will consult the following files/resources in order,
606overwriting earlier ones:</p> 679with later settings overwriting earlier ones:</p>
607<pre> 680<pre>
608 1. system-wide app-defaults file, either locale-dependent OR global 681 1. system-wide app-defaults file, either locale-dependent OR global
609 2. app-defaults file in $XAPPLRESDIR 682 2. app-defaults file in $XAPPLRESDIR
610 3. RESOURCE_MANAGER property on root-window OR $HOME/.Xdefaults 683 3. RESOURCE_MANAGER property on root-window OR $HOME/.Xdefaults
611 4. SCREEN_RESOURCES for the current screen 684 4. SCREEN_RESOURCES for the current screen
612 5. $XENVIRONMENT file OR $HOME/.Xdefaults-&lt;nodename&gt;</pre> 685 5. $XENVIRONMENT file OR $HOME/.Xdefaults-&lt;nodename&gt;</pre>
613<p>If compiled with internal Xresources support (i.e. <strong>rxvt -h</strong>
614lists <strong>.Xdefaults</strong>) then <strong>rxvt</strong> accepts application defaults
615set in XAPPLOADDIR/URxvt (compile-time defined: usually
616<strong>/usr/lib/X11/app-defaults/URxvt</strong>) and resources set in
617<strong>~/.Xdefaults</strong>, or <strong>~/.Xresources</strong> if <strong>~/.Xdefaults</strong> does not exist.
618Note that when reading X resources, <strong>rxvt</strong> recognizes two 686<p>Note that when reading X resources, <strong>rxvt</strong> recognizes two class
619class names: <strong>XTerm</strong> and <strong>URxvt</strong>. The class name <strong>Rxvt</strong> allows 687names: <strong>Rxvt</strong> and <strong>URxvt</strong>. The class name <strong>Rxvt</strong> allows resources
620resources common to both <strong>rxvt</strong> and the original <em>rxvt</em> to be 688common to both <strong>rxvt</strong> and the original <em>rxvt</em> to be easily
621easily configured, while the class name <strong>URxvt</strong> allows resources 689configured, while the class name <strong>URxvt</strong> allows resources unique to
622unique to <strong>rxvt</strong>, notably colours and key-handling, to be 690<strong>rxvt</strong>, to be shared between different <strong>rxvt</strong>
623shared between different <strong>rxvt</strong> configurations. If no 691configurations. If no resources are specified, suitable defaults will
624resources are specified, suitable defaults will be used. Command-line 692be used. Command-line arguments can be used to override resource
625arguments can be used to override resource settings. The following 693settings. The following resources are supported (you might want to
626resources are allowed:</p> 694check the <code>rxvtperl(3)</code> manpage for additional settings by perl
695extensions not documented here):</p>
627<dl> 696<dl>
697<dt><strong><a name="item_depth_3a_bitdepth"><strong>depth:</strong> <em>bitdepth</em></a></strong><br />
698</dt>
699<dd>
700Compile <em>xft</em>: Attempt to find a visual with the given bit depth;
701option <strong>-depth</strong>.
702</dd>
703<p></p>
628<dt><strong><a name="item_geometry_3a_geom"><strong>geometry:</strong> <em>geom</em></a></strong><br /> 704<dt><strong><a name="item_geometry_3a_geom"><strong>geometry:</strong> <em>geom</em></a></strong><br />
629</dt> 705</dt>
630<dd> 706<dd>
631Create the window with the specified X window geometry [default 80x24]; 707Create the window with the specified X window geometry [default 80x24];
632option <strong>-geometry</strong>. 708option <strong>-geometry</strong>.
732<dd> 808<dd>
733<strong>True</strong>: make the background inherit the parent windows' pixmap, giving 809<strong>True</strong>: make the background inherit the parent windows' pixmap, giving
734artificial transparency. <strong>False</strong>: do not inherit the parent windows' 810artificial transparency. <strong>False</strong>: do not inherit the parent windows'
735pixmap. 811pixmap.
736</dd> 812</dd>
813<dd>
814<p><em>Please note that transparency of any kind if completely unsupported by
815the author. Don't bug him with installation questions!</em></p>
816</dd>
737<p></p> 817<p></p>
738<dt><strong><a name="item_fading_3a_number"><strong>fading:</strong> <em>number</em></a></strong><br /> 818<dt><strong><a name="item_fading_3a_number"><strong>fading:</strong> <em>number</em></a></strong><br />
739</dt> 819</dt>
740<dd> 820<dd>
741Fade the text by the given percentage when focus is lost. 821Fade the text by the given percentage when focus is lost; option <strong>-fade</strong>.
822</dd>
823<p></p>
824<dt><strong><a name="item_fadecolor_3a_colour"><strong>fadeColor:</strong> <em>colour</em></a></strong><br />
825</dt>
826<dd>
827Fade to this colour, when fading is used (see <strong>fading:</strong>). The default
828colour is black; option <strong>-fadecolor</strong>.
742</dd> 829</dd>
743<p></p> 830<p></p>
744<dt><strong><a name="item_tintcolor_3a_colour"><strong>tintColor:</strong> <em>colour</em></a></strong><br /> 831<dt><strong><a name="item_tintcolor_3a_colour"><strong>tintColor:</strong> <em>colour</em></a></strong><br />
745</dt> 832</dt>
746<dd> 833<dd>
747Tint the transparent background pixmap with the given colour. 834Tint the transparent background pixmap with the given colour; option
835<strong>-tint</strong>.
748</dd> 836</dd>
749<p></p> 837<p></p>
750<dt><strong><a name="item_shading_3a_number"><strong>shading:</strong> <em>number</em></a></strong><br /> 838<dt><strong><a name="item_shading_3a_number"><strong>shading:</strong> <em>number</em></a></strong><br />
751</dt> 839</dt>
752<dd> 840<dd>
786specifies an integer number of images in that direction. No image will 874specifies an integer number of images in that direction. No image will
787be magnified beyond 10 times its original size. The maximum permitted 875be magnified beyond 10 times its original size. The maximum permitted
788scale is 1000. [default 0x0+50+50] 876scale is 1000. [default 0x0+50+50]
789</dd> 877</dd>
790<p></p> 878<p></p>
791<dt><strong><a name="item_menu_3a_file_5b_3btag_5d"><strong>menu:</strong> <em>file[;tag]</em></a></strong><br />
792</dt>
793<dd>
794Read in the specified menu file (note the `.menu' extension is
795optional) and also optionally specify a starting tag to find. See the
796reference documentation for details on the syntax for the menuBar.
797</dd>
798<p></p>
799<dt><strong><a name="item_path_3a_path"><strong>path:</strong> <em>path</em></a></strong><br /> 879<dt><strong><a name="item_path_3a_path"><strong>path:</strong> <em>path</em></a></strong><br />
800</dt> 880</dt>
801<dd> 881<dd>
802Specify the colon-delimited search path for finding files (XPM and 882Specify the colon-delimited search path for finding XPM files.
803menus), in addition to the paths specified by the <strong>RXVTPATH</strong> and
804<strong>PATH</strong> environment variables.
805</dd> 883</dd>
806<p></p> 884<p></p>
807<dt><strong><a name="item_font_3a_fontlist"><strong>font:</strong> <em>fontlist</em></a></strong><br /> 885<dt><strong><a name="item_font_3a_fontlist"><strong>font:</strong> <em>fontlist</em></a></strong><br />
808</dt> 886</dt>
809<dd> 887<dd>
810Select the fonts to be used. This is a comma separated list of font 888Select the fonts to be used. This is a comma separated list of font names
811names that are used in turn when trying to display Unicode characters. 889that are checked in order when trying to find glyphs for characters. The
812The first font defines the cell size for characters; other fonts might 890first font defines the cell size for characters; other fonts might be
813be smaller, but not larger. A reasonable default font list is always 891smaller, but not (in general) larger. A (hopefully) reasonable default
814appended to it. option <strong>-fn</strong>. 892font list is always appended to it; option <strong>-fn</strong>.
815</dd> 893</dd>
816<dd> 894<dd>
817<p>Each font can either be a standard X11 core font (XLFD) name, with 895<p>Each font can either be a standard X11 core font (XLFD) name, with
818optional prefix <code>x:</code> or a Xft font (Compile <em>xft</em>), prefixed with <code>xft:</code>.</p> 896optional prefix <code>x:</code> or a Xft font (Compile <em>xft</em>), prefixed with <code>xft:</code>.</p>
819</dd> 897</dd>
826<dd> 904<dd>
827<p>For example, this font resource</p> 905<p>For example, this font resource</p>
828</dd> 906</dd>
829<dd> 907<dd>
830<pre> 908<pre>
831 URxvt*font: 9x15bold,\ 909 URxvt.font: 9x15bold,\
832 -misc-fixed-bold-r-normal--15-140-75-75-c-90-iso10646-1,\ 910 -misc-fixed-bold-r-normal--15-140-75-75-c-90-iso10646-1,\
833 -misc-fixed-medium-r-normal--15-140-75-75-c-90-iso10646-1, \ 911 -misc-fixed-medium-r-normal--15-140-75-75-c-90-iso10646-1, \
834 [codeset=JISX0208]xft:Kochi Gothic:antialias=false, \ 912 [codeset=JISX0208]xft:Kochi Gothic:antialias=false, \
835 xft:Code2000:antialias=false</pre> 913 xft:Code2000:antialias=false</pre>
836</dd> 914</dd>
880<dd> 958<dd>
881<p>If set, but empty, then this specific style is disabled and the normal 959<p>If set, but empty, then this specific style is disabled and the normal
882text font will being used for the given style.</p> 960text font will being used for the given style.</p>
883</dd> 961</dd>
884<p></p> 962<p></p>
963<dt><strong><a name="item_intensitystyles_3a_boolean"><strong>intensityStyles:</strong> <em>boolean</em></a></strong><br />
964</dt>
965<dd>
966When font styles are not enabled, or this option is enabled (<strong>True</strong>,
967option <strong>-is</strong>, the default), bold and italic font styles imply high
968intensity foreground/backround colours. Disabling this option (<strong>False</strong>,
969option <strong>+is</strong>) disables this behaviour, the high intensity colours are not
970reachable.
971</dd>
972<p></p>
885<dt><strong><a name="item_selectstyle_3a_mode"><strong>selectstyle:</strong> <em>mode</em></a></strong><br /> 973<dt><strong><a name="item_selectstyle_3a_mode"><strong>selectstyle:</strong> <em>mode</em></a></strong><br />
886</dt> 974</dt>
887<dd> 975<dd>
888Set mouse selection style to <strong>old</strong> which is 2.20, <strong>oldword</strong> which is 976Set mouse selection style to <strong>old</strong> which is 2.20, <strong>oldword</strong> which is
889xterm style with 2.20 old word selection, or anything else which gives 977xterm style with 2.20 old word selection, or anything else which gives
956<dd> 1044<dd>
957<p>Example:</p> 1045<p>Example:</p>
958</dd> 1046</dd>
959<dd> 1047<dd>
960<pre> 1048<pre>
961 URxvt*print-pipe: cat &gt; $(TMPDIR=$HOME mktemp urxvt.XXXXXX)</pre> 1049 URxvt.print-pipe: cat &gt; $(TMPDIR=$HOME mktemp urxvt.XXXXXX)</pre>
962</dd> 1050</dd>
963<dd> 1051<dd>
964<p>This creates a new file in your home directory with the screen contents 1052<p>This creates a new file in your home directory with the screen contents
965everytime you hit <code>Print</code>.</p> 1053everytime you hit <code>Print</code>.</p>
966</dd> 1054</dd>
1044<dd> 1132<dd>
1045Set MWM hints to request a borderless window, i.e. if honoured by the 1133Set MWM hints to request a borderless window, i.e. if honoured by the
1046WM, the rxvt-unicode window will not have window decorations; option <strong>-bl</strong>. 1134WM, the rxvt-unicode window will not have window decorations; option <strong>-bl</strong>.
1047</dd> 1135</dd>
1048<p></p> 1136<p></p>
1137<dt><strong><a name="item_skipbuiltinglyphs_3a_boolean"><strong>skipBuiltinGlyphs:</strong> <em>boolean</em></a></strong><br />
1138</dt>
1139<dd>
1140Compile <em>frills</em>: Disable the usage of the built-in block graphics/line
1141drawing characters and just rely on what the specified fonts provide. Use
1142this if you have a good font and want to use its block graphic glyphs;
1143option <strong>-sbg</strong>.
1144</dd>
1145<p></p>
1049<dt><strong><a name="item_termname_3a_termname"><strong>termName:</strong> <em>termname</em></a></strong><br /> 1146<dt><strong><a name="item_termname_3a_termname"><strong>termName:</strong> <em>termname</em></a></strong><br />
1050</dt> 1147</dt>
1051<dd> 1148<dd>
1052Specifies the terminal type name to be set in the <strong>TERM</strong> environment 1149Specifies the terminal type name to be set in the <strong>TERM</strong> environment
1053variable; option <strong>-tn</strong>. 1150variable; option <strong>-tn</strong>.
1133</dd> 1230</dd>
1134<p></p> 1231<p></p>
1135<dt><strong><a name="item_cutchars_3a_string"><strong>cutchars:</strong> <em>string</em></a></strong><br /> 1232<dt><strong><a name="item_cutchars_3a_string"><strong>cutchars:</strong> <em>string</em></a></strong><br />
1136</dt> 1233</dt>
1137<dd> 1234<dd>
1138The characters used as delimiters for double-click word selection. The 1235The characters used as delimiters for double-click word selection
1139built-in default: 1236(whitespace delimiting is added automatically if resource is given).
1237</dd>
1238<dd>
1239<p>When the selection extension is in use (the default if compiled in, see
1240the <code>rxvtperl(3)</code> manpage), a suitable regex using these characters
1241will be created (if the resource exists, otherwise, no regex will be
1242created). In this mode, characters outside ISO-8859-1 can be used.</p>
1243</dd>
1244<dd>
1245<p>When the selection extension is not used, only ISO-8859-1 characters can
1246be used. If not specified, the built-in default is used:</p>
1140</dd> 1247</dd>
1141<dd> 1248<dd>
1142<p><strong>BACKSLASH ```'&amp;()*,;&lt;=</strong>?@[]{|} &gt;&gt;</p> 1249<p><strong>BACKSLASH ```'&amp;()*,;&lt;=</strong>?@[]{|} &gt;&gt;</p>
1143</dd> 1250</dd>
1144<p></p> 1251<p></p>
1158</dt> 1265</dt>
1159<dd> 1266<dd>
1160The locale to use for opening the IM. You can use an <code>LC_CTYPE</code> of e.g. 1267The locale to use for opening the IM. You can use an <code>LC_CTYPE</code> of e.g.
1161<code>de_DE.UTF-8</code> for normal text processing but <code>ja_JP.EUC-JP</code> for the 1268<code>de_DE.UTF-8</code> for normal text processing but <code>ja_JP.EUC-JP</code> for the
1162input extension to be able to input japanese characters while staying in 1269input extension to be able to input japanese characters while staying in
1163another locale. option <strong>-imlocale</strong>. 1270another locale; option <strong>-imlocale</strong>.
1164</dd> 1271</dd>
1165<p></p> 1272<p></p>
1166<dt><strong><a name="item_imfont_3a_fontset"><strong>imFont:</strong> <em>fontset</em></a></strong><br /> 1273<dt><strong><a name="item_imfont_3a_fontset"><strong>imFont:</strong> <em>fontset</em></a></strong><br />
1167</dt> 1274</dt>
1168<dd> 1275<dd>
1177<dt><strong><a name="item_tripleclickwords_3a_boolean"><strong>tripleclickwords:</strong> <em>boolean</em></a></strong><br /> 1284<dt><strong><a name="item_tripleclickwords_3a_boolean"><strong>tripleclickwords:</strong> <em>boolean</em></a></strong><br />
1178</dt> 1285</dt>
1179<dd> 1286<dd>
1180Change the meaning of triple-click selection with the left mouse 1287Change the meaning of triple-click selection with the left mouse
1181button. Instead of selecting a full line it will extend the selection to 1288button. Instead of selecting a full line it will extend the selection to
1182the end of the logical line only. option <strong>-tcw</strong>. 1289the end of the logical line only; option <strong>-tcw</strong>.
1183</dd> 1290</dd>
1184<p></p> 1291<p></p>
1185<dt><strong><a name="item_insecure_3a_boolean"><strong>insecure:</strong> <em>boolean</em></a></strong><br /> 1292<dt><strong><a name="item_insecure_3a_boolean"><strong>insecure:</strong> <em>boolean</em></a></strong><br />
1186</dt> 1293</dt>
1187<dd> 1294<dd>
1188Enables ``insecure'' mode. Rxvt-unicode offers some escape sequences that 1295Enables ``insecure'' mode. Rxvt-unicode offers some escape sequences that
1189echo arbitrary strings like the icon name or the locale. This could be 1296echo arbitrary strings like the icon name or the locale. This could be
1190abused if somebody gets 8-bit-clean access to your display, whether 1297abused if somebody gets 8-bit-clean access to your display, whether
1191throuh a mail client displaying mail bodies unfiltered or though 1298through a mail client displaying mail bodies unfiltered or through
1192write(1). Therefore, these sequences are disabled by default. (Note 1299<code>write(1)</code> or any other means. Therefore, these sequences are disabled by
1193that other terminals, including xterm, have these sequences 1300default. (Note that many other terminals, including xterm, have these
1194enabled by default). You can enable them by setting this boolean 1301sequences enabled by default, which doesn't make it safer, though).
1195resource or specifying <strong>-insecure</strong> as an option. At the moment, this 1302</dd>
1196enabled display-answer, locale, findfont, icon label and window title 1303<dd>
1197requests as well as dynamic menubar dispatch. 1304<p>You can enable them by setting this boolean resource or specifying
1305<strong>-insecure</strong> as an option. At the moment, this enables display-answer,
1306locale, findfont, icon label and window title requests.</p>
1198</dd> 1307</dd>
1199<p></p> 1308<p></p>
1200<dt><strong><a name="item_modifier_3a_modifier"><strong>modifier:</strong> <em>modifier</em></a></strong><br /> 1309<dt><strong><a name="item_modifier_3a_modifier"><strong>modifier:</strong> <em>modifier</em></a></strong><br />
1201</dt> 1310</dt>
1202<dd> 1311<dd>
1211Specify the reply rxvt-unicode sends to the shell when an ENQ (control-E) 1320Specify the reply rxvt-unicode sends to the shell when an ENQ (control-E)
1212character is passed through. It may contain escape values as described 1321character is passed through. It may contain escape values as described
1213in the entry on <strong>keysym</strong> following. 1322in the entry on <strong>keysym</strong> following.
1214</dd> 1323</dd>
1215<p></p> 1324<p></p>
1216<dt><strong><a name="item_secondaryscreen_3a_bool"><strong>secondaryScreen:</strong> <em>bool</em></a></strong><br /> 1325<dt><strong><a name="item_secondaryscreen_3a_boolean"><strong>secondaryScreen:</strong> <em>boolean</em></a></strong><br />
1217</dt> 1326</dt>
1218<dd> 1327<dd>
1219Turn on/off secondary screen (default enabled). 1328Turn on/off secondary screen (default enabled).
1220</dd> 1329</dd>
1221<p></p> 1330<p></p>
1222<dt><strong><a name="item_secondaryscroll_3a_bool"><strong>secondaryScroll:</strong> <em>bool</em></a></strong><br /> 1331<dt><strong><a name="item_secondaryscroll_3a_boolean"><strong>secondaryScroll:</strong> <em>boolean</em></a></strong><br />
1223</dt> 1332</dt>
1224<dd> 1333<dd>
1225Turn on/off secondary screen scroll (default enabled). If the this 1334Turn on/off secondary screen scroll (default enabled). If the this
1226option is enabled, scrolls on the secondary screen will change the 1335option is enabled, scrolls on the secondary screen will change the
1227scrollback buffer and switching to/from the secondary screen will 1336scrollback buffer and switching to/from the secondary screen will
1228instead scroll the screen up. 1337instead scroll the screen up.
1338</dd>
1339<p></p>
1340<dt><strong><a name="item_hold_3a_boolean"><strong>hold</strong>: <em>boolean</em></a></strong><br />
1341</dt>
1342<dd>
1343Turn on/off hold window after exit support. If enabled, rxvt
1344will not immediately destroy its window when the program executed within
1345it exits. Instead, it will wait till it is being killed or closed by the
1346user.
1229</dd> 1347</dd>
1230<p></p> 1348<p></p>
1231<dt><strong><a name="item_keysym_2esym_3a_string"><strong>keysym.</strong><em>sym</em>: <em>string</em></a></strong><br /> 1349<dt><strong><a name="item_keysym_2esym_3a_string"><strong>keysym.</strong><em>sym</em>: <em>string</em></a></strong><br />
1232</dt> 1350</dt>
1233<dd> 1351<dd>
1260<code>\000</code>: octal number) or verbatim control characters (<code>^?</code>: delete, 1378<code>\000</code>: octal number) or verbatim control characters (<code>^?</code>: delete,
1261<code>^@</code>: null, <code>^A</code> ...) and may be enclosed with double quotes so that it 1379<code>^@</code>: null, <code>^A</code> ...) and may be enclosed with double quotes so that it
1262can start or end with whitespace.</p> 1380can start or end with whitespace.</p>
1263</dd> 1381</dd>
1264<dd> 1382<dd>
1265<p>Please note that you need to double the <code>\</code> when using 1383<p>Please note that you need to double the <code>\</code> in resource files, as
1266<code>--enable-xgetdefault</code>, as X itself does it's own de-escaping (you can 1384Xlib itself does it's own de-escaping (you can use <code>\033</code> instead of
1267use <code>\033</code> instead of <code>\e</code> (and so on), which will work with both Xt and 1385<code>\e</code> (and so on), which will work with both Xt and rxvt's own
1268rxvt's own processing).</p> 1386processing).</p>
1269</dd> 1387</dd>
1270<dd> 1388<dd>
1271<p>You can define a range of keysyms in one shot by providing a <em>string</em> 1389<p>You can define a range of keysyms in one shot by providing a <em>string</em>
1272with pattern <strong>list/PREFIX/MIDDLE/SUFFIX</strong>, where the delimeter `/' 1390with pattern <strong>list/PREFIX/MIDDLE/SUFFIX</strong>, where the delimeter `/'
1273should be a character not used by the strings.</p> 1391should be a character not used by the strings.</p>
1295when Control-Meta-c is being pressed'':</p> 1413when Control-Meta-c is being pressed'':</p>
1296</dd> 1414</dd>
1297<dd> 1415<dd>
1298<pre> 1416<pre>
1299 URxvt.keysym.M-C-c: command:\033]701;zh_CN.GBK\007</pre> 1417 URxvt.keysym.M-C-c: command:\033]701;zh_CN.GBK\007</pre>
1418</dd>
1419<dd>
1420<p>If <em>string</em> takes the form <code>perl:STRING</code>, then the specified <strong>STRING</strong>
1421is passed to the <code>on_keyboard_command</code> perl handler. See the <code>rxvtperl(3)</code>
1422manpage. For example, the <em>selection</em> extension (activated via
1423<code>rxvt -pe selection</code>) listens for <code>selection:rot13</code> events:</p>
1424</dd>
1425<dd>
1426<pre>
1427 URxvt.keysym.M-C-c: perl:selection:rot13</pre>
1300</dd> 1428</dd>
1301<dd> 1429<dd>
1302<p>Due the the large number of modifier combinations, a defined key mapping 1430<p>Due the the large number of modifier combinations, a defined key mapping
1303will match if at <em>at least</em> the specified identifiers are being set, and 1431will match if at <em>at least</em> the specified identifiers are being set, and
1304no other key mappings with those and more bits are being defined. That 1432no other key mappings with those and more bits are being defined. That
1338</dd> 1466</dd>
1339<dd> 1467<dd>
1340<pre> 1468<pre>
1341 URxvt.keysym.M-C-3: command:\033[8;25;80t 1469 URxvt.keysym.M-C-3: command:\033[8;25;80t
1342 URxvt.keysym.M-C-4: command:\033[8;48;110t</pre> 1470 URxvt.keysym.M-C-4: command:\033[8;48;110t</pre>
1471</dd>
1472<p></p>
1473<dt><strong><a name="item_perl_2dext_2dcommon_3a_string"><strong>perl-ext-common</strong>: <em>string</em></a></strong><br />
1474</dt>
1475<dt><strong><a name="item_perl_2dext_3a_string"><strong>perl-ext</strong>: <em>string</em></a></strong><br />
1476</dt>
1477<dd>
1478Comma-separated <code>list(s)</code> of perl extension scripts (default: <code>default</code>) to
1479use in this terminal instance; option <strong>-pe</strong>.
1480</dd>
1481<dd>
1482<p>Extension names can be prefixed with a <code>-</code> sign to prohibit using
1483them. This can be useful to selectively disable some extensions loaded
1484by default, or specified via the <code>perl-ext-common</code> resource. For
1485example, <code>default,-selection</code> will use all the default extension except
1486<code>selection</code>.</p>
1487</dd>
1488<dd>
1489<p>Extension names can also be followed by an argument in angle brackets
1490(e.g. <code>searchable-scrollback&lt;M-s&gt;</code>, which binds the hotkey for
1491searchable scorllback to Alt/Meta-s). Mentioning the same extension
1492multiple times with different arguments will pass multiple arguments to
1493the extension.</p>
1494</dd>
1495<dd>
1496<p>Each extension is looked up in the library directories, loaded if
1497necessary, and bound to the current terminal instance.</p>
1498</dd>
1499<dd>
1500<p>If both of these resources are the empty string, then the perl
1501interpreter will not be initialized. The idea behind two options is that
1502<strong>perl-ext-common</strong> will be used for extensions that should be available to
1503all instances, while <strong>perl-ext</strong> is used for specific instances.</p>
1504</dd>
1505<p></p>
1506<dt><strong><a name="item_perl_2deval_3a_string"><strong>perl-eval</strong>: <em>string</em></a></strong><br />
1507</dt>
1508<dd>
1509Perl code to be evaluated when all extensions have been registered. See
1510the <code>rxvtperl(3)</code> manpage. Due to security reasons, this resource
1511will be ignored when running setuid/setgid.
1512</dd>
1513<p></p>
1514<dt><strong><a name="item_perl_2dlib_3a_path"><strong>perl-lib</strong>: <em>path</em></a></strong><br />
1515</dt>
1516<dd>
1517Colon-separated list of additional directories that hold extension
1518scripts. When looking for extensions specified by the <code>perl</code> resource,
1519rxvt will first look in these directories and then in
1520<em>/opt/rxvt/lib/urxvt/perl/</em>. Due to security reasons, this resource
1521will be ignored when running setuid/setgid.
1522</dd>
1523<dd>
1524<p>See the <code>rxvtperl(3)</code> manpage.</p>
1525</dd>
1526<p></p>
1527<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 />
1528</dt>
1529<dd>
1530Additional selection patterns, see the <code>rxvtperl(3)</code> manpage for
1531details.
1532</dd>
1533<p></p>
1534<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 />
1535</dt>
1536<dd>
1537Selection auto-transform patterns, see the <code>rxvtperl(3)</code> manpage
1538for details.
1539</dd>
1540<p></p>
1541<dt><strong><a name="item_searchable_2dscrollback_3a_keysym"><strong>searchable-scrollback:</strong> <em>keysym</em></a></strong><br />
1542</dt>
1543<dd>
1544Sets the hotkey that starts the incremental scrollback buffer search
1545(default: <code>M-s</code>).
1546</dd>
1547<p></p>
1548<dt><strong><a name="item_urllauncher_3a_string"><strong>urlLauncher</strong>: <em>string</em></a></strong><br />
1549</dt>
1550<dd>
1551Specifies the program to be started with a URL argument. Used by the
1552<code>selection-popup</code> and <code>mark-urls</code> perl extensions.
1553</dd>
1554<p></p>
1555<dt><strong><a name="item_transient_2dfor_3a_windowid"><strong>transient-for</strong>: <em>windowid</em></a></strong><br />
1556</dt>
1557<dd>
1558Compile <em>frills</em>: Sets the WM_TRANSIENT_FOR property to the given window id.
1559</dd>
1560<p></p>
1561<dt><strong><a name="item_override_2dredirect_3a_boolean"><strong>override-redirect</strong>: <em>boolean</em></a></strong><br />
1562</dt>
1563<dd>
1564Compile <em>frills</em>: Sets override-redirect for the terminal window, making
1565it almost invisible to window managers; option <strong>-override-redirect</strong>.
1343</dd> 1566</dd>
1344<p></p></dl> 1567<p></p></dl>
1345<p> 1568<p>
1346</p> 1569</p>
1347<hr /> 1570<hr />
1383(which can span multiple screen lines), unless modified by resource 1606(which can span multiple screen lines), unless modified by resource
1384<strong>tripleclickwords</strong>. 1607<strong>tripleclickwords</strong>.
1385</dd> 1608</dd>
1386<dd> 1609<dd>
1387<p>Starting a selection while pressing the <strong>Meta</strong> key (or <strong>Meta+Ctrl</strong> keys) 1610<p>Starting a selection while pressing the <strong>Meta</strong> key (or <strong>Meta+Ctrl</strong> keys)
1388(Compile: <em>frills</em>) will create a rectangular selection instead of a normal 1611(Compile: <em>frills</em>) will create a rectangular selection instead of a
1389one.</p> 1612normal one. In this mode, every selected row becomes its own line in the
1613selection, and trailing whitespace is visually underlined and removed from
1614the selection.</p>
1390</dd> 1615</dd>
1391<p></p> 1616<p></p>
1392<dt><strong><a name="item_insertion_3a"><strong>Insertion</strong>:</a></strong><br /> 1617<dt><strong><a name="item_insertion_3a"><strong>Insertion</strong>:</a></strong><br />
1393</dt> 1618</dt>
1394<dd> 1619<dd>
1395Pressing and releasing the Middle mouse button (or <strong>Shift-Insert</strong>) in 1620Pressing and releasing the Middle mouse button in an <strong>rxvt</strong>
1396an <strong>rxvt</strong> window causes the current text selection to be 1621window causes the value of the PRIMARY selection (or CLIPBOARD with the
1397inserted as if it had been typed on the keyboard. 1622Meta modifier) to be inserted as if it had been typed on the keyboard.
1623</dd>
1624<dd>
1625<p>Pressing <strong>Shift-Insert</strong> causes the value of the PRIMARY selection to be
1626inserted too.</p>
1398</dd> 1627</dd>
1399<p></p></dl> 1628<p></p></dl>
1400<p> 1629<p>
1401</p> 1630</p>
1402<hr /> 1631<hr />
1403<h1><a name="changing_fonts">CHANGING FONTS</a></h1> 1632<h1><a name="changing_fonts">CHANGING FONTS</a></h1>
1404<p>Changing fonts (or font sizes, respectively) via the keypad is not yet 1633<p>Changing fonts (or font sizes, respectively) via the keypad is not yet
1405supported in rxvt-unicode. Bug me if you need this.</p> 1634supported in rxvt-unicode. Bug me if you need this.</p>
1406<p>You can, however, switch fonts at runtime using escape sequences (and 1635<p>You can, however, switch fonts at runtime using escape sequences, e.g.:</p>
1407therefore using the menubar), e.g.:</p>
1408<pre> 1636<pre>
1409 printf '\e]701;%s\007' &quot;9x15bold,xft:Kochi Gothic&quot;</pre> 1637 printf '\e]710;%s\007' &quot;9x15bold,xft:Kochi Gothic&quot;</pre>
1638<p>You can use keyboard shortcuts, too:</p>
1639<pre>
1640 URxvt.keysym.M-C-1: command:\033]710;suxuseuro\007\033]711;suxuseuro\007
1641 URxvt.keysym.M-C-2: command:\033]710;9x15bold\007\033]711;9x15bold\007</pre>
1410<p>rxvt-unicode will automatically re-apply these fonts to the output so far.</p> 1642<p>rxvt-unicode will automatically re-apply these fonts to the output so far.</p>
1411<p> 1643<p>
1412</p> 1644</p>
1413<hr /> 1645<hr />
1414<h1><a name="iso_14755_support">ISO 14755 SUPPORT</a></h1> 1646<h1><a name="iso_14755_support">ISO 14755 SUPPORT</a></h1>
1478<hr /> 1710<hr />
1479<h1><a name="colors_and_graphics">COLORS AND GRAPHICS</a></h1> 1711<h1><a name="colors_and_graphics">COLORS AND GRAPHICS</a></h1>
1480<p>In addition to the default foreground and background colours, 1712<p>In addition to the default foreground and background colours,
1481<strong>rxvt</strong> can display up to 16 colours (8 ANSI colours plus 1713<strong>rxvt</strong> can display up to 16 colours (8 ANSI colours plus
1482high-intensity bold/blink versions of the same). Here is a list of the 1714high-intensity bold/blink versions of the same). Here is a list of the
1483colours with their <strong>rgb.txt</strong> names.</p> 1715colours with their names.</p>
1484<table> 1716<table>
1485<tr><td>color0</td><td>(black)</td><td>= Black</td></tr> 1717<tr><td>color0</td><td>(black)</td><td>= Black</td></tr>
1486<tr><td>color1</td><td>(red)</td><td>= Red3</td></tr> 1718<tr><td>color1</td><td>(red)</td><td>= Red3</td></tr>
1487<tr><td>color2</td><td>(green)</td><td>= Green3</td></tr> 1719<tr><td>color2</td><td>(green)</td><td>= Green3</td></tr>
1488<tr><td>color3</td><td>(yellow)</td><td>= Yellow3</td></tr> 1720<tr><td>color3</td><td>(yellow)</td><td>= Yellow3</td></tr>
1502<tr><td>background</td><td></td><td>= White</td></tr> 1734<tr><td>background</td><td></td><td>= White</td></tr>
1503</table><p>It is also possible to specify the colour values of <strong>foreground</strong>, 1735</table><p>It is also possible to specify the colour values of <strong>foreground</strong>,
1504<strong>background</strong>, <strong>cursorColor</strong>, <strong>cursorColor2</strong>, <strong>colorBD</strong>, <strong>colorUL</strong> as 1736<strong>background</strong>, <strong>cursorColor</strong>, <strong>cursorColor2</strong>, <strong>colorBD</strong>, <strong>colorUL</strong> as
1505a number 0-15, as a convenient shorthand to reference the colour name of 1737a number 0-15, as a convenient shorthand to reference the colour name of
1506color0-color15.</p> 1738color0-color15.</p>
1739<p>If Xft support has been compiled in and as long as Xft/Xrender/X don't get
1740their act together, rxvt-unicode will support <code>rgba:rrrr/gggg/bbbb/aaaa</code>
1741(recommended, but <strong>MUST</strong> have 4 digits/component), <code>#ARGB</code>, <code>#AARRGGBB</code>
1742and <code>#AAAARRRRGGGGBBBB</code> colour specifications, in addition to the ones
1743provided by X, where the additional A component specifies alpha (opacity)
1744values (0 is completely transparent and the maximum is opaque). You
1745probably need to specify <strong>``-depth 32''</strong>, too, and have the luck that your
1746X-server uses ARGB pixel layout, as X is far from just supporting ARGB
1747visuals out of the box, and rxvt-unicode just fudges around.</p>
1748<p><em>Please note that transparency of any kind if completely unsupported by
1749the author. Don't bug him with installation questions!</em></p>
1507<p>Note that <strong>-rv</strong> (<strong>``reverseVideo: True''</strong>) simulates reverse video by 1750<p>Note that <strong>-rv</strong> (<strong>``reverseVideo: True''</strong>) simulates reverse video by
1508always swapping the foreground/background colours. This is in contrast to 1751always swapping the foreground/background colours. This is in contrast to
1509<em>xterm</em>(1) where the colours are only swapped if they have not otherwise 1752<em>xterm</em>(1) where the colours are only swapped if they have not otherwise
1510been specified. For example,</p> 1753been specified. For example,</p>
1511<dl> 1754<dl>
1573<p></p> 1816<p></p>
1574<dt><strong><a name="item_shell"><strong>SHELL</strong></a></strong><br /> 1817<dt><strong><a name="item_shell"><strong>SHELL</strong></a></strong><br />
1575</dt> 1818</dt>
1576<dd> 1819<dd>
1577The shell to be used for command execution, defaults to <code>/bin/sh</code>. 1820The shell to be used for command execution, defaults to <code>/bin/sh</code>.
1578</dd>
1579<p></p>
1580<dt><strong><a name="item_rxvtpath"><strong>RXVTPATH</strong></a></strong><br />
1581</dt>
1582<dd>
1583The path where rxvt looks for support files such as menu and xpm
1584files.
1585</dd>
1586<p></p>
1587<dt><strong><a name="item_path"><strong>PATH</strong></a></strong><br />
1588</dt>
1589<dd>
1590Used in the same way as <a href="#item_rxvtpath"><code>RXVTPATH</code></a>.
1591</dd> 1821</dd>
1592<p></p> 1822<p></p>
1593<dt><strong><a name="item_rxvt_socket"><strong>RXVT_SOCKET</strong></a></strong><br /> 1823<dt><strong><a name="item_rxvt_socket"><strong>RXVT_SOCKET</strong></a></strong><br />
1594</dt> 1824</dt>
1595<dd> 1825<dd>
1638<h1><a name="see_also">SEE ALSO</a></h1> 1868<h1><a name="see_also">SEE ALSO</a></h1>
1639<p>rxvt(7), rxvtc(1), rxvtd(1), xterm(1), sh(1), resize(1), X(1), pty(4), tty(4), <code>utmp(5)</code></p> 1869<p>rxvt(7), rxvtc(1), rxvtd(1), xterm(1), sh(1), resize(1), X(1), pty(4), tty(4), <code>utmp(5)</code></p>
1640<p> 1870<p>
1641</p> 1871</p>
1642<hr /> 1872<hr />
1643<h1><a name="bugs">BUGS</a></h1>
1644<p>Check the BUGS file for an up-to-date list.</p>
1645<p>Cursor change support is not yet implemented.</p>
1646<p>Click-and-drag doesn't work with X11 mouse report overriding.</p>
1647<p>
1648</p>
1649<hr />
1650<h1><a name="current_project_coordinator">CURRENT PROJECT COORDINATOR</a></h1> 1873<h1><a name="current_project_coordinator">CURRENT PROJECT COORDINATOR</a></h1>
1651<dl> 1874<dl>
1652<dt><strong><a name="item_project_coordinator">Project Coordinator</a></strong><br /> 1875<dt><strong><a name="item_project_coordinator">Project Coordinator</a></strong><br />
1653</dt> 1876</dt>
1654<dd> 1877<dd>
1697</dd> 1920</dd>
1698<p></p> 1921<p></p>
1699<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 /> 1922<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 />
1700</dt> 1923</dt>
1701<dd> 1924<dd>
1702Rewrote screen display and text selection routines. Project Coordinator 1925Rewrote screen display and text selection routines.
1703(changes.txt 2.4.6 - rxvt-unicode) 1926
1927</dd>
1928<dd>
1929<pre>
1930
1931Project Coordinator (changes.txt 2.4.6 - rxvt-unicode)</pre>
1704</dd> 1932</dd>
1705<p></p> 1933<p></p>
1706<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 /> 1934<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 />
1707</dt> 1935</dt>
1708<dd> 1936<dd>
1709Forked rxvt-unicode, rewrote most of the display code and internal 1937Forked rxvt-unicode, unicode support, rewrote almost all the code, perl
1710character handling to store text in unicode, improve xterm 1938extension, random hacks, numerous bugfixes and extensions.
1711compatibility and apply numerous other bugfixes and extensions.
1712</dd> 1939</dd>
1713<dd> 1940<dd>
1714<p>Project Coordinator (Changes 1.0 -)</p> 1941<p>Project Coordinator (Changes 1.0 -)</p>
1942</dd>
1943<p></p>
1944<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 />
1945</dt>
1946<dd>
1947Pty/tty/utmp/wtmp rewrite, lots of random hacking and bugfixing.
1715</dd> 1948</dd>
1716<p></p></dl> 1949<p></p></dl>
1717 1950
1718</body> 1951</body>
1719 1952

Diff Legend

Removed lines
+ Added lines
< Changed lines
> Changed lines