From swear@aa.net  Tue Aug  7 09:17:55 2001
Return-Path: <swear@aa.net>
Received: from localhost.localdomain (host68.207.55.120.aadsl.com [207.55.120.68])
	by hub.freebsd.org (Postfix) with ESMTP id 66EBC37B40E
	for <FreeBSD-gnats-submit@freebsd.org>; Tue,  7 Aug 2001 09:17:40 -0700 (PDT)
	(envelope-from swear@aa.net)
Received: (from jojo@localhost)
	by localhost.localdomain (8.11.3/8.11.3) id f77GJrL48527;
	Tue, 7 Aug 2001 09:19:53 -0700 (PDT)
	(envelope-from swear@aa.net)
Message-Id: <b3g0b3x2om.0b3@localhost.localdomain>
Date: 07 Aug 2001 09:19:53 -0700
From: swear@aa.net (Gary W. Swearingen)
Sender: jojo@localhost.localdomain
Reply-To: swear@aa.net
To: FreeBSD-gnats-submit@freebsd.org
Subject: kbdmap(1) doesn't explain that cmd is interactive only.
X-Send-Pr-Version: 3.113
X-GNATS-Notify:

>Number:         29506
>Category:       docs
>Synopsis:       kbdmap(1) doesn't explain that cmd is interactive only.
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    murray
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Tue Aug 07 09:20:02 PDT 2001
>Closed-Date:    Mon Sep 3 21:54:16 PDT 2001
>Last-Modified:  Mon Sep 03 21:54:36 PDT 2001
>Originator:     Gary W. Swearingen
>Release:        FreeBSD 4.3-STABLE i386
>Organization:
none
>Environment:
n/a
================
>Description:

The man page doesn't explain that it is requires user input after it
starts.

I wasted much time trying to determine, by reading the man page, how to
supply it the information needed to set a keymap or font.  I suppose the
"front end" phrase should have clued me in, but it was not clear enough
for me.

I suspect that the problem is shared by the kbdcontrol(1) and
vidcontrol(1) pages too, but I haven't looked.
================
>How-To-Repeat:
n/a
================
>Fix:

I'm sure that much could be usefully added to this brief man page by an
interested person.  Here's my small contribution:

patch -d "some man/man1/" < this-PR

*** old.kbdmap.1	Mon Aug  6 18:09:55 2001
--- kbdmap.1	Mon Aug  6 18:00:45 2001
***************
*** 11,17 ****
       KKbbddmmaapp allows easy setting of available keymaps.  The vviiddffoonntt command
       allows the setting of fonts.  Both examine a database for the keymaps and
       fonts.  Descriptions are in English by default, but may also be in other
!      languages.
  
       It is strongly recommended to not choose MSDOS codepage keymaps or fonts.
       Use the ISO standard version if available!  X11 does not support MSDOS
--- 11,19 ----
       KKbbddmmaapp allows easy setting of available keymaps.  The vviiddffoonntt command
       allows the setting of fonts.  Both examine a database for the keymaps and
       fonts.  Descriptions are in English by default, but may also be in other
!      languages.  These programs are interactive and expect to run in a
!      terminal to get some required inputs (e.g., a keymap selection) from
!      the users after the programs start.
  
       It is strongly recommended to not choose MSDOS codepage keymaps or fonts.
       Use the ISO standard version if available!  X11 does not support MSDOS

>Release-Note:
>Audit-Trail:
Responsible-Changed-From-To: gnats-admin->freebsd-doc 
Responsible-Changed-By: dd 
Responsible-Changed-When: Sat Aug 11 13:10:27 PDT 2001 
Responsible-Changed-Why:  
misfiled 

http://www.FreeBSD.org/cgi/query-pr.cgi?pr=29506 
State-Changed-From-To: open->analyzed 
State-Changed-By: murray 
State-Changed-When: Mon Sep 3 20:19:52 PDT 2001 
State-Changed-Why:  
The man page in -CURRENT has been updated, thanks! 



Responsible-Changed-From-To: freebsd-doc->murray 
Responsible-Changed-By: murray 
Responsible-Changed-When: Mon Sep 3 20:19:52 PDT 2001 
Responsible-Changed-Why:  
My MFC reminder. 

http://www.FreeBSD.org/cgi/query-pr.cgi?pr=29506 
State-Changed-From-To: analyzed->closed 
State-Changed-By: murray 
State-Changed-When: Mon Sep 3 21:54:16 PDT 2001 
State-Changed-Why:  
This change has been MFCed and will be in -CURRENT.  Thanks. 


http://www.FreeBSD.org/cgi/query-pr.cgi?pr=29506 
>Unformatted:
