From owner-freebsd-doc@FreeBSD.ORG Tue May 6 08:00:31 2003 Return-Path: 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 9AEDE37B404 for ; Tue, 6 May 2003 08:00:31 -0700 (PDT) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id A1D8C43F93 for ; Tue, 6 May 2003 08:00:30 -0700 (PDT) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (gnats@localhost [127.0.0.1]) by freefall.freebsd.org (8.12.9/8.12.9) with ESMTP id h46F0UUp012816 for ; Tue, 6 May 2003 08:00:30 -0700 (PDT) (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.12.9/8.12.9/Submit) id h46F0Udv012815; Tue, 6 May 2003 08:00:30 -0700 (PDT) Resent-Date: Tue, 6 May 2003 08:00:30 -0700 (PDT) Resent-Message-Id: <200305061500.h46F0Udv012815@freefall.freebsd.org> Resent-From: FreeBSD-gnats-submit@FreeBSD.org (GNATS Filer) Resent-To: freebsd-doc@FreeBSD.org Resent-Reply-To: FreeBSD-gnats-submit@FreeBSD.org, Jon Passki Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 3227B37B401 for ; 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 ; 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 To: FreeBSD-gnats-submit@FreeBSD.org X-Send-Pr-Version: 3.113 Subject: docs/51875: atkbd(4) adjustment X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list Reply-To: Jon Passki List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 06 May 2003 15:00:32 -0000 >Number: 51875 >Category: docs >Synopsis: atkbd(4) adjustment >Confidential: no >Severity: non-critical >Priority: low >Responsible: freebsd-doc >State: open >Quarter: >Keywords: >Date-Required: >Class: doc-bug >Submitter-Id: current-users >Arrival-Date: Tue May 06 08:00:30 PDT 2003 >Closed-Date: >Last-Modified: >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: >Unformatted: