From: Reginald Kennedy <rk@rejii.com>
Date: Sat, 12 May 2012 22:49:47 +0000 (+0800)
Subject: Add details to man page on how to bind non-latin characters.
X-Git-Tag: SPECTRWM_1_1_0~37
X-Git-Url: https://code.delx.au/spectrwm/commitdiff_plain/9e02feddd558ae6e6b87ba68343014b3342cbbc0

Add details to man page on how to bind non-latin characters.

From: Rovanion Luckey <rovanion.luckey@gmail.com>

ok marco
---

diff --git a/spectrwm.1 b/spectrwm.1
index 1bbbeda..2ec43fa 100644
--- a/spectrwm.1
+++ b/spectrwm.1
@@ -616,6 +616,24 @@ To use the currently defined
 specify MOD as the modifier key.
 .Pp
 Multiple key combinations may be bound to the same action.
+.Pp
+To bind non-latin characters such as å or π you must enter the xkb
+character name instead of the character itself. Run xev, focus the window
+and press the specific key and in the terminal output read the symbol name.
+In the fallowing example for å:
+.Bd -literal -offset indent
+KeyPress event, serial 41, synthetic NO, window 0x2600001,
+    root 0x15a, subw 0x0, time 106213808, (11,5), root:(359,823),
+    state 0x0, keycode 24 (keysym 0xe5, aring), same_screen YES,
+    XLookupString gives 2 bytes: (c3 a5) "Ã¥"
+    XmbLookupString gives 2 bytes: (c3 a5) "Ã¥"
+    XFilterEvent returns: False
+.Ed
+.Pp
+The xkb name is aring. In other words, in .spectrwm.conf add:
+.Bd -literal -offset indent
+bind[program] = MOD+aring
+.Ed
 .Sh KEYBOARD MAPPING FILES
 Keyboard mapping files for several keyboard layouts are listed
 below.