1 files changed, 86 insertions, 10 deletions

diff --git a/FAQ/hardware.sgml b/FAQ/hardware.sgml
index 4949d3299a..467dd2a9ef 100644
--- a/FAQ/hardware.sgml
+++ b/FAQ/hardware.sgml
@@ -1,4 +1,4 @@
-<!-- $Id: hardware.sgml,v 1.2 1997-11-04 03:49:22 steve Exp $ -->
+<!-- $Id: hardware.sgml,v 1.3 1998-02-01 23:02:35 jfieber Exp $ -->
 <!-- The FreeBSD Documentation Project -->
 
   <sect>
@@ -144,21 +144,27 @@
       name="sio"> man page to get more information on configuring such cards.
 
     <sect1>
-      <heading>I have an unusual bus mouse. How do I set it up?</heading>
+      <heading>I have an unusual bus mouse. How do I set it up?<label id="busmouse"></heading>
 
-      <p>FreeBSD supports the Logitech and ATI Inport bus mice.  You need
-      to add the following line to the kernel config file and recompile
-      for the Logitech and ATI mice:
+      <p>FreeBSD supports the bus mouse and the InPort bus mouse from such
+      manufactures as Microsoft, Logitech and ATI.  The bus device driver
+      is compiled in the GENERIC kernel by default.  If you are building 
+      a custom kernel with the bus mouse driver, make sure to add the 
+      following line to the kernel config file:
 
       <verb>
         device mse0 at isa? port 0x23c tty irq5 vector mseintr
       </verb>
 
+      <p>The bus mouse usually comes with an dedicatd interface card.
+      It may allow you to set the port address and the IRQ number other
+      than shown above.  Refer to the manual of your mouse and the
+      <htmlurl url="http://www.freebsd.org/cgi/man.cgi?mse" name="mse">
+      man page for more information.
+
     <sect1>
       <heading>
-        How do I use my PS/2 (``keyboard'') mouse?
-        <label id="ps2mouse">
-      </heading>
+        How do I use my PS/2 (``mouse port'' or ``keyboard'') mouse?<label id="ps2mouse"></heading>
 
       <p>If you're running a relatively recent version of FreeBSD then you
       can simply enable it in the kernel configuration menu
@@ -172,8 +178,6 @@
 
       <verb>
         device psm0 at isa? port "IO_KBD" conflicts tty irq 12 vector psmintr
-        # Options for psm:
-        options PSM_CHECKSYNC      #checks the header byte for sync.
       </verb>
 
       <p>See the <url url="../handbook/kernelconfig.html"
@@ -191,6 +195,78 @@
       <p>when logged in as root.
 
     <sect1>
+      <heading>Is it possible to make use of a mouse in any way outside the X Window?<label id="moused"></heading>
+
+      <p>If you are using the default console driver, syscons, you can
+      use a mouse pointer in text consoles to cut & paste text.
+      Run the mouse daemon, moused, and turn on the mouse pointer
+      in the virtual console:
+
+      <verb>
+        moused -p /dev/xxxx -t yyyy 
+        vidcontrol -m on
+      </verb>
+
+      <p>Where <tt>xxxx</tt> is the mouse device name and <tt>yyyy</tt> 
+      is a protocol type for the mouse.  See the 
+      <htmlurl url="http://www.freebsd.org/cgi/man.cgi?moused" name="moused">
+      man page for supported protocol types.  
+
+      <p>You may wish to run the mouse daemon automatically when the 
+      system starts.  In version 2.2.1, set the following variables in
+      <tt>/etc/sysconfig</tt>.
+
+      <verb>
+	mousedtype="yyyy"
+	mousedport="xxxx"
+	mousedflags=""
+      </verb>
+
+      In versions 2.2.2 or later, set the following variables in
+      <tt>/etc/rc.conf</tt>.
+
+      <verb>
+	moused_type="yyyy"
+	moused_port="xxxx"
+	moused_flags=""
+      </verb>
+
+      <p>Staring from FreeBSD 2.2.6, the mouse daemon is capable of 
+      determining the correct protocol type automatically unless the mouse 
+      is a relatively old serial mouse model.  Specify ``<tt>auto</tt>'' as
+      the protocol to invoke automatic detection.
+
+      <p>When the mouse daemon is running, access to the mouse needs to be
+      coordinated between the mouse daemon and other programs such as the
+      X Window.  Refer to <ref id="x-and-moused" name="another section"> 
+      on this issue".
+
+    <sect1>
+      <heading>How do I cut and paste text with mouse in the text console?</heading>
+
+      <p>Once you get the mouse deamon running (see <ref id="moused" 
+      name="previous section">), hold down the button 1 (left button) 
+      and move the mouse to select a region of
+      text.  Then, press the button 2 (middle button) or the button 3 (right
+      button) to paste it at the text cursor.
+
+      <p>In versions 2.2.6 and later, pressing the button 2 will paste 
+      the text.  Pressing the button 3 will ``extend'' the selected region
+      of text.  If your mouse does not have the middle button, you may wish
+      to emulate it or remap buttons using moused options.  See the 
+      <htmlurl url="http://www.freebsd.org/cgi/man.cgi?moused" name="moused">
+      man page for details.
+
+    <sect1>
+      <heading>My mouse has a fancy wheel and buttons.  Can I use them in FreeBSD?</heading>
+
+      <p>The answer is, unfortunately, ``It depends.''  These mice with
+      additional features require specialized driver in most cases.
+      Unless the mouse device driver or the user program has specific 
+      support for the mouse, it will act just like a standard two, or 
+      three button mouse.
+
+    <sect1>
       <heading>
         How do I use the mouse/trackball/touchpad on my laptop?
       </heading>