Date: Thu, 11 Jul 2002 13:10:03 -0700 (PDT) From: marcov@stack.nl (Marco van de Voort) To: freebsd-doc@FreeBSD.org Subject: Re: docs/40423: Keyboard(4)'s definition of parameters to GETFKEY/SETFKEY off by one. Message-ID: <200207112010.g6BKA31B003462@freefall.freebsd.org>
next in thread | raw e-mail | index | archive | help
The following reply was made to PR docs/40423; it has been noted by GNATS. From: marcov@stack.nl (Marco van de Voort) To: Giorgos Keramidas <keramida@freebsd.org> Cc: Marco van de Voort <marcov@stack.nl>, 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 22:02:26 +0200 (CEST) > 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. Hmm, the page mentions both the GETFKEY IOCTL-function, and the structure that is used to set the function keys is also mentioned. I'd say it is for both the programmatic as the kbdcontrol struct. Since the kbdcontrol struct has its own manpage, at least a small note is in order IMHO. > The kbdcontrol(1) manpage refers to atkbd(4) which also uses the 1..64 > numbering. Then that is also incorrect ;-) I think it is wise to make cler. > 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. I don't know what you mean by the F(x) interface. I've translated kbio.h for fixing up the console experience of some project, and was quite confused by this for a while. To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?200207112010.g6BKA31B003462>