… | |
… | |
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.8</strong>, is a colour vt102 terminal |
53 | emulator intended as an <em>xterm</em>(1) replacement for users who do not |
53 | emulator intended as an <em>xterm</em>(1) replacement for users who do not |
54 | require features such as Tektronix 4014 emulation and toolkit-style |
54 | require features such as Tektronix 4014 emulation and toolkit-style |
55 | configurability. As a result, <strong>rxvt-unicode</strong> uses much less swap space -- |
55 | configurability. As a result, <strong>rxvt-unicode</strong> uses much less swap space -- |
56 | a significant advantage on a machine serving many X sessions.</p> |
56 | a significant advantage on a machine serving many X sessions.</p> |
57 | <p> |
57 | <p> |
… | |
… | |
150 | </dt> |
150 | </dt> |
151 | <dd> |
151 | <dd> |
152 | Turn on/off jump scrolling; resource <strong>jumpScroll</strong>. |
152 | Turn on/off jump scrolling; resource <strong>jumpScroll</strong>. |
153 | </dd> |
153 | </dd> |
154 | <p></p> |
154 | <p></p> |
155 | <dt><strong><a name="item__2dip_7c_2bip"><strong>-ip</strong>|<strong>+ip</strong></a></strong><br /> |
155 | <dt><strong><a name="item__2dip_7c_2bip__7c__2dtr_7c_2btr"><strong>-ip</strong>|<strong>+ip</strong> | <strong>-tr</strong>|<strong>+tr</strong></a></strong><br /> |
156 | </dt> |
156 | </dt> |
157 | <dd> |
157 | <dd> |
158 | Turn on/off inheriting parent window's pixmap. Alternative form is |
158 | Turn on/off inheriting parent window's pixmap. Alternative form is |
159 | <strong>-tr</strong>; resource <strong>inheritPixmap</strong>. |
159 | <strong>-tr</strong>; resource <strong>inheritPixmap</strong>. |
160 | </dd> |
160 | </dd> |
161 | <p></p> |
161 | <p></p> |
162 | <dt><strong><a name="item__2dfade_number"><strong>-fade</strong> <em>number</em></a></strong><br /> |
162 | <dt><strong><a name="item__2dfade_number"><strong>-fade</strong> <em>number</em></a></strong><br /> |
163 | </dt> |
163 | </dt> |
164 | <dd> |
164 | <dd> |
165 | Fade the text by the given percentage when focus is lost. resource <strong>fading</strong>. |
165 | Fade the text by the given percentage when focus is lost. Small values |
|
|
166 | fade a little only, 100 completely replaces all colours by the fade |
|
|
167 | colour; resource <strong>fading</strong>. |
|
|
168 | </dd> |
|
|
169 | <p></p> |
|
|
170 | <dt><strong><a name="item__2dfadecolor_colour"><strong>-fadecolor</strong> <em>colour</em></a></strong><br /> |
|
|
171 | </dt> |
|
|
172 | <dd> |
|
|
173 | Fade to this colour when fading is used (see <strong>-fade</strong>). The default colour |
|
|
174 | is black. resource <strong>fadeColor</strong>. |
166 | </dd> |
175 | </dd> |
167 | <p></p> |
176 | <p></p> |
168 | <dt><strong><a name="item__2dtint_colour"><strong>-tint</strong> <em>colour</em></a></strong><br /> |
177 | <dt><strong><a name="item__2dtint_colour"><strong>-tint</strong> <em>colour</em></a></strong><br /> |
169 | </dt> |
178 | </dt> |
170 | <dd> |
179 | <dd> |
171 | Tint the transparent background pixmap with the given colour when |
180 | Tint the transparent background pixmap with the given colour when |
172 | transparency is enabled with <strong>-tr</strong> or <strong>-ip</strong>. See also the <strong>-sh</strong> |
181 | transparency is enabled with <strong>-tr</strong> or <strong>-ip</strong>. This only works for |
173 | option that can be used to brighten or darken the image in addition to |
182 | non-tiled backgrounds, currently. See also the <strong>-sh</strong> option that can be |
174 | tinting it. |
183 | used to brighten or darken the image in addition to tinting it; resource |
|
|
184 | <em>tintColor</em>. Example: |
|
|
185 | </dd> |
|
|
186 | <dd> |
|
|
187 | <pre> |
|
|
188 | rxvt -tr -tint blue -sh 40</pre> |
175 | </dd> |
189 | </dd> |
176 | <p></p> |
190 | <p></p> |
177 | <dt><strong><a name="item__2dsh"><strong>-sh</strong></a></strong><br /> |
191 | <dt><strong><a name="item__2dsh"><strong>-sh</strong></a></strong><br /> |
178 | </dt> |
192 | </dt> |
179 | <dd> |
193 | <dd> |
… | |
… | |
336 | </dd> |
350 | </dd> |
337 | <p></p> |
351 | <p></p> |
338 | <dt><strong><a name="item__2dst_7c_2bst"><strong>-st</strong>|<strong>+st</strong></a></strong><br /> |
352 | <dt><strong><a name="item__2dst_7c_2bst"><strong>-st</strong>|<strong>+st</strong></a></strong><br /> |
339 | </dt> |
353 | </dt> |
340 | <dd> |
354 | <dd> |
341 | Display normal (non XTerm/NeXT) scrollbar without/with a trough; |
355 | Display rxvt (non XTerm/NeXT) scrollbar without/with a trough; |
342 | resource <strong>scrollBar_floating</strong>. |
356 | resource <strong>scrollBar_floating</strong>. |
343 | </dd> |
357 | </dd> |
344 | <p></p> |
358 | <p></p> |
345 | <dt><strong><a name="item__2dptab_7c_2bptab"><strong>-ptab</strong>|<strong>+ptab</strong></a></strong><br /> |
359 | <dt><strong><a name="item__2dptab_7c_2bptab"><strong>-ptab</strong>|<strong>+ptab</strong></a></strong><br /> |
346 | </dt> |
360 | </dt> |
… | |
… | |
545 | <p>Here is a short Gtk2-perl snippet that illustrates how this option can be |
559 | <p>Here is a short Gtk2-perl snippet that illustrates how this option can be |
546 | used (a longer example is in <em>doc/embed</em>):</p> |
560 | used (a longer example is in <em>doc/embed</em>):</p> |
547 | </dd> |
561 | </dd> |
548 | <dd> |
562 | <dd> |
549 | <pre> |
563 | <pre> |
550 | my $rxvt = new Gtk2::DrawingArea; |
564 | my $rxvt = new Gtk2::Socket; |
551 | $...->add ($rxvt); # important to add it somewhere first |
565 | $rxvt->signal_connect_after (realize => sub { |
552 | $rxvt->realize; # now it can be realized |
|
|
553 | my $xid = $rxvt->window->get_xid;</pre> |
566 | my $xid = $_[0]->window->get_xid; |
554 | </dd> |
|
|
555 | <dd> |
|
|
556 | <pre> |
|
|
557 | system "rxvt -embed $xid &";</pre> |
567 | system "rxvt -embed $xid &"; |
|
|
568 | });</pre> |
558 | </dd> |
569 | </dd> |
559 | <p></p> |
570 | <p></p> |
560 | <dt><strong><a name="item__2dpty_2dfd_fileno"><strong>-pty-fd</strong> <em>fileno</em></a></strong><br /> |
571 | <dt><strong><a name="item__2dpty_2dfd_fileno"><strong>-pty-fd</strong> <em>fileno</em></a></strong><br /> |
561 | </dt> |
572 | </dt> |
562 | <dd> |
573 | <dd> |
… | |
… | |
580 | use Fcntl;</pre> |
591 | use Fcntl;</pre> |
581 | </dd> |
592 | </dd> |
582 | <dd> |
593 | <dd> |
583 | <pre> |
594 | <pre> |
584 | my $pty = new IO::Pty; |
595 | my $pty = new IO::Pty; |
585 | fcntl $pty, F_SETFD, 0; # clear close-on-exec</pre> |
596 | fcntl $pty, F_SETFD, 0; # clear close-on-exec |
586 | </dd> |
|
|
587 | <dd> |
|
|
588 | <pre> |
|
|
589 | system "rxvt -pty-fd " . (fileno $pty) . "&";</pre> |
597 | system "rxvt -pty-fd " . (fileno $pty) . "&"; |
|
|
598 | close $pty;</pre> |
590 | </dd> |
599 | </dd> |
591 | <dd> |
600 | <dd> |
592 | <pre> |
601 | <pre> |
593 | # now communicate with rxvt |
602 | # now communicate with rxvt |
594 | my $slave = $pty->slave; |
603 | my $slave = $pty->slave; |
… | |
… | |
741 | </dd> |
750 | </dd> |
742 | <p></p> |
751 | <p></p> |
743 | <dt><strong><a name="item_fading_3a_number"><strong>fading:</strong> <em>number</em></a></strong><br /> |
752 | <dt><strong><a name="item_fading_3a_number"><strong>fading:</strong> <em>number</em></a></strong><br /> |
744 | </dt> |
753 | </dt> |
745 | <dd> |
754 | <dd> |
746 | Fade the text by the given percentage when focus is lost. |
755 | Fade the text by the given percentage when focus is lost; option <strong>-fade</strong>. |
|
|
756 | </dd> |
|
|
757 | <p></p> |
|
|
758 | <dt><strong><a name="item_fadecolor_3a_colour"><strong>fadeColor:</strong> <em>colour</em></a></strong><br /> |
|
|
759 | </dt> |
|
|
760 | <dd> |
|
|
761 | Fade to this colour, when fading is used (see <strong>fading:</strong>). The default |
|
|
762 | colour is black; option <strong>-fadecolor</strong>. |
747 | </dd> |
763 | </dd> |
748 | <p></p> |
764 | <p></p> |
749 | <dt><strong><a name="item_tintcolor_3a_colour"><strong>tintColor:</strong> <em>colour</em></a></strong><br /> |
765 | <dt><strong><a name="item_tintcolor_3a_colour"><strong>tintColor:</strong> <em>colour</em></a></strong><br /> |
750 | </dt> |
766 | </dt> |
751 | <dd> |
767 | <dd> |
752 | Tint the transparent background pixmap with the given colour. |
768 | Tint the transparent background pixmap with the given colour; option |
|
|
769 | <strong>-tint</strong>. |
753 | </dd> |
770 | </dd> |
754 | <p></p> |
771 | <p></p> |
755 | <dt><strong><a name="item_shading_3a_number"><strong>shading:</strong> <em>number</em></a></strong><br /> |
772 | <dt><strong><a name="item_shading_3a_number"><strong>shading:</strong> <em>number</em></a></strong><br /> |
756 | </dt> |
773 | </dt> |
757 | <dd> |
774 | <dd> |
… | |
… | |
767 | <p></p> |
784 | <p></p> |
768 | <dt><strong><a name="item_troughcolor_3a_colour"><strong>troughColor:</strong> <em>colour</em></a></strong><br /> |
785 | <dt><strong><a name="item_troughcolor_3a_colour"><strong>troughColor:</strong> <em>colour</em></a></strong><br /> |
769 | </dt> |
786 | </dt> |
770 | <dd> |
787 | <dd> |
771 | Use the specified colour for the scrollbar's trough area [default |
788 | Use the specified colour for the scrollbar's trough area [default |
772 | #969696]. Only relevant for normal (non XTerm/NeXT) scrollbar. |
789 | #969696]. Only relevant for rxvt (non XTerm/NeXT) scrollbar. |
773 | </dd> |
790 | </dd> |
774 | <p></p> |
791 | <p></p> |
775 | <dt><strong><a name="item_bordercolor_3a_colour"><strong>borderColor:</strong> <em>colour</em></a></strong><br /> |
792 | <dt><strong><a name="item_bordercolor_3a_colour"><strong>borderColor:</strong> <em>colour</em></a></strong><br /> |
776 | </dt> |
793 | </dt> |
777 | <dd> |
794 | <dd> |
… | |
… | |
897 | <p></p> |
914 | <p></p> |
898 | <dt><strong><a name="item_scrollstyle_3a_mode"><strong>scrollstyle:</strong> <em>mode</em></a></strong><br /> |
915 | <dt><strong><a name="item_scrollstyle_3a_mode"><strong>scrollstyle:</strong> <em>mode</em></a></strong><br /> |
899 | </dt> |
916 | </dt> |
900 | <dd> |
917 | <dd> |
901 | Set scrollbar style to <strong>rxvt</strong>, <strong>plain</strong>, <strong>next</strong> or <strong>xterm</strong>. <strong>plain</strong> is |
918 | Set scrollbar style to <strong>rxvt</strong>, <strong>plain</strong>, <strong>next</strong> or <strong>xterm</strong>. <strong>plain</strong> is |
902 | the author's favourite.. |
919 | the author's favourite. |
903 | </dd> |
920 | </dd> |
904 | <p></p> |
921 | <p></p> |
905 | <dt><strong><a name="item_title_3a_string"><strong>title:</strong> <em>string</em></a></strong><br /> |
922 | <dt><strong><a name="item_title_3a_string"><strong>title:</strong> <em>string</em></a></strong><br /> |
906 | </dt> |
923 | </dt> |
907 | <dd> |
924 | <dd> |
… | |
… | |
952 | </dt> |
969 | </dt> |
953 | <dd> |
970 | <dd> |
954 | Specify a command pipe for vt100 printer [default <em>lpr(1)</em>]. Use |
971 | Specify 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 |
972 | <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. |
973 | <strong>Shift-Print</strong> to include the scrollback as well. |
|
|
974 | </dd> |
|
|
975 | <dd> |
|
|
976 | <p>The string will be interpreted as if typed into the shell as-is.</p> |
|
|
977 | </dd> |
|
|
978 | <dd> |
|
|
979 | <p>Example:</p> |
|
|
980 | </dd> |
|
|
981 | <dd> |
|
|
982 | <pre> |
|
|
983 | URxvt*print-pipe: cat > $(TMPDIR=$HOME mktemp urxvt.XXXXXX)</pre> |
|
|
984 | </dd> |
|
|
985 | <dd> |
|
|
986 | <p>This creates a new file in your home directory with the screen contents |
|
|
987 | everytime you hit <code>Print</code>.</p> |
957 | </dd> |
988 | </dd> |
958 | <p></p> |
989 | <p></p> |
959 | <dt><strong><a name="item_scrollbar_3a_boolean"><strong>scrollBar:</strong> <em>boolean</em></a></strong><br /> |
990 | <dt><strong><a name="item_scrollbar_3a_boolean"><strong>scrollBar:</strong> <em>boolean</em></a></strong><br /> |
960 | </dt> |
991 | </dt> |
961 | <dd> |
992 | <dd> |
… | |
… | |
1100 | </dd> |
1131 | </dd> |
1101 | <p></p> |
1132 | <p></p> |
1102 | <dt><strong><a name="item_pointerblankdelay_3a_number"><strong>pointerBlankDelay:</strong> <em>number</em></a></strong><br /> |
1133 | <dt><strong><a name="item_pointerblankdelay_3a_number"><strong>pointerBlankDelay:</strong> <em>number</em></a></strong><br /> |
1103 | </dt> |
1134 | </dt> |
1104 | <dd> |
1135 | <dd> |
1105 | Specifies number of seconds before blanking the pointer [default 2]. |
1136 | Specifies number of seconds before blanking the pointer [default 2]. Use a |
|
|
1137 | large number (e.g. <code>987654321</code>) to effectively disable the timeout. |
1106 | </dd> |
1138 | </dd> |
1107 | <p></p> |
1139 | <p></p> |
1108 | <dt><strong><a name="item_backspacekey_3a_string"><strong>backspacekey:</strong> <em>string</em></a></strong><br /> |
1140 | <dt><strong><a name="item_backspacekey_3a_string"><strong>backspacekey:</strong> <em>string</em></a></strong><br /> |
1109 | </dt> |
1141 | </dt> |
1110 | <dd> |
1142 | <dd> |
… | |
… | |
1285 | when Control-Meta-c is being pressed'':</p> |
1317 | when Control-Meta-c is being pressed'':</p> |
1286 | </dd> |
1318 | </dd> |
1287 | <dd> |
1319 | <dd> |
1288 | <pre> |
1320 | <pre> |
1289 | URxvt.keysym.M-C-c: command:\033]701;zh_CN.GBK\007</pre> |
1321 | URxvt.keysym.M-C-c: command:\033]701;zh_CN.GBK\007</pre> |
|
|
1322 | </dd> |
|
|
1323 | <dd> |
|
|
1324 | <p>Due the the large number of modifier combinations, a defined key mapping |
|
|
1325 | will match if at <em>at least</em> the specified identifiers are being set, and |
|
|
1326 | no other key mappings with those and more bits are being defined. That |
|
|
1327 | means that defining a key map for <code>a</code> will automatically provide |
|
|
1328 | definitions for <code>Meta-a</code>, <code>Shift-a</code> and so on, unless some of those are defined |
|
|
1329 | mappings themselves.</p> |
|
|
1330 | </dd> |
|
|
1331 | <dd> |
|
|
1332 | <p>Unfortunately, this will override built-in key mappings. For example |
|
|
1333 | if you overwrite the <code>Insert</code> key you will disable rxvt's |
|
|
1334 | <code>Shift-Insert</code> mapping. To re-enable that, you can poke ``holes'' into the |
|
|
1335 | user-defined keymap using the <code>builtin:</code> replacement:</p> |
|
|
1336 | </dd> |
|
|
1337 | <dd> |
|
|
1338 | <pre> |
|
|
1339 | URxvt.keysym.Insert: <my insert key sequence> |
|
|
1340 | URxvt.keysym.S-Insert: builtin:</pre> |
|
|
1341 | </dd> |
|
|
1342 | <dd> |
|
|
1343 | <p>The first line defines a mapping for <code>Insert</code> and <em>any</em> combination |
|
|
1344 | of modifiers. The second line re-establishes the default mapping for |
|
|
1345 | <code>Shift-Insert</code>.</p> |
1290 | </dd> |
1346 | </dd> |
1291 | <dd> |
1347 | <dd> |
1292 | <p>The following example will map Control-Meta-1 and Control-Meta-2 to |
1348 | <p>The following example will map Control-Meta-1 and Control-Meta-2 to |
1293 | the fonts <code>suxuseuro</code> and <code>9x15bold</code>, so you can have some limited |
1349 | the fonts <code>suxuseuro</code> and <code>9x15bold</code>, so you can have some limited |
1294 | font-switching at runtime:</p> |
1350 | font-switching at runtime:</p> |
… | |
… | |
1561 | <dd> |
1617 | <dd> |
1562 | The unix domain socket path used by <code>rxvtc(1)</code> and |
1618 | The unix domain socket path used by <code>rxvtc(1)</code> and |
1563 | rxvtd(1). |
1619 | rxvtd(1). |
1564 | </dd> |
1620 | </dd> |
1565 | <dd> |
1621 | <dd> |
1566 | <p>Default <code>$HOME/.rxvt-unicode-<nodename</code>.</p> |
1622 | <p>Default <em>$HOME/.rxvt-unicode-<em><nodename </em></em> >>>.</p> |
1567 | </dd> |
1623 | </dd> |
1568 | <p></p> |
1624 | <p></p> |
1569 | <dt><strong><a name="item_home"><strong>HOME</strong></a></strong><br /> |
1625 | <dt><strong><a name="item_home"><strong>HOME</strong></a></strong><br /> |
1570 | </dt> |
1626 | </dt> |
1571 | <dd> |
1627 | <dd> |
… | |
… | |
1600 | <p></p></dl> |
1656 | <p></p></dl> |
1601 | <p> |
1657 | <p> |
1602 | </p> |
1658 | </p> |
1603 | <hr /> |
1659 | <hr /> |
1604 | <h1><a name="see_also">SEE ALSO</a></h1> |
1660 | <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> |
1661 | <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> |
1662 | <p> |
1607 | </p> |
1663 | </p> |
1608 | <hr /> |
1664 | <hr /> |
1609 | <h1><a name="bugs">BUGS</a></h1> |
1665 | <h1><a name="bugs">BUGS</a></h1> |
1610 | <p>Check the BUGS file for an up-to-date list.</p> |
1666 | <p>Check the BUGS file for an up-to-date list.</p> |