From c01d5f7d0f7211c1ee9e03758220b8d1868f3e85 Mon Sep 17 00:00:00 2001
From: Tom Rhodes <trhodes@FreeBSD.org>
Date: Tue, 29 Jan 2008 18:28:50 +0000
Subject: [PATCH] Some clarifications to make keyboard configuration under
 syscons.

PR:		89325
Submitted by:	Oliver Fromme <olli@secnetix.de>
Reviewed by:	emax
---
 share/man/man4/atkbd.4           | 10 +++++++++-
 usr.sbin/kbdcontrol/kbdcontrol.1 |  5 ++++-
 usr.sbin/kbdcontrol/kbdmap.5     | 12 ++++++++++--
 3 files changed, 23 insertions(+), 4 deletions(-)

diff --git a/share/man/man4/atkbd.4 b/share/man/man4/atkbd.4
index 590b7c1b2213..73831c2bb538 100644
--- a/share/man/man4/atkbd.4
+++ b/share/man/man4/atkbd.4
@@ -26,7 +26,7 @@
 .\"
 .\" $FreeBSD$
 .\"
-.Dd May 21, 1999
+.Dd January 29, 2008
 .Dt ATKBD 4
 .Os
 .Sh NAME
@@ -68,6 +68,11 @@ They are numbered as follows and can be associated with strings
 by the
 .Xr kbdcontrol 1
 command.
+You can use a keyboard map file (see
+.Xr kbdmap 5 )
+to map them to arbitrary keys, particularly
+the functions in the range from 65 to 96
+which are not used by default.
 .Pp
 .Bl -tag -width "Function Key Number" -compact
 .It "Function Key number"
@@ -112,6 +117,8 @@ Left GUI Key
 Right GUI Key
 .It 64
 Menu
+.It "65, 66,...96"
+free (not used by default)
 .El
 .Pp
 See the man page for the
@@ -205,6 +212,7 @@ In both cases, you also need to have following lines in
 .Xr atkbdc 4 ,
 .Xr psm 4 ,
 .Xr syscons 4 ,
+.Xr kbdmap 5 ,
 .Xr loader 8
 .Sh HISTORY
 The
diff --git a/usr.sbin/kbdcontrol/kbdcontrol.1 b/usr.sbin/kbdcontrol/kbdcontrol.1
index 176a7226de41..68cee84398e7 100644
--- a/usr.sbin/kbdcontrol/kbdcontrol.1
+++ b/usr.sbin/kbdcontrol/kbdcontrol.1
@@ -13,7 +13,7 @@
 .\"     @(#)kbdcontrol.1
 .\" $FreeBSD$
 .\"
-.Dd November 16, 2006
+.Dd January 29, 2008
 .Dt KBDCONTROL 1
 .Os
 .Sh NAME
@@ -122,6 +122,9 @@ Install keyboard map file from
 .Ar keymap_file .
 You may load the keyboard map file from a menu-driven command,
 .Xr kbdmap 1 .
+The format of keyboard map files is documented in the
+.Xr kbdmap 5
+manual page.
 .It Fl d
 Dump the current keyboard map onto stdout.
 The output may be redirected to a file and can be loaded
diff --git a/usr.sbin/kbdcontrol/kbdmap.5 b/usr.sbin/kbdcontrol/kbdmap.5
index 5d9776d9a039..2b94b356581f 100644
--- a/usr.sbin/kbdcontrol/kbdmap.5
+++ b/usr.sbin/kbdcontrol/kbdmap.5
@@ -24,7 +24,7 @@
 .\"
 .\" $FreeBSD$
 .\"
-.Dd September 11, 2000
+.Dd January 29, 2008
 .Dt KBDMAP 5
 .Os
 .Sh NAME
@@ -165,7 +165,15 @@ Act as the
 function key,
 where
 .Ar N
-is a decimal number.
+is a decimal number in the range from 1 to 96.
+Refer to the
+.Xr atkbd 4
+manual page for a list of predefined function keys.
+You can use the
+.Fl f
+option of the
+.Xr kbdcontrol 1
+utility to assign arbitrary strings to function keys.
 .It lshift
 Act as left shift key.
 .It rshift