From owner-freebsd-doc  Wed Mar 19 07:47:41 1997
Return-Path: <owner-doc>
Received: (from root@localhost)
          by freefall.freebsd.org (8.8.5/8.8.5) id HAA26846
          for doc-outgoing; Wed, 19 Mar 1997 07:47:41 -0800 (PST)
Received: from door.jcave.com (root@door.jcave.com [204.130.210.2])
          by freefall.freebsd.org (8.8.5/8.8.5) with SMTP id HAA26833
          for <freebsd-doc@FreeBSD.ORG>; Wed, 19 Mar 1997 07:47:37 -0800 (PST)
Received: from picasso (p073.cs1.jcave.com [204.130.210.73]) by door.jcave.com (8.6.12/8.6.9) with SMTP id IAA01732 for <freebsd-doc@FreeBSD.ORG>; Wed, 19 Mar 1997 08:49:49 -0700
Message-ID: <33300AAF.3D89@jcave.com>
Date: Wed, 19 Mar 1997 08:47:59 -0700
From: Earl Bryner <brynere@jcave.com>
X-Mailer: Mozilla 3.0 (WinNT; I)
MIME-Version: 1.0
To: freebsd-doc@FreeBSD.ORG
Subject: FAQ suggestion.
Content-Type: text/plain; charset=us-ascii
Content-Transfer-Encoding: 7bit
Sender: owner-doc@FreeBSD.ORG
X-Loop: FreeBSD.org
Precedence: bulk

First of all I would like to commend the FreeBSD team for the technical
accuracy of all the online help files.  After experienceing Microsoft
help files, it's refreshing to find an organization that realizes the
importance of accurate help files.

I was recently installing FreeBSD 2.1.6 on a machine with a PS/2 mouse
port, and I had difficulty getting the port to work.  The problem was
that I didn't completely understand the kernel config file.

Version 2.1.6 apparently builds a config file with the psm0 device line
allready there, with one little ( big ) difference.  Right after the
isa? option, the keyword disable is inserted.

device   psm0  at isa? disable port "IO_KBD" conflicts tty irq 12 vector
psmintr

To the uninitiated, the part after isa? looks like some sort of
information to the kernel to disable IO_KBD because it conflicts with
the psm0 device.  

To make a long story short, I was thinking that it might be a good idea
to revise the FAQ section 3.9.1 to add a statement something to the
effect:

If your kernel already has a psm0 device, make sure that it is enabled
by removing the disable option, so the entry reads:

device   psm0  at isa? port "IO_KBD" conflicts tty irq 12 vector psmintr


PS: Is there any documentation available on kernel config file syntax
and options?

Thanks Earl.