--- rxvt-unicode/doc/rxvt.1.html	2005/04/17 22:36:13	1.20
+++ rxvt-unicode/doc/rxvt.1.html	2005/10/25 20:04:58	1.24
@@ -49,7 +49,7 @@
 </p>
 <hr />
 <h1><a name="description">DESCRIPTION</a></h1>
-<p><strong>rxvt-unicode</strong>, version <strong>5.3</strong>, is a colour vt102 terminal
+<p><strong>rxvt-unicode</strong>, version <strong>5.8</strong>, is a colour vt102 terminal
 emulator intended as an <em>xterm</em>(1) replacement for users who do not
 require features such as Tektronix 4014 emulation and toolkit-style
 configurability. As a result, <strong>rxvt-unicode</strong> uses much less swap space --
@@ -152,7 +152,7 @@
 Turn on/off jump scrolling; resource <strong>jumpScroll</strong>.
 </dd>
 <p></p>
-<dt><strong><a name="item__2dip_7c_2bip"><strong>-ip</strong>|<strong>+ip</strong></a></strong><br />
+<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 />
 </dt>
 <dd>
 Turn on/off inheriting parent window's pixmap. Alternative form is
@@ -162,16 +162,30 @@
 <dt><strong><a name="item__2dfade_number"><strong>-fade</strong> <em>number</em></a></strong><br />
 </dt>
 <dd>
-Fade the text by the given percentage when focus is lost. resource <strong>fading</strong>.
+Fade the text by the given percentage when focus is lost. Small values
+fade a little only, 100 completely replaces all colours by the fade
+colour; resource <strong>fading</strong>.
+</dd>
+<p></p>
+<dt><strong><a name="item__2dfadecolor_colour"><strong>-fadecolor</strong> <em>colour</em></a></strong><br />
+</dt>
+<dd>
+Fade to this colour when fading is used (see <strong>-fade</strong>). The default colour
+is black. resource <strong>fadeColor</strong>.
 </dd>
 <p></p>
 <dt><strong><a name="item__2dtint_colour"><strong>-tint</strong> <em>colour</em></a></strong><br />
 </dt>
 <dd>
 Tint the transparent background pixmap with the given colour when
-transparency is enabled with <strong>-tr</strong> or <strong>-ip</strong>. See also the <strong>-sh</strong>
-option that can be used to brighten or darken the image in addition to
-tinting it.
+transparency is enabled with <strong>-tr</strong> or <strong>-ip</strong>. This only works for
+non-tiled backgrounds, currently. See also the <strong>-sh</strong> option that can be
+used to brighten or darken the image in addition to tinting it; resource
+<em>tintColor</em>. Example:
+</dd>
+<dd>
+<pre>
+   rxvt -tr -tint blue -sh 40</pre>
 </dd>
 <p></p>
 <dt><strong><a name="item__2dsh"><strong>-sh</strong></a></strong><br />
@@ -338,7 +352,7 @@
 <dt><strong><a name="item__2dst_7c_2bst"><strong>-st</strong>|<strong>+st</strong></a></strong><br />
 </dt>
 <dd>
-Display normal (non XTerm/NeXT) scrollbar without/with a trough;
+Display rxvt (non XTerm/NeXT) scrollbar without/with a trough;
 resource <strong>scrollBar_floating</strong>.
 </dd>
 <p></p>
@@ -738,13 +752,21 @@
 <dt><strong><a name="item_fading_3a_number"><strong>fading:</strong> <em>number</em></a></strong><br />
 </dt>
 <dd>
-Fade the text by the given percentage when focus is lost.
+Fade the text by the given percentage when focus is lost; option <strong>-fade</strong>.
+</dd>
+<p></p>
+<dt><strong><a name="item_fadecolor_3a_colour"><strong>fadeColor:</strong> <em>colour</em></a></strong><br />
+</dt>
+<dd>
+Fade to this colour, when fading is used (see <strong>fading:</strong>). The default
+colour is black; option <strong>-fadecolor</strong>.
 </dd>
 <p></p>
 <dt><strong><a name="item_tintcolor_3a_colour"><strong>tintColor:</strong> <em>colour</em></a></strong><br />
 </dt>
 <dd>
-Tint the transparent background pixmap with the given colour.
+Tint the transparent background pixmap with the given colour; option
+<strong>-tint</strong>.
 </dd>
 <p></p>
 <dt><strong><a name="item_shading_3a_number"><strong>shading:</strong> <em>number</em></a></strong><br />
@@ -764,7 +786,7 @@
 </dt>
 <dd>
 Use the specified colour for the scrollbar's trough area [default
-#969696]. Only relevant for normal (non XTerm/NeXT) scrollbar.
+#969696]. Only relevant for rxvt (non XTerm/NeXT) scrollbar.
 </dd>
 <p></p>
 <dt><strong><a name="item_bordercolor_3a_colour"><strong>borderColor:</strong> <em>colour</em></a></strong><br />
@@ -894,7 +916,7 @@
 </dt>
 <dd>
 Set scrollbar style to <strong>rxvt</strong>, <strong>plain</strong>, <strong>next</strong> or <strong>xterm</strong>. <strong>plain</strong> is
-the author's favourite..
+the author's favourite.
 </dd>
 <p></p>
 <dt><strong><a name="item_title_3a_string"><strong>title:</strong> <em>string</em></a></strong><br />
@@ -950,6 +972,20 @@
 <strong>Print</strong> to initiate a screen dump to the printer and <strong>Ctrl-Print</strong> or
 <strong>Shift-Print</strong> to include the scrollback as well.
 </dd>
+<dd>
+<p>The string will be interpreted as if typed into the shell as-is.</p>
+</dd>
+<dd>
+<p>Example:</p>
+</dd>
+<dd>
+<pre>
+   URxvt*print-pipe: cat &gt; $(TMPDIR=$HOME mktemp urxvt.XXXXXX)</pre>
+</dd>
+<dd>
+<p>This creates a new file in your home directory with the screen contents
+everytime you hit <code>Print</code>.</p>
+</dd>
 <p></p>
 <dt><strong><a name="item_scrollbar_3a_boolean"><strong>scrollBar:</strong> <em>boolean</em></a></strong><br />
 </dt>
@@ -1285,6 +1321,30 @@
   URxvt.keysym.M-C-c: command:\033]701;zh_CN.GBK\007</pre>
 </dd>
 <dd>
+<p>Due the the large number of modifier combinations, a defined key mapping
+will match if at <em>at least</em> the specified identifiers are being set, and
+no other key mappings with those and more bits are being defined. That
+means that defining a key map for <code>a</code> will automatically provide
+definitions for <code>Meta-a</code>, <code>Shift-a</code> and so on, unless some of those are defined
+mappings themselves.</p>
+</dd>
+<dd>
+<p>Unfortunately, this will override built-in key mappings. For example
+if you overwrite the <code>Insert</code> key you will disable rxvt's
+<code>Shift-Insert</code> mapping. To re-enable that, you can poke ``holes'' into the
+user-defined keymap using the <code>builtin:</code> replacement:</p>
+</dd>
+<dd>
+<pre>
+  URxvt.keysym.Insert: &lt;my insert key sequence&gt;
+  URxvt.keysym.S-Insert: builtin:</pre>
+</dd>
+<dd>
+<p>The first line defines a mapping for <code>Insert</code> and <em>any</em> combination
+of modifiers. The second line re-establishes the default mapping for
+<code>Shift-Insert</code>.</p>
+</dd>
+<dd>
 <p>The following example will map Control-Meta-1 and Control-Meta-2 to
 the fonts <code>suxuseuro</code> and <code>9x15bold</code>, so you can have some limited
 font-switching at runtime:</p>
@@ -1559,7 +1619,7 @@
 rxvtd(1).
 </dd>
 <dd>
-<p>Default <code>$HOME/.rxvt-unicode-&lt;nodename</code>.</p>
+<p>Default <em>$HOME/.rxvt-unicode-<em>&lt;nodename </em></em> &gt;&gt;&gt;.</p>
 </dd>
 <p></p>
 <dt><strong><a name="item_home"><strong>HOME</strong></a></strong><br />
@@ -1598,7 +1658,7 @@
 </p>
 <hr />
 <h1><a name="see_also">SEE ALSO</a></h1>
-<p>rxvt(7), xterm(1), sh(1), resize(1), X(1), pty(4), tty(4), <code>utmp(5)</code></p>
+<p>rxvt(7), rxvtc(1), rxvtd(1), xterm(1), sh(1), resize(1), X(1), pty(4), tty(4), <code>utmp(5)</code></p>
 <p>
 </p>
 <hr />