Date: Fri, 7 Jan 2000 14:20:35 +1100 (EST) From: jsutton@bbcon.com.au To: FreeBSD-gnats-submit@freebsd.org Subject: docs/15958: Mice section for doc/en_US.ISO_8859-1/books/handbook/hw/ Message-ID: <200001070320.OAA31567@firewall.bbcon.com.au>
next in thread | raw e-mail | index | archive | help
>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: freebsd-doc
>State: open
>Quarter:
>Keywords:
>Date-Required:
>Class: change-request
>Submitter-Id: current-users
>Arrival-Date: Thu Jan 6 19:30:01 PST 2000
>Closed-Date:
>Last-Modified:
>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:
>Unformatted:
To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-doc" in the body of the message
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?200001070320.OAA31567>