[src/netbsd-1-4]: src/share/man/man4 -pckbc0 -> pckbc*

[drochner <drochner%NetBSD.org@localhost>]

details:   https://anonhg.NetBSD.org/src/rev/e31436e3fbe6
branches:  netbsd-1-4
changeset: 468412:e31436e3fbe6
user:      drochner <drochner%NetBSD.org@localhost>
date:      Wed Apr 21 18:42:04 1999 +0000

description:
-pckbc0 -> pckbc*
-add pckbc(4) and pcppi(4) manpages
-split pms(4i386) driver manpage into an opms(4i386) and an mi pms(4)
-add some MLINKS
-various fixes/additions

diffstat:

 share/man/man4/man4.i386/opms.4 |  79 +++++++++++++++++++++++++++++++++++++++++
 share/man/man4/pckbc.4          |  35 ++++++++++++++++++
 share/man/man4/pcppi.4          |  46 +++++++++++++++++++++++
 share/man/man4/pms.4            |  64 +++++++++++++++++++++++++++++++++
 4 files changed, 224 insertions(+), 0 deletions(-)

diffs (240 lines):

diff -r c92fa78c9fd5 -r e31436e3fbe6 share/man/man4/man4.i386/opms.4
--- /dev/null   Thu Jan 01 00:00:00 1970 +0000
+++ b/share/man/man4/man4.i386/opms.4   Wed Apr 21 18:42:04 1999 +0000
@@ -0,0 +1,79 @@
+.\"    $NetBSD: opms.4,v 1.1.2.2 1999/04/21 18:42:06 drochner Exp $
+.\"
+.\" Copyright (c) 1993 Christopher G. Demetriou
+.\" All rights reserved.
+.\"
+.\" Redistribution and use in source and binary forms, with or without
+.\" modification, are permitted provided that the following conditions
+.\" are met:
+.\" 1. Redistributions of source code must retain the above copyright
+.\"    notice, this list of conditions and the following disclaimer.
+.\" 2. Redistributions in binary form must reproduce the above copyright
+.\"    notice, this list of conditions and the following disclaimer in the
+.\"    documentation and/or other materials provided with the distribution.
+.\" 3. All advertising materials mentioning features or use of this software
+.\"    must display the following acknowledgement:
+.\"      This product includes software developed by Christopher G. Demetriou.
+.\" 4. The name of the author may not be used to endorse or promote products
+.\"    derived from this software without specific prior written permission
+.\"
+.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
+.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
+.\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
+.\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
+.\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
+.\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
+.\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
+.\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
+.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+.\"
+.Dd March 12, 1997
+.Dt OPMS 4 i386
+.Os
+.Sh NAME
+.Nm opms
+.Nd PS/2 auxiliary port mouse driver
+.Sh SYNOPSIS
+.Cd pckbc* at isa?
+.Cd opms* at pckbc?
+.Cd opms0 at pc? irq 12
+.Cd opms0 at vt? irq 12
+.Cd options PMS_RESET_AND_DISABLE
+.Sh DESCRIPTION
+This driver provides a interface to a PS/2 auxiliary port mouse which
+is backwards-compatible to previous
+.Nx / i386
+versions without
+.Xr wscons 4
+support.
+The
+.Dq opms
+driver internally converts the PS/2 mouse output into
+.Xr busmouse 4
+protocol.
+.Sh CONFIGURATION
+The option PMS_RESET_AND_DISABLE is available only if the
+.Dq opms
+device is attached to a
+.Xr pc 4
+or
+.Xr pcvt 4
+terminal driver. It causes the mouse device to be reset when it
+is probed and disabled when it is closed.
+.Sh FILES
+.Bl -tag -width Pa -compact
+.It Pa /dev/pms0
+first PS/2 mouse device.
+.El
+.Sh SEE ALSO
+.Xr pms 4 ,
+.Xr pckbc 4 ,
+.Xr wsmouse 4 ,
+.Xr busmouse 4 ,
+.Xr lms 4 ,
+.Xr mms 4 .
+.Sh BUGS
+The
+.Nm
+device probe routine has been known to confuse some keyboard controllers.
diff -r c92fa78c9fd5 -r e31436e3fbe6 share/man/man4/pckbc.4
--- /dev/null   Thu Jan 01 00:00:00 1970 +0000
+++ b/share/man/man4/pckbc.4    Wed Apr 21 18:42:04 1999 +0000
@@ -0,0 +1,35 @@
+.\" $NetBSD: pckbc.4,v 1.1.2.2 1999/04/21 18:42:04 drochner Exp $
+.Dd April 21, 1999
+.Os
+.Dt PCKBC 4
+.Sh NAME
+.Nm pckbc
+.Nd PC (ISA) keyboard controller driver
+.Sh SYNOPSIS
+.Cd pckbc* at isa?
+.Cd pckbd* at pckbc? slot ?
+.Cd pms* at pckbc? slot ?
+.Cd pmsi* at pckbc? slot ?
+.Cd opms* at pckbc? slot ?
+.Sh DESCRIPTION
+The
+.Nm
+driver handles ressource allocation and device attachment for the
+traditional PC/AT keyboard controller. It provides two logical
+connections for child devices, the
+.Dq keyboard
+slot for a keyboard and the
+.Dq auxillary
+slot for mice (the latter might be missing in older keyboard controllers).
+.Pp
+The optional
+.Dq slot
+locator argument can be used to force unusual connections of devices to
+logical slots. This feature is for experimentation only, it will not be
+useful in normal operation.
+.Sh SEE ALSO
+.Xr isa 4 ,
+.Xr pckbd 4 ,
+.Xr pms 4 ,
+.Xr pmsi 4 ,
+.Xr opms 4 .
diff -r c92fa78c9fd5 -r e31436e3fbe6 share/man/man4/pcppi.4
--- /dev/null   Thu Jan 01 00:00:00 1970 +0000
+++ b/share/man/man4/pcppi.4    Wed Apr 21 18:42:04 1999 +0000
@@ -0,0 +1,46 @@
+.\" $NetBSD: pcppi.4,v 1.1.2.2 1999/04/21 18:42:05 drochner Exp $
+.Dd April 21, 1999
+.Os
+.Dt PCPPI 4
+.Sh NAME
+.Nm pcppi
+.Nd PC (ISA) control and timer port driver
+.Sh SYNOPSIS
+.Cd pcppi* at isa?
+.Cd spkr* at pcppi?
+.Cd midi* at pcppi?
+.Cd isabeep* at pcppi?
+(alpha only)
+.Cd sysbeep* at pcppi?
+(i386 only)
+.Sh DESCRIPTION
+The
+.Nm
+driver handles ressource allocation and device attachment for the
+ports related to the ISA speaker in the traditional PC/AT
+.Dq design .
+These are the
+.Dq system control port
+(which was implemented by the 8255
+.Dq PPI
+in the XT, hence the name of this driver)
+at IO address 0x61 and the first 8253 timer at 0x40-0x43.
+.Pp
+It provides its child devices with the ability to output
+simple tones through the PC speaker.
+.Xr speaker 4
+and
+.Xr midi 4
+are devices for their own.
+.Dq isabeep /
+.Dq sysbeep
+is a helper device which the
+.Xr pckbd 4
+driver uses as a substitute for a
+.Dq keyboard beep
+because the PC keyboard hardware doesn't provide this.
+.Sh SEE ALSO
+.Xr isa 4 ,
+.Xr speaker 4 ,
+.Xr midi 4 ,
+.Xr pckbd 4 .
diff -r c92fa78c9fd5 -r e31436e3fbe6 share/man/man4/pms.4
--- /dev/null   Thu Jan 01 00:00:00 1970 +0000
+++ b/share/man/man4/pms.4      Wed Apr 21 18:42:04 1999 +0000
@@ -0,0 +1,64 @@
+.\"    $NetBSD: pms.4,v 1.1.2.2 1999/04/21 18:42:05 drochner Exp $
+.\"
+.\" Copyright (c) 1993 Christopher G. Demetriou
+.\" All rights reserved.
+.\"
+.\" Redistribution and use in source and binary forms, with or without
+.\" modification, are permitted provided that the following conditions
+.\" are met:
+.\" 1. Redistributions of source code must retain the above copyright
+.\"    notice, this list of conditions and the following disclaimer.
+.\" 2. Redistributions in binary form must reproduce the above copyright
+.\"    notice, this list of conditions and the following disclaimer in the
+.\"    documentation and/or other materials provided with the distribution.
+.\" 3. All advertising materials mentioning features or use of this software
+.\"    must display the following acknowledgement:
+.\"      This product includes software developed by Christopher G. Demetriou.
+.\" 4. The name of the author may not be used to endorse or promote products
+.\"    derived from this software without specific prior written permission
+.\"
+.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
+.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
+.\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
+.\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
+.\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
+.\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
+.\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
+.\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
+.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+.\"
+.Dd March 12, 1997
+.Dt PMS 4
+.Os
+.Sh NAME
+.Nm pms
+.Nd PS/2 auxiliary port mouse driver
+.Sh SYNOPSIS
+.Cd pckbc* at isa?
+.Cd pms* at pckbc?
+.Cd pmsi* at pckbc?
+.Cd wsmouse* at pms?
+.Cd wsmouse* at pmsi?
+.Sh DESCRIPTION
+The
+.Nm
+drivers provide an interface to PS/2 auxiliary port mice within the
+.Xr wscons 4
+framework. Parent device in terms of the autoconfiguration framework is
+.Xr pckbc 4 ,
+the PC keyboard controller.
+.Dq pms
+is a generic driver which supports 2 coordinate axes and 3 buttons. The
+.Dq pmsi
+variant provides specific support for wheel mice of the
+.Dq IntelliMouse
+breed; wheel movements are mapped to a third (z-) axis.
+Mouse related data are accessed by
+.Xr wsmouse 4
+devices.
+.Sh SEE ALSO
+.Xr wsmouse 4 ,
+.Xr ums 4 ,
+.Xr pckbc 4 ,
+.Xr opms 4 .