>Number:         34054
>Category:       misc
>Synopsis:       The eap(4) man page does not document the joystick attachment
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    misc-bug-people
>State:          open
>Class:          doc-bug
>Submitter-Id:   net
>Arrival-Date:   Sat Jul 22 14:55:00 +0000 2006
>Originator:     Björn Johannesson
>Release:        3.99.23
>Organization:
>Environment:
NetBSD hallabo.localdomain 3.99.23 NetBSD 3.99.23 (HALLABO) #9: Fri Jul 21 13:35:45 CEST 2006  bjorn@hallabo.localdomain:/usr/src/sys/arch/i386/compile/HALLABO i386
>Description:
The eap(4) man page does not document the joystick attachment and it's
problems.
>How-To-Repeat:
Read the eap(4) man page.
>Fix:
Perhaps the CAVEATS section could be worded better...

--- eap.4.orig  2006-07-22 16:23:18.000000000 +0200
+++ eap.4       2006-07-22 16:52:36.000000000 +0200
@@ -34,7 +34,7 @@
 .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
 .\" POSSIBILITY OF SUCH DAMAGE.
 .\"
-.Dd June 22, 2005
+.Dd July 22, 2006
 .Dt EAP 4
 .Os
 .Sh NAME
@@ -43,6 +43,7 @@
 .Sh SYNOPSIS
 .Cd "eap*   at pci? dev ? function ?"
 .Cd "audio* at audiobus?"
+.Cd "joy*   at eap?"
 .Cd "midi*  at eap?"
 .Cd "options EAP_USE_BOTH_DACS"
 .Sh DESCRIPTION
@@ -64,6 +65,7 @@
 .Sh SEE ALSO
 .Xr ac97 4 ,
 .Xr audio 4 ,
+.Xr joy 4 ,
 .Xr midi 4 ,
 .Xr pci 4
 .Sh HISTORY
@@ -71,3 +73,13 @@
 .Nm
 device driver appeared in
 .Nx 1.4 .
+.Sh CAVEATS
+The joystick port hardware works by emulating a legacy
+.Xr isa 4
+joystick port.
+This can cause problems since it's not known if the address is usable on the
+.Xr pci 4
+bus, and since the pci probe is before the
+.Xr isa 4
+probe, it can conflict with isa devices.
+Use with caution.