From eb4a8f222fb6af97f4c5d830c83ee18a70674990 Mon Sep 17 00:00:00 2001
From: Gabor Pali <pgj@FreeBSD.org>
Date: Sat, 14 Jun 2008 09:55:49 +0000
Subject: [PATCH] Update Question 4.4.1: - Replace /dev/ttyv0 with /dev/console
 in the examples - Remove /etc/rc.i386 and add a note about rc.conf(5)
 settings - Add some examples from the kbdcontrol(1) man page - Add links for
 kbdcontrol(1), kbdmux(4) - Reword a few things (suggested by trhodes)

Reviewed by:	trhodes, danger, remko
Approved by:	gabor (mentor)
---
 en_US.ISO8859-1/books/faq/book.sgml | 47 ++++++++++++++++++++---------
 1 file changed, 32 insertions(+), 15 deletions(-)

diff --git a/en_US.ISO8859-1/books/faq/book.sgml b/en_US.ISO8859-1/books/faq/book.sgml
index 81c6a7fd1d..b102562c37 100644
--- a/en_US.ISO8859-1/books/faq/book.sgml
+++ b/en_US.ISO8859-1/books/faq/book.sgml
@@ -2367,10 +2367,7 @@
 
         <answer>
           <para>FreeBSD supports USB keyboards
-            out-of-the-box.  Enable USB support in
-            <filename>/etc/rc.conf</filename>.</para>
-
-          <para>Once you have USB keyboard support enabled on your
+            out-of-the-box.  Once you have USB keyboard support enabled on your
             system, the AT keyboard becomes
             <devicename>/dev/kbd0</devicename> and the USB keyboard
             becomes <devicename>/dev/kbd1</devicename>, if both are
@@ -2384,28 +2381,48 @@
             following command as a part of system
             initialization.</para>
 
-          <screen>&prompt.root; <userinput>kbdcontrol -k /dev/kbd1 &lt; /dev/ttyv0 &gt; /dev/null</userinput></screen>
+          <screen>&prompt.root; <userinput>kbdcontrol -k /dev/kbd1 &lt; /dev/console &gt; /dev/null</userinput></screen>
 
           <para>Note that if the USB keyboard is the only keyboard, it
             is accessed as <devicename>/dev/ukbd0</devicename>, thus,
             the command should look like:</para>
 
-          <screen>&prompt.root; <userinput>kbdcontrol -k /dev/ukbd0 &lt; /dev/ttyv0 &gt; /dev/null</userinput></screen>
+          <screen>&prompt.root; <userinput>kbdcontrol -k /dev/ukbd0 &lt; /dev/console &gt; /dev/null</userinput></screen>
 
-          <para><filename>/etc/rc.i386</filename> is a good place to
-            add the above command.</para>
+          <note>
+            <para>To make this change permanent across reboots, add
+              <literal>keyboard="/dev/ukbd0"</literal> to
+              <filename>/etc/rc.conf</filename>.</para>
+          </note>
 
           <para>Once this is done, the USB keyboard should work in the
             X environment as well without any special settings.</para>
 
-          <para>Hot-plugging and unplugging of the USB keyboard may
-            not work quite right yet. We recommend connecting the
-            keyboard before starting the system and leaving it
-            connected until the system is shutdown to avoid
-            troubles.</para>
+          <para>If you want to switch back to the default keyboard,
+            use this command:</para>
 
-          <para>See the &man.ukbd.4; manual page for more information.</para>
-        </answer>
+          <screen>&prompt.root; <userinput>kbdcontrol -k /dev/kbd0 &gt; /dev/null</userinput></screen>
+
+          <para>To allow using both the second USB keyboard and the
+            first AT keyboard at the same time on a console via
+            &man.kbdmux.4; driver type the following commands:</para>
+
+          <screen>&prompt.root; <userinput>kbdcontrol -K &lt; /dev/console &gt; /dev/null</userinput>
+<userinput>kbdcontrol -a atkbd0 &lt; /dev/kbdmux0 &gt; /dev/null</userinput>
+<userinput>kbdcontrol -a ukbd1 &lt; /dev/kbdmux0 &gt; /dev/null</userinput>
+<userinput>kbdcontrol -k /dev/kbdmux0 &lt; /dev/console &gt; /dev/null</userinput></screen>
+
+          <para>See the &man.ukbd.4;, &man.kbdcontrol.1; and
+            &man.kbdmux.4; manual pages for more information.</para>
+
+          <note>
+            <para>Hot-plugging and unplugging of the USB keyboard may
+              not work quite right yet.  We recommend connecting the
+              keyboard before starting the system and leaving it
+              connected until the system is shutdown to avoid
+              issues.</para>
+          </note>
+       </answer>
       </qandaentry>
 
       <qandaentry>