Overhaul of HP300 documentation:

- improve cross-referencing
- pages for recent drivers
- use correct driver names

share/man/man4/man4.hp300/Makefile

@@ -1,9 +1,16 @@
-#	$NetBSD: Makefile,v 1.8 1999/12/21 05:32:02 fair Exp $
+#	$NetBSD: Makefile,v 1.9 2001/09/11 06:30:02 gmcgarry Exp $
 #	from: @(#)Makefile	8.1 (Berkeley) 6/18/93
 
-MAN=	autoconf.4 cons.4 ct.4 dca.4 dcl.4 dcm.4 dv.4 gb.4 grf.4 hil.4 \
+MAN=	apci.4 autoconf.4 cons.4 ct.4 dio.4 dca.4 dcm.4 dnkbd.4 \
-	intro.4 ite.4 mem.4 ppi.4 rb.4 rd.4 rmp.4 tc.4
+	dvbox.4 frodo.4 \
+	gbox.4 grf.4 hpib.4 hil.4 hyper.4 intro.4 intio.4 ite.4 mem.4 \
+	oscsi.4 ppi.4 rbox.4 rd.4 rmp.4 topcat.4
+
+#MAN+=	dcl.4 st.4 
+
 MLINKS=	mem.4 kmem.4
+MLINKS=	hpib.4 nhpib.4 hpib.4 fhpib.4 hpib.4 hpibbus.4
+
 MANSUBDIR=/hp300
 
 .include <bsd.man.mk>

share/man/man4/man4.hp300/apci.4

@@ -0,0 +1,56 @@
+.\"     $NetBSD: apci.4,v 1.1 2001/09/11 06:30:03 gmcgarry Exp $
+.\"
+.\" Copyright (c) 2001 The NetBSD Foundation, Inc.
+.\" All rights reserved.
+.\"
+.\" This code is derived from software contributed to The NetBSD Foundation
+.\" by Gregory McGarry.
+.\"
+.\" 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 the NetBSD
+.\"        Foundation, Inc. and its contributors.
+.\" 4. Neither the name of The NetBSD Foundation nor the names of its
+.\"    contributors may be used to endorse or promote products derived
+.\"    from this software without specific prior written permission.
+.\"
+.\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
+.\" ``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 FOUNDATION OR CONTRIBUTORS
+.\" 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 September 11, 2001
+.Dt APCI 4 hp300
+.Os
+.Sh NAME
+.Nm apci
+.Nd
+.Tn APCI UART driver
+.Sh SYNOPSIS
+.Cd "apci at frodo? offset ?"
+.Sh DESCRIPTION
+The
+.Nm
+driver provides support for the APCI 8250-like UARTs found on the
+Frodo ASIC on HP Apollo 9000/4xx series workstations.  There are four
+APCI UARTs on the Frodo ASIC.  The first one is used to communicatie
+with the Domain keyboard.  The second one is the serial console port
+when the firmware is in Domain/OS mode.
+.Sh SEE ALSO
+.Xr dnkbd 4 ,
+.Xr frodo 4

share/man/man4/man4.hp300/dca.4

@@ -1,4 +1,4 @@
-.\"	$NetBSD: dca.4,v 1.5 1999/12/15 23:44:51 abs Exp $
+.\"	$NetBSD: dca.4,v 1.6 2001/09/11 06:30:03 gmcgarry Exp $
 .\"
 .\" Copyright (c) 1990, 1991, 1993
 .\"	The Regents of the University of California.  All rights reserved.
@@ -46,7 +46,8 @@
 .Tn HP98644A
 serial communications interface
 .Sh SYNOPSIS
-.Cd "dca0 at scode9 flags 0x1"
+.Cd "dca0 at dio? scode 9 flags 0x1"
+.Cd "dca* at dio? scode ?"
 .Sh DESCRIPTION
 The
 .Tn 98644A
@@ -78,6 +79,7 @@ The single-character input
 has overflowed and incoming data has been lost.
 .El
 .Sh SEE ALSO
+.Xr dio 4 ,
 .Xr tty 4
 .Sh BUGS
 Data loss is possible on busy systems with baud rates greater than 300.

share/man/man4/man4.hp300/dcl.4

@@ -1,4 +1,4 @@
-.\"	$NetBSD: dcl.4,v 1.6 2001/04/11 19:06:11 wiz Exp $
+.\"	$NetBSD: dcl.4,v 1.7 2001/09/11 06:30:03 gmcgarry Exp $
 .\"
 .\" Copyright (c) 1990, 1991, 1993
 .\"	The Regents of the University of California.  All rights reserved.
@@ -46,7 +46,7 @@
 .Tn HP
 98628A serial communications link
 .Sh SYNOPSIS
-.Cd "dcl0 at scode? flags 0x1"
+.Cd "dcl0 at dio? scode ? flags 0x1"
 .Sh DESCRIPTION
 The 98628A is a buffered
 .Tn EIA

share/man/man4/man4.hp300/dcm.4

@@ -1,4 +1,4 @@
-.\"	$NetBSD: dcm.4,v 1.6 2001/04/11 19:06:12 wiz Exp $
+.\"	$NetBSD: dcm.4,v 1.7 2001/09/11 06:30:03 gmcgarry Exp $
 .\"
 .\" Copyright (c) 1990, 1991, 1993
 .\"	The Regents of the University of California.  All rights reserved.
@@ -43,10 +43,10 @@
 .Sh NAME
 .Nm dcm
 .Nd
-.Tn HP
+.Tn HP98642A
-98642A serial communications multiplexer
+serial communications multiplexer
 .Sh SYNOPSIS
-.Cd "dcm0 at scode? flags 0xe"
+.Cd "dcm* at dio? scode ? flags 0xe"
 .Sh DESCRIPTION
 The
 .Tn 98642A
@@ -94,6 +94,7 @@ The 3 character buffer in the uart has
 overflowed.
 .El
 .Sh SEE ALSO
+.Xr dio 4 ,
 .Xr tty 4
 .Sh BUGS
 Total throughput per card, all ports together, is limited to 76800 bits per

share/man/man4/man4.hp300/dio.4

@@ -0,0 +1,115 @@
+.\"     $NetBSD: dio.4,v 1.1 2001/09/11 06:30:03 gmcgarry Exp $
+.\"
+.\" Copyright (c) 2001 The NetBSD Foundation, Inc.
+.\" All rights reserved.
+.\"
+.\" This code is derived from software contributed to The NetBSD Foundation
+.\" by Gregory McGarry.
+.\"
+.\" 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 the NetBSD
+.\"        Foundation, Inc. and its contributors.
+.\" 4. Neither the name of The NetBSD Foundation nor the names of its
+.\"    contributors may be used to endorse or promote products derived
+.\"    from this software without specific prior written permission.
+.\"
+.\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
+.\" ``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 FOUNDATION OR CONTRIBUTORS
+.\" 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 September 10, 2001
+.Dt DIO 4 hp300
+.Os
+.Sh NAME
+.Nm dio
+.Nd
+.Tn DIO/DIO-II bus
+.Sh SYNOPSIS
+.Cd "dio0 at mainbus0"
+.Sh DESCRIPTION
+This driver is for the DIO/DIO-II bus on HP 9000/3xx series
+workstations.
+.Sh SUPPORTED DEVICES
+.Nx
+includes
+.Tn DIO
+drivers, sorted by device type and driver name:
+.Pp
+.Ss Framebuffers
+.Bl -tag -width XXXXXX -offset indent
+.It dvbox
+.Tn HP98730
+``DaVinci'' graphics device interface
+.It gbox
+.Tn HP98700
+``Gatorbox'' graphics device interface
+.It hyper
+.Tn A1096A
+``Hyperion'' graphics device interface
+.It rbox
+.Tn HP98720
+``Renaissance'' graphics device interface
+.It topcat
+.Tn HP98544
+98550 ``Topcat'' and ``Catseye'' device interface
+.El
+.Pp
+.Ss Serial interfaces
+.Bl -tag -width XXXXXX -offset indent
+.It dca
+.Tn HP98644A
+serial communications interface
+.It dcm
+.Tn HP98642A
+serial communications multiplexer
+.El
+.Pp
+.Ss Network interfaces
+.Bl -tag -width XXXXXX -offset indent
+.It le
+.Tn HP98643
+built-in and add-on Ethernet boards
+.El
+.Pp
+.Ss HP-IB interfaces
+.Bl -tag -width XXXXXXe -offset indent
+.It fhpib
+``fast'' HP-IB interface
+.It nhpib
+``normal'' HP-IB interface
+.El
+.Pp
+.Ss SCSI interfaces
+.Bl -tag -width XXXXXX -offset indent
+.It oscsi
+Old HP300 SCSI driver
+.El
+.Pp
+.Sh SEE ALSO
+.Xr dca 4 ,
+.Xr dcm 4 ,
+.Xr dvbox 4 ,
+.Xr gbox 4 ,
+.Xr hpib 4 ,
+.Xr hyper 4 ,
+.Xr le 4 ,
+.Xr oscsi 4 ,
+.Xr rbox 4 ,
+.Xr topcat 4

share/man/man4/man4.hp300/dnkbd.4

@@ -0,0 +1,53 @@
+.\"     $NetBSD: dnkbd.4,v 1.1 2001/09/11 06:30:03 gmcgarry Exp $
+.\"
+.\" Copyright (c) 2001 The NetBSD Foundation, Inc.
+.\" All rights reserved.
+.\"
+.\" This code is derived from software contributed to The NetBSD Foundation
+.\" by Gregory McGarry.
+.\"
+.\" 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 the NetBSD
+.\"        Foundation, Inc. and its contributors.
+.\" 4. Neither the name of The NetBSD Foundation nor the names of its
+.\"    contributors may be used to endorse or promote products derived
+.\"    from this software without specific prior written permission.
+.\"
+.\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
+.\" ``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 FOUNDATION OR CONTRIBUTORS
+.\" 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 September 11, 2001
+.Dt DNKBD 4 hp300
+.Os
+.Sh NAME
+.Nm dnkbd
+.Nd
+.Tn Domain keyboard
+.Sh SYNOPSIS
+.Cd "dnkbd at frodo? offset ?"
+.Sh DESCRIPTION
+The
+.Nm
+driver provides support for the Domain keyboard found on HP Apollo
+9000/4xx series workstations.
+.Sh SEE ALSO
+.Xr apci 4 ,
+.Xr frodo 4

share/man/man4/man4.hp300/dvbox.4

@@ -1,4 +1,4 @@
-.\"	$NetBSD: dv.4,v 1.8 2001/09/11 00:08:33 wiz Exp $
+.\"	$NetBSD: dvbox.4,v 1.1 2001/09/11 06:30:03 gmcgarry Exp $
 .\"
 .\" Copyright (c) 1990, 1991, 1993
 .\"	The Regents of the University of California.  All rights reserved.
@@ -38,10 +38,10 @@
 .\"     from: @(#)dv.4	8.1 (Berkeley) 6/9/93
 .\"
 .Dd June 9, 1993
-.Dt DV 4 hp300
+.Dt DVBOX 4 hp300
 .Os
 .Sh NAME
-.Nm dv
+.Nm dvbox
 .Nd
 .Tn HP98730
 ``DaVinci'' graphics device interface
@@ -57,9 +57,7 @@ up.
 The DaVinci can be configured at either the ``internal'' address
 (frame buffer address 0x200000, control register space address 0x560000)
 or at an external select code less than 32.
-At the internal address it will be the ``preferred'' console device
+At the internal address it will be the ``preferred'' console device.
-(see
-.Xr cons 4 ) .
 The hardware installation manual describes the procedure for
 setting these values.
 .Pp
@@ -109,7 +107,7 @@ mapped, the frame buffer structure is accessible.  The structure describing
 the 98730 is defined in
 .Aq Pa hpdev/grf_dvreg.h .
 .El
-.Sh EXAMPLES
+.Sh EXAMPLE
 This is a short segment of code showing how the device is opened and mapped
 into user process address space assuming that it is
 .Ql grf0 :

share/man/man4/man4.hp300/frodo.4

@@ -0,0 +1,66 @@
+.\"     $NetBSD: frodo.4,v 1.1 2001/09/11 06:30:04 gmcgarry Exp $
+.\"
+.\" Copyright (c) 2001 The NetBSD Foundation, Inc.
+.\" All rights reserved.
+.\"
+.\" This code is derived from software contributed to The NetBSD Foundation
+.\" by Gregory McGarry.
+.\"
+.\" 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 the NetBSD
+.\"        Foundation, Inc. and its contributors.
+.\" 4. Neither the name of The NetBSD Foundation nor the names of its
+.\"    contributors may be used to endorse or promote products derived
+.\"    from this software without specific prior written permission.
+.\"
+.\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
+.\" ``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 FOUNDATION OR CONTRIBUTORS
+.\" 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 September 10, 2001
+.Dt FRODO 4 hp300
+.Os
+.Sh NAME
+.Nm frodo
+.Nd HP Apollo 9000/4xx Frodo ASIC
+.Sh SYNOPSIS
+.Cd "frodo0 at intio?"
+.Sh DESCRIPTION
+The
+.Nm
+driver supports the Frodo ASIC (a.k.a. Apollo Utility chip) found on
+HP Apollo 9000/4xx series workstations.
+.Sh SUPPORTED DEVICES
+.Nx
+includes
+.Tn FRODO
+drivers, sorted by device type and driver name:
+.Ss Serial devices
+.Bl -tag -width pcdisplay -offset indent
+.It dnkbd
+8250-like serial ports (Domain keyboard flavor)
+.It apci
+8250-like serial ports (tty flavor)
+.El
+.Pp
+.Sh SEE ALSO
+.Xr apci 4 ,
+.Xr dnkbd 4 ,
+.Xr intio 4

share/man/man4/man4.hp300/gbox.4

@@ -1,4 +1,4 @@
-.\"	$NetBSD: gb.4,v 1.6 2001/09/11 00:08:34 wiz Exp $
+.\"	$NetBSD: gbox.4,v 1.1 2001/09/11 06:30:04 gmcgarry Exp $
 .\"
 .\" Copyright (c) 1990, 1991, 1993
 .\"	The Regents of the University of California.  All rights reserved.
@@ -125,7 +125,7 @@ Unmap control registers and framebuffer space.
 .Pp
 For further information about the use of ioctl see the man page.
 .El
-.Sh EXAMPLES
+.Sh EXAMPLE
 A small example of opening, mapping and using the device is given below.
 For more examples of the details on the behavior of the device, see the device
 dependent source files for the X Window System, in the

share/man/man4/man4.hp300/grf.4

@@ -1,4 +1,4 @@
-.\"	$NetBSD: grf.4,v 1.5 2001/09/11 00:08:34 wiz Exp $
+.\"	$NetBSD: grf.4,v 1.6 2001/09/11 06:30:04 gmcgarry Exp $
 .\"
 .\" Copyright (c) 1990, 1991, 1993
 .\"	The Regents of the University of California.  All rights reserved.
@@ -37,7 +37,7 @@
 .\"
 .\"     from: @(#)grf.4	8.1 (Berkeley) 6/9/93
 .\"
-.Dd June 9, 1993
+.Dd September 10, 2001
 .Dt GRF 4 hp300
 .Os
 .Sh NAME
@@ -45,6 +45,12 @@
 .Nd
 .Tn HP
 graphics frame buffer device interface
+.Sh SYNOPSIS
+.Cd "grf* at dvbox?"
+.Cd "grf* at gbox?"
+.Cd "grf* at hyper?"
+.Cd "grf* at rbox?"
+.Cd "grf* at topcat?"
 .Sh DESCRIPTION
 This is a generic description of the frame buffer device interface.
 The devices to which this applies are the 98544, 98545 and 98547
@@ -204,8 +210,9 @@ Invalid ioctl specification.
 .El
 .Sh SEE ALSO
 .Xr ioctl 2 ,
-.Xr dv 4 ,
+.Xr dvbox 4 ,
-.Xr gb 4 ,
+.Xr gbox 4 ,
-.Xr rb 4 ,
+.Xr hyper 4 ,
-.Xr tc 4 ,
+.Xr rbox 4 ,
+.Xr topcat 4 ,
 .Xr hil 4

share/man/man4/man4.hp300/hpib.4

@@ -0,0 +1,56 @@
+.\"     $NetBSD: hpib.4,v 1.1 2001/09/11 06:30:04 gmcgarry Exp $
+.\"
+.\" Copyright (c) 2001 The NetBSD Foundation, Inc.
+.\" All rights reserved.
+.\"
+.\" This code is derived from software contributed to The NetBSD Foundation
+.\" by Gregory McGarry.
+.\"
+.\" 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 the NetBSD
+.\"        Foundation, Inc. and its contributors.
+.\" 4. Neither the name of The NetBSD Foundation nor the names of its
+.\"    contributors may be used to endorse or promote products derived
+.\"    from this software without specific prior written permission.
+.\"
+.\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
+.\" ``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 FOUNDATION OR CONTRIBUTORS
+.\" 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 September 10, 2001
+.Dt HPIB 4 hp300
+.Os
+.Sh NAME
+.Nm hpib
+.Nd Built-in and 98625 HP-IB interface
+.Sh SYNOPSIS
+.Cd "nhpib*	at dio? scode ?"
+.Cd "hpibbus*	at nhpib?"
+.Cd "fhpib*	at dio? scode ?"
+.Cd "hpibbus*	at fhpib?"
+.Sh DESCRIPTION
+The
+.Nm
+driver supports the built-in and 98625 HP-IB interface.
+.Sh SEE ALSO
+.Xr ct 4 ,
+.Xr rd 4 ,
+.Xr mt 4 ,
+.Xr ppi 4

share/man/man4/man4.hp300/hyper.4

@@ -0,0 +1,51 @@
+.\"     $NetBSD: hyper.4,v 1.1 2001/09/11 06:30:04 gmcgarry Exp $
+.\"
+.\" Copyright (c) 2001 The NetBSD Foundation, Inc.
+.\" All rights reserved.
+.\"
+.\" This code is derived from software contributed to The NetBSD Foundation
+.\" by Gregory McGarry.
+.\"
+.\" 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 the NetBSD
+.\"        Foundation, Inc. and its contributors.
+.\" 4. Neither the name of The NetBSD Foundation nor the names of its
+.\"    contributors may be used to endorse or promote products derived
+.\"    from this software without specific prior written permission.
+.\"
+.\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
+.\" ``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 FOUNDATION OR CONTRIBUTORS
+.\" 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 September 10, 2001
+.Dt HYPER 4 hp300
+.Os
+.Sh NAME
+.Nm hyper
+.Nd
+.Tn A1096A
+``Hyperion'' graphics device interface
+.Sh SYNOPSIS
+.Cd "hyper* at dio? scode ?"
+.Sh DESCRIPTION
+This driver is for the Hyperion monochrome framebuffer.
+.Sh SEE ALSO
+.Xr ite 4 ,
+.Xr grf 4

share/man/man4/man4.hp300/intio.4

@@ -0,0 +1,71 @@
+.\"	$NetBSD: intio.4,v 1.1 2001/09/11 06:30:05 gmcgarry Exp $
+.\"
+.\" Copyright (c) 1998 MINOURA Makoto
+.\" Copyright (c) 1998 NetBSD Foundation, Inc.
+.\" 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 Minoura Makoto.
+.\" 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 September 10, 2001
+.Dt INTIO 4 hp300
+.Os
+.Sh NAME
+.Nm intio
+.Nd hp300 internal I/O space driver
+.Sh SYNOPSIS
+.Cd "intio0 at mainbus0"
+.Sh DESCRIPTION
+.Nm
+is a virtual device corresponding to the hp300 internal I/O space.
+.Pp
+Internal I/O space spans the hp300 physical address space, and is
+mapped permanently in the kernel virtual space at the very early time
+of the kernel startup procedure.
+.Pp
+.Nm
+driver manages the internal I/O space of hp300.
+.Pp
+.Bl -bullet -offset indent -tag
+.It
+Address range management to avoid confliction of address space of
+which devices probe by touching hardware port is difficult.
+.It
+Interrupt vector management.
+.It
+.Xr bus_space 9
+and
+.Xr bus_dma 9
+implementation.
+.It
+Other utility functions.
+.El
+.Pp
+.Nm
+is always required to run NetBSD kernel.
+.Sh SEE ALSO
+.Xr intro 4 ,
+.Xr bus_space 9 ,
+.Xr bus_dma 9

share/man/man4/man4.hp300/intro.4

@@ -1,4 +1,4 @@
-.\"	$NetBSD: intro.4,v 1.7 2001/04/04 10:54:47 wiz Exp $
+.\"	$NetBSD: intro.4,v 1.8 2001/09/11 06:30:05 gmcgarry Exp $
 .\"
 .\" Copyright (c) 1990, 1991, 1993
 .\"	The Regents of the University of California.  All rights reserved.
@@ -93,15 +93,6 @@ the system will have to be rebooted.
 .Pp
 The autoconfiguration system is described in
 .Xr autoconf 4 .
-A list of the supported devices is given below.
-.Sh SEE ALSO
-.Xr intro 4 ,
-.Xr intro 4 ,
-.Xr autoconf 4 ,
-.Xr config 8
-.Rs
-.%T "Building 4.3 BSD UNIX Systems with Config (SMM:2)"
-.Re
 .Sh LIST OF DEVICES
 The devices listed below are supported in this incarnation of
 the system.  Pseudo-devices are not listed.
@@ -112,29 +103,42 @@ for example, new
 .Tn CS/80
 drives.
 .Bl -column grf/ite -offset indent
+apci	APCI UART driver
 ct	7946/9144 CS/80 cartridge tape
 dca	98644 built-in serial interface
 dcl	HP 98628A communications link
 dcm	HP 98642A communications multiplexer
-dma	98620B DMA controller
+dio	DIO/DIO-II bus
-dv	HP98730 ``DaVinci'' device interface
+dnkbd	Domain keyboard
-gb	 HP98700 ``Gatorbox'' device interface
+dvbox	HP98730 ``DaVinci'' device interface
+frodo	Frodo ASIC (a.k.a. Apollo Utility Chip)
+gbox	HP98700 ``Gatorbox'' device interface
 grf/ite	Topcat/Gatorbox/Renaissance frame buffer
 hil	HIL interface
 hpib	Built-in and 98625 HP-IB interface
+hyper	Hyperion device interface
+intio	HP300 internal I/O space driver
 ite	HP Internal Terminal Emulator
 le	98643 Lance-based Ethernet interface
-mem	main memory
 ppi	HP-IB printer/plotter interface
-rb	HP98720 ``Renaissance'' device interface
+rbox	HP98720 ``Renaissance'' device interface
 rd	CS/80 disk interface
 rmp	HP Remote Maintenance Protocol family
 st	CCS SCSI tape drive
-tc	HP98544-98550 ``Topcat'' and ``Catseye'' device interface
+topcat	HP98544-98550 ``Topcat'' and ``Catseye'' device interface
 .El
+.Sh SEE ALSO
+.Xr intro 4 ,
+.Xr intro 4 ,
+.Xr autoconf 4 ,
+.Xr config 8 .
+.Rs
+.%T "Building 4.3 BSD UNIX Systems with Config (SMM:2)"
+.Re
 .Sh HISTORY
 The
 .Tn HP300
 .Nm intro
 appeared in
 .Bx 4.3 Reno .
+

share/man/man4/man4.hp300/ite.4

@@ -1,4 +1,4 @@
-.\"	$NetBSD: ite.4,v 1.5 1999/12/15 23:44:52 abs Exp $
+.\"	$NetBSD: ite.4,v 1.6 2001/09/11 06:30:05 gmcgarry Exp $
 .\"
 .\" Copyright (c) 1990, 1991, 1993
 .\"	The Regents of the University of California.  All rights reserved.
@@ -37,7 +37,7 @@
 .\"
 .\"     from: @(#)ite.4	8.1 (Berkeley) 6/9/93
 .\"
-.Dd June 9, 1993
+.Dd September 10, 2001
 .Dt ITE 4 hp300
 .Os
 .Sh NAME
@@ -45,6 +45,8 @@
 .Nd
 .Tn HP
 Internal Terminal Emulator graphics driver
+.Sh SYNOPSIS
+.Cd "ite* at grf?"
 .Sh DESCRIPTION
 .Tn TTY
 special files of the form ``ttye?''
@@ -162,6 +164,4 @@ None under
 .Sh SEE ALSO
 .Xr grf 4 ,
 .Xr hil 4 ,
-.Xr gb 4 ,
+.Xr tty 4
-.Xr rb 4 ,
-.Xr tc 4

share/man/man4/man4.hp300/oscsi.4

@@ -0,0 +1,60 @@
+.\"     $NetBSD: oscsi.4,v 1.1 2001/09/11 06:30:05 gmcgarry Exp $
+.\"
+.\" Copyright (c) 2001 The NetBSD Foundation, Inc.
+.\" All rights reserved.
+.\"
+.\" This code is derived from software contributed to The NetBSD Foundation
+.\" by Gregory McGarry.
+.\"
+.\" 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 the NetBSD
+.\"        Foundation, Inc. and its contributors.
+.\" 4. Neither the name of The NetBSD Foundation nor the names of its
+.\"    contributors may be used to endorse or promote products derived
+.\"    from this software without specific prior written permission.
+.\"
+.\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
+.\" ``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 FOUNDATION OR CONTRIBUTORS
+.\" 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 September 11, 2001
+.Dt OSCSI 4 hp300
+.Os
+.Sh NAME
+.Nm oscsi
+.Nd
+.Tn old HP300 CCS SCSI interface
+.Sh SYNOPSIS
+.Cd "oscsi*  at dio? scode ?"
+.Cd "sd*     at oscsi? target ? lun ?"
+.Cd "st*     at oscsi? target ? lun ?"
+.Cd "ac*     at oscsi? target ? lun ?"
+.Sh DESCRIPTION
+The
+.Nm
+driver supports the scsi interface on HP 9000/3xx and 9000/4xx series
+workstations.
+.Sh SEE ALSO
+.Xr ac 4 ,
+.Xr sd 4 ,
+.Xr st 4
+.Sh BUGS
+The current interface should be replaced with the NetBSD
+machine-independent SCSI subsystem.

share/man/man4/man4.hp300/rbox.4

@@ -1,4 +1,4 @@
-.\"	$NetBSD: rb.4,v 1.7 2001/09/11 00:08:34 wiz Exp $
+.\"	$NetBSD: rbox.4,v 1.1 2001/09/11 06:30:05 gmcgarry Exp $
 .\"
 .\" Copyright (c) 1990, 1991, 1993
 .\"	The Regents of the University of California.  All rights reserved.
@@ -37,14 +37,17 @@
 .\"
 .\"     from: @(#)rb.4	8.1 (Berkeley) 6/9/93
 .\"
-.Dd June 9, 1993
+.Dd September 10, 2001
-.Dt RB 4 hp300
+.Dt RBOX 4 hp300
 .Os
 .Sh NAME
-.Nm rb
+.Nm rbox
 .Nd
 .Tn HP98720
 ``Renaissance'' graphics device interface
+.Sh SYNOPSIS
+.Cd "rbox* at intio?"
+.Cd "rbox* at dio? scode ?"
 .Sh DESCRIPTION
 This driver is for the
 .Tn HP98720
@@ -57,9 +60,7 @@ up.
 The Renaissance can be configured at either the ``internal'' address
 (frame buffer address 0x200000, control register space address 0x560000)
 or at an external select code less than 32.
-At the internal address it will be the ``preferred'' console device
+At the internal address it will be the ``preferred'' console device.
-(see
-.Xr cons 4 ) .
 The hardware installation manual describes the procedure for
 setting these values.
 .Pp
@@ -109,7 +110,7 @@ mapped, the frame buffer structure is accessible.  The structure describing
 the 98720 is defined in
 .Pa hpdev/grf_rbreg.h .
 .El
-.Sh EXAMPLES
+.Sh EXAMPLE
 This is a short segment of code showing how the device is opened and mapped
 into user process address space assuming that it is grf0:
 .Bd -literal
@@ -165,7 +166,8 @@ Invalid ioctl specification.
 .El
 .Sh SEE ALSO
 .Xr ioctl 2 ,
-.Xr grf 4 .
+.Xr ite 4 ,
+.Xr grf 4
 .Pp
 For extensive code examples using the
 Renaissance, see the X device dependent source.

share/man/man4/man4.hp300/rd.4

@@ -1,4 +1,4 @@
-.\"	$NetBSD: rd.4,v 1.6 2001/04/11 19:07:09 wiz Exp $
+.\"	$NetBSD: rd.4,v 1.7 2001/09/11 06:30:06 gmcgarry Exp $
 .\"
 .\" Copyright (c) 1990, 1991, 1993
 .\"	The Regents of the University of California.  All rights reserved.
@@ -46,8 +46,8 @@
 .Tn CS/80
 disk interface
 .Sh SYNOPSIS
-.Cd "hpib* at scode?"
+.Cd "rd* at fhpib? slave?"
-.Cd "rd* at hpib? slave?"
+.Cd "rd* at nhpib? slave?"
 .Sh DESCRIPTION
 This is a generic
 .Tn CS/80

share/man/man4/man4.hp300/topcat.4

@@ -1,4 +1,4 @@
-.\"	$NetBSD: tc.4,v 1.7 2001/09/11 00:08:34 wiz Exp $
+.\"	$NetBSD: topcat.4,v 1.1 2001/09/11 06:30:06 gmcgarry Exp $
 .\"
 .\" Copyright (c) 1990, 1991, 1993
 .\"	The Regents of the University of California.  All rights reserved.
@@ -37,14 +37,17 @@
 .\"
 .\"     from: @(#)tc.4	8.1 (Berkeley) 6/9/93
 .\"
-.Dd June 9, 1993
+.Dd September 10, 2001
-.Dt TC 4 hp300
+.Dt TOPCAT 4 hp300
 .Os
 .Sh NAME
-.Nm tc
+.Nm topcat
 .Nd
 .Tn HP98544
 98550 ``Topcat'' and ``Catseye'' device interface
+.Sh SYNOPSIS
+.Cd "topcat* at intio?"
+.Cd "topcat* at dio? scode ?"
 .Sh DESCRIPTION
 This driver is for the
 .Tn HP98544 ,
@@ -115,7 +118,7 @@ describing Topcat/Catseye devices is defined in
 For further information about the use of
 .Xr ioctl 2
 see the man page.
-.Sh EXAMPLES
+.Sh EXAMPLE
 A small example of opening, mapping and using the device is given below.
 For more examples of the details on the behavior of the device, see the device
 dependent source files for the X Window System, in the
@@ -175,4 +178,5 @@ specification.
 .El
 .Sh SEE ALSO
 .Xr ioctl 2 ,
+.Xr ite 4 ,
 .Xr grf 4