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.51 by root, Wed Jan 25 00:57:57 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.2</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>
1678<hr /> 1715<hr />
1679<h1><a name="colors_and_graphics">COLORS AND GRAPHICS</a></h1> 1716<h1><a name="colors_and_graphics">COLORS AND GRAPHICS</a></h1>
1680<p>In addition to the default foreground and background colours, 1717<p>In addition to the default foreground and background colours,
1681<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
1682high-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
1683colours with their <strong>rgb.txt</strong> names.</p> 1720colours with their names.</p>
1684<table> 1721<table>
1685<tr><td>color0</td><td>(black)</td><td>= Black</td></tr> 1722<tr><td>color0</td><td>(black)</td><td>= Black</td></tr>
1686<tr><td>color1</td><td>(red)</td><td>= Red3</td></tr> 1723<tr><td>color1</td><td>(red)</td><td>= Red3</td></tr>
1687<tr><td>color2</td><td>(green)</td><td>= Green3</td></tr> 1724<tr><td>color2</td><td>(green)</td><td>= Green3</td></tr>
1688<tr><td>color3</td><td>(yellow)</td><td>= Yellow3</td></tr> 1725<tr><td>color3</td><td>(yellow)</td><td>= Yellow3</td></tr>
1716on White. 1753on White.
1717</dd> 1754</dd>
1718<p></p></dl> 1755<p></p></dl>
1719<p> 1756<p>
1720</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>
1721<hr /> 1777<hr />
1722<h1><a name="environment">ENVIRONMENT</a></h1> 1778<h1><a name="environment">ENVIRONMENT</a></h1>
1723<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>
1724<dl> 1780<dl>
1725<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 />

Diff Legend

Removed lines
+ Added lines
< Changed lines
> Changed lines