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.70 by root, Sat Oct 27 12:09:02 2007 UTC vs.
Revision 1.72 by root, Fri Nov 23 13:11:31 2007 UTC

… …
4<head> 4<head>
5 <title>rxvt-unicode (ouR XVT, unicode)</title> 5 <title>rxvt-unicode (ouR XVT, unicode)</title>
6 <meta name="description" content="Pod documentation for rxvt-unicode (ouR XVT, unicode)" /> 6 <meta name="description" content="Pod documentation for rxvt-unicode (ouR XVT, unicode)" />
7 <meta name="inputfile" content="&lt;standard input&gt;" /> 7 <meta name="inputfile" content="&lt;standard input&gt;" />
8 <meta name="outputfile" content="&lt;standard output&gt;" /> 8 <meta name="outputfile" content="&lt;standard output&gt;" />
9 <meta name="created" content="Sat Oct 27 14:07:34 2007" /> 9 <meta name="created" content="Fri Nov 23 12:34:59 2007" />
10 <meta name="generator" content="Pod::Xhtml 1.57" /> 10 <meta name="generator" content="Pod::Xhtml 1.57" />
11<link rel="stylesheet" href="http://res.tst.eu/pod.css"/></head> 11<link rel="stylesheet" href="http://res.tst.eu/pod.css"/></head>
12<body> 12<body>
13<div class="pod"> 13<div class="pod">
14<!-- INDEX START --> 14<!-- INDEX START -->
… …
45<p>rxvt-unicode (ouR XVT, unicode) - (a VT102 emulator for the X window system)</p> 45<p>rxvt-unicode (ouR XVT, unicode) - (a VT102 emulator for the X window system)</p>
46 46
47</div> 47</div>
48<h1 id="SYNOPSIS">SYNOPSIS</h1><p><a href="#TOP" class="toplink">Top</a></p> 48<h1 id="SYNOPSIS">SYNOPSIS</h1><p><a href="#TOP" class="toplink">Top</a></p>
49<div id="SYNOPSIS_CONTENT"> 49<div id="SYNOPSIS_CONTENT">
50<p><strong>urxvt</strong> [options] [-e command [ args ]]</p> 50<p><strong>rxvt</strong> [options] [-e command [ args ]]</p>
51 51
52</div> 52</div>
53<h1 id="DESCRIPTION">DESCRIPTION</h1><p><a href="#TOP" class="toplink">Top</a></p> 53<h1 id="DESCRIPTION">DESCRIPTION</h1><p><a href="#TOP" class="toplink">Top</a></p>
54<div id="DESCRIPTION_CONTENT"> 54<div id="DESCRIPTION_CONTENT">
55<p><strong>rxvt-unicode</strong>, version <strong>8.4</strong>, is a colour vt102 terminal 55<p><strong>rxvt-unicode</strong>, version <strong>8.6</strong>, is a colour vt102 terminal
56emulator intended as an <i>xterm</i>(1) replacement for users who do not 56emulator intended as an <i>xterm</i>(1) replacement for users who do not
57require features such as Tektronix 4014 emulation and toolkit-style 57require features such as Tektronix 4014 emulation and toolkit-style
58configurability. As a result, <strong>rxvt-unicode</strong> uses much less swap space -- 58configurability. As a result, <strong>rxvt-unicode</strong> uses much less swap space --
59a significant advantage on a machine serving many X sessions.</p> 59a significant advantage on a machine serving many X sessions.</p>
60 60
61</div> 61</div>
62<h1 id="FREQUENTLY_ASKED_QUESTIONS">FREQUENTLY ASKED QUESTIONS</h1><p><a href="#TOP" class="toplink">Top</a></p> 62<h1 id="FREQUENTLY_ASKED_QUESTIONS">FREQUENTLY ASKED QUESTIONS</h1><p><a href="#TOP" class="toplink">Top</a></p>
63<div id="FREQUENTLY_ASKED_QUESTIONS_CONTENT"> 63<div id="FREQUENTLY_ASKED_QUESTIONS_CONTENT">
64<p>See urxvt(7) (try <code>man 7 urxvt</code>) for a list of 64<p>See rxvt(7) (try <code>man 7 rxvt</code>) for a list of
65frequently asked questions and answer to them and some common 65frequently asked questions and answer to them and some common
66problems. That document is also accessible on the World-Wide-Web at 66problems. That document is also accessible on the World-Wide-Web at
67<a href="http://cvs.schmorp.de/browse/rxvt-unicode/doc/rxvt.7.html">http://cvs.schmorp.de/browse/rxvt-unicode/doc/rxvt.7.html</a>.</p> 67<a href="http://cvs.schmorp.de/browse/rxvt-unicode/doc/rxvt.7.html">http://cvs.schmorp.de/browse/rxvt-unicode/doc/rxvt.7.html</a>.</p>
68 68
69</div> 69</div>
… …
97<p>It is still faithfully following the original rxvt idea of being lean 97<p>It is still faithfully following the original rxvt idea of being lean
98and nice on resources: for example, you can still configure rxvt-unicode 98and nice on resources: for example, you can still configure rxvt-unicode
99without most of its features to get a lean binary. It also comes with 99without most of its features to get a lean binary. It also comes with
100a client/daemon pair that lets you open any number of terminal windows 100a client/daemon pair that lets you open any number of terminal windows
101from within a single process, which makes startup time very fast and 101from within a single process, which makes startup time very fast and
102drastically reduces memory usage. See urxvtd(1) (daemon) and 102drastically reduces memory usage. See rxvtd(1) (daemon) and
103urxvtc(1) (client).</p> 103rxvtc(1) (client).</p>
104<p>It also makes technical information about escape sequences (which have 104<p>It also makes technical information about escape sequences (which have
105been extended) more accessible: see urxvt(7) for technical 105been extended) more accessible: see rxvt(7) for technical
106reference documentation (escape sequences etc.).</p> 106reference documentation (escape sequences etc.).</p>
107 107
108</div> 108</div>
109<h1 id="OPTIONS">OPTIONS</h1><p><a href="#TOP" class="toplink">Top</a></p> 109<h1 id="OPTIONS">OPTIONS</h1><p><a href="#TOP" class="toplink">Top</a></p>
110<div id="OPTIONS_CONTENT"> 110<div id="OPTIONS_CONTENT">
111<p>The <strong>urxvt</strong> options (mostly a subset of <i>xterm</i>'s) are listed 111<p>The <strong>rxvt</strong> options (mostly a subset of <i>xterm</i>'s) are listed
112below. In keeping with the smaller-is-better philosophy, options may be 112below. In keeping with the smaller-is-better philosophy, options may be
113eliminated or default values chosen at compile-time, so options and 113eliminated or default values chosen at compile-time, so options and
114defaults listed may not accurately reflect the version installed on 114defaults listed may not accurately reflect the version installed on
115your system. `urxvt -h' gives a list of major compile-time options on 115your system. `rxvt -h' gives a list of major compile-time options on
116the <i>Options</i> line. Option descriptions may be prefixed with which 116the <i>Options</i> line. Option descriptions may be prefixed with which
117compile option each is dependent upon. e.g. `Compile <i>XIM</i>:' requires 117compile option each is dependent upon. e.g. `Compile <i>XIM</i>:' requires
118<i>XIM</i> on the <i>Options</i> line. Note: `urxvt -help' gives a list of all 118<i>XIM</i> on the <i>Options</i> line. Note: `rxvt -help' gives a list of all
119command-line options compiled into your version.</p> 119command-line options compiled into your version.</p>
120<p>Note that <strong>urxvt</strong> permits the resource name to be used as a 120<p>Note that <strong>rxvt</strong> permits the resource name to be used as a
121long-option (--/++ option) so the potential command-line options are 121long-option (--/++ option) so the potential command-line options are
122far greater than those listed. For example: `urxvt --loginShell --color1 122far greater than those listed. For example: `rxvt --loginShell --color1
123Orange'.</p> 123Orange'.</p>
124<p>The following options are available:</p> 124<p>The following options are available:</p>
125<dl> 125<dl>
126 <dt><strong>-help</strong>, <strong>--help</strong></dt> 126 <dt><strong>-help</strong>, <strong>--help</strong></dt>
127 <dd> 127 <dd>
… …
156 </dd> 156 </dd>
157 <dt><strong>-tr</strong>|<strong>+tr</strong></dt> 157 <dt><strong>-tr</strong>|<strong>+tr</strong></dt>
158 <dd> 158 <dd>
159 <p>Turn on/off illusion of a transparent window background. Obsolete form of it is 159 <p>Turn on/off illusion of a transparent window background. Obsolete form of it is
160<strong>-ip</strong> and it should not be used anymore; resource <strong>transparent</strong>.</p> 160<strong>-ip</strong> and it should not be used anymore; resource <strong>transparent</strong>.</p>
161 <p><i>Please note that old resource name of <strong>inheritPixmap</strong> is obsolete and should be 161 <p><i>Please note that old resource name of <strong>inheritPixmap</strong> is obsolete and should be
162changed to <strong>transparent</strong>. Backwards compatibility support for <strong>inheritPixmap</strong> will 162changed to <strong>transparent</strong>. Backwards compatibility support for <strong>inheritPixmap</strong> will
163be phased out in future versions of rxvt!</i></p> 163be phased out in future versions of rxvt!</i></p>
164 <p><i>Please address all transparency related issues to Sasha Vasko at 164 <p><i>Please address all transparency related issues to Sasha Vasko at
165sasha@aftercode.net. Read the FAQ (man 7 urxvt)!</i></p> 165sasha@aftercode.net. Read the FAQ (man 7 rxvt)!</i></p>
166 </dd> 166 </dd>
167 <dt><strong>-fade</strong> <i>number</i></dt> 167 <dt><strong>-fade</strong> <i>number</i></dt>
168 <dd> 168 <dd>
169 <p>Fade the text by the given percentage when focus is lost. Small values 169 <p>Fade the text by the given percentage when focus is lost. Small values
170fade a little only, 100 completely replaces all colours by the fade 170fade a little only, 100 completely replaces all colours by the fade
… …
181transparency is enabled with <strong>-tr</strong>. This only works for 181transparency is enabled with <strong>-tr</strong>. This only works for
182non-tiled backgrounds, currently. See also the <strong>-sh</strong> option that can be 182non-tiled backgrounds, currently. See also the <strong>-sh</strong> option that can be
183used to brighten or darken the image in addition to tinting it. 183used to brighten or darken the image in addition to tinting it.
184Please note that certain tint colours can be applied on the server-side, 184Please note that certain tint colours can be applied on the server-side,
185thus yielding performance gain of two orders of magnitude. These colours are: 185thus yielding performance gain of two orders of magnitude. These colours are:
186blue, red, green, cyan, magenta, yellow, and those close to them; resource 186blue, red, green, cyan, magenta, yellow, and those close to them. Also
187pure black and pure white colors essentially mean no tinting; resource
187<i>tintColor</i>. Example:</p> 188<i>tintColor</i>. Example:</p>
188<pre> urxvt -tr -tint blue -sh 40 189<pre> rxvt -tr -tint blue -sh 40
189 190
190</pre> 191</pre>
191 </dd> 192 </dd>
192 <dt><strong>-sh</strong> <i>number</i></dt> 193 <dt><strong>-sh</strong> <i>number</i></dt>
193 <dd> 194 <dd>
194 <p>Darken (0 .. 100) or lighten (-1 .. -100) the transparent 195 <p>Darken (0 .. 100) or lighten (100 .. 200) the transparent
195background image in addition to (or instead of) tinting it; 196background image in addition to (or instead of) tinting it;
196resource <i>shading</i>.</p> 197resource <i>shading</i>.</p>
197 </dd> 198 </dd>
198 <dt><strong>-blt</strong> <i>string</i></dt> 199 <dt><strong>-blt</strong> <i>string</i></dt>
199 <dd> 200 <dd>
… …
220 </dd> 221 </dd>
221 <dt><strong>-fg</strong> <i>colour</i></dt> 222 <dt><strong>-fg</strong> <i>colour</i></dt>
222 <dd> 223 <dd>
223 <p>Window foreground colour; resource <strong>foreground</strong>.</p> 224 <p>Window foreground colour; resource <strong>foreground</strong>.</p>
224 </dd> 225 </dd>
225 <dt><strong>-pixmap</strong> <i>file[;geom]</i></dt> 226 <dt><strong>-pixmap</strong> <i>file[;geom[:op1][:op2][...]]</i></dt>
226 <dd> 227 <dd>
227 <p>Compile <i>afterimage</i>: Specify image file for the background and also 228 <p>Compile <i>afterimage</i>: Specify image file for the background and also
228optionally specify its scaling with a geometry string. Note you may need to 229optionally specify its scaling with a geometry string. Note you may need to
229add quotes to avoid special shell interpretation of the <code>;</code> in the 230add quotes to avoid special shell interpretation of the <code>;</code> in the
230command-line; for more details see resource <strong>backgroundPixmap</strong>.</p> 231command-line; for more details see resource <strong>backgroundPixmap</strong>.</p>
231 </dd> 232 </dd>
232 <dt><strong>-cr</strong> <i>colour</i></dt> 233 <dt><strong>-cr</strong> <i>colour</i></dt>
… …
254smaller, but not (in general) larger. A (hopefully) reasonable default 255smaller, but not (in general) larger. A (hopefully) reasonable default
255font list is always appended to it. See resource <strong>font</strong> for more details.</p> 256font list is always appended to it. See resource <strong>font</strong> for more details.</p>
256 <p>In short, to specify an X11 core font, just specify its name or prefix it 257 <p>In short, to specify an X11 core font, just specify its name or prefix it
257with <code>x:</code>. To specify an XFT-font, you need to prefix it with <code>xft:</code>, 258with <code>x:</code>. To specify an XFT-font, you need to prefix it with <code>xft:</code>,
258e.g.:</p> 259e.g.:</p>
259<pre> urxvt -fn &quot;xft:Bitstream Vera Sans Mono:pixelsize=15&quot; 260<pre> rxvt -fn &quot;xft:Bitstream Vera Sans Mono:pixelsize=15&quot;
260 urxvt -fn &quot;9x15bold,xft:Bitstream Vera Sans Mono&quot; 261 rxvt -fn &quot;9x15bold,xft:Bitstream Vera Sans Mono&quot;
261 262
262</pre> 263</pre>
263 <p>See also the question &quot;How does rxvt-unicode choose fonts?&quot; in the FAQ 264 <p>See also the question &quot;How does rxvt-unicode choose fonts?&quot; in the FAQ
264section of urxvt(7).</p> 265section of rxvt(7).</p>
265 </dd> 266 </dd>
266 <dt><strong>-fb</strong> <i>fontlist</i></dt> 267 <dt><strong>-fb</strong> <i>fontlist</i></dt>
267 <dd> 268 <dd>
268 <p>Compile <i>font-styles</i>: The bold font list to use when <strong>bold</strong> characters 269 <p>Compile <i>font-styles</i>: The bold font list to use when <strong>bold</strong> characters
269are to be printed. See resource <strong>boldFont</strong> for details.</p> 270are to be printed. See resource <strong>boldFont</strong> for details.</p>
… …
398<i>termcap(5)</i> database and should have <i>li#</i> and <i>co#</i> entries; 399<i>termcap(5)</i> database and should have <i>li#</i> and <i>co#</i> entries;
399resource <strong>termName</strong>.</p> 400resource <strong>termName</strong>.</p>
400 </dd> 401 </dd>
401 <dt><strong>-e</strong> <i>command [arguments]</i></dt> 402 <dt><strong>-e</strong> <i>command [arguments]</i></dt>
402 <dd> 403 <dd>
403 <p>Run the command with its command-line arguments in the <strong>urxvt</strong> 404 <p>Run the command with its command-line arguments in the <strong>rxvt</strong>
404window; also sets the window title and icon name to be the basename of 405window; also sets the window title and icon name to be the basename of
405the program being executed if neither <i>-title</i> (<i>-T</i>) nor <i>-n</i> are 406the program being executed if neither <i>-title</i> (<i>-T</i>) nor <i>-n</i> are
406given on the command line. If this option is used, it must be the last 407given on the command line. If this option is used, it must be the last
407on the command-line. If there is no <strong>-e</strong> option then the default is to 408on the command-line. If there is no <strong>-e</strong> option then the default is to
408run the program specified by the <strong>SHELL</strong> environment variable or, 409run the program specified by the <strong>SHELL</strong> environment variable or,
409failing that, <i>sh(1)</i>.</p> 410failing that, <i>sh(1)</i>.</p>
410 <p>Please note that you must specify a program with arguments. If you want to 411 <p>Please note that you must specify a program with arguments. If you want to
411run shell commands, you have to specify the shell, like this:</p> 412run shell commands, you have to specify the shell, like this:</p>
412<pre> urxvt -e sh -c &quot;shell commands&quot; 413<pre> rxvt -e sh -c &quot;shell commands&quot;
413 414
414</pre> 415</pre>
415 </dd> 416 </dd>
416 <dt><strong>-title</strong> <i>text</i></dt> 417 <dt><strong>-title</strong> <i>text</i></dt>
417 <dd> 418 <dd>
… …
479 <p>Turn on/off secondary screen scroll (default enabled); resource 480 <p>Turn on/off secondary screen scroll (default enabled); resource
480<strong>secondaryScroll</strong>.</p> 481<strong>secondaryScroll</strong>.</p>
481 </dd> 482 </dd>
482 <dt><strong>-hold</strong>|<strong>+hold</strong></dt> 483 <dt><strong>-hold</strong>|<strong>+hold</strong></dt>
483 <dd> 484 <dd>
484 <p>Turn on/off hold window after exit support. If enabled, urxvt 485 <p>Turn on/off hold window after exit support. If enabled, rxvt
485will not immediately destroy its window when the program executed within 486will not immediately destroy its window when the program executed within
486it exits. Instead, it will wait till it is being killed or closed by the 487it exits. Instead, it will wait till it is being killed or closed by the
487user; resource <strong>hold</strong>.</p> 488user; resource <strong>hold</strong>.</p>
488 </dd> 489 </dd>
490 <dt><strong>-xrm</strong> <i>string</i></dt>
491 <dd>
492 <p>Works like the X Toolkit option of the same name, by adding the <i>string</i>
493as if it were specified in a resource file. Resource values specified this
494way take precedence over all other resource specifications.</p>
495 <p>Note that you need to use the <i>same</i> syntax as in the .Xdefaults file,
496e.g. <code>*.background: black</code>. Also note that all rxvt-specific
497options can be specified as long-options on the commandline, so use
498of <strong>-xrm</strong> is mostly limited to cases where you want to specify other
499resources (e.g. for input methods) or for compatibility with other
500programs.</p>
501 </dd>
489 <dt><strong>-keysym.</strong><i>sym</i> <i>string</i></dt> 502 <dt><strong>-keysym.</strong><i>sym</i> <i>string</i></dt>
490 <dd> 503 <dd>
491 <p>Remap a key symbol. See resource <strong>keysym</strong>.</p> 504 <p>Remap a key symbol. See resource <strong>keysym</strong>.</p>
492 </dd> 505 </dd>
493 <dt><strong>-embed</strong> <i>windowid</i></dt> 506 <dt><strong>-embed</strong> <i>windowid</i></dt>
494 <dd> 507 <dd>
495 <p>Tells urxvt to embed its windows into an already-existing window, 508 <p>Tells rxvt to embed its windows into an already-existing window,
496which enables applications to easily embed a terminal.</p> 509which enables applications to easily embed a terminal.</p>
497 <p>Right now, urxvt will first unmap/map the specified window, so it 510 <p>Right now, rxvt will first unmap/map the specified window, so it
498shouldn't be a top-level window. urxvt will also reconfigure it 511shouldn't be a top-level window. rxvt will also reconfigure it
499quite a bit, so don't expect it to keep some specific state. It's best to 512quite a bit, so don't expect it to keep some specific state. It's best to
500create an extra subwindow for urxvt and leave it alone.</p> 513create an extra subwindow for rxvt and leave it alone.</p>
501 <p>The window will not be destroyed when urxvt exits.</p> 514 <p>The window will not be destroyed when rxvt exits.</p>
502 <p>It might be useful to know that urxvt will not close file 515 <p>It might be useful to know that rxvt will not close file
503descriptors passed to it (except for stdin/out/err, of course), so you 516descriptors passed to it (except for stdin/out/err, of course), so you
504can use file descriptors to communicate with the programs within the 517can use file descriptors to communicate with the programs within the
505terminal. This works regardless of whether the <code>-embed</code> option was used or 518terminal. This works regardless of whether the <code>-embed</code> option was used or
506not.</p> 519not.</p>
507 <p>Here is a short Gtk2-perl snippet that illustrates how this option can be 520 <p>Here is a short Gtk2-perl snippet that illustrates how this option can be
508used (a longer example is in <cite>doc/embed</cite>):</p> 521used (a longer example is in <cite>doc/embed</cite>):</p>
509<pre> my $rxvt = new Gtk2::Socket; 522<pre> my $rxvt = new Gtk2::Socket;
510 $rxvt-&gt;signal_connect_after (realize =&gt; sub { 523 $rxvt-&gt;signal_connect_after (realize =&gt; sub {
511 my $xid = $_[0]-&gt;window-&gt;get_xid; 524 my $xid = $_[0]-&gt;window-&gt;get_xid;
512 system &quot;urxvt -embed $xid &amp;&quot;; 525 system &quot;rxvt -embed $xid &amp;&quot;;
513 }); 526 });
514 527
515</pre> 528</pre>
516 </dd> 529 </dd>
517 <dt><strong>-pty-fd</strong> <i>file descriptor</i></dt> 530 <dt><strong>-pty-fd</strong> <i>file descriptor</i></dt>
518 <dd> 531 <dd>
519 <p>Tells urxvt NOT to execute any commands or create a new pty/tty 532 <p>Tells rxvt NOT to execute any commands or create a new pty/tty
520pair but instead use the given file descriptor as the tty master. This is 533pair but instead use the given file descriptor as the tty master. This is
521useful if you want to drive urxvt as a generic terminal emulator 534useful if you want to drive rxvt as a generic terminal emulator
522without having to run a program within it.</p> 535without having to run a program within it.</p>
523 <p>If this switch is given, urxvt will not create any utmp/wtmp 536 <p>If this switch is given, rxvt will not create any utmp/wtmp
524entries and will not tinker with pty/tty permissions - you have to do that 537entries and will not tinker with pty/tty permissions - you have to do that
525yourself if you want that.</p> 538yourself if you want that.</p>
526 <p>As an extremely special case, specifying <code>-1</code> will completely suppress 539 <p>As an extremely special case, specifying <code>-1</code> will completely suppress
527pty/tty operations.</p> 540pty/tty operations.</p>
528 <p>Here is a example in perl that illustrates how this option can be used (a 541 <p>Here is a example in perl that illustrates how this option can be used (a
… …
530<pre> use IO::Pty; 543<pre> use IO::Pty;
531 use Fcntl; 544 use Fcntl;
532 545
533 my $pty = new IO::Pty; 546 my $pty = new IO::Pty;
534 fcntl $pty, F_SETFD, 0; # clear close-on-exec 547 fcntl $pty, F_SETFD, 0; # clear close-on-exec
535 system &quot;urxvt -pty-fd &quot; . (fileno $pty) . &quot;&amp;&quot;; 548 system &quot;rxvt -pty-fd &quot; . (fileno $pty) . &quot;&amp;&quot;;
536 close $pty; 549 close $pty;
537 550
538 # now communicate with rxvt 551 # now communicate with rxvt
539 my $slave = $pty-&gt;slave; 552 my $slave = $pty-&gt;slave;
540 while (&lt;$slave&gt;) { print $slave &quot;got &lt;$_&gt;\n&quot; } 553 while (&lt;$slave&gt;) { print $slave &quot;got &lt;$_&gt;\n&quot; }
… …
549</dl> 562</dl>
550 563
551</div> 564</div>
552<h1 id="RESOURCES_available_also_as_long_opt">RESOURCES (available also as long-options)</h1><p><a href="#TOP" class="toplink">Top</a></p> 565<h1 id="RESOURCES_available_also_as_long_opt">RESOURCES (available also as long-options)</h1><p><a href="#TOP" class="toplink">Top</a></p>
553<div id="RESOURCES_available_also_as_long_opt-2"> 566<div id="RESOURCES_available_also_as_long_opt-2">
554<p>Note: `urxvt --help' gives a list of all resources (long 567<p>Note: `rxvt --help' gives a list of all resources (long
555options) compiled into your version.</p> 568options) compiled into your version.</p>
556<p>You can set and change the resources using X11 tools like <strong>xrdb</strong>. Many 569<p>You can set and change the resources using X11 tools like <strong>xrdb</strong>. Many
557distribution do also load settings from the <strong>~/.Xresources</strong> file when X 570distribution do also load settings from the <strong>~/.Xresources</strong> file when X
558starts. urxvt will consult the following files/resources in order, 571starts. rxvt will consult the following files/resources in order,
559with later settings overwriting earlier ones:</p> 572with later settings overwriting earlier ones:</p>
560<pre> 1. system-wide app-defaults file, either locale-dependent OR global 573<pre> 1. system-wide app-defaults file, either locale-dependent OR global
561 2. app-defaults file in $XAPPLRESDIR 574 2. app-defaults file in $XAPPLRESDIR
562 3. RESOURCE_MANAGER property on root-window OR $HOME/.Xdefaults 575 3. RESOURCE_MANAGER property on root-window OR $HOME/.Xdefaults
563 4. SCREEN_RESOURCES for the current screen 576 4. SCREEN_RESOURCES for the current screen
564 5. $XENVIRONMENT file OR $HOME/.Xdefaults-&lt;nodename&gt; 577 5. $XENVIRONMENT file OR $HOME/.Xdefaults-&lt;nodename&gt;
578 6. resources specified via -xrm on the commandline
565 579
566</pre> 580</pre>
567<p>Note that when reading X resources, <strong>urxvt</strong> recognizes two class 581<p>Note that when reading X resources, <strong>rxvt</strong> recognizes two class
568names: <strong>Rxvt</strong> and <strong>URxvt</strong>. The class name <strong>Rxvt</strong> allows resources 582names: <strong>Rxvt</strong> and <strong>URxvt</strong>. The class name <strong>Rxvt</strong> allows resources
569common to both <strong>urxvt</strong> and the original <i>rxvt</i> to be easily 583common to both <strong>rxvt</strong> and the original <i>rxvt</i> to be easily
570configured, while the class name <strong>URxvt</strong> allows resources unique to 584configured, while the class name <strong>URxvt</strong> allows resources unique to
571<strong>urxvt</strong>, to be shared between different <strong>urxvt</strong> 585<strong>rxvt</strong>, to be shared between different <strong>rxvt</strong>
572configurations. If no resources are specified, suitable defaults will 586configurations. If no resources are specified, suitable defaults will
573be used. Command-line arguments can be used to override resource 587be used. Command-line arguments can be used to override resource
574settings. The following resources are supported (you might want to 588settings. The following resources are supported (you might want to
575check the urxvtperl(3) manpage for additional settings by perl 589check the rxvtperl(3) manpage for additional settings by perl
576extensions not documented here):</p> 590extensions not documented here):</p>
577<dl> 591<dl>
578 <dt><strong>depth:</strong> <i>bitdepth</i></dt> 592 <dt><strong>depth:</strong> <i>bitdepth</i></dt>
579 <dd> 593 <dd>
580 <p>Compile <i>xft</i>: Attempt to find a visual with the given bit depth; 594 <p>Compile <i>xft</i>: Attempt to find a visual with the given bit depth;
… …
602high-intensity (bold = bright foreground, blink = bright background) 616high-intensity (bold = bright foreground, blink = bright background)
603colours. The canonical names are as follows: 0=black, 1=red, 2=green, 617colours. The canonical names are as follows: 0=black, 1=red, 2=green,
6043=yellow, 4=blue, 5=magenta, 6=cyan, 7=white, but the actual colour 6183=yellow, 4=blue, 5=magenta, 6=cyan, 7=white, but the actual colour
605names used are listed in the <strong>COLORS AND GRAPHICS</strong> section.</p> 619names used are listed in the <strong>COLORS AND GRAPHICS</strong> section.</p>
606 <p>Colours higher than 15 cannot be set using resources (yet), but can be 620 <p>Colours higher than 15 cannot be set using resources (yet), but can be
607changed using an escape command (see urxvt(7)).</p> 621changed using an escape command (see rxvt(7)).</p>
608 <p>Colours 16-79 form a standard 4x4x4 colour cube (the same as xterm with 622 <p>Colours 16-79 form a standard 4x4x4 colour cube (the same as xterm with
60988 colour support). Colours 80-87 are evenly spaces grey steps.</p> 62388 colour support). Colours 80-87 are evenly spaces grey steps.</p>
610 </dd> 624 </dd>
611 <dt><strong>colorBD:</strong> <i>colour</i></dt> 625 <dt><strong>colorBD:</strong> <i>colour</i></dt>
612 <dt><strong>colorIT:</strong> <i>colour</i></dt> 626 <dt><strong>colorIT:</strong> <i>colour</i></dt>
… …
648<strong>+rv</strong>. See note in <strong>COLORS AND GRAPHICS</strong> section.</p> 662<strong>+rv</strong>. See note in <strong>COLORS AND GRAPHICS</strong> section.</p>
649 </dd> 663 </dd>
650 <dt><strong>jumpScroll:</strong> <i>boolean</i></dt> 664 <dt><strong>jumpScroll:</strong> <i>boolean</i></dt>
651 <dd> 665 <dd>
652 <p><strong>True</strong>: specify that jump scrolling should be used. When receiving lots 666 <p><strong>True</strong>: specify that jump scrolling should be used. When receiving lots
653of lines, urxvt will only scroll once a whole screen height of lines 667of lines, rxvt will only scroll once a whole screen height of lines
654has been read, resulting in fewer updates while still displaying every 668has been read, resulting in fewer updates while still displaying every
655received line; option <strong>-j</strong>.</p> 669received line; option <strong>-j</strong>.</p>
656 <p><strong>False</strong>: specify that smooth scrolling should be used. urxvt will 670 <p><strong>False</strong>: specify that smooth scrolling should be used. rxvt will
657force a screen refresh on each new line it received; option <strong>+j</strong>.</p> 671force a screen refresh on each new line it received; option <strong>+j</strong>.</p>
658 </dd> 672 </dd>
659 <dt><strong>skipScroll:</strong> <i>boolean</i></dt> 673 <dt><strong>skipScroll:</strong> <i>boolean</i></dt>
660 <dd> 674 <dd>
661 <p><strong>True</strong>: (the default) specify that skip scrolling should be used. When 675 <p><strong>True</strong>: (the default) specify that skip scrolling should be used. When
662receiving lots of lines, urxvt will only scroll once in a while 676receiving lots of lines, rxvt will only scroll once in a while
663(around 60 times per second), resulting in far fewer updates. This can 677(around 60 times per second), resulting in far fewer updates. This can
664result in urxvt not ever displaying some of the lines it receives; 678result in rxvt not ever displaying some of the lines it receives;
665option <strong>-ss</strong>.</p> 679option <strong>-ss</strong>.</p>
666 <p><strong>False</strong>: specify that everything is to be displayed, even 680 <p><strong>False</strong>: specify that everything is to be displayed, even
667if the refresh is too fast for the human eye to read anything (or the 681if the refresh is too fast for the human eye to read anything (or the
668monitor to display anything); option <strong>+ss</strong>.</p> 682monitor to display anything); option <strong>+ss</strong>.</p>
669 </dd> 683 </dd>
… …
698 <dd> 712 <dd>
699 <p>Specify background blending type; option <strong>-blt</strong>.</p> 713 <p>Specify background blending type; option <strong>-blt</strong>.</p>
700 </dd> 714 </dd>
701 <dt><strong>blurRadius:</strong> <i>number</i></dt> 715 <dt><strong>blurRadius:</strong> <i>number</i></dt>
702 <dd> 716 <dd>
703 <p>Apply Gaussian Blurr with the specified radius to the transparent 717 <p>Apply Gaussian Blurr with the specified radius to the transparent
704background image; option <strong>-blr</strong>.</p> 718background image; option <strong>-blr</strong>.</p>
705 </dd> 719 </dd>
706 <dt><strong>scrollColor:</strong> <i>colour</i></dt> 720 <dt><strong>scrollColor:</strong> <i>colour</i></dt>
707 <dd> 721 <dd>
708 <p>Use the specified colour for the scrollbar [default #B2B2B2].</p> 722 <p>Use the specified colour for the scrollbar [default #B2B2B2].</p>
… …
715 <dt><strong>borderColor:</strong> <i>colour</i></dt> 729 <dt><strong>borderColor:</strong> <i>colour</i></dt>
716 <dd> 730 <dd>
717 <p>The colour of the border around the text area and between the scrollbar 731 <p>The colour of the border around the text area and between the scrollbar
718and the text.</p> 732and the text.</p>
719 </dd> 733 </dd>
720 <dt><strong>backgroundPixmap:</strong> <i>file[;geom]</i></dt> 734 <dt><strong>backgroundPixmap:</strong> <i>file[;geom[:op1][:op2][...]]</i></dt>
721 <dd> 735 <dd>
722 <p>Use the specified image file for the background and also optionally 736 <p>Use the specified image file for the background and also
723specify its scaling with a geometry string <strong>WxH+X+Y</strong>, 737optionally specify its scaling with a geometry string <strong>WxH+X+Y</strong>,
724in which <strong>&quot;W&quot; / &quot;H&quot;</strong> specify the horizontal/vertical scale (percent), 738(default <code>0x0+50+50</code>) in which <strong>&quot;W&quot; / &quot;H&quot;</strong> specify the
725and <strong>&quot;X&quot; / &quot;Y&quot;</strong> locate the image centre (percent). 739horizontal/vertical scale (percent), and <strong>&quot;X&quot; / &quot;Y&quot;</strong> locate the image
726A scale of 0 displays the image with tiling. A scale of 1 displays the 740centre (percent). A scale of 0 displays the image with tiling. A scale
727image without any scaling. A scale of 2 to 9 specifies an integer 741of 1 displays the image without any scaling. A scale of 2 to 9 specifies
728number of images in that direction. No image will be magnified beyond 742an integer number of images in that direction. No image will be magnified
72910 times its original size. The maximum permitted scale is 1000. 743beyond 10 times its original size. The maximum permitted scale is 1000.
730Special string of <strong>&quot;auto&quot;</strong> used as a geometry will cause image to be 744Additional operations can be specified after colon <strong>:op1:op2...</strong>.
731automatically scaled to match window size. 745Supported operations are:</p>
746<pre> tile force background image to be tiled and not scaled. Equivalent to 0x0,
747 propscale will scale image keeping proportions,
748 auto will scale image to match window size. Equivalent to 100x100;
749 hscale will scale image horizontally to the window size;
750 vscale will scale image vertically to the window size;
751 scale will scale image to match window size;
752 root will tile image as if it was a root window background, auto-adjusting
753 whenever terminal window moves.
754
755</pre>
732If used in conjunction with <strong>-tr</strong> option - specified pixmap will be 756 <p>If used in conjunction with <strong>-tr</strong> option, the specified pixmap will be
733blended over transparency image using either alpha-blending, or any 757blended over transparency image using either alpha-blending, or any
734other blending type, specified with <strong>-blt &quot;type&quot;</strong> option. 758other blending type, specified with <strong>-blt &quot;type&quot;</strong> option.</p>
735[default 0x0+50+50]</p>
736 </dd> 759 </dd>
737 <dt><strong>path:</strong> <i>path</i></dt> 760 <dt><strong>path:</strong> <i>path</i></dt>
738 <dd> 761 <dd>
739 <p>Specify the colon-delimited search path for finding background image files.</p> 762 <p>Specify the colon-delimited search path for finding background image files.</p>
740 </dd> 763 </dd>
… …
992 <dt><strong>cutchars:</strong> <i>string</i></dt> 1015 <dt><strong>cutchars:</strong> <i>string</i></dt>
993 <dd> 1016 <dd>
994 <p>The characters used as delimiters for double-click word selection 1017 <p>The characters used as delimiters for double-click word selection
995(whitespace delimiting is added automatically if resource is given).</p> 1018(whitespace delimiting is added automatically if resource is given).</p>
996 <p>When the perl selection extension is in use (the default if compiled 1019 <p>When the perl selection extension is in use (the default if compiled
997in, see the urxvtperl(3) manpage), a suitable regex using these 1020in, see the rxvtperl(3) manpage), a suitable regex using these
998characters will be created (if the resource exists, otherwise, no regex 1021characters will be created (if the resource exists, otherwise, no regex
999will be created). In this mode, characters outside ISO-8859-1 can be used.</p> 1022will be created). In this mode, characters outside ISO-8859-1 can be used.</p>
1000 <p>When the selection extension is not used, only ISO-8859-1 characters can 1023 <p>When the selection extension is not used, only ISO-8859-1 characters can
1001be used. If not specified, the built-in default is used:</p> 1024be used. If not specified, the built-in default is used:</p>
1002 <p><strong>BACKSLASH `&quot;'&amp;()*,;&lt;=&gt;?@[]{|}</strong></p> 1025 <p><strong>BACKSLASH `&quot;'&amp;()*,;&lt;=&gt;?@[]^{|}</strong></p>
1003 </dd> 1026 </dd>
1004 <dt><strong>preeditType:</strong> <i>style</i></dt> 1027 <dt><strong>preeditType:</strong> <i>style</i></dt>
1005 <dd> 1028 <dd>
1006 <p><strong>OverTheSpot</strong>, <strong>OffTheSpot</strong>, <strong>Root</strong>; option <strong>-pt</strong>.</p> 1029 <p><strong>OverTheSpot</strong>, <strong>OffTheSpot</strong>, <strong>Root</strong>; option <strong>-pt</strong>.</p>
1007 </dd> 1030 </dd>
… …
1019 <dt><strong>imFont:</strong> <i>fontset</i></dt> 1042 <dt><strong>imFont:</strong> <i>fontset</i></dt>
1020 <dd> 1043 <dd>
1021 <p>Specify the font-set used for XIM styles <code>OverTheSpot</code> or 1044 <p>Specify the font-set used for XIM styles <code>OverTheSpot</code> or
1022<code>OffTheSpot</code>. It must be a standard X font set (XLFD patterns separated 1045<code>OffTheSpot</code>. It must be a standard X font set (XLFD patterns separated
1023by commas), i.e. it's not in the same format as the other font lists used 1046by commas), i.e. it's not in the same format as the other font lists used
1024in urxvt. The default will be set-up to chose *any* suitable found 1047in rxvt. The default will be set-up to chose *any* suitable found
1025found, preferably one or two pixels differing in size to the base font. 1048found, preferably one or two pixels differing in size to the base font.
1026option <strong>-imfont</strong>.</p> 1049option <strong>-imfont</strong>.</p>
1027 </dd> 1050 </dd>
1028 <dt><strong>tripleclickwords:</strong> <i>boolean</i></dt> 1051 <dt><strong>tripleclickwords:</strong> <i>boolean</i></dt>
1029 <dd> 1052 <dd>
… …
1067scrollback buffer and switching to/from the secondary screen will 1090scrollback buffer and switching to/from the secondary screen will
1068instead scroll the screen up.</p> 1091instead scroll the screen up.</p>
1069 </dd> 1092 </dd>
1070 <dt><strong>hold</strong>: <i>boolean</i></dt> 1093 <dt><strong>hold</strong>: <i>boolean</i></dt>
1071 <dd> 1094 <dd>
1072 <p>Turn on/off hold window after exit support. If enabled, urxvt 1095 <p>Turn on/off hold window after exit support. If enabled, rxvt
1073will not immediately destroy its window when the program executed within 1096will not immediately destroy its window when the program executed within
1074it exits. Instead, it will wait till it is being killed or closed by the 1097it exits. Instead, it will wait till it is being killed or closed by the
1075user.</p> 1098user.</p>
1076 </dd> 1099 </dd>
1077 <dt><strong>keysym.</strong><i>sym</i>: <i>string</i></dt> 1100 <dt><strong>keysym.</strong><i>sym</i>: <i>string</i></dt>
… …
1106 URxvt.keysym.Meta-Control-0x62: \033&lt;M-C-b&gt; 1129 URxvt.keysym.Meta-Control-0x62: \033&lt;M-C-b&gt;
1107 URxvt.keysym.Meta-Control-0x63: \033&lt;M-C-c&gt; 1130 URxvt.keysym.Meta-Control-0x63: \033&lt;M-C-c&gt;
1108 1131
1109</pre> 1132</pre>
1110 <p>If <i>string</i> takes the form of <code>command:STRING</code>, the specified <strong>STRING</strong> 1133 <p>If <i>string</i> takes the form of <code>command:STRING</code>, the specified <strong>STRING</strong>
1111is interpreted and executed as urxvt's control sequence. For 1134is interpreted and executed as rxvt's control sequence. For
1112example the following means &quot;change the current locale to <code>zh_CN.GBK</code> 1135example the following means &quot;change the current locale to <code>zh_CN.GBK</code>
1113when Control-Meta-c is being pressed&quot;:</p> 1136when Control-Meta-c is being pressed&quot;:</p>
1114<pre> URxvt.keysym.M-C-c: command:\033]701;zh_CN.GBK\007 1137<pre> URxvt.keysym.M-C-c: command:\033]701;zh_CN.GBK\007
1115 1138
1116</pre> 1139</pre>
1117 <p>If <i>string</i> takes the form <code>perl:STRING</code>, then the specified <strong>STRING</strong> 1140 <p>If <i>string</i> takes the form <code>perl:STRING</code>, then the specified <strong>STRING</strong>
1118is passed to the <code>on_keyboard_command</code> perl handler. See the urxvtperl(3) 1141is passed to the <code>on_keyboard_command</code> perl handler. See the rxvtperl(3)
1119manpage. For example, the <cite>selection</cite> extension (activated via 1142manpage. For example, the <cite>selection</cite> extension (activated via
1120<code>urxvt -pe selection</code>) listens for <code>selection:rot13</code> events:</p> 1143<code>rxvt -pe selection</code>) listens for <code>selection:rot13</code> events:</p>
1121<pre> URxvt.keysym.M-C-c: perl:selection:rot13 1144<pre> URxvt.keysym.M-C-c: perl:selection:rot13
1122 1145
1123</pre> 1146</pre>
1124 <p>Due the the large number of modifier combinations, a defined key mapping 1147 <p>Due the the large number of modifier combinations, a defined key mapping
1125will match if at <i>at least</i> the specified identifiers are being set, and 1148will match if at <i>at least</i> the specified identifiers are being set, and
1126no other key mappings with those and more bits are being defined. That 1149no other key mappings with those and more bits are being defined. That
1127means that defining a key map for <code>a</code> will automatically provide 1150means that defining a key map for <code>a</code> will automatically provide
1128definitions for <code>Meta-a</code>, <code>Shift-a</code> and so on, unless some of those are defined 1151definitions for <code>Meta-a</code>, <code>Shift-a</code> and so on, unless some of those are defined
1129mappings themselves.</p> 1152mappings themselves.</p>
1130 <p>Unfortunately, this will override built-in key mappings. For example 1153 <p>Unfortunately, this will override built-in key mappings. For example
1131if you overwrite the <code>Insert</code> key you will disable urxvt's 1154if you overwrite the <code>Insert</code> key you will disable rxvt's
1132<code>Shift-Insert</code> mapping. To re-enable that, you can poke &quot;holes&quot; into the 1155<code>Shift-Insert</code> mapping. To re-enable that, you can poke &quot;holes&quot; into the
1133user-defined keymap using the <code>builtin:</code> replacement:</p> 1156user-defined keymap using the <code>builtin:</code> replacement:</p>
1134<pre> URxvt.keysym.Insert: &lt;my insert key sequence&gt; 1157<pre> URxvt.keysym.Insert: &lt;my insert key sequence&gt;
1135 URxvt.keysym.S-Insert: builtin: 1158 URxvt.keysym.S-Insert: builtin:
1136 1159
… …
1143font-switching at runtime:</p> 1166font-switching at runtime:</p>
1144<pre> URxvt.keysym.M-C-1: command:\033]50;suxuseuro\007 1167<pre> URxvt.keysym.M-C-1: command:\033]50;suxuseuro\007
1145 URxvt.keysym.M-C-2: command:\033]50;9x15bold\007 1168 URxvt.keysym.M-C-2: command:\033]50;9x15bold\007
1146 1169
1147</pre> 1170</pre>
1148 <p>Other things are possible, e.g. resizing (see urxvt(7) for more 1171 <p>Other things are possible, e.g. resizing (see rxvt(7) for more
1149info):</p> 1172info):</p>
1150<pre> URxvt.keysym.M-C-3: command:\033[8;25;80t 1173<pre> URxvt.keysym.M-C-3: command:\033[8;25;80t
1151 URxvt.keysym.M-C-4: command:\033[8;48;110t 1174 URxvt.keysym.M-C-4: command:\033[8;48;110t
1152 1175
1153</pre> 1176</pre>
… …
1175all instances, while <strong>perl-ext</strong> is used for specific instances.</p> 1198all instances, while <strong>perl-ext</strong> is used for specific instances.</p>
1176 </dd> 1199 </dd>
1177 <dt><strong>perl-eval</strong>: <i>string</i></dt> 1200 <dt><strong>perl-eval</strong>: <i>string</i></dt>
1178 <dd> 1201 <dd>
1179 <p>Perl code to be evaluated when all extensions have been registered. See 1202 <p>Perl code to be evaluated when all extensions have been registered. See
1180the urxvtperl(3) manpage. Due to security reasons, this resource 1203the rxvtperl(3) manpage. Due to security reasons, this resource
1181will be ignored when running setuid/setgid.</p> 1204will be ignored when running setuid/setgid.</p>
1182 </dd> 1205 </dd>
1183 <dt><strong>perl-lib</strong>: <i>path</i></dt> 1206 <dt><strong>perl-lib</strong>: <i>path</i></dt>
1184 <dd> 1207 <dd>
1185 <p>Colon-separated list of additional directories that hold extension 1208 <p>Colon-separated list of additional directories that hold extension
1186scripts. When looking for extensions specified by the <code>perl</code> resource, 1209scripts. When looking for extensions specified by the <code>perl</code> resource,
1187urxvt will first look in these directories and then in 1210rxvt will first look in these directories and then in
1188<cite>/usr/local/lib/urxvt/perl/</cite>. Due to security reasons, this resource 1211<cite>/opt/rxvt/lib/urxvt/perl/</cite>. Due to security reasons, this resource
1189will be ignored when running setuid/setgid.</p> 1212will be ignored when running setuid/setgid.</p>
1190 <p>See the urxvtperl(3) manpage.</p> 1213 <p>See the rxvtperl(3) manpage.</p>
1191 </dd> 1214 </dd>
1192 <dt><strong>selection.pattern-<i>idx</i></strong>: <i>perl-regex</i></dt> 1215 <dt><strong>selection.pattern-<i>idx</i></strong>: <i>perl-regex</i></dt>
1193 <dd> 1216 <dd>
1194 <p>Additional selection patterns, see the urxvtperl(3) manpage for 1217 <p>Additional selection patterns, see the rxvtperl(3) manpage for
1195details.</p> 1218details.</p>
1196 </dd> 1219 </dd>
1197 <dt><strong>selection-autotransform.<i>idx</i></strong>: <i>perl-transform</i></dt> 1220 <dt><strong>selection-autotransform.<i>idx</i></strong>: <i>perl-transform</i></dt>
1198 <dd> 1221 <dd>
1199 <p>Selection auto-transform patterns, see the urxvtperl(3) manpage 1222 <p>Selection auto-transform patterns, see the rxvtperl(3) manpage
1200for details.</p> 1223for details.</p>
1201 </dd> 1224 </dd>
1202 <dt><strong>searchable-scrollback:</strong> <i>keysym</i></dt> 1225 <dt><strong>searchable-scrollback:</strong> <i>keysym</i></dt>
1203 <dd> 1226 <dd>
1204 <p>Sets the hotkey that starts the incremental scrollback buffer search 1227 <p>Sets the hotkey that starts the incremental scrollback buffer search
… …
1225</dl> 1248</dl>
1226 1249
1227</div> 1250</div>
1228<h1 id="THE_SCROLLBAR">THE SCROLLBAR</h1><p><a href="#TOP" class="toplink">Top</a></p> 1251<h1 id="THE_SCROLLBAR">THE SCROLLBAR</h1><p><a href="#TOP" class="toplink">Top</a></p>
1229<div id="THE_SCROLLBAR_CONTENT"> 1252<div id="THE_SCROLLBAR_CONTENT">
1230<p>Lines of text that scroll off the top of the <strong>urxvt</strong> window 1253<p>Lines of text that scroll off the top of the <strong>rxvt</strong> window
1231(resource: <strong>saveLines</strong>) and can be scrolled back using the scrollbar 1254(resource: <strong>saveLines</strong>) and can be scrolled back using the scrollbar
1232or by keystrokes. The normal <strong>urxvt</strong> scrollbar has arrows and 1255or by keystrokes. The normal <strong>rxvt</strong> scrollbar has arrows and
1233its behaviour is fairly intuitive. The <strong>xterm-scrollbar</strong> is without 1256its behaviour is fairly intuitive. The <strong>xterm-scrollbar</strong> is without
1234arrows and its behaviour mimics that of <i>xterm</i></p> 1257arrows and its behaviour mimics that of <i>xterm</i></p>
1235<p>Scroll down with <strong>Button1</strong> (<strong>xterm-scrollbar</strong>) or <strong>Shift-Next</strong>. 1258<p>Scroll down with <strong>Button1</strong> (<strong>xterm-scrollbar</strong>) or <strong>Shift-Next</strong>.
1236Scroll up with <strong>Button3</strong> (<strong>xterm-scrollbar</strong>) or <strong>Shift-Prior</strong>. 1259Scroll up with <strong>Button3</strong> (<strong>xterm-scrollbar</strong>) or <strong>Shift-Prior</strong>.
1237Continuous scroll with <strong>Button2</strong>.</p> 1260Continuous scroll with <strong>Button2</strong>.</p>
… …
1268selection, and trailing whitespace is visually underlined and removed from 1291selection, and trailing whitespace is visually underlined and removed from
1269the selection.</p> 1292the selection.</p>
1270 </dd> 1293 </dd>
1271 <dt><strong>Pasting</strong>:</dt> 1294 <dt><strong>Pasting</strong>:</dt>
1272 <dd> 1295 <dd>
1273 <p>Pressing and releasing the Middle mouse button in an <strong>urxvt</strong> 1296 <p>Pressing and releasing the Middle mouse button in an <strong>rxvt</strong>
1274window causes the value of the PRIMARY selection (or CLIPBOARD with the 1297window causes the value of the PRIMARY selection (or CLIPBOARD with the
1275<strong>Meta</strong> modifier) to be inserted as if it had been typed on the keyboard.</p> 1298<strong>Meta</strong> modifier) to be inserted as if it had been typed on the keyboard.</p>
1276 <p>Pressing <strong>Shift-Insert</strong> causes the value of the PRIMARY selection to be 1299 <p>Pressing <strong>Shift-Insert</strong> causes the value of the PRIMARY selection to be
1277inserted too.</p> 1300inserted too.</p>
1278 </dd> 1301 </dd>
… …
1353both scenario A and B of ISO 14755, including part 5.2.</p> 1376both scenario A and B of ISO 14755, including part 5.2.</p>
1354 1377
1355</div> 1378</div>
1356<h1 id="LOGIN_STAMP">LOGIN STAMP</h1><p><a href="#TOP" class="toplink">Top</a></p> 1379<h1 id="LOGIN_STAMP">LOGIN STAMP</h1><p><a href="#TOP" class="toplink">Top</a></p>
1357<div id="LOGIN_STAMP_CONTENT"> 1380<div id="LOGIN_STAMP_CONTENT">
1358<p><strong>urxvt</strong> tries to write an entry into the <i>utmp</i>(5) file so that 1381<p><strong>rxvt</strong> tries to write an entry into the <i>utmp</i>(5) file so that
1359it can be seen via the <i>who(1)</i> command, and can accept messages. To 1382it can be seen via the <i>who(1)</i> command, and can accept messages. To
1360allow this feature, <strong>urxvt</strong> may need to be installed setuid root 1383allow this feature, <strong>rxvt</strong> may need to be installed setuid root
1361on some systems or setgid to root or to some other group on others.</p> 1384on some systems or setgid to root or to some other group on others.</p>
1362 1385
1363</div> 1386</div>
1364<h1 id="COLORS_AND_GRAPHICS">COLORS AND GRAPHICS</h1><p><a href="#TOP" class="toplink">Top</a></p> 1387<h1 id="COLORS_AND_GRAPHICS">COLORS AND GRAPHICS</h1><p><a href="#TOP" class="toplink">Top</a></p>
1365<div id="COLORS_AND_GRAPHICS_CONTENT"> 1388<div id="COLORS_AND_GRAPHICS_CONTENT">
1366<p>In addition to the default foreground and background colours, 1389<p>In addition to the default foreground and background colours,
1367<strong>urxvt</strong> can display up to 16 colours (8 ANSI colours plus 1390<strong>rxvt</strong> can display up to 16 colours (8 ANSI colours plus
1368high-intensity bold/blink versions of the same). Here is a list of the 1391high-intensity bold/blink versions of the same). Here is a list of the
1369colours with their names.</p> 1392colours with their names.</p>
1370<table><tr><td>color0</td><td>(black)</td><td>= Black</td></tr><tr><td>color1</td><td>(red)</td><td>= Red3</td></tr><tr><td>color2</td><td>(green)</td><td>= Green3</td></tr><tr><td>color3</td><td>(yellow)</td><td>= Yellow3</td></tr><tr><td>color4</td><td>(blue)</td><td>= Blue3</td></tr><tr><td>color5</td><td>(magenta)</td><td>= Magenta3</td></tr><tr><td>color6</td><td>(cyan)</td><td>= Cyan3</td></tr><tr><td>color7</td><td>(white)</td><td>= AntiqueWhite</td></tr><tr><td>color8</td><td>(bright black)</td><td>= Grey25</td></tr><tr><td>color9</td><td>(bright red)</td><td>= Red</td></tr><tr><td>color10</td><td>(bright green)</td><td>= Green</td></tr><tr><td>color11</td><td>(bright yellow)</td><td>= Yellow</td></tr><tr><td>color12</td><td>(bright blue)</td><td>= Blue</td></tr><tr><td>color13</td><td>(bright magenta)</td><td>= Magenta</td></tr><tr><td>color14</td><td>(bright cyan)</td><td>= Cyan</td></tr><tr><td>color15</td><td>(bright white)</td><td>= White</td></tr><tr><td>foreground</td><td></td><td>= Black</td></tr><tr><td>background</td><td></td><td>= White</td></tr></table><p>It is also possible to specify the colour values of <strong>foreground</strong>, 1393<table><tr><td>color0</td><td>(black)</td><td>= Black</td></tr><tr><td>color1</td><td>(red)</td><td>= Red3</td></tr><tr><td>color2</td><td>(green)</td><td>= Green3</td></tr><tr><td>color3</td><td>(yellow)</td><td>= Yellow3</td></tr><tr><td>color4</td><td>(blue)</td><td>= Blue3</td></tr><tr><td>color5</td><td>(magenta)</td><td>= Magenta3</td></tr><tr><td>color6</td><td>(cyan)</td><td>= Cyan3</td></tr><tr><td>color7</td><td>(white)</td><td>= AntiqueWhite</td></tr><tr><td>color8</td><td>(bright black)</td><td>= Grey25</td></tr><tr><td>color9</td><td>(bright red)</td><td>= Red</td></tr><tr><td>color10</td><td>(bright green)</td><td>= Green</td></tr><tr><td>color11</td><td>(bright yellow)</td><td>= Yellow</td></tr><tr><td>color12</td><td>(bright blue)</td><td>= Blue</td></tr><tr><td>color13</td><td>(bright magenta)</td><td>= Magenta</td></tr><tr><td>color14</td><td>(bright cyan)</td><td>= Cyan</td></tr><tr><td>color15</td><td>(bright white)</td><td>= White</td></tr><tr><td>foreground</td><td></td><td>= Black</td></tr><tr><td>background</td><td></td><td>= White</td></tr></table><p>It is also possible to specify the colour values of <strong>foreground</strong>,
1371<strong>background</strong>, <strong>cursorColor</strong>, <strong>cursorColor2</strong>, <strong>colorBD</strong>, <strong>colorUL</strong> as 1394<strong>background</strong>, <strong>cursorColor</strong>, <strong>cursorColor2</strong>, <strong>colorBD</strong>, <strong>colorUL</strong> as
1372a number 0-15, as a convenient shorthand to reference the colour name of 1395a number 0-15, as a convenient shorthand to reference the colour name of
1373color0-color15.</p> 1396color0-color15.</p>
1374<p>In addition to the colours defined above, urxvt offers an 1397<p>In addition to the colours defined above, rxvt offers an
1375additional 72 colours. The first 64 of those (with indices 16 to 79) 1398additional 72 colours. The first 64 of those (with indices 16 to 79)
1376consist of a 4*4*4 RGB colour cube (i.e. <i>index = r * 16 + g * 4 + b + 1399consist of a 4*4*4 RGB colour cube (i.e. <i>index = r * 16 + g * 4 + b +
137716</i>), followed by 8 additional shades of gray (with indices 80 to 87).</p> 140016</i>), followed by 8 additional shades of gray (with indices 80 to 87).</p>
1378<p>Together, all those colours implement the 88 colour xterm colours. Only 1401<p>Together, all those colours implement the 88 colour xterm colours. Only
1379the first 16 can be changed using resources currently, the rest can only 1402the first 16 can be changed using resources currently, the rest can only
… …
1381<p>Note that <strong>-rv</strong> (<strong>&quot;reverseVideo: True&quot;</strong>) simulates reverse video by 1404<p>Note that <strong>-rv</strong> (<strong>&quot;reverseVideo: True&quot;</strong>) simulates reverse video by
1382always swapping the foreground/background colours. This is in contrast to 1405always swapping the foreground/background colours. This is in contrast to
1383<i>xterm</i>(1) where the colours are only swapped if they have not otherwise 1406<i>xterm</i>(1) where the colours are only swapped if they have not otherwise
1384been specified. For example,</p> 1407been specified. For example,</p>
1385<dl> 1408<dl>
1386 <dt><strong>urxvt -fg Black -bg White -rv</strong></dt> 1409 <dt><strong>rxvt -fg Black -bg White -rv</strong></dt>
1387 <dd> 1410 <dd>
1388 <p>would yield White on Black, while on <i>xterm</i>(1) it would yield Black 1411 <p>would yield White on Black, while on <i>xterm</i>(1) it would yield Black
1389on White.</p> 1412on White.</p>
1390 </dd> 1413 </dd>
1391</dl> 1414</dl>
… …
1405<p>You probably need to specify <strong>&quot;-depth 32&quot;</strong>, too, and have the luck that 1428<p>You probably need to specify <strong>&quot;-depth 32&quot;</strong>, too, and have the luck that
1406your X-server uses ARGB pixel layout, as X is far from just supporting 1429your X-server uses ARGB pixel layout, as X is far from just supporting
1407ARGB visuals out of the box, and rxvt-unicode just fudges around.</p> 1430ARGB visuals out of the box, and rxvt-unicode just fudges around.</p>
1408<p>For example, the following selects an almost completely transparent red 1431<p>For example, the following selects an almost completely transparent red
1409background, and an almost opaque pink foreground:</p> 1432background, and an almost opaque pink foreground:</p>
1410<pre> urxvt -depth 32 -bg rgba:0000/0000/0000/aaaa -fg &quot;[80]pink&quot; 1433<pre> rxvt -depth 32 -bg rgba:0000/0000/0000/aaaa -fg &quot;[80]pink&quot;
1411 1434
1412</pre> 1435</pre>
1413<p><i>Please note that transparency of any kind if completely unsupported by 1436<p><i>Please note that transparency of any kind if completely unsupported by
1414the author. Don't bug him with installation questions!</i></p> 1437the author. Don't bug him with installation questions!</i></p>
1415 1438
1416</div> 1439</div>
1417<h1 id="ENVIRONMENT">ENVIRONMENT</h1><p><a href="#TOP" class="toplink">Top</a></p> 1440<h1 id="ENVIRONMENT">ENVIRONMENT</h1><p><a href="#TOP" class="toplink">Top</a></p>
1418<div id="ENVIRONMENT_CONTENT"> 1441<div id="ENVIRONMENT_CONTENT">
1419<p><strong>urxvt</strong> sets and/or uses the following environment variables:</p> 1442<p><strong>rxvt</strong> sets and/or uses the following environment variables:</p>
1420<dl> 1443<dl>
1421 <dt><strong>TERM</strong></dt> 1444 <dt><strong>TERM</strong></dt>
1422 <dd> 1445 <dd>
1423 <p>Normally set to <code>rxvt-unicode</code>, unless overwritten at configure time, via 1446 <p>Normally set to <code>rxvt-unicode</code>, unless overwritten at configure time, via
1424resources or on the command line.</p> 1447resources or on the command line.</p>
1425 </dd> 1448 </dd>
1426 <dt><strong>COLORTERM</strong></dt> 1449 <dt><strong>COLORTERM</strong></dt>
1427 <dd> 1450 <dd>
1428 <p>Either <code>rxvt</code>, <code>rxvt-xpm</code>, depending on whether urxvt was 1451 <p>Either <code>rxvt</code>, <code>rxvt-xpm</code>, depending on whether rxvt was
1429compiled with background image support, and optionally with the added 1452compiled with background image support, and optionally with the added
1430extension <code>-mono</code> to indicate that rxvt-unicode runs on a monochrome 1453extension <code>-mono</code> to indicate that rxvt-unicode runs on a monochrome
1431screen.</p> 1454screen.</p>
1432 </dd> 1455 </dd>
1433 <dt><strong>COLORFGBG</strong></dt> 1456 <dt><strong>COLORFGBG</strong></dt>
1434 <dd> 1457 <dd>
1435 <p>Set to a string of the form <code>fg;bg</code> or <code>fg;xpm;bg</code>, where <code>fg</code> is 1458 <p>Set to a string of the form <code>fg;bg</code> or <code>fg;xpm;bg</code>, where <code>fg</code> is
1436the colour code used as default foreground/text colour (or the string 1459the colour code used as default foreground/text colour (or the string
1437<code>default</code> to indicate that the default-colour escape sequence is to be 1460<code>default</code> to indicate that the default-colour escape sequence is to be
1438used), <code>bg</code> is the colour code used as default background colour (or the 1461used), <code>bg</code> is the colour code used as default background colour (or the
1439string <code>default</code>), and <code>xpm</code> is the string <code>default</code> if urxvt 1462string <code>default</code>), and <code>xpm</code> is the string <code>default</code> if rxvt
1440was compiled with background image support. Libraries like <code>ncurses</code> 1463was compiled with background image support. Libraries like <code>ncurses</code>
1441and <code>slang</code> can (and do) use this information to optimize screen output.</p> 1464and <code>slang</code> can (and do) use this information to optimize screen output.</p>
1442 </dd> 1465 </dd>
1443 <dt><strong>WINDOWID</strong></dt> 1466 <dt><strong>WINDOWID</strong></dt>
1444 <dd> 1467 <dd>
1445 <p>Set to the (decimal) X Window ID of the urxvt window (the toplevel 1468 <p>Set to the (decimal) X Window ID of the rxvt window (the toplevel
1446window, which usually has subwindows for the scrollbar, the terminal 1469window, which usually has subwindows for the scrollbar, the terminal
1447window and so on).</p> 1470window and so on).</p>
1448 </dd> 1471 </dd>
1449 <dt><strong>TERMINFO</strong></dt> 1472 <dt><strong>TERMINFO</strong></dt>
1450 <dd> 1473 <dd>
1451 <p>Set to the terminfo directory iff urxvt was configured with 1474 <p>Set to the terminfo directory iff rxvt was configured with
1452<code>--with-terminfo=PATH</code>.</p> 1475<code>--with-terminfo=PATH</code>.</p>
1453 </dd> 1476 </dd>
1454 <dt><strong>DISPLAY</strong></dt> 1477 <dt><strong>DISPLAY</strong></dt>
1455 <dd> 1478 <dd>
1456 <p>Used by urxvt to connect to the display and set to the correct 1479 <p>Used by rxvt to connect to the display and set to the correct
1457display in its child processes.</p> 1480display in its child processes.</p>
1458 </dd> 1481 </dd>
1459 <dt><strong>SHELL</strong></dt> 1482 <dt><strong>SHELL</strong></dt>
1460 <dd> 1483 <dd>
1461 <p>The shell to be used for command execution, defaults to <code>/bin/sh</code>.</p> 1484 <p>The shell to be used for command execution, defaults to <code>/bin/sh</code>.</p>
1462 </dd> 1485 </dd>
1463 <dt><strong>RXVT_SOCKET</strong></dt> 1486 <dt><strong>RXVT_SOCKET</strong></dt>
1464 <dd> 1487 <dd>
1465 <p>The unix domain socket path used by urxvtc(1) and 1488 <p>The unix domain socket path used by rxvtc(1) and
1466urxvtd(1).</p> 1489rxvtd(1).</p>
1467 <p>Default <cite>$HOME/.rxvt-unicode-<i>&lt;nodename</i></cite>.</p> 1490 <p>Default <cite>$HOME/.rxvt-unicode-<i>&lt;nodename</i></cite>.</p>
1468 </dd> 1491 </dd>
1469 <dt><strong>HOME</strong></dt> 1492 <dt><strong>HOME</strong></dt>
1470 <dd> 1493 <dd>
1471 <p>Used to locate the default directory for the unix domain socket for 1494 <p>Used to locate the default directory for the unix domain socket for
… …
1477 <p>Directory where various X resource files are being located.</p> 1500 <p>Directory where various X resource files are being located.</p>
1478 </dd> 1501 </dd>
1479 <dt><strong>XENVIRONMENT</strong></dt> 1502 <dt><strong>XENVIRONMENT</strong></dt>
1480 <dd> 1503 <dd>
1481 <p>If set and accessible, gives the name of a X resource file to be loaded by 1504 <p>If set and accessible, gives the name of a X resource file to be loaded by
1482urxvt.</p> 1505rxvt.</p>
1483 </dd> 1506 </dd>
1484</dl> 1507</dl>
1485 1508
1486</div> 1509</div>
1487<h1 id="FILES">FILES</h1><p><a href="#TOP" class="toplink">Top</a></p> 1510<h1 id="FILES">FILES</h1><p><a href="#TOP" class="toplink">Top</a></p>
… …
1494</dl> 1517</dl>
1495 1518
1496</div> 1519</div>
1497<h1 id="SEE_ALSO">SEE ALSO</h1><p><a href="#TOP" class="toplink">Top</a></p> 1520<h1 id="SEE_ALSO">SEE ALSO</h1><p><a href="#TOP" class="toplink">Top</a></p>
1498<div id="SEE_ALSO_CONTENT"> 1521<div id="SEE_ALSO_CONTENT">
1499<p>urxvt(7), urxvtc(1), urxvtd(1), xterm(1), sh(1), resize(1), X(1), pty(4), tty(4), utmp(5)</p> 1522<p>rxvt(7), rxvtc(1), rxvtd(1), xterm(1), sh(1), resize(1), X(1), pty(4), tty(4), utmp(5)</p>
1500 1523
1501</div> 1524</div>
1502<h1 id="CURRENT_PROJECT_COORDINATOR">CURRENT PROJECT COORDINATOR</h1><p><a href="#TOP" class="toplink">Top</a></p> 1525<h1 id="CURRENT_PROJECT_COORDINATOR">CURRENT PROJECT COORDINATOR</h1><p><a href="#TOP" class="toplink">Top</a></p>
1503<div id="CURRENT_PROJECT_COORDINATOR_CONTENT"> 1526<div id="CURRENT_PROJECT_COORDINATOR_CONTENT">
1504<dl> 1527<dl>

Diff Legend

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