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.17 by root, Thu Feb 17 15:07:48 2005 UTC vs.
Revision 1.23 by root, Thu Jul 7 19:37:46 2005 UTC

… …
47<p><strong>rxvt</strong> [options] [-e command [ args ]]</p> 47<p><strong>rxvt</strong> [options] [-e command [ args ]]</p>
48<p> 48<p>
49</p> 49</p>
50<hr /> 50<hr />
51<h1><a name="description">DESCRIPTION</a></h1> 51<h1><a name="description">DESCRIPTION</a></h1>
52<p><strong>rxvt-unicode</strong>, version <strong>5.2</strong>, is a colour vt102 terminal 52<p><strong>rxvt-unicode</strong>, version <strong>5.6</strong>, is a colour vt102 terminal
53emulator intended as an <em>xterm</em>(1) replacement for users who do not 53emulator intended as an <em>xterm</em>(1) replacement for users who do not
54require features such as Tektronix 4014 emulation and toolkit-style 54require features such as Tektronix 4014 emulation and toolkit-style
55configurability. As a result, <strong>rxvt-unicode</strong> uses much less swap space -- 55configurability. As a result, <strong>rxvt-unicode</strong> uses much less swap space --
56a significant advantage on a machine serving many X sessions.</p> 56a significant advantage on a machine serving many X sessions.</p>
57<p> 57<p>
… …
336</dd> 336</dd>
337<p></p> 337<p></p>
338<dt><strong><a name="item__2dst_7c_2bst"><strong>-st</strong>|<strong>+st</strong></a></strong><br /> 338<dt><strong><a name="item__2dst_7c_2bst"><strong>-st</strong>|<strong>+st</strong></a></strong><br />
339</dt> 339</dt>
340<dd> 340<dd>
341Display normal (non XTerm/NeXT) scrollbar without/with a trough; 341Display rxvt (non XTerm/NeXT) scrollbar without/with a trough;
342resource <strong>scrollBar_floating</strong>. 342resource <strong>scrollBar_floating</strong>.
343</dd> 343</dd>
344<p></p> 344<p></p>
345<dt><strong><a name="item__2dptab_7c_2bptab"><strong>-ptab</strong>|<strong>+ptab</strong></a></strong><br /> 345<dt><strong><a name="item__2dptab_7c_2bptab"><strong>-ptab</strong>|<strong>+ptab</strong></a></strong><br />
346</dt> 346</dt>
… …
545<p>Here is a short Gtk2-perl snippet that illustrates how this option can be 545<p>Here is a short Gtk2-perl snippet that illustrates how this option can be
546used (a longer example is in <em>doc/embed</em>):</p> 546used (a longer example is in <em>doc/embed</em>):</p>
547</dd> 547</dd>
548<dd> 548<dd>
549<pre> 549<pre>
550 my $rxvt = new Gtk2::DrawingArea; 550 my $rxvt = new Gtk2::Socket;
551 $...-&gt;add ($rxvt); # important to add it somewhere first 551 $rxvt-&gt;signal_connect_after (realize =&gt; sub {
552 $rxvt-&gt;realize; # now it can be realized
553 my $xid = $rxvt-&gt;window-&gt;get_xid;</pre> 552 my $xid = $_[0]-&gt;window-&gt;get_xid;
554</dd>
555<dd>
556<pre>
557 system &quot;rxvt -embed $xid &amp;&quot;;</pre> 553 system &quot;rxvt -embed $xid &amp;&quot;;
554 });</pre>
558</dd> 555</dd>
559<p></p> 556<p></p>
560<dt><strong><a name="item__2dpty_2dfd_fileno"><strong>-pty-fd</strong> <em>fileno</em></a></strong><br /> 557<dt><strong><a name="item__2dpty_2dfd_fileno"><strong>-pty-fd</strong> <em>fileno</em></a></strong><br />
561</dt> 558</dt>
562<dd> 559<dd>
… …
580 use Fcntl;</pre> 577 use Fcntl;</pre>
581</dd> 578</dd>
582<dd> 579<dd>
583<pre> 580<pre>
584 my $pty = new IO::Pty; 581 my $pty = new IO::Pty;
585 fcntl $pty, F_SETFD, 0; # clear close-on-exec</pre> 582 fcntl $pty, F_SETFD, 0; # clear close-on-exec
586</dd>
587<dd>
588<pre>
589 system &quot;rxvt -pty-fd &quot; . (fileno $pty) . &quot;&amp;&quot;;</pre> 583 system &quot;rxvt -pty-fd &quot; . (fileno $pty) . &quot;&amp;&quot;;
584 close $pty;</pre>
590</dd> 585</dd>
591<dd> 586<dd>
592<pre> 587<pre>
593 # now communicate with rxvt 588 # now communicate with rxvt
594 my $slave = $pty-&gt;slave; 589 my $slave = $pty-&gt;slave;
… …
767<p></p> 762<p></p>
768<dt><strong><a name="item_troughcolor_3a_colour"><strong>troughColor:</strong> <em>colour</em></a></strong><br /> 763<dt><strong><a name="item_troughcolor_3a_colour"><strong>troughColor:</strong> <em>colour</em></a></strong><br />
769</dt> 764</dt>
770<dd> 765<dd>
771Use the specified colour for the scrollbar's trough area [default 766Use the specified colour for the scrollbar's trough area [default
772#969696]. Only relevant for normal (non XTerm/NeXT) scrollbar. 767#969696]. Only relevant for rxvt (non XTerm/NeXT) scrollbar.
773</dd> 768</dd>
774<p></p> 769<p></p>
775<dt><strong><a name="item_bordercolor_3a_colour"><strong>borderColor:</strong> <em>colour</em></a></strong><br /> 770<dt><strong><a name="item_bordercolor_3a_colour"><strong>borderColor:</strong> <em>colour</em></a></strong><br />
776</dt> 771</dt>
777<dd> 772<dd>
… …
897<p></p> 892<p></p>
898<dt><strong><a name="item_scrollstyle_3a_mode"><strong>scrollstyle:</strong> <em>mode</em></a></strong><br /> 893<dt><strong><a name="item_scrollstyle_3a_mode"><strong>scrollstyle:</strong> <em>mode</em></a></strong><br />
899</dt> 894</dt>
900<dd> 895<dd>
901Set scrollbar style to <strong>rxvt</strong>, <strong>plain</strong>, <strong>next</strong> or <strong>xterm</strong>. <strong>plain</strong> is 896Set scrollbar style to <strong>rxvt</strong>, <strong>plain</strong>, <strong>next</strong> or <strong>xterm</strong>. <strong>plain</strong> is
902the author's favourite.. 897the author's favourite.
903</dd> 898</dd>
904<p></p> 899<p></p>
905<dt><strong><a name="item_title_3a_string"><strong>title:</strong> <em>string</em></a></strong><br /> 900<dt><strong><a name="item_title_3a_string"><strong>title:</strong> <em>string</em></a></strong><br />
906</dt> 901</dt>
907<dd> 902<dd>
… …
952</dt> 947</dt>
953<dd> 948<dd>
954Specify a command pipe for vt100 printer [default <em>lpr(1)</em>]. Use 949Specify a command pipe for vt100 printer [default <em>lpr(1)</em>]. Use
955<strong>Print</strong> to initiate a screen dump to the printer and <strong>Ctrl-Print</strong> or 950<strong>Print</strong> to initiate a screen dump to the printer and <strong>Ctrl-Print</strong> or
956<strong>Shift-Print</strong> to include the scrollback as well. 951<strong>Shift-Print</strong> to include the scrollback as well.
952</dd>
953<dd>
954<p>The string will be interpreted as if typed into the shell as-is.</p>
955</dd>
956<dd>
957<p>Example:</p>
958</dd>
959<dd>
960<pre>
961 URxvt*print-pipe: cat &gt; $(TMPDIR=$HOME mktemp urxvt.XXXXXX)</pre>
962</dd>
963<dd>
964<p>This creates a new file in your home directory with the screen contents
965everytime you hit <code>Print</code>.</p>
957</dd> 966</dd>
958<p></p> 967<p></p>
959<dt><strong><a name="item_scrollbar_3a_boolean"><strong>scrollBar:</strong> <em>boolean</em></a></strong><br /> 968<dt><strong><a name="item_scrollbar_3a_boolean"><strong>scrollBar:</strong> <em>boolean</em></a></strong><br />
960</dt> 969</dt>
961<dd> 970<dd>
… …
1100</dd> 1109</dd>
1101<p></p> 1110<p></p>
1102<dt><strong><a name="item_pointerblankdelay_3a_number"><strong>pointerBlankDelay:</strong> <em>number</em></a></strong><br /> 1111<dt><strong><a name="item_pointerblankdelay_3a_number"><strong>pointerBlankDelay:</strong> <em>number</em></a></strong><br />
1103</dt> 1112</dt>
1104<dd> 1113<dd>
1105Specifies number of seconds before blanking the pointer [default 2]. 1114Specifies number of seconds before blanking the pointer [default 2]. Use a
1115large number (e.g. <code>987654321</code>) to effectively disable the timeout.
1106</dd> 1116</dd>
1107<p></p> 1117<p></p>
1108<dt><strong><a name="item_backspacekey_3a_string"><strong>backspacekey:</strong> <em>string</em></a></strong><br /> 1118<dt><strong><a name="item_backspacekey_3a_string"><strong>backspacekey:</strong> <em>string</em></a></strong><br />
1109</dt> 1119</dt>
1110<dd> 1120<dd>
… …
1285when Control-Meta-c is being pressed'':</p> 1295when Control-Meta-c is being pressed'':</p>
1286</dd> 1296</dd>
1287<dd> 1297<dd>
1288<pre> 1298<pre>
1289 URxvt.keysym.M-C-c: command:\033]701;zh_CN.GBK\007</pre> 1299 URxvt.keysym.M-C-c: command:\033]701;zh_CN.GBK\007</pre>
1300</dd>
1301<dd>
1302<p>Due the the large number of modifier combinations, a defined key mapping
1303will match if at <em>at least</em> the specified identifiers are being set, and
1304no other key mappings with those and more bits are being defined. That
1305means that defining a key map for <code>a</code> will automatically provide
1306definitions for <code>Meta-a</code>, <code>Shift-a</code> and so on, unless some of those are defined
1307mappings themselves.</p>
1308</dd>
1309<dd>
1310<p>Unfortunately, this will override built-in key mappings. For example
1311if you overwrite the <code>Insert</code> key you will disable rxvt's
1312<code>Shift-Insert</code> mapping. To re-enable that, you can poke ``holes'' into the
1313user-defined keymap using the <code>builtin:</code> replacement:</p>
1314</dd>
1315<dd>
1316<pre>
1317 URxvt.keysym.Insert: &lt;my insert key sequence&gt;
1318 URxvt.keysym.S-Insert: builtin:</pre>
1319</dd>
1320<dd>
1321<p>The first line defines a mapping for <code>Insert</code> and <em>any</em> combination
1322of modifiers. The second line re-establishes the default mapping for
1323<code>Shift-Insert</code>.</p>
1290</dd> 1324</dd>
1291<dd> 1325<dd>
1292<p>The following example will map Control-Meta-1 and Control-Meta-2 to 1326<p>The following example will map Control-Meta-1 and Control-Meta-2 to
1293the fonts <code>suxuseuro</code> and <code>9x15bold</code>, so you can have some limited 1327the fonts <code>suxuseuro</code> and <code>9x15bold</code>, so you can have some limited
1294font-switching at runtime:</p> 1328font-switching at runtime:</p>
… …
1561<dd> 1595<dd>
1562The unix domain socket path used by <code>rxvtc(1)</code> and 1596The unix domain socket path used by <code>rxvtc(1)</code> and
1563rxvtd(1). 1597rxvtd(1).
1564</dd> 1598</dd>
1565<dd> 1599<dd>
1566<p>Default <code>$HOME/.rxvt-unicode-&lt;nodename</code>.</p> 1600<p>Default <em>$HOME/.rxvt-unicode-<em>&lt;nodename </em></em> &gt;&gt;&gt;.</p>
1567</dd> 1601</dd>
1568<p></p> 1602<p></p>
1569<dt><strong><a name="item_home"><strong>HOME</strong></a></strong><br /> 1603<dt><strong><a name="item_home"><strong>HOME</strong></a></strong><br />
1570</dt> 1604</dt>
1571<dd> 1605<dd>
… …
1600<p></p></dl> 1634<p></p></dl>
1601<p> 1635<p>
1602</p> 1636</p>
1603<hr /> 1637<hr />
1604<h1><a name="see_also">SEE ALSO</a></h1> 1638<h1><a name="see_also">SEE ALSO</a></h1>
1605<p>rxvt(7), xterm(1), sh(1), resize(1), X(1), pty(4), tty(4), <code>utmp(5)</code></p> 1639<p>rxvt(7), rxvtc(1), rxvtd(1), xterm(1), sh(1), resize(1), X(1), pty(4), tty(4), <code>utmp(5)</code></p>
1606<p> 1640<p>
1607</p> 1641</p>
1608<hr /> 1642<hr />
1609<h1><a name="bugs">BUGS</a></h1> 1643<h1><a name="bugs">BUGS</a></h1>
1610<p>Check the BUGS file for an up-to-date list.</p> 1644<p>Check the BUGS file for an up-to-date list.</p>

Diff Legend

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