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.48 by root, Thu Jan 19 19:26:30 2006 UTC vs.
Revision 1.56 by root, Tue Jan 31 00:25:16 2006 UTC

… …
24 <li><a href="#text_selection_and_insertion">TEXT SELECTION AND INSERTION</a></li> 24 <li><a href="#text_selection_and_insertion">TEXT SELECTION AND INSERTION</a></li>
25 <li><a href="#changing_fonts">CHANGING FONTS</a></li> 25 <li><a href="#changing_fonts">CHANGING FONTS</a></li>
26 <li><a href="#iso_14755_support">ISO 14755 SUPPORT</a></li> 26 <li><a href="#iso_14755_support">ISO 14755 SUPPORT</a></li>
27 <li><a href="#login_stamp">LOGIN STAMP</a></li> 27 <li><a href="#login_stamp">LOGIN STAMP</a></li>
28 <li><a href="#colors_and_graphics">COLORS AND GRAPHICS</a></li> 28 <li><a href="#colors_and_graphics">COLORS AND GRAPHICS</a></li>
29 <ul>
30
31 <li><a href="#alpha_channel_support">ALPHA CHANNEL SUPPORT</a></li>
32 </ul>
33
29 <li><a href="#environment">ENVIRONMENT</a></li> 34 <li><a href="#environment">ENVIRONMENT</a></li>
30 <li><a href="#files">FILES</a></li> 35 <li><a href="#files">FILES</a></li>
31 <li><a href="#see_also">SEE ALSO</a></li> 36 <li><a href="#see_also">SEE ALSO</a></li>
32 <li><a href="#current_project_coordinator">CURRENT PROJECT COORDINATOR</a></li> 37 <li><a href="#current_project_coordinator">CURRENT PROJECT COORDINATOR</a></li>
33 <li><a href="#authors">AUTHORS</a></li> 38 <li><a href="#authors">AUTHORS</a></li>
… …
46<p><strong>rxvt</strong> [options] [-e command [ args ]]</p> 51<p><strong>rxvt</strong> [options] [-e command [ args ]]</p>
47<p> 52<p>
48</p> 53</p>
49<hr /> 54<hr />
50<h1><a name="description">DESCRIPTION</a></h1> 55<h1><a name="description">DESCRIPTION</a></h1>
51<p><strong>rxvt-unicode</strong>, version <strong>7.1</strong>, is a colour vt102 terminal 56<p><strong>rxvt-unicode</strong>, version <strong>7.5</strong>, is a colour vt102 terminal
52emulator intended as an <em>xterm</em>(1) replacement for users who do not 57emulator intended as an <em>xterm</em>(1) replacement for users who do not
53require features such as Tektronix 4014 emulation and toolkit-style 58require features such as Tektronix 4014 emulation and toolkit-style
54configurability. As a result, <strong>rxvt-unicode</strong> uses much less swap space -- 59configurability. As a result, <strong>rxvt-unicode</strong> uses much less swap space --
55a significant advantage on a machine serving many X sessions.</p> 60a significant advantage on a machine serving many X sessions.</p>
56<p> 61<p>
… …
131Attempt to open a window on the named X display (<strong>-d</strong> still 136Attempt 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 137respected). In the absence of this option, the display specified by the
133<strong>DISPLAY</strong> environment variable is used. 138<strong>DISPLAY</strong> environment variable is used.
134</dd> 139</dd>
135<p></p> 140<p></p>
141<dt><strong><a name="item__2ddepth_bitdepth"><strong>-depth</strong> <em>bitdepth</em></a></strong><br />
142</dt>
143<dd>
144Compile <em>xft</em>: Attempt to find a visual with the given bit depth;
145resource <strong>depth</strong>.
146</dd>
147<p></p>
136<dt><strong><a name="item__2dgeometry_geom"><strong>-geometry</strong> <em>geom</em></a></strong><br /> 148<dt><strong><a name="item__2dgeometry_geom"><strong>-geometry</strong> <em>geom</em></a></strong><br />
137</dt> 149</dt>
138<dd> 150<dd>
139Window geometry (<strong>-g</strong> still respected); resource <strong>geometry</strong>. 151Window geometry (<strong>-g</strong> still respected); resource <strong>geometry</strong>.
140</dd> 152</dd>
… …
154<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 /> 166<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 />
155</dt> 167</dt>
156<dd> 168<dd>
157Turn on/off inheriting parent window's pixmap. Alternative form is 169Turn on/off inheriting parent window's pixmap. Alternative form is
158<strong>-tr</strong>; resource <strong>inheritPixmap</strong>. 170<strong>-tr</strong>; resource <strong>inheritPixmap</strong>.
171</dd>
172<dd>
173<p><em>Please note that transparency of any kind if completely unsupported by
174the author. Don't bug him with installation questions!</em></p>
159</dd> 175</dd>
160<p></p> 176<p></p>
161<dt><strong><a name="item__2dfade_number"><strong>-fade</strong> <em>number</em></a></strong><br /> 177<dt><strong><a name="item__2dfade_number"><strong>-fade</strong> <em>number</em></a></strong><br />
162</dt> 178</dt>
163<dd> 179<dd>
… …
168<p></p> 184<p></p>
169<dt><strong><a name="item__2dfadecolor_colour"><strong>-fadecolor</strong> <em>colour</em></a></strong><br /> 185<dt><strong><a name="item__2dfadecolor_colour"><strong>-fadecolor</strong> <em>colour</em></a></strong><br />
170</dt> 186</dt>
171<dd> 187<dd>
172Fade to this colour when fading is used (see <strong>-fade</strong>). The default colour 188Fade to this colour when fading is used (see <strong>-fade</strong>). The default colour
173is black. resource <strong>fadeColor</strong>. 189is opaque black. resource <strong>fadeColor</strong>.
174</dd> 190</dd>
175<p></p> 191<p></p>
176<dt><strong><a name="item__2dtint_colour"><strong>-tint</strong> <em>colour</em></a></strong><br /> 192<dt><strong><a name="item__2dtint_colour"><strong>-tint</strong> <em>colour</em></a></strong><br />
177</dt> 193</dt>
178<dd> 194<dd>
… …
681be used. Command-line arguments can be used to override resource 697be used. Command-line arguments can be used to override resource
682settings. The following resources are supported (you might want to 698settings. The following resources are supported (you might want to
683check the <code>rxvtperl(3)</code> manpage for additional settings by perl 699check the <code>rxvtperl(3)</code> manpage for additional settings by perl
684extensions not documented here):</p> 700extensions not documented here):</p>
685<dl> 701<dl>
702<dt><strong><a name="item_depth_3a_bitdepth"><strong>depth:</strong> <em>bitdepth</em></a></strong><br />
703</dt>
704<dd>
705Compile <em>xft</em>: Attempt to find a visual with the given bit depth;
706option <strong>-depth</strong>.
707</dd>
708<p></p>
686<dt><strong><a name="item_geometry_3a_geom"><strong>geometry:</strong> <em>geom</em></a></strong><br /> 709<dt><strong><a name="item_geometry_3a_geom"><strong>geometry:</strong> <em>geom</em></a></strong><br />
687</dt> 710</dt>
688<dd> 711<dd>
689Create the window with the specified X window geometry [default 80x24]; 712Create the window with the specified X window geometry [default 80x24];
690option <strong>-geometry</strong>. 713option <strong>-geometry</strong>.
… …
789</dt> 812</dt>
790<dd> 813<dd>
791<strong>True</strong>: make the background inherit the parent windows' pixmap, giving 814<strong>True</strong>: make the background inherit the parent windows' pixmap, giving
792artificial transparency. <strong>False</strong>: do not inherit the parent windows' 815artificial transparency. <strong>False</strong>: do not inherit the parent windows'
793pixmap. 816pixmap.
817</dd>
818<dd>
819<p><em>Please note that transparency of any kind if completely unsupported by
820the author. Don't bug him with installation questions!</em></p>
794</dd> 821</dd>
795<p></p> 822<p></p>
796<dt><strong><a name="item_fading_3a_number"><strong>fading:</strong> <em>number</em></a></strong><br /> 823<dt><strong><a name="item_fading_3a_number"><strong>fading:</strong> <em>number</em></a></strong><br />
797</dt> 824</dt>
798<dd> 825<dd>
… …
1208</dd> 1235</dd>
1209<p></p> 1236<p></p>
1210<dt><strong><a name="item_cutchars_3a_string"><strong>cutchars:</strong> <em>string</em></a></strong><br /> 1237<dt><strong><a name="item_cutchars_3a_string"><strong>cutchars:</strong> <em>string</em></a></strong><br />
1211</dt> 1238</dt>
1212<dd> 1239<dd>
1213The characters used as delimiters for double-click word selection. The 1240The characters used as delimiters for double-click word selection
1214built-in default: 1241(whitespace delimiting is added automatically if resource is given).
1242</dd>
1243<dd>
1244<p>When the selection extension is in use (the default if compiled in, see
1245the <code>rxvtperl(3)</code> manpage), a suitable regex using these characters
1246will be created (if the resource exists, otherwise, no regex will be
1247created). In this mode, characters outside ISO-8859-1 can be used.</p>
1248</dd>
1249<dd>
1250<p>When the selection extension is not used, only ISO-8859-1 characters can
1251be used. If not specified, the built-in default is used:</p>
1215</dd> 1252</dd>
1216<dd> 1253<dd>
1217<p><strong>BACKSLASH ```'&amp;()*,;&lt;=</strong>?@[]{|} &gt;&gt;</p> 1254<p><strong>BACKSLASH ```'&amp;()*,;&lt;=</strong>?@[]{|} &gt;&gt;</p>
1218</dd> 1255</dd>
1219<p></p> 1256<p></p>
… …
1583</dd> 1620</dd>
1584<p></p> 1621<p></p>
1585<dt><strong><a name="item_insertion_3a"><strong>Insertion</strong>:</a></strong><br /> 1622<dt><strong><a name="item_insertion_3a"><strong>Insertion</strong>:</a></strong><br />
1586</dt> 1623</dt>
1587<dd> 1624<dd>
1588Pressing and releasing the Middle mouse button (or <strong>Shift-Insert</strong>) in 1625Pressing and releasing the Middle mouse button in an <strong>rxvt</strong>
1589an <strong>rxvt</strong> window causes the current text selection to be 1626window causes the value of the PRIMARY selection (or CLIPBOARD with the
1590inserted as if it had been typed on the keyboard. 1627Meta modifier) to be inserted as if it had been typed on the keyboard.
1628</dd>
1629<dd>
1630<p>Pressing <strong>Shift-Insert</strong> causes the value of the PRIMARY selection to be
1631inserted too.</p>
1591</dd> 1632</dd>
1592<p></p></dl> 1633<p></p></dl>
1593<p> 1634<p>
1594</p> 1635</p>
1595<hr /> 1636<hr />
… …
1674<hr /> 1715<hr />
1675<h1><a name="colors_and_graphics">COLORS AND GRAPHICS</a></h1> 1716<h1><a name="colors_and_graphics">COLORS AND GRAPHICS</a></h1>
1676<p>In addition to the default foreground and background colours, 1717<p>In addition to the default foreground and background colours,
1677<strong>rxvt</strong> can display up to 16 colours (8 ANSI colours plus 1718<strong>rxvt</strong> can display up to 16 colours (8 ANSI colours plus
1678high-intensity bold/blink versions of the same). Here is a list of the 1719high-intensity bold/blink versions of the same). Here is a list of the
1679colours with their <strong>rgb.txt</strong> names.</p> 1720colours with their names.</p>
1680<table> 1721<table>
1681<tr><td>color0</td><td>(black)</td><td>= Black</td></tr> 1722<tr><td>color0</td><td>(black)</td><td>= Black</td></tr>
1682<tr><td>color1</td><td>(red)</td><td>= Red3</td></tr> 1723<tr><td>color1</td><td>(red)</td><td>= Red3</td></tr>
1683<tr><td>color2</td><td>(green)</td><td>= Green3</td></tr> 1724<tr><td>color2</td><td>(green)</td><td>= Green3</td></tr>
1684<tr><td>color3</td><td>(yellow)</td><td>= Yellow3</td></tr> 1725<tr><td>color3</td><td>(yellow)</td><td>= Yellow3</td></tr>
… …
1712on White. 1753on White.
1713</dd> 1754</dd>
1714<p></p></dl> 1755<p></p></dl>
1715<p> 1756<p>
1716</p> 1757</p>
1758<h2><a name="alpha_channel_support">ALPHA CHANNEL SUPPORT</a></h2>
1759<p>If Xft support has been compiled in and as long as Xft/Xrender/X don't get
1760their act together, rxvt-unicode will support <code>rgba:rrrr/gggg/bbbb/aaaa</code>
1761(recommended, but <strong>MUST</strong> have 4 digits/component) colour specifications,
1762in addition to the ones provided by X, where the additional A component
1763specifies opacity (alpha) values. The minimum value of <code>0</code> is completely
1764transparent). You can also prefix any color with <code>[a]</code>, where <code>a</code> is on
1765to four hex digits specifiying the opacity value.</p>
1766<p>You probably need to specify <strong>``-depth 32''</strong>, too, and have the luck that
1767your X-server uses ARGB pixel layout, as X is far from just supporting
1768ARGB visuals out of the box, and rxvt-unicode just fudges around.</p>
1769<p>For example, the following selects an almost completely transparent red
1770background, and an almost opaque pink foreground:</p>
1771<pre>
1772 rxvt -depth 32 -bg rgba:0000/0000/0000/2222 -fg &quot;[e]pink&quot;</pre>
1773<p><em>Please note that transparency of any kind if completely unsupported by
1774the author. Don't bug him with installation questions!</em></p>
1775<p>
1776</p>
1717<hr /> 1777<hr />
1718<h1><a name="environment">ENVIRONMENT</a></h1> 1778<h1><a name="environment">ENVIRONMENT</a></h1>
1719<p><strong>rxvt</strong> sets and/or uses the following environment variables:</p> 1779<p><strong>rxvt</strong> sets and/or uses the following environment variables:</p>
1720<dl> 1780<dl>
1721<dt><strong><a name="item_term"><strong>TERM</strong></a></strong><br /> 1781<dt><strong><a name="item_term"><strong>TERM</strong></a></strong><br />
… …
1895</dd> 1955</dd>
1896<p></p> 1956<p></p>
1897<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 /> 1957<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 />
1898</dt> 1958</dt>
1899<dd> 1959<dd>
1900Pty/tty/utmp/wtmp rewrite, lots of random hacking and bugxifing. 1960Pty/tty/utmp/wtmp rewrite, lots of random hacking and bugfixing.
1901</dd> 1961</dd>
1902<p></p></dl> 1962<p></p></dl>
1903 1963
1904</body> 1964</body>
1905 1965

Diff Legend

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