add a page for hpibbus, and the bits that go with it;

mostly taken from source code, with some tweaks from miod

ok miod

4 files changed, 90 insertions, 19 deletions

diff --git a/share/man/man4/man4.hp300/Makefile b/share/man/man4/man4.hp300/Makefile
index 9d30a1e688c..a2278090482 100644
--- a/share/man/man4/man4.hp300/Makefile
+++ b/share/man/man4/man4.hp300/Makefile
@@ -1,11 +1,11 @@
-#	$OpenBSD: Makefile,v 1.14 2007/01/06 20:40:20 miod Exp $
+#	$OpenBSD: Makefile,v 1.15 2008/04/01 14:22:28 jmc Exp $
 #	from: @(#)Makefile	5.1 (Berkeley) 6/29/90
 
 MAN=	apci.4 autoconf.4 ct.4 dca.4 dcm.4 dio.4 dnkbd.4 dvbox.4 \
-	frodo.4 gbox.4 hd.4 hyper.4 intro.4 isabr.4 le.4 mem.4 \
+	frodo.4 gbox.4 hd.4 hpibbus.4 hyper.4 intro.4 isabr.4 le.4 mem.4 \
 	nhpib.4 ppi.4 rbox.4 sgc.4 spc.4 topcat.4 tvrx.4
 MLINKS=	mem.4 kmem.4
-MLINKS+=nhpib.4 fhpib.4 nhpib.4 hpibbus.4
+MLINKS+=nhpib.4 fhpib.4
 MANSUBDIR=hp300
 
 .include <bsd.prog.mk>
diff --git a/share/man/man4/man4.hp300/hpibbus.4 b/share/man/man4/man4.hp300/hpibbus.4
new file mode 100644
index 00000000000..4e12f5862d8
--- /dev/null
+++ b/share/man/man4/man4.hp300/hpibbus.4
@@ -0,0 +1,76 @@
+.\"	$OpenBSD: hpibbus.4,v 1.1 2008/04/01 14:22:28 jmc Exp $
+.\"
+.\" Copyright (c) 1996, 1997 Jason R. Thorpe.  All rights reserved.
+.\" Copyright (c) 1982, 1990, 1993
+.\"	The Regents of the University of California.  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. Neither the name of the University 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 REGENTS 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 REGENTS 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 $Mdocdate: April 1 2008 $
+.Dt HPIBBUS 4 hp300
+.Os
+.Sh NAME
+.Nm hpibbus
+.Nd HP-IB bus interface
+.Sh SYNOPSIS
+.Cd "hpibbus*	at nhpib?"
+.Cd "hpibbus*	at fhpib?"
+.Pp
+.Cd "hd*	at hpibbus?                 " Pq "disks"
+.Cd "ct*	at hpibbus?                 " Pq "cartridge tapes"
+.Cd "mt*	at hpibbus?                 " Pq "9-track tapes"
+.Cd "ppi0	at hpibbus? slave 5 punit 0 " Pq "plotter"
+.Sh DESCRIPTION
+HP-IB is essentially an IEEE 488 bus,
+with an HP command set
+.Po
+CS/80 on
+.Sq newer
+devices, Amigo on before-the-early-1980s devices
+.Pc
+thrown on top.
+Devices that respond to CS/80 (and probably Amigo, too)
+are tagged with a 16-bit ID.
+.Pp
+HP-IB has a 2-level addressing scheme:
+slave, the analog of a SCSI ID, and punit, the analog of a SCSI LUN.
+.Pp
+The CS/80 ID is unique to the slave, and is shared by all its punits.
+Most devices only have one punit; multiple punits are often used for disk
+drives that have an accompanying tape drive on the second punit,
+or for dual floppy drives.
+.Pp
+In addition, not all HP-IB devices speak CS/80 or Amigo.
+Examples of such devices are HP-IB plotters,
+which simply take raw plotter commands over 488.
+These devices do not have ID tags,
+and often the host cannot even tell if such
+a device is attached to the system.
+.Sh SEE ALSO
+.Xr \&ct 4 ,
+.Xr hd 4 ,
+.Xr intro 4 ,
+.Xr nhpib 4 ,
+.Xr ppi 4
diff --git a/share/man/man4/man4.hp300/intro.4 b/share/man/man4/man4.hp300/intro.4
index 9fe889f8f5c..b2d30652104 100644
--- a/share/man/man4/man4.hp300/intro.4
+++ b/share/man/man4/man4.hp300/intro.4
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: intro.4,v 1.29 2008/03/26 08:52:38 jmc Exp $
+.\"	$OpenBSD: intro.4,v 1.30 2008/04/01 14:22:28 jmc Exp $
 .\"
 .\" Copyright (c) 1990, 1991, 1993
 .\"	The Regents of the University of California.  All rights reserved.
@@ -29,7 +29,7 @@
 .\"
 .\"     from: @(#)intro.4	8.1 (Berkeley) 6/5/93
 .\"
-.Dd $Mdocdate: March 26 2008 $
+.Dd $Mdocdate: April 1 2008 $
 .Dt INTRO 4 hp300
 .Os
 .Sh NAME
@@ -128,13 +128,15 @@ CS/80 disk interface
 .It Xr hil 4
 introduction to HP-HIL support
 .It Xr hpibbus 4
-built-in 98624 and 98625 HP-IB interfaces
+HP-IB bus interface
 .It Xr hyper 4
 HP A1096A Hyperion frame buffer
 .It Xr isabr 4
 Frodo ISA bridge
 .It Xr le 4
 AMD LANCE Ethernet device
+.It Xr nhpib 4
+built-in 98624 and 98625 HP-IB interfaces
 .It Xr ppi 4
 HP-IB printer/plotter interface
 .It Xr rbox 4
diff --git a/share/man/man4/man4.hp300/nhpib.4 b/share/man/man4/man4.hp300/nhpib.4
index 939fa29a64c..e18f952504e 100644
--- a/share/man/man4/man4.hp300/nhpib.4
+++ b/share/man/man4/man4.hp300/nhpib.4
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: nhpib.4,v 1.7 2007/06/21 12:06:14 jmc Exp $
+.\"	$OpenBSD: nhpib.4,v 1.8 2008/04/01 14:22:28 jmc Exp $
 .\"     $NetBSD: hpib.4,v 1.2 2002/01/15 01:35:44 wiz Exp $
 .\"
 .\" Copyright (c) 2001 The NetBSD Foundation, Inc.
@@ -35,22 +35,18 @@
 .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
 .\" POSSIBILITY OF SUCH DAMAGE.
 .\"
-.Dd $Mdocdate: June 21 2007 $
+.Dd $Mdocdate: April 1 2008 $
 .Dt NHPIB 4 hp300
 .Os
 .Sh NAME
-.Nm nhpib
+.Nm nhpib ,
+.Nm fhpib
 .Nd built-in 98624 and 98625 HP-IB interfaces
 .Sh SYNOPSIS
 .Cd "nhpib*	at dio?                " Pq "built-in and 98624 HP-IB interface"
 .Cd "hpibbus*	at nhpib?"
 .Cd "fhpib*	at dio?                " Pq "98625 fast HP-IB interface"
 .Cd "hpibbus*	at fhpib?"
-.Pp
-.Cd "hd*	at hpibbus?                 " Pq "disks"
-.Cd "ct*	at hpibbus?                 " Pq "cartridge tapes"
-.Cd "mt*	at hpibbus?                 " Pq "9-track tapes"
-.Cd "ppi0	at hpibbus? slave 5 punit 0 " Pq "plotter"
 .Sh DESCRIPTION
 The
 .Nm
@@ -58,9 +54,6 @@ driver supports the built-in and 98624 HP-IB interfaces, while the
 .Nm fhpib
 driver supports the faster 98625 HP-IB interface.
 .Sh SEE ALSO
-.Xr \&ct 4 ,
 .Xr dio 4 ,
-.Xr hd 4 ,
-.Xr intro 4 ,
-.\" .Xr mt 4 ,
-.Xr ppi 4
+.Xr hpibbus 4 ,
+.Xr intro 4