summaryrefslogtreecommitdiff
path: root/src/SW/xf86-input-evdev/document.en.rest.txt
diff options
context:
space:
mode:
Diffstat (limited to 'src/SW/xf86-input-evdev/document.en.rest.txt')
-rw-r--r--src/SW/xf86-input-evdev/document.en.rest.txt21
1 files changed, 21 insertions, 0 deletions
diff --git a/src/SW/xf86-input-evdev/document.en.rest.txt b/src/SW/xf86-input-evdev/document.en.rest.txt
index 04dafaa..4935fed 100644
--- a/src/SW/xf86-input-evdev/document.en.rest.txt
+++ b/src/SW/xf86-input-evdev/document.en.rest.txt
@@ -6,6 +6,27 @@
:tags: - software
- keyboard
+.. admonition:: There's a better way!
+
+ These days, the recommended input driver for X11 is
+ ``xf86-input-libinput``, so I've stopped maintaining this patch.
+
+ Fortunately, there's a much simpler way to get the same result: you
+ can tell the kernel to remap codes for you, independently for each
+ keyboard you may have, via the ``udev`` "HW DB".
+
+ In ``/etc/udev/hwdb.d/50-apple-kbd.hwdb`` I have::
+
+ evdev:input:b0003v05ACp0221*
+ KEYBOARD_KEY_ff0003=insert # fn -> insert
+
+ (*Important*: the second line starts with exactly 1 space (0x20)
+ character)
+
+ This `Arch documentation page
+ <https://wiki.archlinux.org/index.php/Map_scancodes_to_keycodes>`_
+ has all the details.
+
The standard ``xf86-input-evdev`` driver that comes with `xorg` only
uses keycodes between 8 and 255, dropping all others. This is fine
most of the time (who ever saw a keyboard with more than 247 keys on