e000e8
diff -up kbd-2.0.4/docs/man/man1/showkey.1.orig kbd-2.0.4/docs/man/man1/showkey.1
e000e8
--- kbd-2.0.4/docs/man/man1/showkey.1.orig	2016-10-31 16:56:02.000000000 +0100
e000e8
+++ kbd-2.0.4/docs/man/man1/showkey.1	2017-01-11 10:45:03.763312393 +0100
e000e8
@@ -84,6 +84,19 @@ corresponds to what the keyboard hardwar
e000e8
 to know the scan codes sent by various keys it is better to boot a
e000e8
 2.4 kernel. Since 2.6.9 there also is the boot option atkbd.softraw=0
e000e8
 that tells the 2.6 kernel to return the actual scan codes.
e000e8
+
e000e8
+.SH NOTES
e000e8
+The raw scan codes are available only on AT and PS/2 keyboards,
e000e8
+and even then they are disabled unless the
e000e8
+.B atkbd.softraw=0
e000e8
+kernel parameter is used.
e000e8
+When the raw scan codes are not available, the kernel uses a fixed built-in
e000e8
+table to produce scan codes from keycodes.  Thus,
e000e8
+.BR setkeycodes (8)
e000e8
+can affect the output of
e000e8
+.B showkey
e000e8
+in scan code dump mode.
e000e8
+
e000e8
 .SH "SEE ALSO"
e000e8
 .BR loadkeys (1),
e000e8
 .BR dumpkeys (1),
e000e8
diff -up kbd-2.0.4/docs/man/man8/setkeycodes.8.orig kbd-2.0.4/docs/man/man8/setkeycodes.8
e000e8
--- kbd-2.0.4/docs/man/man8/setkeycodes.8.orig	2016-10-31 16:56:02.000000000 +0100
e000e8
+++ kbd-2.0.4/docs/man/man8/setkeycodes.8	2017-01-11 10:45:03.763312393 +0100
e000e8
@@ -38,6 +38,10 @@ to showkey(1), the command
e000e8
 .RE
e000e8
 will assign the keycode 112 to it, and then loadkeys(1) can be used
e000e8
 to define the function of this key.
e000e8
+
e000e8
+USB keyboards have standardized keycodes and
e000e8
+.B setkeycodes
e000e8
+doesn't affect them at all.
e000e8
 .LP
e000e8
 Some older kernels might hardwire a low scancode range to the
e000e8
 equivalent keycodes; setkeycodes will fail when you try to remap
e000e8
@@ -56,6 +60,14 @@ None.
e000e8
 .SH BUGS
e000e8
 The keycodes of X have nothing to do with those of Linux.
e000e8
 Unusual keys can be made visible under Linux, but not under X.
e000e8
+
e000e8
+.B setkeycodes
e000e8
+affects only the "first" input device
e000e8
+that has modifiable scancode-to-keycode mapping.
e000e8
+If there is more than one such device,
e000e8
+.B setkeycodes
e000e8
+cannot change the mapping of other devices than the "first" one.
e000e8
+
e000e8
 .SH "SEE ALSO"
e000e8
 .I "dumpkeys (1), loadkeys (1), showkey (1), getkeycodes (8)"
e000e8