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.45 by root, Fri Jan 13 12:40:46 2006 UTC vs.
Revision 1.52 by root, Wed Jan 25 21:48:47 2006 UTC

41<p>rxvt-unicode (ouR XVT, unicode) - (a VT102 emulator for the X window system)</p> 41<p>rxvt-unicode (ouR XVT, unicode) - (a VT102 emulator for the X window system)</p>
42<p> 42<p>
43</p> 43</p>
44<hr /> 44<hr />
45<h1><a name="synopsis">SYNOPSIS</a></h1> 45<h1><a name="synopsis">SYNOPSIS</a></h1>
46<p><strong>urxvt</strong> [options] [-e command [ args ]]</p> 46<p><strong>rxvt</strong> [options] [-e command [ args ]]</p>
47<p> 47<p>
48</p> 48</p>
49<hr /> 49<hr />
50<h1><a name="description">DESCRIPTION</a></h1> 50<h1><a name="description">DESCRIPTION</a></h1>
51<p><strong>rxvt-unicode</strong>, version <strong>7.0</strong>, is a colour vt102 terminal 51<p><strong>rxvt-unicode</strong>, version <strong>7.3</strong>, is a colour vt102 terminal
52emulator intended as an <em>xterm</em>(1) replacement for users who do not 52emulator intended as an <em>xterm</em>(1) replacement for users who do not
53require features such as Tektronix 4014 emulation and toolkit-style 53require features such as Tektronix 4014 emulation and toolkit-style
54configurability. As a result, <strong>rxvt-unicode</strong> uses much less swap space -- 54configurability. As a result, <strong>rxvt-unicode</strong> uses much less swap space --
55a significant advantage on a machine serving many X sessions.</p> 55a significant advantage on a machine serving many X sessions.</p>
56<p> 56<p>
57</p> 57</p>
58<hr /> 58<hr />
59<h1><a name="frequently_asked_questions">FREQUENTLY ASKED QUESTIONS</a></h1> 59<h1><a name="frequently_asked_questions">FREQUENTLY ASKED QUESTIONS</a></h1>
60<p>See <code>urxvt(7)</code> (try <code>man 7 urxvt</code>) for a list of 60<p>See <code>rxvt(7)</code> (try <code>man 7 rxvt</code>) for a list of
61frequently asked questions and answer to them and some common 61frequently asked questions and answer to them and some common
62problems. That document is also accessible on the World-Wide-Web at 62problems. That document is also accessible on the World-Wide-Web at
63<a href="http://cvs.schmorp.de/browse/*checkout*/rxvt-unicode/doc/rxvt.7.html">http://cvs.schmorp.de/browse/*checkout*/rxvt-unicode/doc/rxvt.7.html</a>.</p> 63<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>
64<p> 64<p>
65</p> 65</p>
93<p>It is still faithfully following the original rxvt idea of being lean 93<p>It is still faithfully following the original rxvt idea of being lean
94and nice on resources: for example, you can still configure rxvt-unicode 94and nice on resources: for example, you can still configure rxvt-unicode
95without most of it's features to get a lean binary. It also comes with 95without most of it's features to get a lean binary. It also comes with
96a client/daemon pair that lets you open any number of terminal windows 96a client/daemon pair that lets you open any number of terminal windows
97from within a single process, which makes startup time very fast and 97from within a single process, which makes startup time very fast and
98drastically reduces memory usage. See <code>urxvtd(1)</code> (daemon) and 98drastically reduces memory usage. See <code>rxvtd(1)</code> (daemon) and
99<code>urxvtc(1)</code> (client).</p> 99<code>rxvtc(1)</code> (client).</p>
100<p>It also makes technical information about escape sequences (which have 100<p>It also makes technical information about escape sequences (which have
101been extended) easier accessible: see <code>urxvt(7)</code> for technical 101been extended) easier accessible: see <code>rxvt(7)</code> for technical
102reference documentation (escape sequences etc.).</p> 102reference documentation (escape sequences etc.).</p>
103<p> 103<p>
104</p> 104</p>
105<hr /> 105<hr />
106<h1><a name="options">OPTIONS</a></h1> 106<h1><a name="options">OPTIONS</a></h1>
107<p>The <strong>urxvt</strong> options (mostly a subset of <em>xterm</em>'s) are listed 107<p>The <strong>rxvt</strong> options (mostly a subset of <em>xterm</em>'s) are listed
108below. In keeping with the smaller-is-better philosophy, options may be 108below. In keeping with the smaller-is-better philosophy, options may be
109eliminated or default values chosen at compile-time, so options and 109eliminated or default values chosen at compile-time, so options and
110defaults listed may not accurately reflect the version installed on 110defaults listed may not accurately reflect the version installed on
111your system. `urxvt -h' gives a list of major compile-time options on 111your system. `rxvt -h' gives a list of major compile-time options on
112the <em>Options</em> line. Option descriptions may be prefixed with which 112the <em>Options</em> line. Option descriptions may be prefixed with which
113compile option each is dependent upon. e.g. `Compile <em>XIM</em>:' requires 113compile option each is dependent upon. e.g. `Compile <em>XIM</em>:' requires
114<em>XIM</em> on the <em>Options</em> line. Note: `urxvt -help' gives a list of all 114<em>XIM</em> on the <em>Options</em> line. Note: `rxvt -help' gives a list of all
115command-line options compiled into your version.</p> 115command-line options compiled into your version.</p>
116<p>Note that <strong>urxvt</strong> permits the resource name to be used as a 116<p>Note that <strong>rxvt</strong> permits the resource name to be used as a
117long-option (--/++ option) so the potential command-line options are 117long-option (--/++ option) so the potential command-line options are
118far greater than those listed. For example: `urxvt --loginShell --color1 118far greater than those listed. For example: `rxvt --loginShell --color1
119Orange'.</p> 119Orange'.</p>
120<p>The following options are available:</p> 120<p>The following options are available:</p>
121<dl> 121<dl>
122<dt><strong><a name="item__2dhelp_2c__2d_2dhelp"><strong>-help</strong>, <strong>--help</strong></a></strong><br /> 122<dt><strong><a name="item__2dhelp_2c__2d_2dhelp"><strong>-help</strong>, <strong>--help</strong></a></strong><br />
123</dt> 123</dt>
129</dt> 129</dt>
130<dd> 130<dd>
131Attempt to open a window on the named X display (<strong>-d</strong> still 131Attempt to open a window on the named X display (<strong>-d</strong> still
132respected). In the absence of this option, the display specified by the 132respected). In the absence of this option, the display specified by the
133<strong>DISPLAY</strong> environment variable is used. 133<strong>DISPLAY</strong> environment variable is used.
134</dd>
135<p></p>
136<dt><strong><a name="item__2ddepth_bitdepth"><strong>-depth</strong> <em>bitdepth</em></a></strong><br />
137</dt>
138<dd>
139Compile <em>frills</em>: Attempt to find a visual with the given bit depth;
140resource <strong>depth</strong>.
134</dd> 141</dd>
135<p></p> 142<p></p>
136<dt><strong><a name="item__2dgeometry_geom"><strong>-geometry</strong> <em>geom</em></a></strong><br /> 143<dt><strong><a name="item__2dgeometry_geom"><strong>-geometry</strong> <em>geom</em></a></strong><br />
137</dt> 144</dt>
138<dd> 145<dd>
182used to brighten or darken the image in addition to tinting it; resource 189used to brighten or darken the image in addition to tinting it; resource
183<em>tintColor</em>. Example: 190<em>tintColor</em>. Example:
184</dd> 191</dd>
185<dd> 192<dd>
186<pre> 193<pre>
187 urxvt -tr -tint blue -sh 40</pre> 194 rxvt -tr -tint blue -sh 40</pre>
188</dd> 195</dd>
189<p></p> 196<p></p>
190<dt><strong><a name="item__2dsh"><strong>-sh</strong></a></strong><br /> 197<dt><strong><a name="item__2dsh"><strong>-sh</strong></a></strong><br />
191</dt> 198</dt>
192<dd> 199<dd>
255with <code>x:</code>. To specify an XFT-font, you need to prefix it with <code>xft:</code>, 262with <code>x:</code>. To specify an XFT-font, you need to prefix it with <code>xft:</code>,
256e.g.:</p> 263e.g.:</p>
257</dd> 264</dd>
258<dd> 265<dd>
259<pre> 266<pre>
260 urxvt -fn &quot;xft:Bitstream Vera Sans Mono:pixelsize=15&quot; 267 rxvt -fn &quot;xft:Bitstream Vera Sans Mono:pixelsize=15&quot;
261 urxvt -fn &quot;9x15bold,xft:Bitstream Vera Sans Mono&quot;</pre> 268 rxvt -fn &quot;9x15bold,xft:Bitstream Vera Sans Mono&quot;</pre>
262</dd> 269</dd>
263<dd> 270<dd>
264<p>See also the question ``How does rxvt-unicode choose fonts?'' in the FAQ 271<p>See also the question ``How does rxvt-unicode choose fonts?'' in the FAQ
265section of urxvt(7).</p> 272section of rxvt(7).</p>
266</dd> 273</dd>
267<p></p> 274<p></p>
268<dt><strong><a name="item__2dfb_fontlist"><strong>-fb</strong> <em>fontlist</em></a></strong><br /> 275<dt><strong><a name="item__2dfb_fontlist"><strong>-fb</strong> <em>fontlist</em></a></strong><br />
269</dt> 276</dt>
270<dd> 277<dd>
415Compile <em>frills</em>: Set MWM hints to request a borderless window, i.e. 422Compile <em>frills</em>: Set MWM hints to request a borderless window, i.e.
416if honoured by the WM, the rxvt-unicode window will not have window 423if honoured by the WM, the rxvt-unicode window will not have window
417decorations; resource <strong>borderLess</strong>. 424decorations; resource <strong>borderLess</strong>.
418</dd> 425</dd>
419<p></p> 426<p></p>
427<dt><strong><a name="item__2doverride_2dredirect"><strong>-override-redirect</strong></a></strong><br />
428</dt>
429<dd>
430Compile <em>frills</em>: Sets override-redirect on the window; resource
431<strong>override-redirect</strong>.
432</dd>
433<p></p>
420<dt><strong><a name="item__2dsbg"><strong>-sbg</strong></a></strong><br /> 434<dt><strong><a name="item__2dsbg"><strong>-sbg</strong></a></strong><br />
421</dt> 435</dt>
422<dd> 436<dd>
423Compile <em>frills</em>: Disable the usage of the built-in block graphics/line 437Compile <em>frills</em>: Disable the usage of the built-in block graphics/line
424drawing characters and just rely on what the specified fonts provide. Use 438drawing characters and just rely on what the specified fonts provide. Use
444</dd> 458</dd>
445<p></p> 459<p></p>
446<dt><strong><a name="item__2de_command__5barguments_5d"><strong>-e</strong> <em>command [arguments]</em></a></strong><br /> 460<dt><strong><a name="item__2de_command__5barguments_5d"><strong>-e</strong> <em>command [arguments]</em></a></strong><br />
447</dt> 461</dt>
448<dd> 462<dd>
449Run the command with its command-line arguments in the <strong>urxvt</strong> 463Run the command with its command-line arguments in the <strong>rxvt</strong>
450window; also sets the window title and icon name to be the basename of 464window; also sets the window title and icon name to be the basename of
451the program being executed if neither <em>-title</em> (<em>-T</em>) nor <em>-n</em> are 465the program being executed if neither <em>-title</em> (<em>-T</em>) nor <em>-n</em> are
452given on the command line. If this option is used, it must be the last 466given on the command line. If this option is used, it must be the last
453on the command-line. If there is no <strong>-e</strong> option then the default is to 467on the command-line. If there is no <strong>-e</strong> option then the default is to
454run the program specified by the <strong>SHELL</strong> environment variable or, 468run the program specified by the <strong>SHELL</strong> environment variable or,
458<p>Please note that you must specify a program with arguments. If you want to 472<p>Please note that you must specify a program with arguments. If you want to
459run shell commands, you have to specify the shell, like this:</p> 473run shell commands, you have to specify the shell, like this:</p>
460</dd> 474</dd>
461<dd> 475<dd>
462<pre> 476<pre>
463 urxvt -e sh -c &quot;shell commands&quot;</pre> 477 rxvt -e sh -c &quot;shell commands&quot;</pre>
464</dd> 478</dd>
465<p></p> 479<p></p>
466<dt><strong><a name="item__2dtitle_text"><strong>-title</strong> <em>text</em></a></strong><br /> 480<dt><strong><a name="item__2dtitle_text"><strong>-title</strong> <em>text</em></a></strong><br />
467</dt> 481</dt>
468<dd> 482<dd>
553</dd> 567</dd>
554<p></p> 568<p></p>
555<dt><strong><a name="item__2dhold_7c_2bhold"><strong>-hold</strong>|<strong>+hold</strong></a></strong><br /> 569<dt><strong><a name="item__2dhold_7c_2bhold"><strong>-hold</strong>|<strong>+hold</strong></a></strong><br />
556</dt> 570</dt>
557<dd> 571<dd>
558Turn on/off hold window after exit support. If enabled, urxvt 572Turn on/off hold window after exit support. If enabled, rxvt
559will not immediately destroy its window when the program executed within 573will not immediately destroy its window when the program executed within
560it exits. Instead, it will wait till it is being killed or closed by the 574it exits. Instead, it will wait till it is being killed or closed by the
561user; resource <strong>hold</strong>. 575user; resource <strong>hold</strong>.
562</dd> 576</dd>
563<p></p> 577<p></p>
568</dd> 582</dd>
569<p></p> 583<p></p>
570<dt><strong><a name="item__2dembed_windowid"><strong>-embed</strong> <em>windowid</em></a></strong><br /> 584<dt><strong><a name="item__2dembed_windowid"><strong>-embed</strong> <em>windowid</em></a></strong><br />
571</dt> 585</dt>
572<dd> 586<dd>
573Tells urxvt to embed it's windows into an already-existing window, 587Tells rxvt to embed it's windows into an already-existing window,
574which enables applications to easily embed a terminal. 588which enables applications to easily embed a terminal.
575</dd> 589</dd>
576<dd> 590<dd>
577<p>Right now, urxvt will first unmap/map the specified window, so it 591<p>Right now, rxvt will first unmap/map the specified window, so it
578shouldn't be a top-level window. urxvt will also reconfigure it 592shouldn't be a top-level window. rxvt will also reconfigure it
579quite a bit, so don't expect it to keep some specific state. It's best to 593quite a bit, so don't expect it to keep some specific state. It's best to
580create an extra subwindow for urxvt and leave it alone.</p> 594create an extra subwindow for rxvt and leave it alone.</p>
581</dd>
582<dd> 595</dd>
596<dd>
583<p>The window will not be destroyed when urxvt exits.</p> 597<p>The window will not be destroyed when rxvt exits.</p>
584</dd>
585<dd> 598</dd>
599<dd>
586<p>It might be useful to know that urxvt will not close file 600<p>It might be useful to know that rxvt will not close file
587descriptors passed to it (except for stdin/out/err, of course), so you 601descriptors passed to it (except for stdin/out/err, of course), so you
588can use file descriptors to communicate with the programs within the 602can use file descriptors to communicate with the programs within the
589terminal. This works regardless of wether the <code>-embed</code> option was used or 603terminal. This works regardless of wether the <code>-embed</code> option was used or
590not.</p> 604not.</p>
591</dd> 605</dd>
596<dd> 610<dd>
597<pre> 611<pre>
598 my $rxvt = new Gtk2::Socket; 612 my $rxvt = new Gtk2::Socket;
599 $rxvt-&gt;signal_connect_after (realize =&gt; sub { 613 $rxvt-&gt;signal_connect_after (realize =&gt; sub {
600 my $xid = $_[0]-&gt;window-&gt;get_xid; 614 my $xid = $_[0]-&gt;window-&gt;get_xid;
601 system &quot;urxvt -embed $xid &amp;&quot;; 615 system &quot;rxvt -embed $xid &amp;&quot;;
602 });</pre> 616 });</pre>
603</dd> 617</dd>
604<p></p> 618<p></p>
605<dt><strong><a name="item__2dpty_2dfd_file_descriptor"><strong>-pty-fd</strong> <em>file descriptor</em></a></strong><br /> 619<dt><strong><a name="item__2dpty_2dfd_file_descriptor"><strong>-pty-fd</strong> <em>file descriptor</em></a></strong><br />
606</dt> 620</dt>
607<dd> 621<dd>
608Tells urxvt NOT to execute any commands or create a new pty/tty 622Tells rxvt NOT to execute any commands or create a new pty/tty
609pair but instead use the given filehandle as the tty master. This is 623pair but instead use the given filehandle as the tty master. This is
610useful if you want to drive urxvt as a generic terminal emulator 624useful if you want to drive rxvt as a generic terminal emulator
611without having to run a program within it. 625without having to run a program within it.
612</dd> 626</dd>
613<dd> 627<dd>
614<p>If this switch is given, urxvt will not create any utmp/wtmp 628<p>If this switch is given, rxvt will not create any utmp/wtmp
615entries and will not tinker with pty/tty permissions - you have to do that 629entries and will not tinker with pty/tty permissions - you have to do that
616yourself if you want that.</p> 630yourself if you want that.</p>
617</dd> 631</dd>
618<dd> 632<dd>
619<p>As an extremely special case, specifying <code>-1</code> will completely suppress 633<p>As an extremely special case, specifying <code>-1</code> will completely suppress
630</dd> 644</dd>
631<dd> 645<dd>
632<pre> 646<pre>
633 my $pty = new IO::Pty; 647 my $pty = new IO::Pty;
634 fcntl $pty, F_SETFD, 0; # clear close-on-exec 648 fcntl $pty, F_SETFD, 0; # clear close-on-exec
635 system &quot;urxvt -pty-fd &quot; . (fileno $pty) . &quot;&amp;&quot;; 649 system &quot;rxvt -pty-fd &quot; . (fileno $pty) . &quot;&amp;&quot;;
636 close $pty;</pre> 650 close $pty;</pre>
637</dd> 651</dd>
638<dd> 652<dd>
639<pre> 653<pre>
640 # now communicate with rxvt 654 # now communicate with rxvt
651<p></p></dl> 665<p></p></dl>
652<p> 666<p>
653</p> 667</p>
654<hr /> 668<hr />
655<h1><a name="resources__available_also_as_longoptions_">RESOURCES (available also as long-options)</a></h1> 669<h1><a name="resources__available_also_as_longoptions_">RESOURCES (available also as long-options)</a></h1>
656<p>Note: `urxvt --help' gives a list of all resources (long 670<p>Note: `rxvt --help' gives a list of all resources (long
657options) compiled into your version.</p> 671options) compiled into your version.</p>
658<p>You can set and change the resources using X11 tools like <strong>xrdb</strong>. Many 672<p>You can set and change the resources using X11 tools like <strong>xrdb</strong>. Many
659distribution do also load settings from the <strong>~/.Xresources</strong> file when X 673distribution do also load settings from the <strong>~/.Xresources</strong> file when X
660starts. urxvt will consult the following files/resources in order, 674starts. rxvt will consult the following files/resources in order,
661with later settings overwriting earlier ones:</p> 675with later settings overwriting earlier ones:</p>
662<pre> 676<pre>
663 1. system-wide app-defaults file, either locale-dependent OR global 677 1. system-wide app-defaults file, either locale-dependent OR global
664 2. app-defaults file in $XAPPLRESDIR 678 2. app-defaults file in $XAPPLRESDIR
665 3. RESOURCE_MANAGER property on root-window OR $HOME/.Xdefaults 679 3. RESOURCE_MANAGER property on root-window OR $HOME/.Xdefaults
666 4. SCREEN_RESOURCES for the current screen 680 4. SCREEN_RESOURCES for the current screen
667 5. $XENVIRONMENT file OR $HOME/.Xdefaults-&lt;nodename&gt;</pre> 681 5. $XENVIRONMENT file OR $HOME/.Xdefaults-&lt;nodename&gt;</pre>
668<p>Note that when reading X resources, <strong>urxvt</strong> recognizes two class 682<p>Note that when reading X resources, <strong>rxvt</strong> recognizes two class
669names: <strong>Rxvt</strong> and <strong>URxvt</strong>. The class name <strong>Rxvt</strong> allows resources 683names: <strong>Rxvt</strong> and <strong>URxvt</strong>. The class name <strong>Rxvt</strong> allows resources
670common to both <strong>urxvt</strong> and the original <em>rxvt</em> to be easily 684common to both <strong>rxvt</strong> and the original <em>rxvt</em> to be easily
671configured, while the class name <strong>URxvt</strong> allows resources unique to 685configured, while the class name <strong>URxvt</strong> allows resources unique to
672<strong>urxvt</strong>, to be shared between different <strong>urxvt</strong> 686<strong>rxvt</strong>, to be shared between different <strong>rxvt</strong>
673configurations. If no resources are specified, suitable defaults will 687configurations. If no resources are specified, suitable defaults will
674be used. Command-line arguments can be used to override resource 688be used. Command-line arguments can be used to override resource
675settings. The following resources are supported (you might want to 689settings. The following resources are supported (you might want to
676check the <code>urxvtperl(3)</code> manpage for additional settings by perl 690check the <code>rxvtperl(3)</code> manpage for additional settings by perl
677extensions not documented here):</p> 691extensions not documented here):</p>
678<dl> 692<dl>
693<dt><strong><a name="item_depth_3a_bitdepth"><strong>depth:</strong> <em>bitdepth</em></a></strong><br />
694</dt>
695<dd>
696Compile <em>frills</em>: Attempt to find a visual with the given bit depth;
697option <strong>-depth</strong>.
698</dd>
699<p></p>
679<dt><strong><a name="item_geometry_3a_geom"><strong>geometry:</strong> <em>geom</em></a></strong><br /> 700<dt><strong><a name="item_geometry_3a_geom"><strong>geometry:</strong> <em>geom</em></a></strong><br />
680</dt> 701</dt>
681<dd> 702<dd>
682Create the window with the specified X window geometry [default 80x24]; 703Create the window with the specified X window geometry [default 80x24];
683option <strong>-geometry</strong>. 704option <strong>-geometry</strong>.
7073=yellow, 4=blue, 5=magenta, 6=cyan, 7=white, but the actual colour 7283=yellow, 4=blue, 5=magenta, 6=cyan, 7=white, but the actual colour
708names used are listed in the <strong>COLORS AND GRAPHICS</strong> section. 729names used are listed in the <strong>COLORS AND GRAPHICS</strong> section.
709</dd> 730</dd>
710<dd> 731<dd>
711<p>Colours higher than 15 cannot be set using resources (yet), but can be 732<p>Colours higher than 15 cannot be set using resources (yet), but can be
712changed using an escape command (see urxvt(7)).</p> 733changed using an escape command (see rxvt(7)).</p>
713</dd> 734</dd>
714<dd> 735<dd>
715<p>Colours 16-79 form a standard 4x4x4 colour cube (the same as xterm with 736<p>Colours 16-79 form a standard 4x4x4 colour cube (the same as xterm with
71688 colour support). Colours 80-87 are evenly spaces grey steps.</p> 73788 colour support). Colours 80-87 are evenly spaces grey steps.</p>
717</dd> 738</dd>
845specifies an integer number of images in that direction. No image will 866specifies an integer number of images in that direction. No image will
846be magnified beyond 10 times its original size. The maximum permitted 867be magnified beyond 10 times its original size. The maximum permitted
847scale is 1000. [default 0x0+50+50] 868scale is 1000. [default 0x0+50+50]
848</dd> 869</dd>
849<p></p> 870<p></p>
850<dt><strong><a name="item_menu_3a_file_5b_3btag_5d"><strong>menu:</strong> <em>file[;tag]</em></a></strong><br />
851</dt>
852<dd>
853Read in the specified menu file (note the `.menu' extension is
854optional) and also optionally specify a starting tag to find. See the
855reference documentation for details on the syntax for the menuBar.
856</dd>
857<p></p>
858<dt><strong><a name="item_path_3a_path"><strong>path:</strong> <em>path</em></a></strong><br /> 871<dt><strong><a name="item_path_3a_path"><strong>path:</strong> <em>path</em></a></strong><br />
859</dt> 872</dt>
860<dd> 873<dd>
861Specify the colon-delimited search path for finding files (XPM and 874Specify the colon-delimited search path for finding XPM files.
862menus), in addition to the paths specified by the <strong>RXVTPATH</strong> and
863<strong>PATH</strong> environment variables.
864</dd> 875</dd>
865<p></p> 876<p></p>
866<dt><strong><a name="item_font_3a_fontlist"><strong>font:</strong> <em>fontlist</em></a></strong><br /> 877<dt><strong><a name="item_font_3a_fontlist"><strong>font:</strong> <em>fontlist</em></a></strong><br />
867</dt> 878</dt>
868<dd> 879<dd>
885<dd> 896<dd>
886<p>For example, this font resource</p> 897<p>For example, this font resource</p>
887</dd> 898</dd>
888<dd> 899<dd>
889<pre> 900<pre>
890 URxvt*font: 9x15bold,\ 901 URxvt.font: 9x15bold,\
891 -misc-fixed-bold-r-normal--15-140-75-75-c-90-iso10646-1,\ 902 -misc-fixed-bold-r-normal--15-140-75-75-c-90-iso10646-1,\
892 -misc-fixed-medium-r-normal--15-140-75-75-c-90-iso10646-1, \ 903 -misc-fixed-medium-r-normal--15-140-75-75-c-90-iso10646-1, \
893 [codeset=JISX0208]xft:Kochi Gothic:antialias=false, \ 904 [codeset=JISX0208]xft:Kochi Gothic:antialias=false, \
894 xft:Code2000:antialias=false</pre> 905 xft:Code2000:antialias=false</pre>
895</dd> 906</dd>
1025<dd> 1036<dd>
1026<p>Example:</p> 1037<p>Example:</p>
1027</dd> 1038</dd>
1028<dd> 1039<dd>
1029<pre> 1040<pre>
1030 URxvt*print-pipe: cat &gt; $(TMPDIR=$HOME mktemp urxvt.XXXXXX)</pre> 1041 URxvt.print-pipe: cat &gt; $(TMPDIR=$HOME mktemp urxvt.XXXXXX)</pre>
1031</dd> 1042</dd>
1032<dd> 1043<dd>
1033<p>This creates a new file in your home directory with the screen contents 1044<p>This creates a new file in your home directory with the screen contents
1034everytime you hit <code>Print</code>.</p> 1045everytime you hit <code>Print</code>.</p>
1035</dd> 1046</dd>
1211</dd> 1222</dd>
1212<p></p> 1223<p></p>
1213<dt><strong><a name="item_cutchars_3a_string"><strong>cutchars:</strong> <em>string</em></a></strong><br /> 1224<dt><strong><a name="item_cutchars_3a_string"><strong>cutchars:</strong> <em>string</em></a></strong><br />
1214</dt> 1225</dt>
1215<dd> 1226<dd>
1216The characters used as delimiters for double-click word selection. The 1227The characters used as delimiters for double-click word selection
1217built-in default: 1228(whitespace delimiting is added automatically if resource is given).
1229</dd>
1230<dd>
1231<p>When the selection extension is in use (the default if compiled in, see
1232the <code>rxvtperl(3)</code> manpage), a suitable regex using these characters
1233will be created (if the resource exists, otherwise, no regex will be
1234created). In this mode, characters outside ISO-8859-1 can be used.</p>
1235</dd>
1236<dd>
1237<p>When the selection extension is not used, only ISO-8859-1 characters can
1238be used. If not specified, the built-in default is used:</p>
1218</dd> 1239</dd>
1219<dd> 1240<dd>
1220<p><strong>BACKSLASH ```'&amp;()*,;&lt;=</strong>?@[]{|} &gt;&gt;</p> 1241<p><strong>BACKSLASH ```'&amp;()*,;&lt;=</strong>?@[]{|} &gt;&gt;</p>
1221</dd> 1242</dd>
1222<p></p> 1243<p></p>
1245</dt> 1266</dt>
1246<dd> 1267<dd>
1247Specify the font-set used for XIM styles <code>OverTheSpot</code> or 1268Specify the font-set used for XIM styles <code>OverTheSpot</code> or
1248<code>OffTheSpot</code>. It must be a standard X font set (XLFD patterns separated 1269<code>OffTheSpot</code>. It must be a standard X font set (XLFD patterns separated
1249by commas), i.e. it's not in the same format as the other font lists used 1270by commas), i.e. it's not in the same format as the other font lists used
1250in urxvt. The default will be set-up to chose *any* suitable found 1271in rxvt. The default will be set-up to chose *any* suitable found
1251found, preferably one or two pixels differing in size to the base font. 1272found, preferably one or two pixels differing in size to the base font.
1252option <strong>-imfont</strong>. 1273option <strong>-imfont</strong>.
1253</dd> 1274</dd>
1254<p></p> 1275<p></p>
1255<dt><strong><a name="item_tripleclickwords_3a_boolean"><strong>tripleclickwords:</strong> <em>boolean</em></a></strong><br /> 1276<dt><strong><a name="item_tripleclickwords_3a_boolean"><strong>tripleclickwords:</strong> <em>boolean</em></a></strong><br />
1272sequences enabled by default, which doesn't make it safer, though). 1293sequences enabled by default, which doesn't make it safer, though).
1273</dd> 1294</dd>
1274<dd> 1295<dd>
1275<p>You can enable them by setting this boolean resource or specifying 1296<p>You can enable them by setting this boolean resource or specifying
1276<strong>-insecure</strong> as an option. At the moment, this enables display-answer, 1297<strong>-insecure</strong> as an option. At the moment, this enables display-answer,
1277locale, findfont, icon label and window title requests as well as dynamic 1298locale, findfont, icon label and window title requests.</p>
1278menubar dispatch.</p>
1279</dd> 1299</dd>
1280<p></p> 1300<p></p>
1281<dt><strong><a name="item_modifier_3a_modifier"><strong>modifier:</strong> <em>modifier</em></a></strong><br /> 1301<dt><strong><a name="item_modifier_3a_modifier"><strong>modifier:</strong> <em>modifier</em></a></strong><br />
1282</dt> 1302</dt>
1283<dd> 1303<dd>
1292Specify the reply rxvt-unicode sends to the shell when an ENQ (control-E) 1312Specify the reply rxvt-unicode sends to the shell when an ENQ (control-E)
1293character is passed through. It may contain escape values as described 1313character is passed through. It may contain escape values as described
1294in the entry on <strong>keysym</strong> following. 1314in the entry on <strong>keysym</strong> following.
1295</dd> 1315</dd>
1296<p></p> 1316<p></p>
1297<dt><strong><a name="item_secondaryscreen_3a_bool"><strong>secondaryScreen:</strong> <em>bool</em></a></strong><br /> 1317<dt><strong><a name="item_secondaryscreen_3a_boolean"><strong>secondaryScreen:</strong> <em>boolean</em></a></strong><br />
1298</dt> 1318</dt>
1299<dd> 1319<dd>
1300Turn on/off secondary screen (default enabled). 1320Turn on/off secondary screen (default enabled).
1301</dd> 1321</dd>
1302<p></p> 1322<p></p>
1303<dt><strong><a name="item_secondaryscroll_3a_bool"><strong>secondaryScroll:</strong> <em>bool</em></a></strong><br /> 1323<dt><strong><a name="item_secondaryscroll_3a_boolean"><strong>secondaryScroll:</strong> <em>boolean</em></a></strong><br />
1304</dt> 1324</dt>
1305<dd> 1325<dd>
1306Turn on/off secondary screen scroll (default enabled). If the this 1326Turn on/off secondary screen scroll (default enabled). If the this
1307option is enabled, scrolls on the secondary screen will change the 1327option is enabled, scrolls on the secondary screen will change the
1308scrollback buffer and switching to/from the secondary screen will 1328scrollback buffer and switching to/from the secondary screen will
1309instead scroll the screen up. 1329instead scroll the screen up.
1310</dd> 1330</dd>
1311<p></p> 1331<p></p>
1312<dt><strong><a name="item_hold_3a_bool"><strong>hold</strong>: <em>bool</em></a></strong><br /> 1332<dt><strong><a name="item_hold_3a_boolean"><strong>hold</strong>: <em>boolean</em></a></strong><br />
1313</dt> 1333</dt>
1314<dd> 1334<dd>
1315Turn on/off hold window after exit support. If enabled, urxvt 1335Turn on/off hold window after exit support. If enabled, rxvt
1316will not immediately destroy its window when the program executed within 1336will not immediately destroy its window when the program executed within
1317it exits. Instead, it will wait till it is being killed or closed by the 1337it exits. Instead, it will wait till it is being killed or closed by the
1318user. 1338user.
1319</dd> 1339</dd>
1320<p></p> 1340<p></p>
1352can start or end with whitespace.</p> 1372can start or end with whitespace.</p>
1353</dd> 1373</dd>
1354<dd> 1374<dd>
1355<p>Please note that you need to double the <code>\</code> in resource files, as 1375<p>Please note that you need to double the <code>\</code> in resource files, as
1356Xlib itself does it's own de-escaping (you can use <code>\033</code> instead of 1376Xlib itself does it's own de-escaping (you can use <code>\033</code> instead of
1357<code>\e</code> (and so on), which will work with both Xt and urxvt's own 1377<code>\e</code> (and so on), which will work with both Xt and rxvt's own
1358processing).</p> 1378processing).</p>
1359</dd> 1379</dd>
1360<dd> 1380<dd>
1361<p>You can define a range of keysyms in one shot by providing a <em>string</em> 1381<p>You can define a range of keysyms in one shot by providing a <em>string</em>
1362with pattern <strong>list/PREFIX/MIDDLE/SUFFIX</strong>, where the delimeter `/' 1382with pattern <strong>list/PREFIX/MIDDLE/SUFFIX</strong>, where the delimeter `/'
1378 URxvt.keysym.Meta-Control-0x62: \033&lt;M-C-b&gt; 1398 URxvt.keysym.Meta-Control-0x62: \033&lt;M-C-b&gt;
1379 URxvt.keysym.Meta-Control-0x63: \033&lt;M-C-c&gt;</pre> 1399 URxvt.keysym.Meta-Control-0x63: \033&lt;M-C-c&gt;</pre>
1380</dd> 1400</dd>
1381<dd> 1401<dd>
1382<p>If <em>string</em> takes the form of <code>command:STRING</code>, the specified <strong>STRING</strong> 1402<p>If <em>string</em> takes the form of <code>command:STRING</code>, the specified <strong>STRING</strong>
1383is interpreted and executed as urxvt's control sequence. For 1403is interpreted and executed as rxvt's control sequence. For
1384example the following means ``change the current locale to <code>zh_CN.GBK</code> 1404example the following means ``change the current locale to <code>zh_CN.GBK</code>
1385when Control-Meta-c is being pressed'':</p> 1405when Control-Meta-c is being pressed'':</p>
1386</dd> 1406</dd>
1387<dd> 1407<dd>
1388<pre> 1408<pre>
1389 URxvt.keysym.M-C-c: command:\033]701;zh_CN.GBK\007</pre> 1409 URxvt.keysym.M-C-c: command:\033]701;zh_CN.GBK\007</pre>
1390</dd> 1410</dd>
1391<dd> 1411<dd>
1392<p>If <em>string</em> takes the form <code>perl:STRING</code>, then the specified <strong>STRING</strong> 1412<p>If <em>string</em> takes the form <code>perl:STRING</code>, then the specified <strong>STRING</strong>
1393is passed to the <code>on_keyboard_command</code> perl handler. See the <code>urxvtperl(3)</code> 1413is passed to the <code>on_keyboard_command</code> perl handler. See the <code>rxvtperl(3)</code>
1394manpage. For example, the <em>selection</em> extension (activated via 1414manpage. For example, the <em>selection</em> extension (activated via
1395<code>urxvt -pe selection</code>) listens for <code>selection:rot13</code> events:</p> 1415<code>rxvt -pe selection</code>) listens for <code>selection:rot13</code> events:</p>
1396</dd> 1416</dd>
1397<dd> 1417<dd>
1398<pre> 1418<pre>
1399 URxvt.keysym.M-C-c: perl:selection:rot13</pre> 1419 URxvt.keysym.M-C-c: perl:selection:rot13</pre>
1400</dd> 1420</dd>
1406definitions for <code>Meta-a</code>, <code>Shift-a</code> and so on, unless some of those are defined 1426definitions for <code>Meta-a</code>, <code>Shift-a</code> and so on, unless some of those are defined
1407mappings themselves.</p> 1427mappings themselves.</p>
1408</dd> 1428</dd>
1409<dd> 1429<dd>
1410<p>Unfortunately, this will override built-in key mappings. For example 1430<p>Unfortunately, this will override built-in key mappings. For example
1411if you overwrite the <code>Insert</code> key you will disable urxvt's 1431if you overwrite the <code>Insert</code> key you will disable rxvt's
1412<code>Shift-Insert</code> mapping. To re-enable that, you can poke ``holes'' into the 1432<code>Shift-Insert</code> mapping. To re-enable that, you can poke ``holes'' into the
1413user-defined keymap using the <code>builtin:</code> replacement:</p> 1433user-defined keymap using the <code>builtin:</code> replacement:</p>
1414</dd> 1434</dd>
1415<dd> 1435<dd>
1416<pre> 1436<pre>
1431<pre> 1451<pre>
1432 URxvt.keysym.M-C-1: command:\033]50;suxuseuro\007 1452 URxvt.keysym.M-C-1: command:\033]50;suxuseuro\007
1433 URxvt.keysym.M-C-2: command:\033]50;9x15bold\007</pre> 1453 URxvt.keysym.M-C-2: command:\033]50;9x15bold\007</pre>
1434</dd> 1454</dd>
1435<dd> 1455<dd>
1436<p>Other things are possible, e.g. resizing (see <code>urxvt(7)</code> for more 1456<p>Other things are possible, e.g. resizing (see <code>rxvt(7)</code> for more
1437info):</p> 1457info):</p>
1438</dd> 1458</dd>
1439<dd> 1459<dd>
1440<pre> 1460<pre>
1441 URxvt.keysym.M-C-3: command:\033[8;25;80t 1461 URxvt.keysym.M-C-3: command:\033[8;25;80t
1477<p></p> 1497<p></p>
1478<dt><strong><a name="item_perl_2deval_3a_string"><strong>perl-eval</strong>: <em>string</em></a></strong><br /> 1498<dt><strong><a name="item_perl_2deval_3a_string"><strong>perl-eval</strong>: <em>string</em></a></strong><br />
1479</dt> 1499</dt>
1480<dd> 1500<dd>
1481Perl code to be evaluated when all extensions have been registered. See 1501Perl code to be evaluated when all extensions have been registered. See
1482the <code>urxvtperl(3)</code> manpage. Due to security reasons, this resource 1502the <code>rxvtperl(3)</code> manpage. Due to security reasons, this resource
1483will be ignored when running setuid/setgid. 1503will be ignored when running setuid/setgid.
1484</dd> 1504</dd>
1485<p></p> 1505<p></p>
1486<dt><strong><a name="item_perl_2dlib_3a_path"><strong>perl-lib</strong>: <em>path</em></a></strong><br /> 1506<dt><strong><a name="item_perl_2dlib_3a_path"><strong>perl-lib</strong>: <em>path</em></a></strong><br />
1487</dt> 1507</dt>
1488<dd> 1508<dd>
1489Colon-separated list of additional directories that hold extension 1509Colon-separated list of additional directories that hold extension
1490scripts. When looking for extensions specified by the <code>perl</code> resource, 1510scripts. When looking for extensions specified by the <code>perl</code> resource,
1491urxvt will first look in these directories and then in 1511rxvt will first look in these directories and then in
1492<em>/usr/local/lib/urxvt/perl/</em>. Due to security reasons, this resource 1512<em>/opt/rxvt/lib/urxvt/perl/</em>. Due to security reasons, this resource
1493will be ignored when running setuid/setgid. 1513will be ignored when running setuid/setgid.
1494</dd> 1514</dd>
1495<dd> 1515<dd>
1496<p>See the <code>urxvtperl(3)</code> manpage.</p> 1516<p>See the <code>rxvtperl(3)</code> manpage.</p>
1497</dd> 1517</dd>
1498<p></p> 1518<p></p>
1499<dt><strong><a name="item_selection_2epattern_2didx_3a_perl_2dregex"><strong>selection.pattern-<em>idx</em> </strong>&gt;: <em>perl-regex</em></a></strong><br /> 1519<dt><strong><a name="item_selection_2epattern_2didx_3a_perl_2dregex"><strong>selection.pattern-<em>idx</em> </strong>&gt;: <em>perl-regex</em></a></strong><br />
1500</dt> 1520</dt>
1501<dd> 1521<dd>
1502Additional selection patterns, see the <code>urxvtperl(3)</code> manpage for 1522Additional selection patterns, see the <code>rxvtperl(3)</code> manpage for
1503details. 1523details.
1504</dd> 1524</dd>
1505<p></p> 1525<p></p>
1506<dt><strong><a name="item_selection_2dautotransform_2eidx_3a_perl_2dtransfor"><strong>selection-autotransform.<em>idx</em> </strong>&gt;: <em>perl-transform</em></a></strong><br /> 1526<dt><strong><a name="item_selection_2dautotransform_2eidx_3a_perl_2dtransfor"><strong>selection-autotransform.<em>idx</em> </strong>&gt;: <em>perl-transform</em></a></strong><br />
1507</dt> 1527</dt>
1508<dd> 1528<dd>
1509Selection auto-transform patterns, see the <code>urxvtperl(3)</code> manpage 1529Selection auto-transform patterns, see the <code>rxvtperl(3)</code> manpage
1510for details. 1530for details.
1511</dd> 1531</dd>
1512<p></p> 1532<p></p>
1513<dt><strong><a name="item_searchable_2dscrollback_3a_keysym"><strong>searchable-scrollback:</strong> <em>keysym</em></a></strong><br /> 1533<dt><strong><a name="item_searchable_2dscrollback_3a_keysym"><strong>searchable-scrollback:</strong> <em>keysym</em></a></strong><br />
1514</dt> 1534</dt>
1525</dd> 1545</dd>
1526<p></p> 1546<p></p>
1527<dt><strong><a name="item_transient_2dfor_3a_windowid"><strong>transient-for</strong>: <em>windowid</em></a></strong><br /> 1547<dt><strong><a name="item_transient_2dfor_3a_windowid"><strong>transient-for</strong>: <em>windowid</em></a></strong><br />
1528</dt> 1548</dt>
1529<dd> 1549<dd>
1530Sets the WM_TRANSIENT_FOR property to the given window iw. 1550Compile <em>frills</em>: Sets the WM_TRANSIENT_FOR property to the given window id.
1551</dd>
1552<p></p>
1553<dt><strong><a name="item_override_2dredirect_3a_boolean"><strong>override-redirect</strong>: <em>boolean</em></a></strong><br />
1554</dt>
1555<dd>
1556Compile <em>frills</em>: Sets override-redirect for the terminal window, making
1557it almost invisible to window managers; option <strong>-override-redirect</strong>.
1531</dd> 1558</dd>
1532<p></p></dl> 1559<p></p></dl>
1533<p> 1560<p>
1534</p> 1561</p>
1535<hr /> 1562<hr />
1536<h1><a name="the_scrollbar">THE SCROLLBAR</a></h1> 1563<h1><a name="the_scrollbar">THE SCROLLBAR</a></h1>
1537<p>Lines of text that scroll off the top of the <strong>urxvt</strong> window 1564<p>Lines of text that scroll off the top of the <strong>rxvt</strong> window
1538(resource: <strong>saveLines</strong>) and can be scrolled back using the scrollbar 1565(resource: <strong>saveLines</strong>) and can be scrolled back using the scrollbar
1539or by keystrokes. The normal <strong>urxvt</strong> scrollbar has arrows and 1566or by keystrokes. The normal <strong>rxvt</strong> scrollbar has arrows and
1540its behaviour is fairly intuitive. The <strong>xterm-scrollbar</strong> is without 1567its behaviour is fairly intuitive. The <strong>xterm-scrollbar</strong> is without
1541arrows and its behaviour mimics that of <em>xterm</em></p> 1568arrows and its behaviour mimics that of <em>xterm</em></p>
1542<p>Scroll down with <strong>Button1</strong> (<strong>xterm-scrollbar</strong>) or <strong>Shift-Next</strong>. 1569<p>Scroll down with <strong>Button1</strong> (<strong>xterm-scrollbar</strong>) or <strong>Shift-Next</strong>.
1543Scroll up with <strong>Button3</strong> (<strong>xterm-scrollbar</strong>) or <strong>Shift-Prior</strong>. 1570Scroll up with <strong>Button3</strong> (<strong>xterm-scrollbar</strong>) or <strong>Shift-Prior</strong>.
1544Continuous scroll with <strong>Button2</strong>.</p> 1571Continuous scroll with <strong>Button2</strong>.</p>
1580</dd> 1607</dd>
1581<p></p> 1608<p></p>
1582<dt><strong><a name="item_insertion_3a"><strong>Insertion</strong>:</a></strong><br /> 1609<dt><strong><a name="item_insertion_3a"><strong>Insertion</strong>:</a></strong><br />
1583</dt> 1610</dt>
1584<dd> 1611<dd>
1585Pressing and releasing the Middle mouse button (or <strong>Shift-Insert</strong>) in 1612Pressing and releasing the Middle mouse button in an <strong>rxvt</strong>
1586an <strong>urxvt</strong> window causes the current text selection to be 1613window causes the value of the PRIMARY selection (or CLIPBOARD with the
1587inserted as if it had been typed on the keyboard. 1614Meta modifier) to be inserted as if it had been typed on the keyboard.
1615</dd>
1616<dd>
1617<p>Pressing <strong>Shift-Insert</strong> causes the value of the PRIMARY selection to be
1618inserted too.</p>
1588</dd> 1619</dd>
1589<p></p></dl> 1620<p></p></dl>
1590<p> 1621<p>
1591</p> 1622</p>
1592<hr /> 1623<hr />
1593<h1><a name="changing_fonts">CHANGING FONTS</a></h1> 1624<h1><a name="changing_fonts">CHANGING FONTS</a></h1>
1594<p>Changing fonts (or font sizes, respectively) via the keypad is not yet 1625<p>Changing fonts (or font sizes, respectively) via the keypad is not yet
1595supported in rxvt-unicode. Bug me if you need this.</p> 1626supported in rxvt-unicode. Bug me if you need this.</p>
1596<p>You can, however, switch fonts at runtime using escape sequences (and 1627<p>You can, however, switch fonts at runtime using escape sequences, e.g.:</p>
1597therefore using the menubar), e.g.:</p>
1598<pre> 1628<pre>
1599 printf '\e]710;%s\007' &quot;9x15bold,xft:Kochi Gothic&quot;</pre> 1629 printf '\e]710;%s\007' &quot;9x15bold,xft:Kochi Gothic&quot;</pre>
1630<p>You can use keyboard shortcuts, too:</p>
1631<pre>
1632 URxvt.keysym.M-C-1: command:\033]710;suxuseuro\007\033]711;suxuseuro\007
1633 URxvt.keysym.M-C-2: command:\033]710;9x15bold\007\033]711;9x15bold\007</pre>
1600<p>rxvt-unicode will automatically re-apply these fonts to the output so far.</p> 1634<p>rxvt-unicode will automatically re-apply these fonts to the output so far.</p>
1601<p> 1635<p>
1602</p> 1636</p>
1603<hr /> 1637<hr />
1604<h1><a name="iso_14755_support">ISO 14755 SUPPORT</a></h1> 1638<h1><a name="iso_14755_support">ISO 14755 SUPPORT</a></h1>
1657both scenario A and B of ISO 14755, including part 5.2.</p> 1691both scenario A and B of ISO 14755, including part 5.2.</p>
1658<p> 1692<p>
1659</p> 1693</p>
1660<hr /> 1694<hr />
1661<h1><a name="login_stamp">LOGIN STAMP</a></h1> 1695<h1><a name="login_stamp">LOGIN STAMP</a></h1>
1662<p><strong>urxvt</strong> tries to write an entry into the <em>utmp</em>(5) file so that 1696<p><strong>rxvt</strong> tries to write an entry into the <em>utmp</em>(5) file so that
1663it can be seen via the <em>who(1)</em> command, and can accept messages. To 1697it can be seen via the <em>who(1)</em> command, and can accept messages. To
1664allow this feature, <strong>urxvt</strong> may need to be installed setuid root 1698allow this feature, <strong>rxvt</strong> may need to be installed setuid root
1665on some systems or setgid to root or to some other group on others.</p> 1699on some systems or setgid to root or to some other group on others.</p>
1666<p> 1700<p>
1667</p> 1701</p>
1668<hr /> 1702<hr />
1669<h1><a name="colors_and_graphics">COLORS AND GRAPHICS</a></h1> 1703<h1><a name="colors_and_graphics">COLORS AND GRAPHICS</a></h1>
1670<p>In addition to the default foreground and background colours, 1704<p>In addition to the default foreground and background colours,
1671<strong>urxvt</strong> can display up to 16 colours (8 ANSI colours plus 1705<strong>rxvt</strong> can display up to 16 colours (8 ANSI colours plus
1672high-intensity bold/blink versions of the same). Here is a list of the 1706high-intensity bold/blink versions of the same). Here is a list of the
1673colours with their <strong>rgb.txt</strong> names.</p> 1707colours with their <strong>rgb.txt</strong> names.</p>
1674<table> 1708<table>
1675<tr><td>color0</td><td>(black)</td><td>= Black</td></tr> 1709<tr><td>color0</td><td>(black)</td><td>= Black</td></tr>
1676<tr><td>color1</td><td>(red)</td><td>= Red3</td></tr> 1710<tr><td>color1</td><td>(red)</td><td>= Red3</td></tr>
1697<p>Note that <strong>-rv</strong> (<strong>``reverseVideo: True''</strong>) simulates reverse video by 1731<p>Note that <strong>-rv</strong> (<strong>``reverseVideo: True''</strong>) simulates reverse video by
1698always swapping the foreground/background colours. This is in contrast to 1732always swapping the foreground/background colours. This is in contrast to
1699<em>xterm</em>(1) where the colours are only swapped if they have not otherwise 1733<em>xterm</em>(1) where the colours are only swapped if they have not otherwise
1700been specified. For example,</p> 1734been specified. For example,</p>
1701<dl> 1735<dl>
1702<dt><strong><a name="item_urxvt__2dfg_black__2dbg_white__2drv"><strong>urxvt -fg Black -bg White -rv</strong></a></strong><br /> 1736<dt><strong><a name="item_rxvt__2dfg_black__2dbg_white__2drv"><strong>rxvt -fg Black -bg White -rv</strong></a></strong><br />
1703</dt> 1737</dt>
1704<dd> 1738<dd>
1705would yield White on Black, while on <em>xterm</em>(1) it would yield Black 1739would yield White on Black, while on <em>xterm</em>(1) it would yield Black
1706on White. 1740on White.
1707</dd> 1741</dd>
1708<p></p></dl> 1742<p></p></dl>
1709<p> 1743<p>
1710</p> 1744</p>
1711<hr /> 1745<hr />
1712<h1><a name="environment">ENVIRONMENT</a></h1> 1746<h1><a name="environment">ENVIRONMENT</a></h1>
1713<p><strong>urxvt</strong> sets and/or uses the following environment variables:</p> 1747<p><strong>rxvt</strong> sets and/or uses the following environment variables:</p>
1714<dl> 1748<dl>
1715<dt><strong><a name="item_term"><strong>TERM</strong></a></strong><br /> 1749<dt><strong><a name="item_term"><strong>TERM</strong></a></strong><br />
1716</dt> 1750</dt>
1717<dd> 1751<dd>
1718Normally set to <code>rxvt-unicode</code>, unless overwritten at configure time, via 1752Normally set to <code>rxvt-unicode</code>, unless overwritten at configure time, via
1720</dd> 1754</dd>
1721<p></p> 1755<p></p>
1722<dt><strong><a name="item_colorterm"><strong>COLORTERM</strong></a></strong><br /> 1756<dt><strong><a name="item_colorterm"><strong>COLORTERM</strong></a></strong><br />
1723</dt> 1757</dt>
1724<dd> 1758<dd>
1725Either <code>rxvt</code>, <code>rxvt-xpm</code>, depending on wether urxvt was 1759Either <code>rxvt</code>, <code>rxvt-xpm</code>, depending on wether rxvt was
1726compiled with XPM support, and optionally with the added extension 1760compiled with XPM support, and optionally with the added extension
1727<code>-mono</code> to indicate that rxvt-unicode runs on a monochrome screen. 1761<code>-mono</code> to indicate that rxvt-unicode runs on a monochrome screen.
1728</dd> 1762</dd>
1729<p></p> 1763<p></p>
1730<dt><strong><a name="item_colorfgbg"><strong>COLORFGBG</strong></a></strong><br /> 1764<dt><strong><a name="item_colorfgbg"><strong>COLORFGBG</strong></a></strong><br />
1732<dd> 1766<dd>
1733Set to a string of the form <code>fg;bg</code> or <code>fg;xpm;bg</code>, where <code>fg</code> is 1767Set to a string of the form <code>fg;bg</code> or <code>fg;xpm;bg</code>, where <code>fg</code> is
1734the colour code used as default foreground/text colour (or the string 1768the colour code used as default foreground/text colour (or the string
1735<code>default</code> to indicate that the default-colour escape sequence is to be 1769<code>default</code> to indicate that the default-colour escape sequence is to be
1736used), <code>bg</code> is the colour code used as default background colour (or the 1770used), <code>bg</code> is the colour code used as default background colour (or the
1737string <code>default</code>), and <code>xpm</code> is the string <code>default</code> if urxvt 1771string <code>default</code>), and <code>xpm</code> is the string <code>default</code> if rxvt
1738was compiled with XPM support. Libraries like <code>ncurses</code> and <code>slang</code> can 1772was compiled with XPM support. Libraries like <code>ncurses</code> and <code>slang</code> can
1739(and do) use this information to optimize screen output. 1773(and do) use this information to optimize screen output.
1740</dd> 1774</dd>
1741<p></p> 1775<p></p>
1742<dt><strong><a name="item_windowid"><strong>WINDOWID</strong></a></strong><br /> 1776<dt><strong><a name="item_windowid"><strong>WINDOWID</strong></a></strong><br />
1743</dt> 1777</dt>
1744<dd> 1778<dd>
1745Set to the (decimal) X Window ID of the urxvt window (the toplevel 1779Set to the (decimal) X Window ID of the rxvt window (the toplevel
1746window, which usually has subwindows for the scrollbar, the terminal 1780window, which usually has subwindows for the scrollbar, the terminal
1747window and so on). 1781window and so on).
1748</dd> 1782</dd>
1749<p></p> 1783<p></p>
1750<dt><strong><a name="item_terminfo"><strong>TERMINFO</strong></a></strong><br /> 1784<dt><strong><a name="item_terminfo"><strong>TERMINFO</strong></a></strong><br />
1751</dt> 1785</dt>
1752<dd> 1786<dd>
1753Set to the terminfo directory iff urxvt was configured with 1787Set to the terminfo directory iff rxvt was configured with
1754<code>--with-terminfo=PATH</code>. 1788<code>--with-terminfo=PATH</code>.
1755</dd> 1789</dd>
1756<p></p> 1790<p></p>
1757<dt><strong><a name="item_display"><strong>DISPLAY</strong></a></strong><br /> 1791<dt><strong><a name="item_display"><strong>DISPLAY</strong></a></strong><br />
1758</dt> 1792</dt>
1759<dd> 1793<dd>
1760Used by urxvt to connect to the display and set to the correct 1794Used by rxvt to connect to the display and set to the correct
1761display in it's child processes. 1795display in it's child processes.
1762</dd> 1796</dd>
1763<p></p> 1797<p></p>
1764<dt><strong><a name="item_shell"><strong>SHELL</strong></a></strong><br /> 1798<dt><strong><a name="item_shell"><strong>SHELL</strong></a></strong><br />
1765</dt> 1799</dt>
1766<dd> 1800<dd>
1767The shell to be used for command execution, defaults to <code>/bin/sh</code>. 1801The shell to be used for command execution, defaults to <code>/bin/sh</code>.
1768</dd> 1802</dd>
1769<p></p> 1803<p></p>
1770<dt><strong><a name="item_rxvtpath"><strong>RXVTPATH</strong></a></strong><br />
1771</dt>
1772<dd>
1773The path where urxvt looks for support files such as menu and xpm
1774files.
1775</dd>
1776<p></p>
1777<dt><strong><a name="item_path"><strong>PATH</strong></a></strong><br />
1778</dt>
1779<dd>
1780Used in the same way as <a href="#item_rxvtpath"><code>RXVTPATH</code></a>.
1781</dd>
1782<p></p>
1783<dt><strong><a name="item_rxvt_socket"><strong>RXVT_SOCKET</strong></a></strong><br /> 1804<dt><strong><a name="item_rxvt_socket"><strong>RXVT_SOCKET</strong></a></strong><br />
1784</dt> 1805</dt>
1785<dd> 1806<dd>
1786The unix domain socket path used by <code>urxvtc(1)</code> and 1807The unix domain socket path used by <code>rxvtc(1)</code> and
1787urxvtd(1). 1808rxvtd(1).
1788</dd> 1809</dd>
1789<dd> 1810<dd>
1790<p>Default <em>$HOME/.rxvt-unicode-<em>&lt;nodename </em></em> &gt;&gt;&gt;.</p> 1811<p>Default <em>$HOME/.rxvt-unicode-<em>&lt;nodename </em></em> &gt;&gt;&gt;.</p>
1791</dd> 1812</dd>
1792<p></p> 1813<p></p>
1806<p></p> 1827<p></p>
1807<dt><strong><a name="item_xenvironment"><strong>XENVIRONMENT</strong></a></strong><br /> 1828<dt><strong><a name="item_xenvironment"><strong>XENVIRONMENT</strong></a></strong><br />
1808</dt> 1829</dt>
1809<dd> 1830<dd>
1810If set and accessible, gives the name of a X resource file to be loaded by 1831If set and accessible, gives the name of a X resource file to be loaded by
1811urxvt. 1832rxvt.
1812</dd> 1833</dd>
1813<p></p></dl> 1834<p></p></dl>
1814<p> 1835<p>
1815</p> 1836</p>
1816<hr /> 1837<hr />
1824<p></p></dl> 1845<p></p></dl>
1825<p> 1846<p>
1826</p> 1847</p>
1827<hr /> 1848<hr />
1828<h1><a name="see_also">SEE ALSO</a></h1> 1849<h1><a name="see_also">SEE ALSO</a></h1>
1829<p>urxvt(7), urxvtc(1), urxvtd(1), xterm(1), sh(1), resize(1), X(1), pty(4), tty(4), <code>utmp(5)</code></p> 1850<p>rxvt(7), rxvtc(1), rxvtd(1), xterm(1), sh(1), resize(1), X(1), pty(4), tty(4), <code>utmp(5)</code></p>
1830<p> 1851<p>
1831</p> 1852</p>
1832<hr /> 1853<hr />
1833<h1><a name="current_project_coordinator">CURRENT PROJECT COORDINATOR</a></h1> 1854<h1><a name="current_project_coordinator">CURRENT PROJECT COORDINATOR</a></h1>
1834<dl> 1855<dl>
1880</dd> 1901</dd>
1881<p></p> 1902<p></p>
1882<dt><strong><a name="item_geoff_wing__3cgcw_40pobox_2ecom_3e">Geoff Wing <em><a href="mailto:<gcw@pobox.com"><gcw@pobox.com</a></em>&gt;</a></strong><br /> 1903<dt><strong><a name="item_geoff_wing__3cgcw_40pobox_2ecom_3e">Geoff Wing <em><a href="mailto:<gcw@pobox.com"><gcw@pobox.com</a></em>&gt;</a></strong><br />
1883</dt> 1904</dt>
1884<dd> 1905<dd>
1885Rewrote screen display and text selection routines. Project Coordinator 1906Rewrote screen display and text selection routines.
1886(changes.txt 2.4.6 - rxvt-unicode) 1907
1908</dd>
1909<dd>
1910<pre>
1911
1912Project Coordinator (changes.txt 2.4.6 - rxvt-unicode)</pre>
1887</dd> 1913</dd>
1888<p></p> 1914<p></p>
1889<dt><strong><a name="item_marc_alexander_lehmann__3crxvt_2dunicode_40schmorp">Marc Alexander Lehmann <em><a href="mailto:<rxvt-unicode@schmorp.de"><rxvt-unicode@schmorp.de</a></em>&gt;</a></strong><br /> 1915<dt><strong><a name="item_marc_alexander_lehmann__3crxvt_2dunicode_40schmorp">Marc Alexander Lehmann <em><a href="mailto:<rxvt-unicode@schmorp.de"><rxvt-unicode@schmorp.de</a></em>&gt;</a></strong><br />
1890</dt> 1916</dt>
1891<dd> 1917<dd>
1892Forked rxvt-unicode, rewrote most of the display code and internal 1918Forked rxvt-unicode, unicode support, rewrote almost all the code, perl
1893character handling to store text in unicode, improve xterm 1919extension, random hacks, numerous bugfixes and extensions.
1894compatibility and apply numerous other bugfixes and extensions.
1895</dd> 1920</dd>
1896<dd> 1921<dd>
1897<p>Project Coordinator (Changes 1.0 -)</p> 1922<p>Project Coordinator (Changes 1.0 -)</p>
1923</dd>
1924<p></p>
1925<dt><strong><a name="item_emanuele_giaquinta__3ce_2egiaquinta_40glauco_2eit_">Emanuele Giaquinta <em><a href="mailto:<e.giaquinta@glauco.it"><e.giaquinta@glauco.it</a></em>&gt;</a></strong><br />
1926</dt>
1927<dd>
1928Pty/tty/utmp/wtmp rewrite, lots of random hacking and bugfixing.
1898</dd> 1929</dd>
1899<p></p></dl> 1930<p></p></dl>
1900 1931
1901</body> 1932</body>
1902 1933

Diff Legend

Removed lines
+ Added lines
< Changed lines
> Changed lines