From a63a25616b7b2adb18acebea1d6bd14c126a8a28 Mon Sep 17 00:00:00 2001
From: Ambrevar <ambrevar@gmail.com>
Date: Tue, 30 Oct 2012 19:05:22 +0100
Subject: [PATCH] XKB: added comments.

---
 .xkb/symbols/frex | 17 +++++++++++------
 1 file changed, 11 insertions(+), 6 deletions(-)

diff --git a/.xkb/symbols/frex b/.xkb/symbols/frex
index a65a0acd..87adc680 100644
--- a/.xkb/symbols/frex
+++ b/.xkb/symbols/frex
@@ -1,17 +1,22 @@
 //------------------------------------------------------------------------------
-// XKB Custom french keyboard
-// 2012-09-07
+// XKB Custom french keyboard (flawless)
+// 2012-10-30
 //------------------------------------------------------------------------------
 
-// Installation: copy this file to '/usr/share/X11/xkb/symbols'. You can use it
-// by selection the "frex" layout from Xorg configuration file, or by using the
-// following command:
-//
+// Installation: copy this file to '/usr/{local/,}share/X11/xkb/symbols'. You
+// can use it by selecting the "frex" layout from Xorg configuration file, or by
+// using the following command:
+
 //   setxkbmap frex
 
 // This is used to fix the conflicts generated by chain-includes from original
 // files.
 
+// List of common issues
+// * Right-Ctrl does not behave like Left-Ctrl.
+// * A lot of warning are reported by setxkbmap (you can see them in the TTY).
+// * Ctrl+Space generates a space instead of ^@ (which is used by Emacs).
+
 partial default alphanumeric_keys
 xkb_symbols "basic" {