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