From n_hibma@freebsd.org  Fri May 12 17:02:01 2000
Return-Path: <n_hibma@freebsd.org>
Received: from cmailg1.svr.pol.co.uk (cmailg1.svr.pol.co.uk [195.92.195.171])
	by hub.freebsd.org (Postfix) with ESMTP id 02B4737BCB1
	for <FreeBSD-gnats-submit@freebsd.org>; Fri, 12 May 2000 17:01:59 -0700 (PDT)
	(envelope-from n_hibma@freebsd.org)
Received: from [195.92.67.23] (helo=mail18.svr.pol.co.uk)
	by cmailg1.svr.pol.co.uk with esmtp (Exim 3.13 #0)
	id 12qPNV-00007K-00
	for FreeBSD-gnats-submit@freebsd.org; Sat, 13 May 2000 01:01:57 +0100
Received: from modem-20.parrotfish.dialup.pol.co.uk ([62.137.46.148] helo=heather.plazza.uk)
	by mail18.svr.pol.co.uk with esmtp (Exim 3.13 #0)
	id 12qPNU-0002tf-00
	for FreeBSD-gnats-submit@freebsd.org; Sat, 13 May 2000 01:01:57 +0100
Received: (from n_hibma@localhost)
	by heather.plazza.uk (8.9.3/8.9.3) id BAA02891;
	Sat, 13 May 2000 01:01:54 GMT
	(envelope-from n_hibma)
Message-Id: <200005130101.BAA02891@heather.plazza.uk>
Date: Sat, 13 May 2000 01:01:54 GMT
From: n_hibma@freebsd.org
To: FreeBSD-gnats-submit@freebsd.org
Subject: kbdcontrol manpage incomplete
X-Send-Pr-Version: 3.2

>Number:         18520
>Category:       docs
>Synopsis:       kbdcontrol manpage incomplete
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    ben
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Fri May 12 17:10:00 PDT 2000
>Closed-Date:    Wed Jul 19 20:13:16 BST 2000
>Last-Modified:  Wed Jul 19 20:15:50 BST 2000
>Originator:     Nick Hibma
>Release:        FreeBSD 5.0-CURRENT i386
>Organization:
>Environment:

FreeBSD 3(?), 4, and 5, all revisions

>Description:

	The manpage for kbdcontrol is incomplete. It does not mention that
some commands only apply to /dev/console or the virtual terminals. It would
be useful to see an example along the lines of

	kbdcontrol -k /dev/ukbd0 < /dev/console

to show how to change the keyboard when in an xterm (or when using an automatic
changer line in usbd.conf).

>How-To-Repeat:


>Fix:


>Release-Note:
>Audit-Trail:

From: Ben Smithurst <ben@FreeBSD.org>
To: n_hibma@freebsd.org
Cc: FreeBSD-gnats-submit@freebsd.org
Subject: Re: docs/18520: kbdcontrol manpage incomplete
Date: Wed, 12 Jul 2000 19:24:15 +0100

 n_hibma@freebsd.org wrote:
 
 > 	The manpage for kbdcontrol is incomplete. It does not mention that
 > some commands only apply to /dev/console or the virtual terminals. It would
 > be useful to see an example along the lines of
 > 
 > 	kbdcontrol -k /dev/ukbd0 < /dev/console
 > 
 > to show how to change the keyboard when in an xterm (or when using an automatic
 > changer line in usbd.conf).
 
 What sort of text do you think is needed?  I don't really know enough
 about USB and stuff to see exactly what you mean.  I assume that command
 will mean that the USB keyboard acts as the console keyboard from that
 point forward?  How do you change it back?
 
 Anyway, how about:
 
         To change the default console keyboard to the first USB keyboard
         (see ukbd(4)) when not working on the console or a virtual
         terminal, use this command:
 
 		kbdcontrol -k /dev/ukbd0 < /dev/console
 
 The ukbd(4) manpage seems to have a bit more about this, so I explicitly
 added a reference to it there rather than expecting people to find it in
 the SEE ALSO bit.
 
 -- 
 Ben Smithurst / ben@FreeBSD.org / PGP: 0x99392F7D
 

From: Nick Hibma <n_hibma@qubesoft.com>
To: Ben Smithurst <ben@FreeBSD.org>
Cc: FreeBSD-gnats-submit@FreeBSD.org
Subject: Re: docs/18520: kbdcontrol manpage incomplete
Date: Fri, 14 Jul 2000 22:18:28 +0100 (BST)

 > What sort of text do you think is needed?  I don't really know enough
 > about USB and stuff to see exactly what you mean.  I assume that command
 > will mean that the USB keyboard acts as the console keyboard from that
 > point forward?  How do you change it back?
 
 By using the same command again. A slightly modified / corected version
 of the text you suggested below:
 
 	To change the default console keyboard to the another
 	keyboard, for example the first USB keyboard (see ukbd(4)), use
 	the following commands:
 
 		kbdcontrol -k /dev/kbd1 < /dev/console
 
 	To switch back to the default keyboard, use
 
 		kbdcontrol -k /dev/kbd0
 
 > The ukbd(4) manpage seems to have a bit more about this, so I explicitly
 > added a reference to it there rather than expecting people to find it in
 > the SEE ALSO bit.
 
 Yes, that is a good idea.
 
 Thanks,
 
 Nick
 
 --
 n_hibma@webweaving.org
 n_hibma@freebsd.org                                          USB project
 http://www.etla.net/~n_hibma/
 
 

From: Ben Smithurst <ben@FreeBSD.org>
To: Nick Hibma <n_hibma@qubesoft.com>
Cc: FreeBSD-gnats-submit@FreeBSD.org
Subject: Re: docs/18520: kbdcontrol manpage incomplete
Date: Sat, 15 Jul 2000 16:59:00 +0100

 Nick Hibma wrote:
 
 > 	To change the default console keyboard to the another
 > 	keyboard, for example the first USB keyboard (see ukbd(4)), use
 > 	the following commands:
 > 
 > 		kbdcontrol -k /dev/kbd1 < /dev/console
 > 
 > 	To switch back to the default keyboard, use
 > 
 > 		kbdcontrol -k /dev/kbd0
 
 how about this addition as well:
 
  .It Fl k Ar keyboard_device
  Use the specified device as the console keyboard.
 +When using this option, the standard input of the
 +.Nm
 +process should be redirected from
 +.Pa /dev/console
 +if you are not working on the system console or a virtual terminal
 +(see
 +.Sx EXAMPLES
 +section).
 
 Or, if you don't speak mdoc:
 
      -k keyboard_device
              Use the specified device as the console keyboard.  When using
              this option, the standard input of the kbdcontrol process should
              be redirected from /dev/console if you are not working on the
              system console or a virtual terminal (see EXAMPLES section).
 
 -- 
 Ben Smithurst                 / ben@FreeBSD.org / PGP: 0x99392F7D
 FreeBSD Documentation Project /
 

From: Ben Smithurst <ben@FreeBSD.org>
To: Nick Hibma <n_hibma@qubesoft.com>
Cc: FreeBSD-gnats-submit@FreeBSD.org
Subject: Re: docs/18520: kbdcontrol manpage incomplete
Date: Sat, 15 Jul 2000 16:50:01 +0100

 Nick Hibma wrote:
 
 > 	To change the default console keyboard to the another
 > 	keyboard, for example the first USB keyboard (see ukbd(4)), use
 > 	the following commands:
 > 
 > 		kbdcontrol -k /dev/kbd1 < /dev/console
 > 
 > 	To switch back to the default keyboard, use
 > 
 > 		kbdcontrol -k /dev/kbd0
 
 ok, I'll commit this soon.
 
 -- 
 Ben Smithurst                 / ben@FreeBSD.org / PGP: 0x99392F7D
 FreeBSD Documentation Project /
 
Responsible-Changed-From-To: freebsd-doc->ben 
Responsible-Changed-By: ben 
Responsible-Changed-When: Tue Jul 18 17:29:18 BST 2000 
Responsible-Changed-Why:  
I'm looking at this. 

http://www.freebsd.org/cgi/query-pr.cgi?pr=18520 
State-Changed-From-To: open->closed 
State-Changed-By: ben 
State-Changed-When: Wed Jul 19 20:13:16 BST 2000 
State-Changed-Why:  
committed in current and stable, thanks! 

http://www.freebsd.org/cgi/query-pr.cgi?pr=18520 
>Unformatted:
