--- rxvt-unicode/doc/rxvt.1.html 2005/01/11 02:24:59 1.1 +++ rxvt-unicode/doc/rxvt.1.html 2005/01/16 15:59:45 1.2 @@ -1103,14 +1103,52 @@
keysym.sym: string
-Associate string with keysym sym (0xFF00 - 0xFFFF). It may +Associate string with keysym sym. The intervening resource +name keysym. cannot be omitted. This resource is only available +when compiled with KEYSYM_RESOURCE. +
+
+

The format of sym is ``(mask-)key'', +where mask can be any combination of Control, NumLock, +Shift, Meta, Lock, Mod1, Mod2, Mod3, Mod4, +Mod5, and the abbreviated +C, N, S, M, A, L, 1, 2, 3, 4, 5. +The spellings of key can be obtained by using xev(1) +command or searching keysym macros from +/usr/X11R6/include/X11/keysymdef.h and omit the prefix XK_. +Alternatively you can specify key by its hex keysym value +(0x0000 - 0xFFFF). +Note that the lookup of syms is not performed in an exact manner; +however, the closest match is assured.

+
+
+

string 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 keysym. cannot be -omitted. This resource is only available when compiled with -KEYSYM_RESOURCE. +with whitespace.

+
+
+

You can define a range of keysyms in one shot by providing a string +with pattern list/STRING1/STRING2/STRING3, 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.abc.\e<M-C-.>

+
+
+

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 string takes the form of proto:STRING, +the specified STRING is interpreted and executed as rxvt's +control sequence. For example, ``proto:\033]701;zh_CN.GBK\007'' +means changing the current locale to zh_CN.GBK.