--- rxvt-unicode/doc/rxvt.1.pod	2004/12/15 05:10:57	1.36
+++ rxvt-unicode/doc/rxvt.1.pod	2005/01/16 19:22:16	1.43
@@ -112,7 +112,7 @@
 
 =item B<-fade> I<number>
 
-Fade the text by the given percentage when focus is lost.
+Fade the text by the given percentage when focus is lost. resource B<fading>.
 
 =item B<-tint> I<colour>
 
@@ -138,8 +138,8 @@
 =item B<-pixmap> I<file[;geom]>
 
 Compile I<XPM>: Specify XPM file for the background and also optionally
-specify its scaling with a geometry string. Note you may need to add
-quotes to avoid special shell interpretation of the `;' in the
+specify its scaling with a geometry string. Note you may need to
+add quotes to avoid special shell interpretation of the C<;> in the
 command-line; resource B<backgroundPixmap>.
 
 =item B<-cr> I<colour>
@@ -282,8 +282,9 @@
 
 =item B<-lsp> I<number>
 
-Compile I<linespace>: Lines (pixel height) to insert between each row
-of the display; resource B<linespace>.
+Compile I<frills>: Lines (pixel height) to insert between each row of
+the display. Useful to work around font rendering problems; resource
+B<linespace>.
 
 =item B<-tn> I<termname>
 
@@ -429,7 +430,7 @@
 
 Use the specified colour to display bold or italic characters when the
 foreground colour is the default. If font styles are not available
-(Compile styles) and this option is unset, reverse video is used instead.
+(Compile I<styles>) and this option is unset, reverse video is used instead.
 
 =item B<colorUL:> I<colour>
 
@@ -535,7 +536,7 @@
 appended to it. option B<-fn>.
 
 Each font can either be a standard X11 core font (XLFD) name, with
-optional prefix C<x:> or a Xft font (Compile xft), prefixed with C<xft:>.
+optional prefix C<x:> or a Xft font (Compile I<xft>), prefixed with C<xft:>.
 
 In addition, each font can be prefixed with additional hints and
 specifications enclosed in square brackets (C<[]>). The only available
@@ -819,14 +820,50 @@
 
 =item B<keysym.>I<sym>: I<string>
 
-Associate I<string> with keysym I<sym> (B<0xFF00 - 0xFFFF>). It may
-contain escape values (\a: bell, \b: backspace, \e, \E: escape, \n:
-newline, \r: return, \t:
-tab, \000: octal number) or control characters (^?: delete, ^@: null,
-^A ...) and may enclosed with double quotes so that it can start or end
-with whitespace. The intervening resource name B<keysym.> cannot be
-omitted. This resource is only available when compiled with
-KEYSYM_RESOURCE.
+Compile I<frills>: Associate I<string> with keysym I<sym>. The
+intervening resource name B<keysym.> cannot be omitted.
+
+The format of I<sym> is "I<(modifiers-)key>", where I<modifiers> can be
+any combination of B<ISOLevel3>, B<AppKeypad>, B<Control>, B<NumLock>,
+B<Shift>, B<Meta>, B<Lock>, B<Mod1>, B<Mod2>, B<Mod3>, B<Mod4>, B<Mod5>,
+and the abbreviated B<I>, B<K>, B<C>, B<N>, B<S>, B<M>, B<A>, B<L>, B<1>,
+B<2>, B<3>, B<4>, B<5>.
+
+The B<NumLock>, B<Meta> and B<ISOLevel3> modifiers are usually aliased to
+whatever modifier the NumLock key, Meta/Alt keys or ISO Level3 Shift/AltGr
+keys are being mapped. B<AppKeypad> is a artificial modifier mapped to the
+current application keymap mode state.
+
+The spellings of I<key> can be obtained by using B<xev>(1) command or
+searching keysym macros from B</usr/X11R6/include/X11/keysymdef.h> and
+omitting the prefix B<XK_>. Alternatively you can specify I<key> by its hex
+keysym value (B<0x0000 - 0xFFFF>). Note that the lookup of I<sym>s is not
+performed in an exact manner; however, the closest match is assured.
+
+I<string> may contain escape values (C<\a>: bell, C<\b>: backspace,
+C<\e>, C<\E>: escape, C<\n>: newline, C<\r>: carriage return, C<\t>: tab,
+C<\000>: octal number) or verbatim control characters (C<^?>: delete,
+C<^@>: null, C<^A> ...) and may be enclosed with double quotes so that it
+can start or end with whitespace.
+
+You can define a range of keysyms in one shot by providing a I<string>
+with pattern B<list/PREFIX/MIDDLE/SUFFIX>, where the delimeter `/'
+should be a character not used by the strings.
+
+Its usage can be demonstrated by an example:
+
+  URxvt.keysym.M-C-0x61:    list|\e<M-C-|abc|>
+
+The above line is equivalent to the following three lines:
+
+  URxvt.keysym.Meta-Control-0x61:    \e<M-C-a>
+  URxvt.keysym.Meta-Control-0x62:    \e<M-C-b>
+  URxvt.keysym.Meta-Control-0x63:    \e<M-C-c>
+
+If I<string> takes the form of C<proto:STRING>, the specified B<STRING> is
+interpreted and executed as @@RXVT_NAME@@'s control sequence. For example,
+C<proto:\033]701;zh_CN.GBK\007> means: change the current locale to
+C<zh_CN.GBK>.
 
 =back
 
@@ -870,7 +907,7 @@
 line.
 
 Starting a selection while pressing the B<Meta> key (or B<Meta+Ctrl> keys)
-(Compile: frills) will create a rectangular selection instead of a normal
+(Compile: I<frills>) will create a rectangular selection instead of a normal
 one.
 
 =item B<Insertion>: