From jon@caffeinated-systems.com  Tue May  6 07:54:00 2003
Return-Path: <jon@caffeinated-systems.com>
Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125])
	by hub.freebsd.org (Postfix) with ESMTP id 3227B37B401
	for <FreeBSD-gnats-submit@freebsd.org>; Tue,  6 May 2003 07:54:00 -0700 (PDT)
Received: from hope.caffeinated-systems.com (hope.caffeinated-systems.com [209.98.4.50])
	by mx1.FreeBSD.org (Postfix) with ESMTP id 64B1C43FCB
	for <FreeBSD-gnats-submit@freebsd.org>; Tue,  6 May 2003 07:53:58 -0700 (PDT)
	(envelope-from jon@caffeinated-systems.com)
Received: by hope.caffeinated-systems.com (Postfix, from userid 1003)
	id 1670F4D28A; Tue,  6 May 2003 09:30:39 -0500 (CDT)
Message-Id: <20030506143039.1670F4D28A@hope.caffeinated-systems.com>
Date: Tue,  6 May 2003 09:30:39 -0500 (CDT)
From: Jon Passki <jon@caffeinated-systems.com>
Reply-To: Jon Passki <jon@caffeinated-systems.com>
To: FreeBSD-gnats-submit@freebsd.org
Cc:
Subject: atkbd(4) adjustment
X-Send-Pr-Version: 3.113
X-GNATS-Notify:

>Number:         51875
>Category:       docs
>Synopsis:       [patch] atkbd(4) adjustment
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-doc
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Tue May 06 08:00:30 PDT 2003
>Closed-Date:    Sat Oct 21 21:16:59 GMT 2006
>Last-Modified:  Sat Oct 21 21:16:59 GMT 2006
>Originator:     Jon Passki
>Release:        FreeBSD 4.8-STABLE i386
>Organization:
>Environment:
System: FreeBSD dominique 4.8-STABLE FreeBSD 4.8-STABLE #7: Fri May  2 14:21:39 CDT 2003 root@dominique:/usr/obj/usr/src/sys/DOMINIQUE  i386

>Description:
	Inconsistent information between GENERIC and atkbd(4)
	The manual page states the driver installs if the keyboard is present (flag bit 0 not set), but GENERIC has the flag bit set to 0x1. 

	Also, LINT and GENERIC show different settings.  atkbd(4) seems to reference LINT on line 39 (.Cd "device atkbd").  A grep shows the difference:

/sys/i386/conf/GENERIC:device           atkbd0  at atkbdc? irq 1 flags 0x1
/sys/i386/conf/LINT:device              atkbd0  at atkbdc? irq 1

	I am not too familiar with the manpage macros, so I do not know if the manpage is referencing LINT, hence this may be an incorrect statement.

>How-To-Repeat:
	Read GENERIC and atkbd(4) :-)
>Fix:
diff -u share/man/man4/atkbd.4.orig share/man/man4/atkbd.4
--- share/man/man4/atkbd.4.orig Fri May  2 12:05:41 2003
+++ share/man/man4/atkbd.4      Fri May  2 12:27:20 2003
@@ -153,9 +153,10 @@
 .It bit 0 (FAIL_IF_NO_KBD)
 By default the
 .Nm
-driver will install even if a keyboard is not actually connected to the
+driver is only installed when a keyboard is connected to the
 system.
-This option prevents the driver from being installed in this situation.
+Remove this option, or zero the flag bit to install the driver for
+situations when the keyboard might not be connected.
 .It bit 1 (NO_RESET)
 When this option is given, the
 .Nm


>Release-Note:
>Audit-Trail:
State-Changed-From-To: open->closed 
State-Changed-By: ru 
State-Changed-When: Sat Oct 21 21:15:06 UTC 2006 
State-Changed-Why:  
The manpage is correct and it doesn't document a particular kernel config 
such as GENERIC.  "By default" means when device flags aren't set. 

Also, in today's 7.0-CURRENT, both i386 and amd64 GENERIC kernels don't 
have this flag set. 

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