From root@firewall.bbcon.com.au  Thu Jan  6 19:27:52 2000
Return-Path: <root@firewall.bbcon.com.au>
Received: from bbcon.com.au (firewall.bbcon.com.au [203.28.19.210])
	by hub.freebsd.org (Postfix) with ESMTP id 0425014F10
	for <FreeBSD-gnats-submit@freebsd.org>; Thu,  6 Jan 2000 19:27:39 -0800 (PST)
	(envelope-from root@firewall.bbcon.com.au)
Received: from firewall.bbcon.com.au (stargate [10.0.0.1])
	by bbcon.com.au (8.9.2/8.9.2) with ESMTP id OAA10252;
	Fri, 7 Jan 2000 14:20:33 +1100 (EST)
	(envelope-from root@firewall.bbcon.com.au)
Received: (from root@localhost)
	by firewall.bbcon.com.au (8.9.3/8.9.2) id OAA31567;
	Fri, 7 Jan 2000 14:20:35 +1100 (EST)
	(envelope-from root)
Message-Id: <200001070320.OAA31567@firewall.bbcon.com.au>
Date: Fri, 7 Jan 2000 14:20:35 +1100 (EST)
From: jsutton@bbcon.com.au
Sender: root@firewall.bbcon.com.au
Reply-To: jsutton@bbcon.com.au
To: FreeBSD-gnats-submit@freebsd.org
Subject: Mice section for doc/en_US.ISO_8859-1/books/handbook/hw/
X-Send-Pr-Version: 3.2

>Number:         15958
>Category:       docs
>Synopsis:       Mice section for doc/en_US.ISO_8859-1/books/handbook/hw/
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    nik
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          change-request
>Submitter-Id:   current-users
>Arrival-Date:   Thu Jan  6 19:30:01 PST 2000
>Closed-Date:    Wed Jan 19 14:41:31 PST 2000
>Last-Modified:  Wed Jan 19 14:44:19 PST 2000
>Originator:     Joel Sutton
>Release:        FreeBSD 3.3-RELEASE i386
>Organization:
Busy Bee Consulting
>Environment:

FreeBSD stargate.home 3.3-RELEASE FreeBSD 3.3-RELEASE #0: Tue Dec 21 17:18:52 EST 1999     root@stargate.home:/usr/src/sys/compile/OFFICE  i386

>Description:

	Here's a patch to add a reasonable starting point for the Mice 
	section of the Hardware Compatibility List. Could someone please
	commit it if it checks out? This is my first attempt at submitting 
	documentation so please be verbose about any errors that I've made.
	Thanks, Joel...

>How-To-Repeat:

>Fix:
	
Index: chapter.sgml
===================================================================
RCS file: /usr/home/cvs/FreeBSD/doc/en_US.ISO_8859-1/books/handbook/hw/chapter.sgml,v
retrieving revision 1.28
diff -u -r1.28 chapter.sgml
--- chapter.sgml	1999/11/07 01:54:46	1.28
+++ chapter.sgml	2000/01/07 02:51:45
@@ -3069,9 +3069,159 @@
     </sect2>
     
     <sect2>
-      <title>* Mice</title>
-      
-      <para></para>
+      <title>Mice</title>
+  	  <para><emphasis>Contributed by Joel Sutton
+  	  <email>jsutton@bbcon.com.au</email> January 2000</emphasis></para>
+
+  	  <para>FreeBSD supports a variety of different mice via the PS/2, serial and
+  	  USB ports. Most users choose to use the mouse daemon to handle their mouse
+  	  because it allows interaction in both X and on the system console.
+  	  For more information on the mouse daemon refer to &man.moused.8;. The
+  	  examples throughout this section assume that the mouse daemon is being used.
+  	  </para>
+  	
+  	  <note>
+        <para>This section contains the names of specific products that the
+        author has confirmed will work with FreeBSD. Other similar devices not
+        listed may also be supported.</para>
+      </note>
+
+      <sect3>
+        <title>PS/2</title>
+        <para></para>
+
+        <sect4>
+          <title>System Configuration</title>
+          <para>To ensure that your PS/2 mouse functions correctly with the mouse daemon
+          you will need to include the following text in
+          <filename>/etc/rc.conf</filename></para>
+
+          <programlisting>moused_enable="YES"
+moused_type="ps/2"
+moused_port="/dev/psm0"</programlisting>
+
+        </sect4>
+
+        <sect4>
+          <title>Known Compatible Devices</title>
+
+          <itemizedlist>
+            <listitem>
+              <para>Logitech First Mouse - Three Button</para>
+            </listitem>
+            <listitem>
+              <para>Microsoft Serial - PS/2 Compatible Mouse</para>
+            </listitem>
+          </itemizedlist>
+        </sect4>
+
+      </sect3>
+
+      <sect3>
+        <title>Serial</title>
+        <para></para>
+
+        <sect4>
+          <title>System Configuration</title>
+          <para>To ensure that your serial mouse functions correctly with the mouse daemon
+          you will need to include the following text in <filename>/etc/rc.conf</filename>.
+          This example assumes that the mouse is connected to COM1: and can be
+          automatically recognised by the mouse daemon.</para>
+
+          <programlisting>moused_enable="YES"
+moused_type="auto"
+moused_port="/dev/cuaa0"</programlisting>
+
+          <para>See the &man.moused.8; manual page for a detailed description
+          of how to configure the mouse daemon to work with specific types
+          of serial mice.</para>
+
+        </sect4>
+
+        <sect4>
+          <title>Known Compatible Devices</title>
+
+          <itemizedlist>
+            <listitem>
+              <para>Generic Microsoft Compatible Mice</para>
+            </listitem>
+            <listitem>
+              <para>Logitech First Mouse - Three Button</para>
+            </listitem>
+            <listitem>
+              <para>Microsoft Serial - PS/2 Compatible Mouse</para>
+            </listitem>
+          </itemizedlist>
+        </sect4>
+
+      </sect3>
+
+      <sect3>
+        <title>USB</title>
+        <para></para>
+
+        <sect4>
+          <title>System Configuration</title>
+
+          <para>The USB device drivers are a relatively new addition to FreeBSD
+          and have not yet been included in the GENERIC kernel. The following
+          prodecure is an example of how to setup the relevant drivers on a
+          typical system.</para>
+
+          <procedure>
+            <step>
+       	      <para>Add the <devicename>ums</devicename> device to the usb
+       	      section of your <link	linkend="kernelconfig-config">kernel
+       	      configuration</link>. For example:
+       	      </para>
+       		
+        	    <programlisting>controller usb0
+controller uhci0
+device ums0</programlisting>
+        	  </step>
+       		
+        	  <step>
+        	    <para><link linkend="kernelconfig-building">Rebuild and
+          		install</link> the new kernel.</para>
+        	  </step>
+       	
+       	    <step>
+       	      <para>Make the <link linkend="kernelconfig-nodes">device node</link> by
+       	      typing:</para>
+        	    <screen>&prompt.root; <userinput>cd /dev</userinput>
+&prompt.root; <userinput>sh MAKEDEV ums0</userinput></screen>
+        	  </step>
+
+        	  <step>
+        	    <para>Include the following text in <filename>/etc/rc.conf</filename>
+        	    to ensure correct operation of the mouse daemon:</para>
+
+             <programlisting>moused_enable="YES"
+moused_type="auto"
+moused_port="/dev/ums0"</programlisting>
+            </step>
+
+            <step>
+              <para>Reboot the system.</para>
+        	    <screen>&prompt.root; <userinput>shutdown -r now</userinput></screen>
+            </step>
+
+          </procedure>
+
+        </sect4>
+
+        <sect4>
+          <title>Known Compatible Devices</title>
+
+          <itemizedlist>
+            <listitem>
+              <para>Logitech TrackMan - Marble Wheel</para>
+            </listitem>
+          </itemizedlist>
+        </sect4>
+
+      </sect3>
+
     </sect2>
     
     <sect2>

>Release-Note:
>Audit-Trail:
Responsible-Changed-From-To: freebsd-doc->jim 
Responsible-Changed-By: jim 
Responsible-Changed-When: Wed Jan 12 16:49:05 PST 2000 
Responsible-Changed-Why:  
I'll take this. 

From: Nik Clayton <nik@freebsd.org>
To: jsutton@bbcon.com.au
Cc: FreeBSD-gnats-submit@freebsd.org
Subject: Re: docs/15958: Mice section for doc/en_US.ISO_8859-1/books/handbook/hw/
Date: Thu, 13 Jan 2000 00:26:03 +0000

 On Fri, Jan 07, 2000 at 02:20:35PM +1100, jsutton@bbcon.com.au wrote:
 > >Number:         15958
 > >Category:       docs
 > >Synopsis:       Mice section for doc/en_US.ISO_8859-1/books/handbook/hw/
 > >Description:
 > 
 > 	Here's a patch to add a reasonable starting point for the Mice 
 > 	section of the Hardware Compatibility List. Could someone please
 > 	commit it if it checks out? This is my first attempt at submitting 
 > 	documentation so please be verbose about any errors that I've made.
 
 Making the changes to my local tree now, so they'll be committed in the
 next 24 hours or so.  I only had to make a couple of changes.  A few 
 were related to indentation, and I changed it to use double spaces after 
 the periods.
 
 Other than that, great.  Thanks very much.
 
 N
 -- 
     If you want to imagine the future, imagine a tennis shoe stamping
     on a penguin's face forever.
         --- with apologies to George Orwell
 
Responsible-Changed-From-To: jim->nik 
Responsible-Changed-By: jim 
Responsible-Changed-When: Thu Jan 13 13:03:35 PST 2000 
Responsible-Changed-Why:  
Nik is now working on this 
State-Changed-From-To: open->closed 
State-Changed-By: nik 
State-Changed-When: Wed Jan 19 14:41:31 PST 2000 
State-Changed-Why:  
Committed, thanks. 
>Unformatted:
