--- rxvt-unicode/doc/rxvt.1.txt	2005/02/18 12:15:07	1.18
+++ rxvt-unicode/doc/rxvt.1.txt	2005/04/22 02:09:39	1.21
@@ -6,7 +6,7 @@
     rxvt [options] [-e command [ args ]]
 
 DESCRIPTION
-    rxvt-unicode, version 5.2, is a colour vt102 terminal emulator intended
+    rxvt-unicode, version 5.5, is a colour vt102 terminal emulator intended
     as an *xterm*(1) replacement for users who do not require features such
     as Tektronix 4014 emulation and toolkit-style configurability. As a
     result, rxvt-unicode uses much less swap space -- a significant
@@ -336,12 +336,11 @@
         Here is a short Gtk2-perl snippet that illustrates how this option
         can be used (a longer example is in doc/embed):
 
-           my $rxvt = new Gtk2::DrawingArea;
-           $...->add ($rxvt); # important to add it somewhere first
-           $rxvt->realize; # now it can be realized
-           my $xid = $rxvt->window->get_xid;
-
-           system "rxvt -embed $xid &";
+           my $rxvt = new Gtk2::Socket;
+           $rxvt->signal_connect_after (realize => sub {
+              my $xid = $_[0]->window->get_xid;
+              system "rxvt -embed $xid &";
+           });
 
     -pty-fd *fileno*
         Tells rxvt NOT to execute any commands or create a new pty/tty pair
@@ -700,6 +699,8 @@
 
     pointerBlankDelay: *number*
         Specifies number of seconds before blanking the pointer [default 2].
+        Use a large number (e.g. 987654321) to effectively disable the
+        timeout.
 
     backspacekey: *string*
         The string to send when the backspace key is pressed. If set to DEC
@@ -826,6 +827,25 @@
 
           URxvt.keysym.M-C-c: command:\033]701;zh_CN.GBK\007
 
+        Due the the large number of modifier combinations, a defined key
+        mapping will match if at *at least* 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 "a" will
+        automatically provide definitions for "Meta-a", "Shift-a" and so on,
+        unless some of those are defined mappings themselves.
+
+        Unfortunately, this will override built-in key mappings. For example
+        if you overwrite the "Insert" key you will disable rxvt's
+        "Shift-Insert" mapping. To re-enable that, you can poke "holes" into
+        the user-defined keymap using the "builtin:" replacement:
+
+          URxvt.keysym.Insert: <my insert key sequence>
+          URxvt.keysym.S-Insert: builtin:
+
+        The first line defines a mapping for "Insert" and *any* combination
+        of modifiers. The second line re-establishes the default mapping for
+        "Shift-Insert".
+
         The following example will map Control-Meta-1 and Control-Meta-2 to
         the fonts "suxuseuro" and "9x15bold", so you can have some limited
         font-switching at runtime: