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.61 by root, Mon Jul 17 19:20:29 2006 UTC vs.
Revision 1.62 by root, Mon Aug 7 16:17:30 2006 UTC

48<p>rxvt-unicode (ouR XVT, unicode) - (a VT102 emulator for the X window system)</p> 48<p>rxvt-unicode (ouR XVT, unicode) - (a VT102 emulator for the X window system)</p>
49<p> 49<p>
50</p> 50</p>
51<hr /> 51<hr />
52<h1><a name="synopsis">SYNOPSIS</a></h1> 52<h1><a name="synopsis">SYNOPSIS</a></h1>
53<p><strong>urxvt</strong> [options] [-e command [ args ]]</p> 53<p><strong>rxvt</strong> [options] [-e command [ args ]]</p>
54<p> 54<p>
55</p> 55</p>
56<hr /> 56<hr />
57<h1><a name="description">DESCRIPTION</a></h1> 57<h1><a name="description">DESCRIPTION</a></h1>
58<p><strong>rxvt-unicode</strong>, version <strong>7.8</strong>, is a colour vt102 terminal 58<p><strong>rxvt-unicode</strong>, version <strong>7.9</strong>, is a colour vt102 terminal
59emulator intended as an <em>xterm</em>(1) replacement for users who do not 59emulator intended as an <em>xterm</em>(1) replacement for users who do not
60require features such as Tektronix 4014 emulation and toolkit-style 60require features such as Tektronix 4014 emulation and toolkit-style
61configurability. As a result, <strong>rxvt-unicode</strong> uses much less swap space -- 61configurability. As a result, <strong>rxvt-unicode</strong> uses much less swap space --
62a significant advantage on a machine serving many X sessions.</p> 62a significant advantage on a machine serving many X sessions.</p>
63<p> 63<p>
64</p> 64</p>
65<hr /> 65<hr />
66<h1><a name="frequently_asked_questions">FREQUENTLY ASKED QUESTIONS</a></h1> 66<h1><a name="frequently_asked_questions">FREQUENTLY ASKED QUESTIONS</a></h1>
67<p>See <code>urxvt(7)</code> (try <code>man 7 urxvt</code>) for a list of 67<p>See <code>rxvt(7)</code> (try <code>man 7 rxvt</code>) for a list of
68frequently asked questions and answer to them and some common 68frequently asked questions and answer to them and some common
69problems. That document is also accessible on the World-Wide-Web at 69problems. That document is also accessible on the World-Wide-Web at
70<a href="http://cvs.schmorp.de/browse/*checkout*/rxvt-unicode/doc/rxvt.7.html">http://cvs.schmorp.de/browse/*checkout*/rxvt-unicode/doc/rxvt.7.html</a>.</p> 70<a href="http://cvs.schmorp.de/browse/*checkout*/rxvt-unicode/doc/rxvt.7.html">http://cvs.schmorp.de/browse/*checkout*/rxvt-unicode/doc/rxvt.7.html</a>.</p>
71<p> 71<p>
72</p> 72</p>
77world. Being a terminal emulator, however, some things are very difficult, 77world. Being a terminal emulator, however, some things are very difficult,
78especially cursive scripts such as arabic, vertically written scripts 78especially cursive scripts such as arabic, vertically written scripts
79like mongolian or scripts requiring extremely complex combining rules, 79like mongolian or scripts requiring extremely complex combining rules,
80like tibetan or devenagari. Don't expect pretty output when using these 80like tibetan or devenagari. Don't expect pretty output when using these
81scripts. Most other scripts, latin, cyrillic, kanji, thai etc. should work 81scripts. Most other scripts, latin, cyrillic, kanji, thai etc. should work
82fine, though. A somewhat difficult case are left-to-right scripts, such 82fine, though. A somewhat difficult case are right-to-left scripts, such
83as hebrew: <strong>rxvt-unicode</strong> adopts the view that bidirectional algorithms 83as hebrew: <strong>rxvt-unicode</strong> adopts the view that bidirectional algorithms
84belong into the application, not the terminal emulator (too many things -- 84belong into the application, not the terminal emulator (too many things --
85such as cursor-movement while editing -- break otherwise), but that might 85such as cursor-movement while editing -- break otherwise), but that might
86change.</p> 86change.</p>
87<p>If you are looking for a terminal that supports more exotic scripts, let 87<p>If you are looking for a terminal that supports more exotic scripts, let
88me recommend <code>mlterm</code>, which is a very userfriendly, lean and clean 88me recommend <code>mlterm</code>, which is a very user friendly, lean and clean
89terminal emulator. In fact, the reason rxvt-unicode was born was solely 89terminal emulator. In fact, the reason rxvt-unicode was born was solely
90because the author couldn't get <code>mlterm</code> to use one font for latin1 and 90because the author couldn't get <code>mlterm</code> to use one font for latin1 and
91another for japanese.</p> 91another for japanese.</p>
92<p>Therefore another design rationale was the use of multiple fonts to 92<p>Therefore another design rationale was the use of multiple fonts to
93display characters: The idea of a single unicode font which many other 93display characters: The idea of a single unicode font which many other
94programs force onto its users never made sense to me: You should be able 94programs force onto its users never made sense to me: You should be able
95to choose any font for any script freely.</p> 95to choose any font for any script freely.</p>
96<p>Apart from that, rxvt-unicode is also much better internationalised than 96<p>Apart from that, rxvt-unicode is also much better internationalised than
97its predecessor, supports things such as XFT and ISO 14755 that are handy 97its predecessor, supports things such as XFT and ISO 14755 that are handy
98in i18n-environments, is faster, and has a lot less bugs than the original 98in i18n-environments, is faster, and has a lot bugs less than the original
99rxvt. This all in addition to dozens of other small improvements.</p> 99rxvt. This all in addition to dozens of other small improvements.</p>
100<p>It is still faithfully following the original rxvt idea of being lean 100<p>It is still faithfully following the original rxvt idea of being lean
101and nice on resources: for example, you can still configure rxvt-unicode 101and nice on resources: for example, you can still configure rxvt-unicode
102without most of its features to get a lean binary. It also comes with 102without most of its features to get a lean binary. It also comes with
103a client/daemon pair that lets you open any number of terminal windows 103a client/daemon pair that lets you open any number of terminal windows
104from within a single process, which makes startup time very fast and 104from within a single process, which makes startup time very fast and
105drastically reduces memory usage. See <code>urxvtd(1)</code> (daemon) and 105drastically reduces memory usage. See <code>rxvtd(1)</code> (daemon) and
106<code>urxvtc(1)</code> (client).</p> 106<code>rxvtc(1)</code> (client).</p>
107<p>It also makes technical information about escape sequences (which have 107<p>It also makes technical information about escape sequences (which have
108been extended) easier accessible: see <code>urxvt(7)</code> for technical 108been extended) more accessible: see <code>rxvt(7)</code> for technical
109reference documentation (escape sequences etc.).</p> 109reference documentation (escape sequences etc.).</p>
110<p> 110<p>
111</p> 111</p>
112<hr /> 112<hr />
113<h1><a name="options">OPTIONS</a></h1> 113<h1><a name="options">OPTIONS</a></h1>
114<p>The <strong>urxvt</strong> options (mostly a subset of <em>xterm</em>'s) are listed 114<p>The <strong>rxvt</strong> options (mostly a subset of <em>xterm</em>'s) are listed
115below. In keeping with the smaller-is-better philosophy, options may be 115below. In keeping with the smaller-is-better philosophy, options may be
116eliminated or default values chosen at compile-time, so options and 116eliminated or default values chosen at compile-time, so options and
117defaults listed may not accurately reflect the version installed on 117defaults listed may not accurately reflect the version installed on
118your system. `urxvt -h' gives a list of major compile-time options on 118your system. `rxvt -h' gives a list of major compile-time options on
119the <em>Options</em> line. Option descriptions may be prefixed with which 119the <em>Options</em> line. Option descriptions may be prefixed with which
120compile option each is dependent upon. e.g. `Compile <em>XIM</em>:' requires 120compile option each is dependent upon. e.g. `Compile <em>XIM</em>:' requires
121<em>XIM</em> on the <em>Options</em> line. Note: `urxvt -help' gives a list of all 121<em>XIM</em> on the <em>Options</em> line. Note: `rxvt -help' gives a list of all
122command-line options compiled into your version.</p> 122command-line options compiled into your version.</p>
123<p>Note that <strong>urxvt</strong> permits the resource name to be used as a 123<p>Note that <strong>rxvt</strong> permits the resource name to be used as a
124long-option (--/++ option) so the potential command-line options are 124long-option (--/++ option) so the potential command-line options are
125far greater than those listed. For example: `urxvt --loginShell --color1 125far greater than those listed. For example: `rxvt --loginShell --color1
126Orange'.</p> 126Orange'.</p>
127<p>The following options are available:</p> 127<p>The following options are available:</p>
128<dl> 128<dl>
129<dt><strong><a name="item__2dhelp_2c__2d_2dhelp"><strong>-help</strong>, <strong>--help</strong></a></strong> 129<dt><strong><a name="item__2dhelp_2c__2d_2dhelp"><strong>-help</strong>, <strong>--help</strong></a></strong>
130 130
171<p>Turn on/off inheriting parent window's pixmap. Alternative form is 171<p>Turn on/off inheriting parent window's pixmap. Alternative form is
172<strong>-tr</strong>; resource <strong>inheritPixmap</strong>.</p> 172<strong>-tr</strong>; resource <strong>inheritPixmap</strong>.</p>
173</dd> 173</dd>
174<dd> 174<dd>
175<p><em>Please note that transparency of any kind if completely unsupported by 175<p><em>Please note that transparency of any kind if completely unsupported by
176the author. Don't bug him with installation questions!</em></p> 176the author. Don't bug him with installation questions! Read the FAQ (man 7
177rxvt)!</em></p>
177</dd> 178</dd>
178</li> 179</li>
179<dt><strong><a name="item__2dfade_number"><strong>-fade</strong> <em>number</em></a></strong> 180<dt><strong><a name="item__2dfade_number"><strong>-fade</strong> <em>number</em></a></strong>
180 181
181<dd> 182<dd>
200used to brighten or darken the image in addition to tinting it; resource 201used to brighten or darken the image in addition to tinting it; resource
201<em>tintColor</em>. Example:</p> 202<em>tintColor</em>. Example:</p>
202</dd> 203</dd>
203<dd> 204<dd>
204<pre> 205<pre>
205 urxvt -tr -tint blue -sh 40</pre> 206 rxvt -tr -tint blue -sh 40</pre>
206</dd> 207</dd>
207</li> 208</li>
208<dt><strong><a name="item__2dsh"><strong>-sh</strong></a></strong> 209<dt><strong><a name="item__2dsh"><strong>-sh</strong></a></strong>
209 210
210<dd> 211<dd>
273with <code>x:</code>. To specify an XFT-font, you need to prefix it with <code>xft:</code>, 274with <code>x:</code>. To specify an XFT-font, you need to prefix it with <code>xft:</code>,
274e.g.:</p> 275e.g.:</p>
275</dd> 276</dd>
276<dd> 277<dd>
277<pre> 278<pre>
278 urxvt -fn &quot;xft:Bitstream Vera Sans Mono:pixelsize=15&quot; 279 rxvt -fn &quot;xft:Bitstream Vera Sans Mono:pixelsize=15&quot;
279 urxvt -fn &quot;9x15bold,xft:Bitstream Vera Sans Mono&quot;</pre> 280 rxvt -fn &quot;9x15bold,xft:Bitstream Vera Sans Mono&quot;</pre>
280</dd> 281</dd>
281<dd> 282<dd>
282<p>See also the question ``How does rxvt-unicode choose fonts?'' in the FAQ 283<p>See also the question ``How does rxvt-unicode choose fonts?'' in the FAQ
283section of urxvt(7).</p> 284section of rxvt(7).</p>
284</dd> 285</dd>
285</li> 286</li>
286<dt><strong><a name="item__2dfb_fontlist"><strong>-fb</strong> <em>fontlist</em></a></strong> 287<dt><strong><a name="item__2dfb_fontlist"><strong>-fb</strong> <em>fontlist</em></a></strong>
287 288
288<dd> 289<dd>
469</dd> 470</dd>
470</li> 471</li>
471<dt><strong><a name="item__2de_command__5barguments_5d"><strong>-e</strong> <em>command [arguments]</em></a></strong> 472<dt><strong><a name="item__2de_command__5barguments_5d"><strong>-e</strong> <em>command [arguments]</em></a></strong>
472 473
473<dd> 474<dd>
474<p>Run the command with its command-line arguments in the <strong>urxvt</strong> 475<p>Run the command with its command-line arguments in the <strong>rxvt</strong>
475window; also sets the window title and icon name to be the basename of 476window; also sets the window title and icon name to be the basename of
476the program being executed if neither <em>-title</em> (<em>-T</em>) nor <em>-n</em> are 477the program being executed if neither <em>-title</em> (<em>-T</em>) nor <em>-n</em> are
477given on the command line. If this option is used, it must be the last 478given on the command line. If this option is used, it must be the last
478on the command-line. If there is no <strong>-e</strong> option then the default is to 479on the command-line. If there is no <strong>-e</strong> option then the default is to
479run the program specified by the <strong>SHELL</strong> environment variable or, 480run the program specified by the <strong>SHELL</strong> environment variable or,
483<p>Please note that you must specify a program with arguments. If you want to 484<p>Please note that you must specify a program with arguments. If you want to
484run shell commands, you have to specify the shell, like this:</p> 485run shell commands, you have to specify the shell, like this:</p>
485</dd> 486</dd>
486<dd> 487<dd>
487<pre> 488<pre>
488 urxvt -e sh -c &quot;shell commands&quot;</pre> 489 rxvt -e sh -c &quot;shell commands&quot;</pre>
489</dd> 490</dd>
490</li> 491</li>
491<dt><strong><a name="item__2dtitle_text"><strong>-title</strong> <em>text</em></a></strong> 492<dt><strong><a name="item__2dtitle_text"><strong>-title</strong> <em>text</em></a></strong>
492 493
493<dd> 494<dd>
578</dd> 579</dd>
579</li> 580</li>
580<dt><strong><a name="item__2dhold_7c_2bhold"><strong>-hold</strong>|<strong>+hold</strong></a></strong> 581<dt><strong><a name="item__2dhold_7c_2bhold"><strong>-hold</strong>|<strong>+hold</strong></a></strong>
581 582
582<dd> 583<dd>
583<p>Turn on/off hold window after exit support. If enabled, urxvt 584<p>Turn on/off hold window after exit support. If enabled, rxvt
584will not immediately destroy its window when the program executed within 585will not immediately destroy its window when the program executed within
585it exits. Instead, it will wait till it is being killed or closed by the 586it exits. Instead, it will wait till it is being killed or closed by the
586user; resource <strong>hold</strong>.</p> 587user; resource <strong>hold</strong>.</p>
587</dd> 588</dd>
588</li> 589</li>
593</dd> 594</dd>
594</li> 595</li>
595<dt><strong><a name="item__2dembed_windowid"><strong>-embed</strong> <em>windowid</em></a></strong> 596<dt><strong><a name="item__2dembed_windowid"><strong>-embed</strong> <em>windowid</em></a></strong>
596 597
597<dd> 598<dd>
598<p>Tells urxvt to embed its windows into an already-existing window, 599<p>Tells rxvt to embed its windows into an already-existing window,
599which enables applications to easily embed a terminal.</p> 600which enables applications to easily embed a terminal.</p>
600</dd> 601</dd>
601<dd> 602<dd>
602<p>Right now, urxvt will first unmap/map the specified window, so it 603<p>Right now, rxvt will first unmap/map the specified window, so it
603shouldn't be a top-level window. urxvt will also reconfigure it 604shouldn't be a top-level window. rxvt will also reconfigure it
604quite a bit, so don't expect it to keep some specific state. It's best to 605quite a bit, so don't expect it to keep some specific state. It's best to
605create an extra subwindow for urxvt and leave it alone.</p> 606create an extra subwindow for rxvt and leave it alone.</p>
606</dd>
607<dd> 607</dd>
608<dd>
608<p>The window will not be destroyed when urxvt exits.</p> 609<p>The window will not be destroyed when rxvt exits.</p>
609</dd>
610<dd> 610</dd>
611<dd>
611<p>It might be useful to know that urxvt will not close file 612<p>It might be useful to know that rxvt will not close file
612descriptors passed to it (except for stdin/out/err, of course), so you 613descriptors passed to it (except for stdin/out/err, of course), so you
613can use file descriptors to communicate with the programs within the 614can use file descriptors to communicate with the programs within the
614terminal. This works regardless of wether the <code>-embed</code> option was used or 615terminal. This works regardless of whether the <code>-embed</code> option was used or
615not.</p> 616not.</p>
616</dd> 617</dd>
617<dd> 618<dd>
618<p>Here is a short Gtk2-perl snippet that illustrates how this option can be 619<p>Here is a short Gtk2-perl snippet that illustrates how this option can be
619used (a longer example is in <em>doc/embed</em>):</p> 620used (a longer example is in <em>doc/embed</em>):</p>
621<dd> 622<dd>
622<pre> 623<pre>
623 my $rxvt = new Gtk2::Socket; 624 my $rxvt = new Gtk2::Socket;
624 $rxvt-&gt;signal_connect_after (realize =&gt; sub { 625 $rxvt-&gt;signal_connect_after (realize =&gt; sub {
625 my $xid = $_[0]-&gt;window-&gt;get_xid; 626 my $xid = $_[0]-&gt;window-&gt;get_xid;
626 system &quot;urxvt -embed $xid &amp;&quot;; 627 system &quot;rxvt -embed $xid &amp;&quot;;
627 });</pre> 628 });</pre>
628</dd> 629</dd>
629</li> 630</li>
630<dt><strong><a name="item__2dpty_2dfd_file_descriptor"><strong>-pty-fd</strong> <em>file descriptor</em></a></strong> 631<dt><strong><a name="item__2dpty_2dfd_file_descriptor"><strong>-pty-fd</strong> <em>file descriptor</em></a></strong>
631 632
632<dd> 633<dd>
633<p>Tells urxvt NOT to execute any commands or create a new pty/tty 634<p>Tells rxvt NOT to execute any commands or create a new pty/tty
634pair but instead use the given filehandle as the tty master. This is 635pair but instead use the given file descriptor as the tty master. This is
635useful if you want to drive urxvt as a generic terminal emulator 636useful if you want to drive rxvt as a generic terminal emulator
636without having to run a program within it.</p> 637without having to run a program within it.</p>
637</dd> 638</dd>
638<dd> 639<dd>
639<p>If this switch is given, urxvt will not create any utmp/wtmp 640<p>If this switch is given, rxvt will not create any utmp/wtmp
640entries and will not tinker with pty/tty permissions - you have to do that 641entries and will not tinker with pty/tty permissions - you have to do that
641yourself if you want that.</p> 642yourself if you want that.</p>
642</dd> 643</dd>
643<dd> 644<dd>
644<p>As an extremely special case, specifying <code>-1</code> will completely suppress 645<p>As an extremely special case, specifying <code>-1</code> will completely suppress
655</dd> 656</dd>
656<dd> 657<dd>
657<pre> 658<pre>
658 my $pty = new IO::Pty; 659 my $pty = new IO::Pty;
659 fcntl $pty, F_SETFD, 0; # clear close-on-exec 660 fcntl $pty, F_SETFD, 0; # clear close-on-exec
660 system &quot;urxvt -pty-fd &quot; . (fileno $pty) . &quot;&amp;&quot;; 661 system &quot;rxvt -pty-fd &quot; . (fileno $pty) . &quot;&amp;&quot;;
661 close $pty;</pre> 662 close $pty;</pre>
662</dd> 663</dd>
663<dd> 664<dd>
664<pre> 665<pre>
665 # now communicate with rxvt 666 # now communicate with rxvt
677</dl> 678</dl>
678<p> 679<p>
679</p> 680</p>
680<hr /> 681<hr />
681<h1><a name="resources__available_also_as_longoptions_">RESOURCES (available also as long-options)</a></h1> 682<h1><a name="resources__available_also_as_longoptions_">RESOURCES (available also as long-options)</a></h1>
682<p>Note: `urxvt --help' gives a list of all resources (long 683<p>Note: `rxvt --help' gives a list of all resources (long
683options) compiled into your version.</p> 684options) compiled into your version.</p>
684<p>You can set and change the resources using X11 tools like <strong>xrdb</strong>. Many 685<p>You can set and change the resources using X11 tools like <strong>xrdb</strong>. Many
685distribution do also load settings from the <strong>~/.Xresources</strong> file when X 686distribution do also load settings from the <strong>~/.Xresources</strong> file when X
686starts. urxvt will consult the following files/resources in order, 687starts. rxvt will consult the following files/resources in order,
687with later settings overwriting earlier ones:</p> 688with later settings overwriting earlier ones:</p>
688<pre> 689<pre>
689 1. system-wide app-defaults file, either locale-dependent OR global 690 1. system-wide app-defaults file, either locale-dependent OR global
690 2. app-defaults file in $XAPPLRESDIR 691 2. app-defaults file in $XAPPLRESDIR
691 3. RESOURCE_MANAGER property on root-window OR $HOME/.Xdefaults 692 3. RESOURCE_MANAGER property on root-window OR $HOME/.Xdefaults
692 4. SCREEN_RESOURCES for the current screen 693 4. SCREEN_RESOURCES for the current screen
693 5. $XENVIRONMENT file OR $HOME/.Xdefaults-&lt;nodename&gt;</pre> 694 5. $XENVIRONMENT file OR $HOME/.Xdefaults-&lt;nodename&gt;</pre>
694<p>Note that when reading X resources, <strong>urxvt</strong> recognizes two class 695<p>Note that when reading X resources, <strong>rxvt</strong> recognizes two class
695names: <strong>Rxvt</strong> and <strong>URxvt</strong>. The class name <strong>Rxvt</strong> allows resources 696names: <strong>Rxvt</strong> and <strong>URxvt</strong>. The class name <strong>Rxvt</strong> allows resources
696common to both <strong>urxvt</strong> and the original <em>rxvt</em> to be easily 697common to both <strong>rxvt</strong> and the original <em>rxvt</em> to be easily
697configured, while the class name <strong>URxvt</strong> allows resources unique to 698configured, while the class name <strong>URxvt</strong> allows resources unique to
698<strong>urxvt</strong>, to be shared between different <strong>urxvt</strong> 699<strong>rxvt</strong>, to be shared between different <strong>rxvt</strong>
699configurations. If no resources are specified, suitable defaults will 700configurations. If no resources are specified, suitable defaults will
700be used. Command-line arguments can be used to override resource 701be used. Command-line arguments can be used to override resource
701settings. The following resources are supported (you might want to 702settings. The following resources are supported (you might want to
702check the <code>urxvtperl(3)</code> manpage for additional settings by perl 703check the <code>rxvtperl(3)</code> manpage for additional settings by perl
703extensions not documented here):</p> 704extensions not documented here):</p>
704<dl> 705<dl>
705<dt><strong><a name="item_depth_3a_bitdepth"><strong>depth:</strong> <em>bitdepth</em></a></strong> 706<dt><strong><a name="item_depth_3a_bitdepth"><strong>depth:</strong> <em>bitdepth</em></a></strong>
706 707
707<dd> 708<dd>
7403=yellow, 4=blue, 5=magenta, 6=cyan, 7=white, but the actual colour 7413=yellow, 4=blue, 5=magenta, 6=cyan, 7=white, but the actual colour
741names used are listed in the <strong>COLORS AND GRAPHICS</strong> section.</p> 742names used are listed in the <strong>COLORS AND GRAPHICS</strong> section.</p>
742</dd> 743</dd>
743<dd> 744<dd>
744<p>Colours higher than 15 cannot be set using resources (yet), but can be 745<p>Colours higher than 15 cannot be set using resources (yet), but can be
745changed using an escape command (see urxvt(7)).</p> 746changed using an escape command (see rxvt(7)).</p>
746</dd> 747</dd>
747<dd> 748<dd>
748<p>Colours 16-79 form a standard 4x4x4 colour cube (the same as xterm with 749<p>Colours 16-79 form a standard 4x4x4 colour cube (the same as xterm with
74988 colour support). Colours 80-87 are evenly spaces grey steps.</p> 75088 colour support). Colours 80-87 are evenly spaces grey steps.</p>
750</dd> 751</dd>
971<dt><strong><a name="item_intensitystyles_3a_boolean"><strong>intensityStyles:</strong> <em>boolean</em></a></strong> 972<dt><strong><a name="item_intensitystyles_3a_boolean"><strong>intensityStyles:</strong> <em>boolean</em></a></strong>
972 973
973<dd> 974<dd>
974<p>When font styles are not enabled, or this option is enabled (<strong>True</strong>, 975<p>When font styles are not enabled, or this option is enabled (<strong>True</strong>,
975option <strong>-is</strong>, the default), bold and italic font styles imply high 976option <strong>-is</strong>, the default), bold and italic font styles imply high
976intensity foreground/backround colours. Disabling this option (<strong>False</strong>, 977intensity foreground/background colours. Disabling this option (<strong>False</strong>,
977option <strong>+is</strong>) disables this behaviour, the high intensity colours are not 978option <strong>+is</strong>) disables this behaviour, the high intensity colours are not
978reachable.</p> 979reachable.</p>
979</dd> 980</dd>
980</li> 981</li>
981<dt><strong><a name="item_selectstyle_3a_mode"><strong>selectstyle:</strong> <em>mode</em></a></strong> 982<dt><strong><a name="item_selectstyle_3a_mode"><strong>selectstyle:</strong> <em>mode</em></a></strong>
1056<pre> 1057<pre>
1057 URxvt.print-pipe: cat &gt; $(TMPDIR=$HOME mktemp urxvt.XXXXXX)</pre> 1058 URxvt.print-pipe: cat &gt; $(TMPDIR=$HOME mktemp urxvt.XXXXXX)</pre>
1058</dd> 1059</dd>
1059<dd> 1060<dd>
1060<p>This creates a new file in your home directory with the screen contents 1061<p>This creates a new file in your home directory with the screen contents
1061everytime you hit <code>Print</code>.</p> 1062every time you hit <code>Print</code>.</p>
1062</dd> 1063</dd>
1063</li> 1064</li>
1064<dt><strong><a name="item_scrollbar_3a_boolean"><strong>scrollBar:</strong> <em>boolean</em></a></strong> 1065<dt><strong><a name="item_scrollbar_3a_boolean"><strong>scrollBar:</strong> <em>boolean</em></a></strong>
1065 1066
1066<dd> 1067<dd>
1100<dt><strong><a name="item_scrollwithbuffer_3a_boolean"><strong>scrollWithBuffer:</strong> <em>boolean</em></a></strong> 1101<dt><strong><a name="item_scrollwithbuffer_3a_boolean"><strong>scrollWithBuffer:</strong> <em>boolean</em></a></strong>
1101 1102
1102<dd> 1103<dd>
1103<p><strong>True</strong>: scroll with scrollback buffer when tty receives new lines (and 1104<p><strong>True</strong>: scroll with scrollback buffer when tty receives new lines (and
1104<strong>scrollTtyOutput</strong> is False); option <strong>-sw</strong>. <strong>False</strong>: do not scroll 1105<strong>scrollTtyOutput</strong> is False); option <strong>-sw</strong>. <strong>False</strong>: do not scroll
1105with scrollback buffer when tty recieves new lines; option <strong>+sw</strong>.</p> 1106with scrollback buffer when tty receives new lines; option <strong>+sw</strong>.</p>
1106</dd> 1107</dd>
1107</li> 1108</li>
1108<dt><strong><a name="item_scrollttykeypress_3a_boolean"><strong>scrollTtyKeypress:</strong> <em>boolean</em></a></strong> 1109<dt><strong><a name="item_scrollttykeypress_3a_boolean"><strong>scrollTtyKeypress:</strong> <em>boolean</em></a></strong>
1109 1110
1110<dd> 1111<dd>
1243<p>The characters used as delimiters for double-click word selection 1244<p>The characters used as delimiters for double-click word selection
1244(whitespace delimiting is added automatically if resource is given).</p> 1245(whitespace delimiting is added automatically if resource is given).</p>
1245</dd> 1246</dd>
1246<dd> 1247<dd>
1247<p>When the selection extension is in use (the default if compiled in, see 1248<p>When the selection extension is in use (the default if compiled in, see
1248the <code>urxvtperl(3)</code> manpage), a suitable regex using these characters 1249the <code>rxvtperl(3)</code> manpage), a suitable regex using these characters
1249will be created (if the resource exists, otherwise, no regex will be 1250will be created (if the resource exists, otherwise, no regex will be
1250created). In this mode, characters outside ISO-8859-1 can be used.</p> 1251created). In this mode, characters outside ISO-8859-1 can be used.</p>
1251</dd> 1252</dd>
1252<dd> 1253<dd>
1253<p>When the selection extension is not used, only ISO-8859-1 characters can 1254<p>When the selection extension is not used, only ISO-8859-1 characters can
1282 1283
1283<dd> 1284<dd>
1284<p>Specify the font-set used for XIM styles <code>OverTheSpot</code> or 1285<p>Specify the font-set used for XIM styles <code>OverTheSpot</code> or
1285<code>OffTheSpot</code>. It must be a standard X font set (XLFD patterns separated 1286<code>OffTheSpot</code>. It must be a standard X font set (XLFD patterns separated
1286by commas), i.e. it's not in the same format as the other font lists used 1287by commas), i.e. it's not in the same format as the other font lists used
1287in urxvt. The default will be set-up to chose *any* suitable found 1288in rxvt. The default will be set-up to chose *any* suitable found
1288found, preferably one or two pixels differing in size to the base font. 1289found, preferably one or two pixels differing in size to the base font.
1289option <strong>-imfont</strong>.</p> 1290option <strong>-imfont</strong>.</p>
1290</dd> 1291</dd>
1291</li> 1292</li>
1292<dt><strong><a name="item_tripleclickwords_3a_boolean"><strong>tripleclickwords:</strong> <em>boolean</em></a></strong> 1293<dt><strong><a name="item_tripleclickwords_3a_boolean"><strong>tripleclickwords:</strong> <em>boolean</em></a></strong>
1346</dd> 1347</dd>
1347</li> 1348</li>
1348<dt><strong><a name="item_hold_3a_boolean"><strong>hold</strong>: <em>boolean</em></a></strong> 1349<dt><strong><a name="item_hold_3a_boolean"><strong>hold</strong>: <em>boolean</em></a></strong>
1349 1350
1350<dd> 1351<dd>
1351<p>Turn on/off hold window after exit support. If enabled, urxvt 1352<p>Turn on/off hold window after exit support. If enabled, rxvt
1352will not immediately destroy its window when the program executed within 1353will not immediately destroy its window when the program executed within
1353it exits. Instead, it will wait till it is being killed or closed by the 1354it exits. Instead, it will wait till it is being killed or closed by the
1354user.</p> 1355user.</p>
1355</dd> 1356</dd>
1356</li> 1357</li>
1388can start or end with whitespace.</p> 1389can start or end with whitespace.</p>
1389</dd> 1390</dd>
1390<dd> 1391<dd>
1391<p>Please note that you need to double the <code>\</code> in resource files, as 1392<p>Please note that you need to double the <code>\</code> in resource files, as
1392Xlib itself does its own de-escaping (you can use <code>\033</code> instead of 1393Xlib itself does its own de-escaping (you can use <code>\033</code> instead of
1393<code>\e</code> (and so on), which will work with both Xt and urxvt's own 1394<code>\e</code> (and so on), which will work with both Xt and rxvt's own
1394processing).</p> 1395processing).</p>
1395</dd> 1396</dd>
1396<dd> 1397<dd>
1397<p>You can define a range of keysyms in one shot by providing a <em>string</em> 1398<p>You can define a range of keysyms in one shot by providing a <em>string</em>
1398with pattern <strong>list/PREFIX/MIDDLE/SUFFIX</strong>, where the delimeter `/' 1399with pattern <strong>list/PREFIX/MIDDLE/SUFFIX</strong>, where the delimiter `/'
1399should be a character not used by the strings.</p> 1400should be a character not used by the strings.</p>
1400</dd> 1401</dd>
1401<dd> 1402<dd>
1402<p>Its usage can be demonstrated by an example:</p> 1403<p>Its usage can be demonstrated by an example:</p>
1403</dd> 1404</dd>
1414 URxvt.keysym.Meta-Control-0x62: \033&lt;M-C-b&gt; 1415 URxvt.keysym.Meta-Control-0x62: \033&lt;M-C-b&gt;
1415 URxvt.keysym.Meta-Control-0x63: \033&lt;M-C-c&gt;</pre> 1416 URxvt.keysym.Meta-Control-0x63: \033&lt;M-C-c&gt;</pre>
1416</dd> 1417</dd>
1417<dd> 1418<dd>
1418<p>If <em>string</em> takes the form of <code>command:STRING</code>, the specified <strong>STRING</strong> 1419<p>If <em>string</em> takes the form of <code>command:STRING</code>, the specified <strong>STRING</strong>
1419is interpreted and executed as urxvt's control sequence. For 1420is interpreted and executed as rxvt's control sequence. For
1420example the following means ``change the current locale to <code>zh_CN.GBK</code> 1421example the following means ``change the current locale to <code>zh_CN.GBK</code>
1421when Control-Meta-c is being pressed'':</p> 1422when Control-Meta-c is being pressed'':</p>
1422</dd> 1423</dd>
1423<dd> 1424<dd>
1424<pre> 1425<pre>
1425 URxvt.keysym.M-C-c: command:\033]701;zh_CN.GBK\007</pre> 1426 URxvt.keysym.M-C-c: command:\033]701;zh_CN.GBK\007</pre>
1426</dd> 1427</dd>
1427<dd> 1428<dd>
1428<p>If <em>string</em> takes the form <code>perl:STRING</code>, then the specified <strong>STRING</strong> 1429<p>If <em>string</em> takes the form <code>perl:STRING</code>, then the specified <strong>STRING</strong>
1429is passed to the <code>on_keyboard_command</code> perl handler. See the <code>urxvtperl(3)</code> 1430is passed to the <code>on_keyboard_command</code> perl handler. See the <code>rxvtperl(3)</code>
1430manpage. For example, the <em>selection</em> extension (activated via 1431manpage. For example, the <em>selection</em> extension (activated via
1431<code>urxvt -pe selection</code>) listens for <code>selection:rot13</code> events:</p> 1432<code>rxvt -pe selection</code>) listens for <code>selection:rot13</code> events:</p>
1432</dd> 1433</dd>
1433<dd> 1434<dd>
1434<pre> 1435<pre>
1435 URxvt.keysym.M-C-c: perl:selection:rot13</pre> 1436 URxvt.keysym.M-C-c: perl:selection:rot13</pre>
1436</dd> 1437</dd>
1442definitions for <code>Meta-a</code>, <code>Shift-a</code> and so on, unless some of those are defined 1443definitions for <code>Meta-a</code>, <code>Shift-a</code> and so on, unless some of those are defined
1443mappings themselves.</p> 1444mappings themselves.</p>
1444</dd> 1445</dd>
1445<dd> 1446<dd>
1446<p>Unfortunately, this will override built-in key mappings. For example 1447<p>Unfortunately, this will override built-in key mappings. For example
1447if you overwrite the <code>Insert</code> key you will disable urxvt's 1448if you overwrite the <code>Insert</code> key you will disable rxvt's
1448<code>Shift-Insert</code> mapping. To re-enable that, you can poke ``holes'' into the 1449<code>Shift-Insert</code> mapping. To re-enable that, you can poke ``holes'' into the
1449user-defined keymap using the <code>builtin:</code> replacement:</p> 1450user-defined keymap using the <code>builtin:</code> replacement:</p>
1450</dd> 1451</dd>
1451<dd> 1452<dd>
1452<pre> 1453<pre>
1467<pre> 1468<pre>
1468 URxvt.keysym.M-C-1: command:\033]50;suxuseuro\007 1469 URxvt.keysym.M-C-1: command:\033]50;suxuseuro\007
1469 URxvt.keysym.M-C-2: command:\033]50;9x15bold\007</pre> 1470 URxvt.keysym.M-C-2: command:\033]50;9x15bold\007</pre>
1470</dd> 1471</dd>
1471<dd> 1472<dd>
1472<p>Other things are possible, e.g. resizing (see <code>urxvt(7)</code> for more 1473<p>Other things are possible, e.g. resizing (see <code>rxvt(7)</code> for more
1473info):</p> 1474info):</p>
1474</dd> 1475</dd>
1475<dd> 1476<dd>
1476<pre> 1477<pre>
1477 URxvt.keysym.M-C-3: command:\033[8;25;80t 1478 URxvt.keysym.M-C-3: command:\033[8;25;80t
1494<code>selection</code>.</p> 1495<code>selection</code>.</p>
1495</dd> 1496</dd>
1496<dd> 1497<dd>
1497<p>Extension names can also be followed by an argument in angle brackets 1498<p>Extension names can also be followed by an argument in angle brackets
1498(e.g. <code>searchable-scrollback&lt;M-s&gt;</code>, which binds the hotkey for 1499(e.g. <code>searchable-scrollback&lt;M-s&gt;</code>, which binds the hotkey for
1499searchable scorllback to Alt/Meta-s). Mentioning the same extension 1500searchable scrollback to Alt/Meta-s). Mentioning the same extension
1500multiple times with different arguments will pass multiple arguments to 1501multiple times with different arguments will pass multiple arguments to
1501the extension.</p> 1502the extension.</p>
1502</dd> 1503</dd>
1503<dd> 1504<dd>
1504<p>Each extension is looked up in the library directories, loaded if 1505<p>Each extension is looked up in the library directories, loaded if
1513</li> 1514</li>
1514<dt><strong><a name="item_perl_2deval_3a_string"><strong>perl-eval</strong>: <em>string</em></a></strong> 1515<dt><strong><a name="item_perl_2deval_3a_string"><strong>perl-eval</strong>: <em>string</em></a></strong>
1515 1516
1516<dd> 1517<dd>
1517<p>Perl code to be evaluated when all extensions have been registered. See 1518<p>Perl code to be evaluated when all extensions have been registered. See
1518the <code>urxvtperl(3)</code> manpage. Due to security reasons, this resource 1519the <code>rxvtperl(3)</code> manpage. Due to security reasons, this resource
1519will be ignored when running setuid/setgid.</p> 1520will be ignored when running setuid/setgid.</p>
1520</dd> 1521</dd>
1521</li> 1522</li>
1522<dt><strong><a name="item_perl_2dlib_3a_path"><strong>perl-lib</strong>: <em>path</em></a></strong> 1523<dt><strong><a name="item_perl_2dlib_3a_path"><strong>perl-lib</strong>: <em>path</em></a></strong>
1523 1524
1524<dd> 1525<dd>
1525<p>Colon-separated list of additional directories that hold extension 1526<p>Colon-separated list of additional directories that hold extension
1526scripts. When looking for extensions specified by the <code>perl</code> resource, 1527scripts. When looking for extensions specified by the <code>perl</code> resource,
1527urxvt will first look in these directories and then in 1528rxvt will first look in these directories and then in
1528<em>/usr/local/lib/urxvt/perl/</em>. Due to security reasons, this resource 1529<em>/opt/rxvt/lib/urxvt/perl/</em>. Due to security reasons, this resource
1529will be ignored when running setuid/setgid.</p> 1530will be ignored when running setuid/setgid.</p>
1530</dd> 1531</dd>
1531<dd> 1532<dd>
1532<p>See the <code>urxvtperl(3)</code> manpage.</p> 1533<p>See the <code>rxvtperl(3)</code> manpage.</p>
1533</dd> 1534</dd>
1534</li> 1535</li>
1535<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> 1536<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>
1536 1537
1537<dd> 1538<dd>
1538<p>Additional selection patterns, see the <code>urxvtperl(3)</code> manpage for 1539<p>Additional selection patterns, see the <code>rxvtperl(3)</code> manpage for
1539details.</p> 1540details.</p>
1540</dd> 1541</dd>
1541</li> 1542</li>
1542<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> 1543<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>
1543 1544
1544<dd> 1545<dd>
1545<p>Selection auto-transform patterns, see the <code>urxvtperl(3)</code> manpage 1546<p>Selection auto-transform patterns, see the <code>rxvtperl(3)</code> manpage
1546for details.</p> 1547for details.</p>
1547</dd> 1548</dd>
1548</li> 1549</li>
1549<dt><strong><a name="item_searchable_2dscrollback_3a_keysym"><strong>searchable-scrollback:</strong> <em>keysym</em></a></strong> 1550<dt><strong><a name="item_searchable_2dscrollback_3a_keysym"><strong>searchable-scrollback:</strong> <em>keysym</em></a></strong>
1550 1551
1576</dl> 1577</dl>
1577<p> 1578<p>
1578</p> 1579</p>
1579<hr /> 1580<hr />
1580<h1><a name="the_scrollbar">THE SCROLLBAR</a></h1> 1581<h1><a name="the_scrollbar">THE SCROLLBAR</a></h1>
1581<p>Lines of text that scroll off the top of the <strong>urxvt</strong> window 1582<p>Lines of text that scroll off the top of the <strong>rxvt</strong> window
1582(resource: <strong>saveLines</strong>) and can be scrolled back using the scrollbar 1583(resource: <strong>saveLines</strong>) and can be scrolled back using the scrollbar
1583or by keystrokes. The normal <strong>urxvt</strong> scrollbar has arrows and 1584or by keystrokes. The normal <strong>rxvt</strong> scrollbar has arrows and
1584its behaviour is fairly intuitive. The <strong>xterm-scrollbar</strong> is without 1585its behaviour is fairly intuitive. The <strong>xterm-scrollbar</strong> is without
1585arrows and its behaviour mimics that of <em>xterm</em></p> 1586arrows and its behaviour mimics that of <em>xterm</em></p>
1586<p>Scroll down with <strong>Button1</strong> (<strong>xterm-scrollbar</strong>) or <strong>Shift-Next</strong>. 1587<p>Scroll down with <strong>Button1</strong> (<strong>xterm-scrollbar</strong>) or <strong>Shift-Next</strong>.
1587Scroll up with <strong>Button3</strong> (<strong>xterm-scrollbar</strong>) or <strong>Shift-Prior</strong>. 1588Scroll up with <strong>Button3</strong> (<strong>xterm-scrollbar</strong>) or <strong>Shift-Prior</strong>.
1588Continuous scroll with <strong>Button2</strong>.</p> 1589Continuous scroll with <strong>Button2</strong>.</p>
1624</dd> 1625</dd>
1625</li> 1626</li>
1626<dt><strong><a name="item_insertion_3a"><strong>Insertion</strong>:</a></strong> 1627<dt><strong><a name="item_insertion_3a"><strong>Insertion</strong>:</a></strong>
1627 1628
1628<dd> 1629<dd>
1629<p>Pressing and releasing the Middle mouse button in an <strong>urxvt</strong> 1630<p>Pressing and releasing the Middle mouse button in an <strong>rxvt</strong>
1630window causes the value of the PRIMARY selection (or CLIPBOARD with the 1631window causes the value of the PRIMARY selection (or CLIPBOARD with the
1631Meta modifier) to be inserted as if it had been typed on the keyboard.</p> 1632Meta modifier) to be inserted as if it had been typed on the keyboard.</p>
1632</dd> 1633</dd>
1633<dd> 1634<dd>
1634<p>Pressing <strong>Shift-Insert</strong> causes the value of the PRIMARY selection to be 1635<p>Pressing <strong>Shift-Insert</strong> causes the value of the PRIMARY selection to be
1710both scenario A and B of ISO 14755, including part 5.2.</p> 1711both scenario A and B of ISO 14755, including part 5.2.</p>
1711<p> 1712<p>
1712</p> 1713</p>
1713<hr /> 1714<hr />
1714<h1><a name="login_stamp">LOGIN STAMP</a></h1> 1715<h1><a name="login_stamp">LOGIN STAMP</a></h1>
1715<p><strong>urxvt</strong> tries to write an entry into the <em>utmp</em>(5) file so that 1716<p><strong>rxvt</strong> tries to write an entry into the <em>utmp</em>(5) file so that
1716it can be seen via the <em>who(1)</em> command, and can accept messages. To 1717it can be seen via the <em>who(1)</em> command, and can accept messages. To
1717allow this feature, <strong>urxvt</strong> may need to be installed setuid root 1718allow this feature, <strong>rxvt</strong> may need to be installed setuid root
1718on some systems or setgid to root or to some other group on others.</p> 1719on some systems or setgid to root or to some other group on others.</p>
1719<p> 1720<p>
1720</p> 1721</p>
1721<hr /> 1722<hr />
1722<h1><a name="colors_and_graphics">COLORS AND GRAPHICS</a></h1> 1723<h1><a name="colors_and_graphics">COLORS AND GRAPHICS</a></h1>
1723<p>In addition to the default foreground and background colours, 1724<p>In addition to the default foreground and background colours,
1724<strong>urxvt</strong> can display up to 16 colours (8 ANSI colours plus 1725<strong>rxvt</strong> can display up to 16 colours (8 ANSI colours plus
1725high-intensity bold/blink versions of the same). Here is a list of the 1726high-intensity bold/blink versions of the same). Here is a list of the
1726colours with their names.</p> 1727colours with their names.</p>
1727<table> 1728<table>
1728<tr><td>color0</td><td>(black)</td><td>= Black</td></tr> 1729<tr><td>color0</td><td>(black)</td><td>= Black</td></tr>
1729<tr><td>color1</td><td>(red)</td><td>= Red3</td></tr> 1730<tr><td>color1</td><td>(red)</td><td>= Red3</td></tr>
1745<tr><td>background</td><td></td><td>= White</td></tr> 1746<tr><td>background</td><td></td><td>= White</td></tr>
1746</table><p>It is also possible to specify the colour values of <strong>foreground</strong>, 1747</table><p>It is also possible to specify the colour values of <strong>foreground</strong>,
1747<strong>background</strong>, <strong>cursorColor</strong>, <strong>cursorColor2</strong>, <strong>colorBD</strong>, <strong>colorUL</strong> as 1748<strong>background</strong>, <strong>cursorColor</strong>, <strong>cursorColor2</strong>, <strong>colorBD</strong>, <strong>colorUL</strong> as
1748a number 0-15, as a convenient shorthand to reference the colour name of 1749a number 0-15, as a convenient shorthand to reference the colour name of
1749color0-color15.</p> 1750color0-color15.</p>
1750<p>In addition to the colours defined above, urxvt offers an 1751<p>In addition to the colours defined above, rxvt offers an
1751additional 72 colours. The first 64 of those (with indices 16 to 79) 1752additional 72 colours. The first 64 of those (with indices 16 to 79)
1752consist of a 4*4*4 RGB colour cube (i.e. <em>index = r * 16 + g * 4 + b + 1753consist of a 4*4*4 RGB colour cube (i.e. <em>index = r * 16 + g * 4 + b +
175316</em>), followed by 8 additional shades of gray (with indices 80 to 87).</p> 175416</em>), followed by 8 additional shades of gray (with indices 80 to 87).</p>
1754<p>Together, all those colours implement the 88 colour xterm colours. Only 1755<p>Together, all those colours implement the 88 colour xterm colours. Only
1755the first 16 can be changed using resources currently, the rest can only 1756the first 16 can be changed using resources currently, the rest can only
1757<p>Note that <strong>-rv</strong> (<strong>``reverseVideo: True''</strong>) simulates reverse video by 1758<p>Note that <strong>-rv</strong> (<strong>``reverseVideo: True''</strong>) simulates reverse video by
1758always swapping the foreground/background colours. This is in contrast to 1759always swapping the foreground/background colours. This is in contrast to
1759<em>xterm</em>(1) where the colours are only swapped if they have not otherwise 1760<em>xterm</em>(1) where the colours are only swapped if they have not otherwise
1760been specified. For example,</p> 1761been specified. For example,</p>
1761<dl> 1762<dl>
1762<dt><strong><a name="item_urxvt__2dfg_black__2dbg_white__2drv"><strong>urxvt -fg Black -bg White -rv</strong></a></strong> 1763<dt><strong><a name="item_rxvt__2dfg_black__2dbg_white__2drv"><strong>rxvt -fg Black -bg White -rv</strong></a></strong>
1763 1764
1764<dd> 1765<dd>
1765<p>would yield White on Black, while on <em>xterm</em>(1) it would yield Black 1766<p>would yield White on Black, while on <em>xterm</em>(1) it would yield Black
1766on White.</p> 1767on White.</p>
1767</dd> 1768</dd>
1781your X-server uses ARGB pixel layout, as X is far from just supporting 1782your X-server uses ARGB pixel layout, as X is far from just supporting
1782ARGB visuals out of the box, and rxvt-unicode just fudges around.</p> 1783ARGB visuals out of the box, and rxvt-unicode just fudges around.</p>
1783<p>For example, the following selects an almost completely transparent red 1784<p>For example, the following selects an almost completely transparent red
1784background, and an almost opaque pink foreground:</p> 1785background, and an almost opaque pink foreground:</p>
1785<pre> 1786<pre>
1786 urxvt -depth 32 -bg rgba:0000/0000/0000/2222 -fg &quot;[e]pink&quot;</pre> 1787 rxvt -depth 32 -bg rgba:0000/0000/0000/2222 -fg &quot;[e]pink&quot;</pre>
1787<p><em>Please note that transparency of any kind if completely unsupported by 1788<p><em>Please note that transparency of any kind if completely unsupported by
1788the author. Don't bug him with installation questions!</em></p> 1789the author. Don't bug him with installation questions!</em></p>
1789<p> 1790<p>
1790</p> 1791</p>
1791<hr /> 1792<hr />
1792<h1><a name="environment">ENVIRONMENT</a></h1> 1793<h1><a name="environment">ENVIRONMENT</a></h1>
1793<p><strong>urxvt</strong> sets and/or uses the following environment variables:</p> 1794<p><strong>rxvt</strong> sets and/or uses the following environment variables:</p>
1794<dl> 1795<dl>
1795<dt><strong><a name="item_term"><strong>TERM</strong></a></strong> 1796<dt><strong><a name="item_term"><strong>TERM</strong></a></strong>
1796 1797
1797<dd> 1798<dd>
1798<p>Normally set to <code>rxvt-unicode</code>, unless overwritten at configure time, via 1799<p>Normally set to <code>rxvt-unicode</code>, unless overwritten at configure time, via
1799resources or on the commandline.</p> 1800resources or on the command line.</p>
1800</dd> 1801</dd>
1801</li> 1802</li>
1802<dt><strong><a name="item_colorterm"><strong>COLORTERM</strong></a></strong> 1803<dt><strong><a name="item_colorterm"><strong>COLORTERM</strong></a></strong>
1803 1804
1804<dd> 1805<dd>
1805<p>Either <code>rxvt</code>, <code>rxvt-xpm</code>, depending on wether urxvt was 1806<p>Either <code>rxvt</code>, <code>rxvt-xpm</code>, depending on whether rxvt was
1806compiled with XPM support, and optionally with the added extension 1807compiled with XPM support, and optionally with the added extension
1807<code>-mono</code> to indicate that rxvt-unicode runs on a monochrome screen.</p> 1808<code>-mono</code> to indicate that rxvt-unicode runs on a monochrome screen.</p>
1808</dd> 1809</dd>
1809</li> 1810</li>
1810<dt><strong><a name="item_colorfgbg"><strong>COLORFGBG</strong></a></strong> 1811<dt><strong><a name="item_colorfgbg"><strong>COLORFGBG</strong></a></strong>
1812<dd> 1813<dd>
1813<p>Set to a string of the form <code>fg;bg</code> or <code>fg;xpm;bg</code>, where <code>fg</code> is 1814<p>Set to a string of the form <code>fg;bg</code> or <code>fg;xpm;bg</code>, where <code>fg</code> is
1814the colour code used as default foreground/text colour (or the string 1815the colour code used as default foreground/text colour (or the string
1815<code>default</code> to indicate that the default-colour escape sequence is to be 1816<code>default</code> to indicate that the default-colour escape sequence is to be
1816used), <code>bg</code> is the colour code used as default background colour (or the 1817used), <code>bg</code> is the colour code used as default background colour (or the
1817string <code>default</code>), and <code>xpm</code> is the string <code>default</code> if urxvt 1818string <code>default</code>), and <code>xpm</code> is the string <code>default</code> if rxvt
1818was compiled with XPM support. Libraries like <code>ncurses</code> and <code>slang</code> can 1819was compiled with XPM support. Libraries like <code>ncurses</code> and <code>slang</code> can
1819(and do) use this information to optimize screen output.</p> 1820(and do) use this information to optimize screen output.</p>
1820</dd> 1821</dd>
1821</li> 1822</li>
1822<dt><strong><a name="item_windowid"><strong>WINDOWID</strong></a></strong> 1823<dt><strong><a name="item_windowid"><strong>WINDOWID</strong></a></strong>
1823 1824
1824<dd> 1825<dd>
1825<p>Set to the (decimal) X Window ID of the urxvt window (the toplevel 1826<p>Set to the (decimal) X Window ID of the rxvt window (the toplevel
1826window, which usually has subwindows for the scrollbar, the terminal 1827window, which usually has subwindows for the scrollbar, the terminal
1827window and so on).</p> 1828window and so on).</p>
1828</dd> 1829</dd>
1829</li> 1830</li>
1830<dt><strong><a name="item_terminfo"><strong>TERMINFO</strong></a></strong> 1831<dt><strong><a name="item_terminfo"><strong>TERMINFO</strong></a></strong>
1831 1832
1832<dd> 1833<dd>
1833<p>Set to the terminfo directory iff urxvt was configured with 1834<p>Set to the terminfo directory iff rxvt was configured with
1834<code>--with-terminfo=PATH</code>.</p> 1835<code>--with-terminfo=PATH</code>.</p>
1835</dd> 1836</dd>
1836</li> 1837</li>
1837<dt><strong><a name="item_display"><strong>DISPLAY</strong></a></strong> 1838<dt><strong><a name="item_display"><strong>DISPLAY</strong></a></strong>
1838 1839
1839<dd> 1840<dd>
1840<p>Used by urxvt to connect to the display and set to the correct 1841<p>Used by rxvt to connect to the display and set to the correct
1841display in its child processes.</p> 1842display in its child processes.</p>
1842</dd> 1843</dd>
1843</li> 1844</li>
1844<dt><strong><a name="item_shell"><strong>SHELL</strong></a></strong> 1845<dt><strong><a name="item_shell"><strong>SHELL</strong></a></strong>
1845 1846
1848</dd> 1849</dd>
1849</li> 1850</li>
1850<dt><strong><a name="item_rxvt_socket"><strong>RXVT_SOCKET</strong></a></strong> 1851<dt><strong><a name="item_rxvt_socket"><strong>RXVT_SOCKET</strong></a></strong>
1851 1852
1852<dd> 1853<dd>
1853<p>The unix domain socket path used by <code>urxvtc(1)</code> and 1854<p>The unix domain socket path used by <code>rxvtc(1)</code> and
1854urxvtd(1).</p> 1855rxvtd(1).</p>
1855</dd> 1856</dd>
1856<dd> 1857<dd>
1857<p>Default <em>$HOME/.rxvt-unicode-<em>&lt;nodename </em></em> &gt;&gt;&gt;.</p> 1858<p>Default <em>$HOME/.rxvt-unicode-<em>&lt;nodename </em></em> &gt;&gt;&gt;.</p>
1858</dd> 1859</dd>
1859</li> 1860</li>
1873</li> 1874</li>
1874<dt><strong><a name="item_xenvironment"><strong>XENVIRONMENT</strong></a></strong> 1875<dt><strong><a name="item_xenvironment"><strong>XENVIRONMENT</strong></a></strong>
1875 1876
1876<dd> 1877<dd>
1877<p>If set and accessible, gives the name of a X resource file to be loaded by 1878<p>If set and accessible, gives the name of a X resource file to be loaded by
1878urxvt.</p> 1879rxvt.</p>
1879</dd> 1880</dd>
1880</li> 1881</li>
1881</dl> 1882</dl>
1882<p> 1883<p>
1883</p> 1884</p>
1893</dl> 1894</dl>
1894<p> 1895<p>
1895</p> 1896</p>
1896<hr /> 1897<hr />
1897<h1><a name="see_also">SEE ALSO</a></h1> 1898<h1><a name="see_also">SEE ALSO</a></h1>
1898<p>urxvt(7), urxvtc(1), urxvtd(1), xterm(1), sh(1), resize(1), X(1), pty(4), tty(4), <code>utmp(5)</code></p> 1899<p>rxvt(7), rxvtc(1), rxvtd(1), xterm(1), sh(1), resize(1), X(1), pty(4), tty(4), <code>utmp(5)</code></p>
1899<p> 1900<p>
1900</p> 1901</p>
1901<hr /> 1902<hr />
1902<h1><a name="current_project_coordinator">CURRENT PROJECT COORDINATOR</a></h1> 1903<h1><a name="current_project_coordinator">CURRENT PROJECT COORDINATOR</a></h1>
1903<dl> 1904<dl>

Diff Legend

Removed lines
+ Added lines
< Changed lines
> Changed lines