From owner-freebsd-doc  Thu Jul 11 13: 0:13 2002
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 B427037B400
	for <freebsd-doc@hub.freebsd.org>; Thu, 11 Jul 2002 13:00:09 -0700 (PDT)
Received: from freefall.freebsd.org (freefall.FreeBSD.org [216.136.204.21])
	by mx1.FreeBSD.org (Postfix) with ESMTP id 7444F43E09
	for <freebsd-doc@hub.freebsd.org>; Thu, 11 Jul 2002 13:00:09 -0700 (PDT)
	(envelope-from gnats@FreeBSD.org)
Received: from freefall.freebsd.org (gnats@localhost [127.0.0.1])
	by freefall.freebsd.org (8.12.4/8.12.4) with ESMTP id g6BK09JU098140
	for <freebsd-doc@freefall.freebsd.org>; Thu, 11 Jul 2002 13:00:09 -0700 (PDT)
	(envelope-from gnats@freefall.freebsd.org)
Received: (from gnats@localhost)
	by freefall.freebsd.org (8.12.4/8.12.4/Submit) id g6BK098N098139;
	Thu, 11 Jul 2002 13:00:09 -0700 (PDT)
Date: Thu, 11 Jul 2002 13:00:09 -0700 (PDT)
Message-Id: <200207112000.g6BK098N098139@freefall.freebsd.org>
To: freebsd-doc@FreeBSD.org
Cc: 
From: Giorgos Keramidas <keramida@freebsd.org>
Subject: Re: docs/40423: Keyboard(4)'s definition of parameters to GETFKEY/SETFKEY off by one.
Reply-To: Giorgos Keramidas <keramida@freebsd.org>
Sender: owner-freebsd-doc@FreeBSD.ORG
Precedence: bulk
List-ID: <freebsd-doc.FreeBSD.ORG>
List-Archive: <http://docs.freebsd.org/mail/> (Web Archive)
List-Help: <mailto:majordomo@FreeBSD.ORG?subject=help> (List Instructions)
List-Subscribe: <mailto:majordomo@FreeBSD.ORG?subject=subscribe%20freebsd-doc>
List-Unsubscribe: <mailto:majordomo@FreeBSD.ORG?subject=unsubscribe%20freebsd-doc>
X-Loop: FreeBSD.org

The following reply was made to PR docs/40423; it has been noted by GNATS.

From: Giorgos Keramidas <keramida@freebsd.org>
To: Marco van de Voort <marcov@stack.nl>
Cc: bug-followup@freebsd.org
Subject: Re: docs/40423: Keyboard(4)'s definition of parameters to GETFKEY/SETFKEY off by one.
Date: Thu, 11 Jul 2002 21:27:47 +0300

 On 2002-07-10 18:26 +0000, Marco van de Voort wrote:
 > The C IOCTL (SET/GETFKEY) interface to set "function keys" requires
 > parameters in the range 0..63 (actually 0..95)
 >
 > Kbdcontrol -f remaps them to 1..64 (1..96)
 >
 > Keyboard(4) which describes (amongst others) the SET/GETFKEY
 > functions specifies the range as 1..64, while not mentioning that
 > kbdcontrol add/subtracts 1 internally when necessary
 
 I think the intent was to make it easier for users of kbdcontrol(1)
 who will have to use the manpage to find out the proper number to pass
 to the -f option of kbdcontrol.  The kbdcontrol(1) manpage refers to
 atkbd(4) which also uses the 1..64 numbering.  Someone who uses a
 programmatic interface should always use the F(x) interface of
 <sys/kbio.h> and will never get to see the actual raw number of a
 function key listed in the source of a program.
 
 - Giorgos
 

To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-doc" in the body of the message