From pepper@reppep.com  Wed Jul 10 20:39:40 2002
Return-Path: <pepper@reppep.com>
Received: from mx1.FreeBSD.org (mx1.FreeBSD.org [216.136.204.125])
	by hub.freebsd.org (Postfix) with ESMTP id 13C1A37B400
	for <FreeBSD-gnats-submit@freebsd.org>; Wed, 10 Jul 2002 20:39:40 -0700 (PDT)
Received: from guest.reppep.com (guest.reppep.com [64.81.19.110])
	by mx1.FreeBSD.org (Postfix) with ESMTP id 45B7C43E42
	for <FreeBSD-gnats-submit@freebsd.org>; Wed, 10 Jul 2002 20:39:39 -0700 (PDT)
	(envelope-from pepper@reppep.com)
Received: by guest.reppep.com (Postfix, from userid 501)
	id 07DC7A848; Wed, 10 Jul 2002 23:40:04 -0400 (EDT)
Message-Id: <20020711034004.07DC7A848@guest.reppep.com>
Date: Wed, 10 Jul 2002 23:40:04 -0400 (EDT)
From: Chris Pepper <pepper@rockefeller.edu>
Reply-To: Chris Pepper <pepper@rockefeller.edu>
To: FreeBSD-gnats-submit@freebsd.org
Cc:
Subject: Update books/faq/book.sgml for USB .ko's & clarify FAQ description.
X-Send-Pr-Version: 3.113
X-GNATS-Notify:

>Number:         40443
>Category:       docs
>Synopsis:       Update books/faq/book.sgml for USB .ko's & clarify FAQ description.
>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:   Wed Jul 10 20:40:01 PDT 2002
>Closed-Date:    Mon Nov 08 08:02:11 GMT 2004
>Last-Modified:  Mon Nov 08 08:02:11 GMT 2004
>Originator:     Chris Pepper
>Release:        FreeBSD 4.6-STABLE i386
>Organization:
>Environment:
System: FreeBSD guest.reppep.com 4.6-STABLE FreeBSD 4.6-STABLE #3: Sun Jul 7 02:08:43 EDT 2002 root@guest.reppep.com:/usr/obj/usr/src/sys/GENERIC i386


	
>Description:
	The FAQ intro, as written, implies most FAQs are about FreeBSD.
	As written, the FAQ says a kernel rebuild is required to use a USB keyboard. Per John Baldwin, this is no longer true since 4.1 (per the USB mouse section, it may not be necessary since 4.0, but I'm believing John).
	
>How-To-Repeat:
	Visit <http://www.FreeBSD.org/doc/en_US.ISO8859-1/books/faq/hardware.html#USBKBD>.
>Fix:
	Apply patch below, to reword intro para, and mention that 4.1+ can load USB support automatically.

--- book.sgml.diff begins here ---
Index: book.sgml
===================================================================
RCS file: /home/ncvs/doc/en_US.ISO8859-1/books/faq/book.sgml,v
retrieving revision 1.456
diff -u -r1.456 book.sgml
--- book.sgml	2002/06/28 23:44:37	1.456
+++ book.sgml	2002/07/11 03:35:06
@@ -62,9 +62,9 @@
 
     <para>Welcome to the FreeBSD 2.X-4.X FAQ!</para>
 
-    <para>As is usual with Usenet FAQs, this document aims to cover the
-      most frequently asked questions concerning the FreeBSD operating
-      system (and of course answer them!).  Although originally intended
+    <para>As is usual with FAQs, this document identifies and answers some
+      frequently asked questions, in this case concerning the FreeBSD operating
+      system.  Although originally intended
       to reduce bandwidth and avoid the same old questions being asked
       over and over again, FAQs have become recognized as valuable
       information resources.</para>
@@ -2426,18 +2426,21 @@
         </question>
 
         <answer>
-          <para>USB device support was added to FreeBSD 3.1.  However, it
-            is still in preliminary state and may not always work as of
-            version 3.2. If you want to experiment with the USB keyboard
-            support, follow the procedure described below.</para>
+          <para>Preliminary USB device support was added to FreeBSD 3.1,
+            and significantly improved in 3.2; 3.1 is not recommended
+            for USB usage.  As of FreeBSD 4.1, the GENERIC kernel
+            can automatically load USB device drivers as
+            necessary.</para>
+
+              <para>With FreeBSD 4.1 and later, USB support can be
+              enabled in /etc/rc.conf; everything else is automatic.
+              Edit <filename>/etc/rc.conf</filename> and add the
+              following lines:</para>
 
-          <procedure>
-            <step>
-              <para>Use FreeBSD 3.2 or later.</para>
-            </step>
+              <programlisting>usbd_enable="YES"
+usbd_flags=""</programlisting>
 
-            <step>
-              <para>Add the following lines to your kernel configuration
+              <para>For FreeBSD 4.0, add the following lines to your kernel configuration
                 file, and rebuild the kernel.</para>
 
               <programlisting>device  uhci
@@ -2446,7 +2449,7 @@
 device  ukbd
 options KBD_INSTALL_CDEV</programlisting>
 
-              <para>In versions of FreeBSD before 4.0, use this
+              <para>In versions of FreeBSD before 4.0, use these lines
                 instead:</para>
 
               <programlisting>controller      uhci0
@@ -2454,35 +2457,22 @@
 controller      usb0
 controller      ukbd0
 options         KBD_INSTALL_CDEV</programlisting>
-            </step>
 
-            <step>
-              <para>Go to the <filename>/dev</filename> directory and create
+              <para>If you've rebuilt your kernel, go to the <filename>/dev</filename> directory and create
                 device nodes as follows:</para>
 
               <screen>&prompt.root; <userinput>cd /dev</userinput>
 &prompt.root; <userinput>./MAKEDEV kbd0 kbd1</userinput></screen>
-
-            </step>
-
-            <step>
-              <para>Edit <filename>/etc/rc.conf</filename> and add the
-                following lines:</para>
-
-              <programlisting>usbd_enable="YES"
-usbd_flags=""</programlisting>
-
-            </step>
-          </procedure>
 
-          <para>After the system is rebooted, the AT keyboard becomes
+          <para>After the system is rebooted, the AT or PS/2 keyboard becomes
             <devicename>/dev/kbd0</devicename> and the USB keyboard becomes
             <devicename>/dev/kbd1</devicename>, if both are connected to the
-            system.  If there is the USB keyboard only, it will be
-            <devicename>/dev/ukbd0</devicename>.</para>
+            system.  If the only keyboard is USB, it will be
+            <devicename>/dev/ukbd0</devicename> and <devicename>/dev/kbd0</devicename>.</para>
 
-          <para>If you want to use the USB keyboard in the console, you
-            have to explicitly tell the console driver to use the existing
+          <para>If you want to use the USB keyboard in the console with
+            an AT or PS/2 keyboard connected, you
+            have to explicitly tell the console driver to use the
             USB keyboard. This can be done by running the following
             command as a part of system initialization.</para>
 
--- book.sgml.diff ends here ---


>Release-Note:
>Audit-Trail:
State-Changed-From-To: open->closed 
State-Changed-By: linimon 
State-Changed-When: Mon Nov 8 08:01:17 GMT 2004 
State-Changed-Why:  
Apparently all the sections in the FAQ to which these patches apply were 
rewritten and updated a long time ago.  Sorry to have let this one languish. 

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