… | |
… | |
21 | <li><a href="#rxvtunicode_vs__rxvt">RXVT-UNICODE VS. RXVT</a></li> |
21 | <li><a href="#rxvtunicode_vs__rxvt">RXVT-UNICODE VS. RXVT</a></li> |
22 | <li><a href="#options">OPTIONS</a></li> |
22 | <li><a href="#options">OPTIONS</a></li> |
23 | <li><a href="#resources__available_also_as_longoptions_">RESOURCES (available also as long-options)</a></li> |
23 | <li><a href="#resources__available_also_as_longoptions_">RESOURCES (available also as long-options)</a></li> |
24 | <li><a href="#the_scrollbar">THE SCROLLBAR</a></li> |
24 | <li><a href="#the_scrollbar">THE SCROLLBAR</a></li> |
25 | <li><a href="#mouse_reporting">MOUSE REPORTING</a></li> |
25 | <li><a href="#mouse_reporting">MOUSE REPORTING</a></li> |
26 | <li><a href="#text_selection_and_insertion">TEXT SELECTION AND INSERTION</a></li> |
26 | <li><a href="#the_selection__selecting_and_pasting_text">THE SELECTION: SELECTING AND PASTING TEXT</a></li> |
27 | <li><a href="#changing_fonts">CHANGING FONTS</a></li> |
27 | <li><a href="#changing_fonts">CHANGING FONTS</a></li> |
28 | <li><a href="#iso_14755_support">ISO 14755 SUPPORT</a></li> |
28 | <li><a href="#iso_14755_support">ISO 14755 SUPPORT</a></li> |
29 | <li><a href="#login_stamp">LOGIN STAMP</a></li> |
29 | <li><a href="#login_stamp">LOGIN STAMP</a></li> |
30 | <li><a href="#colors_and_graphics">COLORS AND GRAPHICS</a></li> |
30 | <li><a href="#colors_and_graphics">COLORS AND GRAPHICS</a></li> |
31 | <ul> |
31 | <ul> |
… | |
… | |
53 | <p><strong>rxvt</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.9</strong>, is a colour vt102 terminal |
58 | <p><strong>rxvt-unicode</strong>, version <strong>8.2</strong>, is a colour vt102 terminal |
59 | emulator intended as an <em>xterm</em>(1) replacement for users who do not |
59 | emulator intended as an <em>xterm</em>(1) replacement for users who do not |
60 | require features such as Tektronix 4014 emulation and toolkit-style |
60 | require features such as Tektronix 4014 emulation and toolkit-style |
61 | configurability. As a result, <strong>rxvt-unicode</strong> uses much less swap space -- |
61 | configurability. As a result, <strong>rxvt-unicode</strong> uses much less swap space -- |
62 | a significant advantage on a machine serving many X sessions.</p> |
62 | a significant advantage on a machine serving many X sessions.</p> |
63 | <p> |
63 | <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>rxvt(7)</code> (try <code>man 7 rxvt</code>) for a list of |
67 | <p>See <code>rxvt(7)</code> (try <code>man 7 rxvt</code>) for a list of |
68 | frequently asked questions and answer to them and some common |
68 | frequently asked questions and answer to them and some common |
69 | problems. That document is also accessible on the World-Wide-Web at |
69 | problems. 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/rxvt-unicode/doc/rxvt.7.html">http://cvs.schmorp.de/browse/rxvt-unicode/doc/rxvt.7.html</a>.</p> |
71 | <p> |
71 | <p> |
72 | </p> |
72 | </p> |
73 | <hr /> |
73 | <hr /> |
74 | <h1><a name="rxvtunicode_vs__rxvt">RXVT-UNICODE VS. RXVT</a></h1> |
74 | <h1><a name="rxvtunicode_vs__rxvt">RXVT-UNICODE VS. RXVT</a></h1> |
75 | <p>Unlike the original rxvt, <strong>rxvt-unicode</strong> stores all text in Unicode |
75 | <p>Unlike the original rxvt, <strong>rxvt-unicode</strong> stores all text in Unicode |
… | |
… | |
209 | <dt><strong><a name="item__2dsh"><strong>-sh</strong></a></strong> |
209 | <dt><strong><a name="item__2dsh"><strong>-sh</strong></a></strong> |
210 | |
210 | |
211 | <dd> |
211 | <dd> |
212 | <p><em>number</em> Darken (0 .. 100) or lighten (-1 .. -100) the transparent |
212 | <p><em>number</em> Darken (0 .. 100) or lighten (-1 .. -100) the transparent |
213 | background image in addition to tinting it (i.e. <strong>-tint</strong> must be |
213 | background image in addition to tinting it (i.e. <strong>-tint</strong> must be |
214 | specified, too, e.g. <code>-tint white</code>).</p> |
214 | specified, too, e.g. <code>-tint white</code>); resource <em>shading</em>.</p> |
215 | </dd> |
215 | </dd> |
216 | </li> |
216 | </li> |
217 | <dt><strong><a name="item__2dbg_colour"><strong>-bg</strong> <em>colour</em></a></strong> |
217 | <dt><strong><a name="item__2dbg_colour"><strong>-bg</strong> <em>colour</em></a></strong> |
218 | |
218 | |
219 | <dd> |
219 | <dd> |
… | |
… | |
542 | </li> |
542 | </li> |
543 | <dt><strong><a name="item__2dtcw"><strong>-tcw</strong></a></strong> |
543 | <dt><strong><a name="item__2dtcw"><strong>-tcw</strong></a></strong> |
544 | |
544 | |
545 | <dd> |
545 | <dd> |
546 | <p>Change the meaning of triple-click selection with the left mouse |
546 | <p>Change the meaning of triple-click selection with the left mouse |
|
|
547 | button. Only effective when the original (non-perl) selection code is |
547 | button. Instead of selecting a full line it will extend the selection the |
548 | in-use. Instead of selecting a full line it will extend the selection the |
548 | end of the logical line only. resource <strong>tripleclickwords</strong>.</p> |
549 | end of the logical line only. resource <strong>tripleclickwords</strong>.</p> |
549 | </dd> |
550 | </dd> |
550 | </li> |
551 | </li> |
551 | <dt><strong><a name="item__2dinsecure"><strong>-insecure</strong></a></strong> |
552 | <dt><strong><a name="item__2dinsecure"><strong>-insecure</strong></a></strong> |
552 | |
553 | |
… | |
… | |
768 | </dd> |
769 | </dd> |
769 | </li> |
770 | </li> |
770 | <dt><strong><a name="item_colorrv_3a_colour"><strong>colorRV:</strong> <em>colour</em></a></strong> |
771 | <dt><strong><a name="item_colorrv_3a_colour"><strong>colorRV:</strong> <em>colour</em></a></strong> |
771 | |
772 | |
772 | <dd> |
773 | <dd> |
773 | <p>Use the specified colour as the background for reverse video |
774 | <p>Use the specified colour as the background for reverse video characters |
774 | characters.</p> |
775 | when OPTION_HC is disabled (--disable-frills).</p> |
775 | </dd> |
776 | </dd> |
776 | </li> |
777 | </li> |
777 | <dt><strong><a name="item_underlinecolor_3a_colour"><strong>underlineColor:</strong> <em>colour</em></a></strong> |
778 | <dt><strong><a name="item_underlinecolor_3a_colour"><strong>underlineColor:</strong> <em>colour</em></a></strong> |
778 | |
779 | |
779 | <dd> |
780 | <dd> |
… | |
… | |
845 | </dd> |
846 | </dd> |
846 | </li> |
847 | </li> |
847 | <dt><strong><a name="item_shading_3a_number"><strong>shading:</strong> <em>number</em></a></strong> |
848 | <dt><strong><a name="item_shading_3a_number"><strong>shading:</strong> <em>number</em></a></strong> |
848 | |
849 | |
849 | <dd> |
850 | <dd> |
850 | <p>Darken (0 .. 100) or lighten (-1 .. -100) the transparent background |
851 | <p>Darken (0 .. 100) or lighten (-1 .. -100) the transparent background image |
851 | image in addition to tinting it.</p> |
852 | in addition to tinting it; option <strong>-sh</strong>.</p> |
852 | </dd> |
853 | </dd> |
853 | </li> |
854 | </li> |
854 | <dt><strong><a name="item_scrollcolor_3a_colour"><strong>scrollColor:</strong> <em>colour</em></a></strong> |
855 | <dt><strong><a name="item_scrollcolor_3a_colour"><strong>scrollColor:</strong> <em>colour</em></a></strong> |
855 | |
856 | |
856 | <dd> |
857 | <dd> |
… | |
… | |
980 | </dd> |
981 | </dd> |
981 | </li> |
982 | </li> |
982 | <dt><strong><a name="item_selectstyle_3a_mode"><strong>selectstyle:</strong> <em>mode</em></a></strong> |
983 | <dt><strong><a name="item_selectstyle_3a_mode"><strong>selectstyle:</strong> <em>mode</em></a></strong> |
983 | |
984 | |
984 | <dd> |
985 | <dd> |
985 | <p>Set mouse selection style to <strong>old</strong> which is 2.20, <strong>oldword</strong> which is |
986 | <p>Set mouse selection style to <strong>old</strong> which is 2.20, <strong>oldword</strong> which |
986 | xterm style with 2.20 old word selection, or anything else which gives |
987 | is xterm style with 2.20 old word selection, or anything else which |
987 | xterm style selection.</p> |
988 | gives xterm style selection. Only effective when the original (non-perl) |
|
|
989 | selection code is in use.</p> |
988 | </dd> |
990 | </dd> |
989 | </li> |
991 | </li> |
990 | <dt><strong><a name="item_scrollstyle_3a_mode"><strong>scrollstyle:</strong> <em>mode</em></a></strong> |
992 | <dt><strong><a name="item_scrollstyle_3a_mode"><strong>scrollstyle:</strong> <em>mode</em></a></strong> |
991 | |
993 | |
992 | <dd> |
994 | <dd> |
… | |
… | |
1013 | <dt><strong><a name="item_mapalert_3a_boolean"><strong>mapAlert:</strong> <em>boolean</em></a></strong> |
1015 | <dt><strong><a name="item_mapalert_3a_boolean"><strong>mapAlert:</strong> <em>boolean</em></a></strong> |
1014 | |
1016 | |
1015 | <dd> |
1017 | <dd> |
1016 | <p><strong>True</strong>: de-iconify (map) on receipt of a bell character. <strong>False</strong>: no |
1018 | <p><strong>True</strong>: de-iconify (map) on receipt of a bell character. <strong>False</strong>: no |
1017 | de-iconify (map) on receipt of a bell character [default].</p> |
1019 | de-iconify (map) on receipt of a bell character [default].</p> |
|
|
1020 | </dd> |
|
|
1021 | </li> |
|
|
1022 | <dt><strong><a name="item_urgentonbell_3a_boolean"><strong>urgentOnBell:</strong> <em>boolean</em></a></strong> |
|
|
1023 | |
|
|
1024 | <dd> |
|
|
1025 | <p><strong>True</strong>: set the urgency hint for the wm on receipt of a bell character. |
|
|
1026 | <strong>False</strong>: do not set the urgency hint [default].</p> |
1018 | </dd> |
1027 | </dd> |
1019 | </li> |
1028 | </li> |
1020 | <dt><strong><a name="item_visualbell_3a_boolean"><strong>visualBell:</strong> <em>boolean</em></a></strong> |
1029 | <dt><strong><a name="item_visualbell_3a_boolean"><strong>visualBell:</strong> <em>boolean</em></a></strong> |
1021 | |
1030 | |
1022 | <dd> |
1031 | <dd> |
… | |
… | |
1243 | <dd> |
1252 | <dd> |
1244 | <p>The characters used as delimiters for double-click word selection |
1253 | <p>The characters used as delimiters for double-click word selection |
1245 | (whitespace delimiting is added automatically if resource is given).</p> |
1254 | (whitespace delimiting is added automatically if resource is given).</p> |
1246 | </dd> |
1255 | </dd> |
1247 | <dd> |
1256 | <dd> |
1248 | <p>When the selection extension is in use (the default if compiled in, see |
1257 | <p>When the perl selection extension is in use (the default if compiled |
1249 | the <code>rxvtperl(3)</code> manpage), a suitable regex using these characters |
1258 | in, see the <code>rxvtperl(3)</code> manpage), a suitable regex using these |
1250 | will be created (if the resource exists, otherwise, no regex will be |
1259 | characters will be created (if the resource exists, otherwise, no regex |
1251 | created). In this mode, characters outside ISO-8859-1 can be used.</p> |
1260 | will be created). In this mode, characters outside ISO-8859-1 can be used.</p> |
1252 | </dd> |
1261 | </dd> |
1253 | <dd> |
1262 | <dd> |
1254 | <p>When the selection extension is not used, only ISO-8859-1 characters can |
1263 | <p>When the selection extension is not used, only ISO-8859-1 characters can |
1255 | be used. If not specified, the built-in default is used:</p> |
1264 | be used. If not specified, the built-in default is used:</p> |
1256 | </dd> |
1265 | </dd> |
… | |
… | |
1338 | </dd> |
1347 | </dd> |
1339 | </li> |
1348 | </li> |
1340 | <dt><strong><a name="item_secondaryscroll_3a_boolean"><strong>secondaryScroll:</strong> <em>boolean</em></a></strong> |
1349 | <dt><strong><a name="item_secondaryscroll_3a_boolean"><strong>secondaryScroll:</strong> <em>boolean</em></a></strong> |
1341 | |
1350 | |
1342 | <dd> |
1351 | <dd> |
1343 | <p>Turn on/off secondary screen scroll (default enabled). If the this |
1352 | <p>Turn on/off secondary screen scroll (default enabled). If this |
1344 | option is enabled, scrolls on the secondary screen will change the |
1353 | option is enabled, scrolls on the secondary screen will change the |
1345 | scrollback buffer and switching to/from the secondary screen will |
1354 | scrollback buffer and switching to/from the secondary screen will |
1346 | instead scroll the screen up.</p> |
1355 | instead scroll the screen up.</p> |
1347 | </dd> |
1356 | </dd> |
1348 | </li> |
1357 | </li> |
… | |
… | |
1384 | <dd> |
1393 | <dd> |
1385 | <p><em>string</em> may contain escape values (<code>\a</code>: bell, <code>\b</code>: backspace, |
1394 | <p><em>string</em> may contain escape values (<code>\a</code>: bell, <code>\b</code>: backspace, |
1386 | <code>\e</code>, <code>\E</code>: escape, <code>\n</code>: newline, <code>\r</code>: carriage return, <code>\t</code>: tab, |
1395 | <code>\e</code>, <code>\E</code>: escape, <code>\n</code>: newline, <code>\r</code>: carriage return, <code>\t</code>: tab, |
1387 | <code>\000</code>: octal number) or verbatim control characters (<code>^?</code>: delete, |
1396 | <code>\000</code>: octal number) or verbatim control characters (<code>^?</code>: delete, |
1388 | <code>^@</code>: null, <code>^A</code> ...) and may be enclosed with double quotes so that it |
1397 | <code>^@</code>: null, <code>^A</code> ...) and may be enclosed with double quotes so that it |
1389 | can start or end with whitespace.</p> |
1398 | can start or end with whitespace. <strong>This feature is deprecated and will |
|
|
1399 | be removed</strong>.</p> |
1390 | </dd> |
1400 | </dd> |
1391 | <dd> |
1401 | <dd> |
1392 | <p>Please note that you need to double the <code>\</code> in resource files, as |
1402 | <p>Please note that you need to double the <code>\</code> in resource files, as |
1393 | Xlib itself does its own de-escaping (you can use <code>\033</code> instead of |
1403 | Xlib itself does its own de-escaping (you can use <code>\033</code> instead of |
1394 | <code>\e</code> (and so on), which will work with both Xt and rxvt's own |
1404 | <code>\e</code> (and so on), which will work with both Xt and rxvt's own |
… | |
… | |
1556 | </li> |
1566 | </li> |
1557 | <dt><strong><a name="item_urllauncher_3a_string"><strong>urlLauncher</strong>: <em>string</em></a></strong> |
1567 | <dt><strong><a name="item_urllauncher_3a_string"><strong>urlLauncher</strong>: <em>string</em></a></strong> |
1558 | |
1568 | |
1559 | <dd> |
1569 | <dd> |
1560 | <p>Specifies the program to be started with a URL argument. Used by the |
1570 | <p>Specifies the program to be started with a URL argument. Used by the |
1561 | <code>selection-popup</code> and <code>mark-urls</code> perl extensions.</p> |
1571 | <code>selection-popup</code> and <code>matcher</code> perl extensions.</p> |
1562 | </dd> |
1572 | </dd> |
1563 | </li> |
1573 | </li> |
1564 | <dt><strong><a name="item_transient_2dfor_3a_windowid"><strong>transient-for</strong>: <em>windowid</em></a></strong> |
1574 | <dt><strong><a name="item_transient_2dfor_3a_windowid"><strong>transient-for</strong>: <em>windowid</em></a></strong> |
1565 | |
1575 | |
1566 | <dd> |
1576 | <dd> |
… | |
… | |
1601 | up and down arrows sends <strong>ESC [ A</strong> (Up) and <strong>ESC [ B</strong> (Down), |
1611 | up and down arrows sends <strong>ESC [ A</strong> (Up) and <strong>ESC [ B</strong> (Down), |
1602 | respectively.</p> |
1612 | respectively.</p> |
1603 | <p> |
1613 | <p> |
1604 | </p> |
1614 | </p> |
1605 | <hr /> |
1615 | <hr /> |
1606 | <h1><a name="text_selection_and_insertion">TEXT SELECTION AND INSERTION</a></h1> |
1616 | <h1><a name="the_selection__selecting_and_pasting_text">THE SELECTION: SELECTING AND PASTING TEXT</a></h1> |
1607 | <p>The behaviour of text selection and insertion mechanism is similar to |
1617 | <p>The behaviour of text selection and insertion/pasting mechanism is similar |
1608 | <em>xterm</em>(1).</p> |
1618 | to <em>xterm</em>(1).</p> |
1609 | <dl> |
1619 | <dl> |
1610 | <dt><strong><a name="item_selection_3a"><strong>Selection</strong>:</a></strong> |
1620 | <dt><strong><a name="item_selecting_3a"><strong>Selecting</strong>:</a></strong> |
1611 | |
1621 | |
1612 | <dd> |
1622 | <dd> |
1613 | <p>Left click at the beginning of the region, drag to the end of the region |
1623 | <p>Left click at the beginning of the region, drag to the end of the region |
1614 | and release; Right click to extend the marked region; Left double-click |
1624 | and release; Right click to extend the marked region; Left double-click |
1615 | to select a word; Left triple-click to select the entire logical line |
1625 | to select a word; Left triple-click to select the entire logical line |
… | |
… | |
1622 | normal one. In this mode, every selected row becomes its own line in the |
1632 | normal one. In this mode, every selected row becomes its own line in the |
1623 | selection, and trailing whitespace is visually underlined and removed from |
1633 | selection, and trailing whitespace is visually underlined and removed from |
1624 | the selection.</p> |
1634 | the selection.</p> |
1625 | </dd> |
1635 | </dd> |
1626 | </li> |
1636 | </li> |
1627 | <dt><strong><a name="item_insertion_3a"><strong>Insertion</strong>:</a></strong> |
1637 | <dt><strong><a name="item_pasting_3a"><strong>Pasting</strong>:</a></strong> |
1628 | |
1638 | |
1629 | <dd> |
1639 | <dd> |
1630 | <p>Pressing and releasing the Middle mouse button in an <strong>rxvt</strong> |
1640 | <p>Pressing and releasing the Middle mouse button in an <strong>rxvt</strong> |
1631 | window causes the value of the PRIMARY selection (or CLIPBOARD with the |
1641 | window causes the value of the PRIMARY selection (or CLIPBOARD with the |
1632 | Meta modifier) to be inserted as if it had been typed on the keyboard.</p> |
1642 | <strong>Meta</strong> modifier) to be inserted as if it had been typed on the keyboard.</p> |
1633 | </dd> |
1643 | </dd> |
1634 | <dd> |
1644 | <dd> |
1635 | <p>Pressing <strong>Shift-Insert</strong> causes the value of the PRIMARY selection to be |
1645 | <p>Pressing <strong>Shift-Insert</strong> causes the value of the PRIMARY selection to be |
1636 | inserted too.</p> |
1646 | inserted too.</p> |
1637 | </dd> |
1647 | </dd> |
… | |
… | |
1774 | <p>If Xft support has been compiled in and as long as Xft/Xrender/X don't get |
1784 | <p>If Xft support has been compiled in and as long as Xft/Xrender/X don't get |
1775 | their act together, rxvt-unicode will support <code>rgba:rrrr/gggg/bbbb/aaaa</code> |
1785 | their act together, rxvt-unicode will support <code>rgba:rrrr/gggg/bbbb/aaaa</code> |
1776 | (recommended, but <strong>MUST</strong> have 4 digits/component) colour specifications, |
1786 | (recommended, but <strong>MUST</strong> have 4 digits/component) colour specifications, |
1777 | in addition to the ones provided by X, where the additional A component |
1787 | in addition to the ones provided by X, where the additional A component |
1778 | specifies opacity (alpha) values. The minimum value of <code>0</code> is completely |
1788 | specifies opacity (alpha) values. The minimum value of <code>0</code> is completely |
1779 | transparent). You can also prefix any color with <code>[a]</code>, where <code>a</code> is on |
1789 | transparent). You can also prefix any color with <code>[percent]</code>, where |
1780 | to four hex digits specifiying the opacity value.</p> |
1790 | <code>percent</code> is a decimal percentage (0-100) that specifies the opacity of |
|
|
1791 | the color, where <code>0</code> is completely transparent and <code>100</code> is completelxy |
|
|
1792 | opaque.</p> |
1781 | <p>You probably need to specify <strong>``-depth 32''</strong>, too, and have the luck that |
1793 | <p>You probably need to specify <strong>``-depth 32''</strong>, too, and have the luck that |
1782 | your X-server uses ARGB pixel layout, as X is far from just supporting |
1794 | your X-server uses ARGB pixel layout, as X is far from just supporting |
1783 | ARGB visuals out of the box, and rxvt-unicode just fudges around.</p> |
1795 | ARGB visuals out of the box, and rxvt-unicode just fudges around.</p> |
1784 | <p>For example, the following selects an almost completely transparent red |
1796 | <p>For example, the following selects an almost completely transparent red |
1785 | background, and an almost opaque pink foreground:</p> |
1797 | background, and an almost opaque pink foreground:</p> |
1786 | <pre> |
1798 | <pre> |
1787 | rxvt -depth 32 -bg rgba:0000/0000/0000/2222 -fg "[e]pink"</pre> |
1799 | rxvt -depth 32 -bg rgba:0000/0000/0000/aaaa -fg "[80]pink"</pre> |
1788 | <p><em>Please note that transparency of any kind if completely unsupported by |
1800 | <p><em>Please note that transparency of any kind if completely unsupported by |
1789 | the author. Don't bug him with installation questions!</em></p> |
1801 | the author. Don't bug him with installation questions!</em></p> |
1790 | <p> |
1802 | <p> |
1791 | </p> |
1803 | </p> |
1792 | <hr /> |
1804 | <hr /> |