From owner-freebsd-doc@FreeBSD.ORG Sun Nov 20 20:30:37 2005 Return-Path: X-Original-To: freebsd-doc@hub.freebsd.org Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id C5E4216A421 for ; Sun, 20 Nov 2005 20:30:36 +0000 (GMT) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id 50C9143D5A for ; Sun, 20 Nov 2005 20:30:35 +0000 (GMT) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (gnats@localhost [127.0.0.1]) by freefall.freebsd.org (8.13.3/8.13.3) with ESMTP id jAKKUZP6057722 for ; Sun, 20 Nov 2005 20:30:35 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.13.3/8.13.1/Submit) id jAKKUZgW057715; Sun, 20 Nov 2005 20:30:35 GMT (envelope-from gnats) Resent-Date: Sun, 20 Nov 2005 20:30:35 GMT Resent-Message-Id: <200511202030.jAKKUZgW057715@freefall.freebsd.org> Resent-From: FreeBSD-gnats-submit@FreeBSD.org (GNATS Filer) Resent-To: freebsd-doc@FreeBSD.org Resent-Reply-To: FreeBSD-gnats-submit@FreeBSD.org, Oliver Fromme Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 937D716A41F for ; Sun, 20 Nov 2005 20:25:25 +0000 (GMT) (envelope-from olli@lurza.secnetix.de) Received: from lurza.secnetix.de (lurza.secnetix.de [83.120.8.8]) by mx1.FreeBSD.org (Postfix) with ESMTP id C758E43D4C for ; Sun, 20 Nov 2005 20:25:24 +0000 (GMT) (envelope-from olli@lurza.secnetix.de) Received: from lurza.secnetix.de (pknwlu@localhost [127.0.0.1]) by lurza.secnetix.de (8.13.4/8.13.4) with ESMTP id jAKKPN0J078884; Sun, 20 Nov 2005 21:25:23 +0100 (CET) (envelope-from oliver.fromme@secnetix.de) Received: (from olli@localhost) by lurza.secnetix.de (8.13.4/8.13.1/Submit) id jAKKPNIg078883; Sun, 20 Nov 2005 21:25:23 +0100 (CET) (envelope-from olli) Message-Id: <200511202025.jAKKPNIg078883@lurza.secnetix.de> Date: Sun, 20 Nov 2005 21:25:23 +0100 (CET) From: Oliver Fromme To: FreeBSD-gnats-submit@FreeBSD.org X-Send-Pr-Version: 3.113 Cc: Oliver Fromme Subject: docs/89325: [PATCH] Clarification of kbdmap(5), atkbd(4) and kbdcontrol(1) manpages X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list Reply-To: Oliver Fromme List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sun, 20 Nov 2005 20:30:38 -0000 >Number: 89325 >Category: docs >Synopsis: [PATCH] Clarification of kbdmap(5), atkbd(4) and kbdcontrol(1) manpages >Confidential: no >Severity: non-critical >Priority: low >Responsible: freebsd-doc >State: open >Quarter: >Keywords: >Date-Required: >Class: doc-bug >Submitter-Id: current-users >Arrival-Date: Sun Nov 20 20:30:34 GMT 2005 >Closed-Date: >Last-Modified: >Originator: Oliver Fromme >Release: FreeBSD 6.0-STABLE i386 >Organization: secnetix GmbH & Co. KG, Munich Germany http://www.secnetix.de/bsd >Environment: System: FreeBSD epia.fromme.com 6.0-STABLE FreeBSD 6.0-STABLE #0: Fri Nov 4 21:35:33 CET 2005 olli@epia.fromme.com:/usr/src/sys/i386/compile/EPIA i386 >Description: NOTE: PR has been re-sent because of wrong Reply-To address in the previous one! When I tried to configure my keyboard under syscons so that I can use Ctrl-Left and Ctrl-Right to jump word-wise left and right, it turned out that the documentation was somewhat sub-optimal. There is no "big picture", and information is spread across various manual pages, which are sometimes not even mentioned in the "SEE ALSO" sections. In fact, I had to resort to reading kernel sources to find out the number of function keys that are supported, among other things -- this isn't documented at all. The small patch below clarifies a few things in the kbdmap(5) manual page and points people in the right direction who try to do similar things. >How-To-Repeat: man 5 kbdmap >Fix: --- src/usr.sbin/kbdcontrol/kbdcontrol.1.orig Sat Aug 6 16:45:18 2005 +++ src/usr.sbin/kbdcontrol/kbdcontrol.1 Sun Nov 20 20:42:27 2005 @@ -118,6 +118,9 @@ .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 --- src/usr.sbin/kbdcontrol/kbdmap.5.orig Sat Aug 21 14:58:09 2004 +++ src/usr.sbin/kbdcontrol/kbdmap.5 Sun Nov 20 20:24:15 2005 @@ -165,7 +165,15 @@ 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 funktion keys. .It lshift Act as left shift key. .It rshift --- src/share/man/man4/atkbd.4.orig Thu Dec 16 00:01:45 2004 +++ src/share/man/man4/atkbd.4 Sun Nov 20 20:51:45 2005 @@ -70,6 +70,11 @@ 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" @@ -114,6 +119,8 @@ Right GUI Key .It 64 Menu +.It "65, 66,...96" +free (not used by default) .El .Pp See the man page for the @@ -209,6 +216,7 @@ .Xr pcvt 4 , .Xr psm 4 , .Xr syscons 4 , +.Xr kbdmap 5 , .Xr loader 8 .Sh HISTORY The >Release-Note: >Audit-Trail: >Unformatted: