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.47 by root, Mon Jan 16 15:12:48 2006 UTC vs.
Revision 1.54 by root, Sun Jan 29 21:45:47 2006 UTC

… …
46<p><strong>rxvt</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.4</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>
… …
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> 134</dd>
135<p></p> 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>.
141</dd>
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>
139Window geometry (<strong>-g</strong> still respected); resource <strong>geometry</strong>. 146Window geometry (<strong>-g</strong> still respected); resource <strong>geometry</strong>.
140</dd> 147</dd>
… …
413</dt> 420</dt>
414<dd> 421<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>.
425</dd>
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>.
418</dd> 432</dd>
419<p></p> 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>
… …
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>rxvtperl(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>.
… …
1201</dd> 1222</dd>
1202<p></p> 1223<p></p>
1203<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 />
1204</dt> 1225</dt>
1205<dd> 1226<dd>
1206The characters used as delimiters for double-click word selection. The 1227The characters used as delimiters for double-click word selection
1207built-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>
1208</dd> 1239</dd>
1209<dd> 1240<dd>
1210<p><strong>BACKSLASH ```'&amp;()*,;&lt;=</strong>?@[]{|} &gt;&gt;</p> 1241<p><strong>BACKSLASH ```'&amp;()*,;&lt;=</strong>?@[]{|} &gt;&gt;</p>
1211</dd> 1242</dd>
1212<p></p> 1243<p></p>
… …
1281Specify 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)
1282character is passed through. It may contain escape values as described 1313character is passed through. It may contain escape values as described
1283in the entry on <strong>keysym</strong> following. 1314in the entry on <strong>keysym</strong> following.
1284</dd> 1315</dd>
1285<p></p> 1316<p></p>
1286<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 />
1287</dt> 1318</dt>
1288<dd> 1319<dd>
1289Turn on/off secondary screen (default enabled). 1320Turn on/off secondary screen (default enabled).
1290</dd> 1321</dd>
1291<p></p> 1322<p></p>
1292<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 />
1293</dt> 1324</dt>
1294<dd> 1325<dd>
1295Turn on/off secondary screen scroll (default enabled). If the this 1326Turn on/off secondary screen scroll (default enabled). If the this
1296option is enabled, scrolls on the secondary screen will change the 1327option is enabled, scrolls on the secondary screen will change the
1297scrollback buffer and switching to/from the secondary screen will 1328scrollback buffer and switching to/from the secondary screen will
1298instead scroll the screen up. 1329instead scroll the screen up.
1299</dd> 1330</dd>
1300<p></p> 1331<p></p>
1301<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 />
1302</dt> 1333</dt>
1303<dd> 1334<dd>
1304Turn on/off hold window after exit support. If enabled, rxvt 1335Turn on/off hold window after exit support. If enabled, rxvt
1305will not immediately destroy its window when the program executed within 1336will not immediately destroy its window when the program executed within
1306it 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
… …
1514</dd> 1545</dd>
1515<p></p> 1546<p></p>
1516<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 />
1517</dt> 1548</dt>
1518<dd> 1549<dd>
1519Sets 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>.
1520</dd> 1558</dd>
1521<p></p></dl> 1559<p></p></dl>
1522<p> 1560<p>
1523</p> 1561</p>
1524<hr /> 1562<hr />
… …
1569</dd> 1607</dd>
1570<p></p> 1608<p></p>
1571<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 />
1572</dt> 1610</dt>
1573<dd> 1611<dd>
1574Pressing and releasing the Middle mouse button (or <strong>Shift-Insert</strong>) in 1612Pressing and releasing the Middle mouse button in an <strong>rxvt</strong>
1575an <strong>rxvt</strong> window causes the current text selection to be 1613window causes the value of the PRIMARY selection (or CLIPBOARD with the
1576inserted 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>
1577</dd> 1619</dd>
1578<p></p></dl> 1620<p></p></dl>
1579<p> 1621<p>
1580</p> 1622</p>
1581<hr /> 1623<hr />
… …
1660<hr /> 1702<hr />
1661<h1><a name="colors_and_graphics">COLORS AND GRAPHICS</a></h1> 1703<h1><a name="colors_and_graphics">COLORS AND GRAPHICS</a></h1>
1662<p>In addition to the default foreground and background colours, 1704<p>In addition to the default foreground and background colours,
1663<strong>rxvt</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
1664high-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
1665colours with their <strong>rgb.txt</strong> names.</p> 1707colours with their names.</p>
1666<table> 1708<table>
1667<tr><td>color0</td><td>(black)</td><td>= Black</td></tr> 1709<tr><td>color0</td><td>(black)</td><td>= Black</td></tr>
1668<tr><td>color1</td><td>(red)</td><td>= Red3</td></tr> 1710<tr><td>color1</td><td>(red)</td><td>= Red3</td></tr>
1669<tr><td>color2</td><td>(green)</td><td>= Green3</td></tr> 1711<tr><td>color2</td><td>(green)</td><td>= Green3</td></tr>
1670<tr><td>color3</td><td>(yellow)</td><td>= Yellow3</td></tr> 1712<tr><td>color3</td><td>(yellow)</td><td>= Yellow3</td></tr>
… …
1684<tr><td>background</td><td></td><td>= White</td></tr> 1726<tr><td>background</td><td></td><td>= White</td></tr>
1685</table><p>It is also possible to specify the colour values of <strong>foreground</strong>, 1727</table><p>It is also possible to specify the colour values of <strong>foreground</strong>,
1686<strong>background</strong>, <strong>cursorColor</strong>, <strong>cursorColor2</strong>, <strong>colorBD</strong>, <strong>colorUL</strong> as 1728<strong>background</strong>, <strong>cursorColor</strong>, <strong>cursorColor2</strong>, <strong>colorBD</strong>, <strong>colorUL</strong> as
1687a number 0-15, as a convenient shorthand to reference the colour name of 1729a number 0-15, as a convenient shorthand to reference the colour name of
1688color0-color15.</p> 1730color0-color15.</p>
1731<p>If Xft support has been compiled in and as long as Xft/Xrender/X don't get
1732their act together, rxvt-unicode will support <code>rgba:rrrr/gggg/bbbb/aaaa</code>
1733(recommended, but <strong>MUST</strong> have 4 digits/component), <code>#ARGB</code>, <code>#AARRGGBB</code>
1734and <code>#AAAARRRRGGGGBBBB</code> colour specifications, in addition to the ones
1735provided by X, where the additional A component specifies alpha (opacity)
1736values (0 is completely transparent and the maximum is opaque). You
1737probably need to specify <strong>``-depth 32''</strong>, too, and have the luck that your
1738X-server uses ARGB pixel layout, as X is far from just supporting ARGB
1739visuals out of the box, and rxvt-unicode just fudges around.</p>
1689<p>Note that <strong>-rv</strong> (<strong>``reverseVideo: True''</strong>) simulates reverse video by 1740<p>Note that <strong>-rv</strong> (<strong>``reverseVideo: True''</strong>) simulates reverse video by
1690always swapping the foreground/background colours. This is in contrast to 1741always swapping the foreground/background colours. This is in contrast to
1691<em>xterm</em>(1) where the colours are only swapped if they have not otherwise 1742<em>xterm</em>(1) where the colours are only swapped if they have not otherwise
1692been specified. For example,</p> 1743been specified. For example,</p>
1693<dl> 1744<dl>
… …
1859</dd> 1910</dd>
1860<p></p> 1911<p></p>
1861<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 /> 1912<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 />
1862</dt> 1913</dt>
1863<dd> 1914<dd>
1864Rewrote screen display and text selection routines. Project Coordinator 1915Rewrote screen display and text selection routines.
1865(changes.txt 2.4.6 - rxvt-unicode) 1916
1917</dd>
1918<dd>
1919<pre>
1920
1921Project Coordinator (changes.txt 2.4.6 - rxvt-unicode)</pre>
1866</dd> 1922</dd>
1867<p></p> 1923<p></p>
1868<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 /> 1924<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 />
1869</dt> 1925</dt>
1870<dd> 1926<dd>
1871Forked rxvt-unicode, rewrote most of the display code and internal 1927Forked rxvt-unicode, unicode support, rewrote almost all the code, perl
1872character handling to store text in unicode, improve xterm 1928extension, random hacks, numerous bugfixes and extensions.
1873compatibility and apply numerous other bugfixes and extensions.
1874</dd> 1929</dd>
1875<dd> 1930<dd>
1876<p>Project Coordinator (Changes 1.0 -)</p> 1931<p>Project Coordinator (Changes 1.0 -)</p>
1932</dd>
1933<p></p>
1934<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 />
1935</dt>
1936<dd>
1937Pty/tty/utmp/wtmp rewrite, lots of random hacking and bugfixing.
1877</dd> 1938</dd>
1878<p></p></dl> 1939<p></p></dl>
1879 1940
1880</body> 1941</body>
1881 1942

Diff Legend

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