Document the recent VAX frame buffer changes, especially the way smg(4)

attaches (or refuses to) now.

7 files changed, 223 insertions, 12 deletions

diff --git a/share/man/man4/man4.vax/Makefile b/share/man/man4/man4.vax/Makefile
index e41f1e4a264..b221a022270 100644
--- a/share/man/man4/man4.vax/Makefile
+++ b/share/man/man4/man4.vax/Makefile
@@ -1,4 +1,4 @@
-#	$OpenBSD: Makefile,v 1.20 2006/07/20 19:15:34 miod Exp $
+#	$OpenBSD: Makefile,v 1.21 2006/07/28 21:25:21 miod Exp $
 #	$NetBSD: Makefile,v 1.6 1996/03/03 17:13:09 thorpej Exp $
 #	from: @(#)Makefile	5.4 (Berkeley) 5/11/90
 
@@ -6,9 +6,9 @@
 # acc.4 ad.4 crl.4 css.4 ct.4 ddn.4 dh.4 dmc.4 dmf.4 dmv.4 dmz.4 dn.4
 # ec.4 en.4 ex.4 fl.4 hdh.4 hk.4 ht.4 hy.4 ik.4 il.4 ix.4 kg.4 lp.4 np.4
 # pcl.4 ps.4 tm.4 tmscp.4 tu.4 up.4 ut.4 uu.4 va.4 vp.4 vv.4
-MAN=	asc.4 autoconf.4 cons.4 de.4 dhu.4 dz.4 hp.4 ibus.4 intro.4 \
-	le.4 led.4 lkkbd.4 lkms.4 mem.4 mscpbus.4 mt.4 mtc.4 ncr.4 \
-	qe.4 ra.4 rx.4 smg.4 ts.4 uba.4 uda.4 vsbus.4 ze.4
+MAN=	asc.4 autoconf.4 cons.4 de.4 dhu.4 dz.4 gpx.4 hp.4 ibus.4 intro.4 \
+	lcg.4 lcspx.4 le.4 led.4 lkkbd.4 lkms.4 mem.4 mscpbus.4 mt.4 mtc.4 \
+	ncr.4 qe.4 ra.4 rx.4 smg.4 ts.4 uba.4 uda.4 vsbus.4 ze.4
 MLINKS=	mem.4 kmem.4
 MANSUBDIR=vax
 
diff --git a/share/man/man4/man4.vax/gpx.4 b/share/man/man4/man4.vax/gpx.4
new file mode 100644
index 00000000000..1a398328bcb
--- /dev/null
+++ b/share/man/man4/man4.vax/gpx.4
@@ -0,0 +1,57 @@
+.\"	$OpenBSD: gpx.4,v 1.1 2006/07/28 21:25:21 miod Exp $
+.\"
+.\" Copyright (c) 2003 Jason L. Wright (jason@thought.net)
+.\" 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.
+.\"
+.\" 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 July 28, 2006
+.Dt GPX 4 vax
+.Os
+.Sh NAME
+.Nm gpx
+.Nd GPX color frame buffer
+.Sh SYNOPSIS
+.Cd "gpx0 at vsbus0 csr 0x3c000000"
+.Cd "wsdisplay* at gpx?"
+.Sh DESCRIPTION
+The
+.Nm
+is a 4 or 8 bit color frame buffer option for low-end VAXstation 3100 systems.
+.Pp
+The
+.Nm
+driver interfaces the frame buffer with the
+.Xr wscons 4
+console framework.
+It does not provide direct device driver entry points
+but makes its functions available via the internal
+.Xr wsdisplay 4
+interface.
+.Sh SEE ALSO
+.Xr intro 4 ,
+.Xr lcg 4 ,
+.Xr lcspx 4 ,
+.Xr smg 4 ,
+.Xr vsbus 4 ,
+.Xr wscons 4 ,
+.Xr wsdisplay 4
diff --git a/share/man/man4/man4.vax/intro.4 b/share/man/man4/man4.vax/intro.4
index 6e7736fd0a9..9e792747f11 100644
--- a/share/man/man4/man4.vax/intro.4
+++ b/share/man/man4/man4.vax/intro.4
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: intro.4,v 1.22 2004/08/15 22:52:41 jmc Exp $
+.\"	$OpenBSD: intro.4,v 1.23 2006/07/28 21:25:21 miod Exp $
 .\"	$NetBSD: intro.4,v 1.3 1996/03/03 17:13:44 thorpej Exp $
 .\"
 .\" Copyright (c) 1980, 1991 Regents of the University of California.
@@ -30,7 +30,7 @@
 .\"
 .\"     from: @(#)intro.4	6.6 (Berkeley) 3/27/91
 .\"
-.Dd March 27, 1991
+.Dd July 28, 2006
 .Dt INTRO 4 vax
 .Os
 .Sh NAME
@@ -108,6 +108,12 @@ DHU-11 terminal multiplexor.
 DZ-11 terminal multiplexer.
 .It Xr ibus 4
 Internal bus on MicroVAX, VAX 4000 series, and others.
+.It Xr gpx 4
+GPX color frame buffer.
+.It Xr lcg 4
+VAXstation 4000/60 and VLC color frame buffer.
+.It Xr lcspx 4
+VAXstation 4000/90 color frame buffer.
 .It Xr le 4
 LANCE Ethernet interface.
 .It Xr lkkbd 4
diff --git a/share/man/man4/man4.vax/lcg.4 b/share/man/man4/man4.vax/lcg.4
new file mode 100644
index 00000000000..0b45cabbc80
--- /dev/null
+++ b/share/man/man4/man4.vax/lcg.4
@@ -0,0 +1,58 @@
+.\"	$OpenBSD: lcg.4,v 1.1 2006/07/28 21:25:21 miod Exp $
+.\"
+.\" Copyright (c) 2003 Jason L. Wright (jason@thought.net)
+.\" 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.
+.\"
+.\" 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 July 28, 2006
+.Dt LCG 4 vax
+.Os
+.Sh NAME
+.Nm lcg
+.Nd VAXstation 4000/60 and VLC color frame buffer
+.Sh SYNOPSIS
+.Cd "lcg0 at vsbus0 csr 0x20100000"
+.Cd "wsdisplay* at lcg?"
+.Sh DESCRIPTION
+The
+.Nm
+is a 4 or 8 bit color frame buffer commonly encountered in VAXstation 4000/60
+and VAXstation VLC systems.
+.Pp
+The
+.Nm
+driver interfaces the frame buffer with the
+.Xr wscons 4
+console framework.
+It does not provide direct device driver entry points
+but makes its functions available via the internal
+.Xr wsdisplay 4
+interface.
+.Sh SEE ALSO
+.Xr gpx 4 ,
+.Xr intro 4 ,
+.Xr lcspx 4 ,
+.Xr smg 4 ,
+.Xr vsbus 4 ,
+.Xr wscons 4 ,
+.Xr wsdisplay 4
diff --git a/share/man/man4/man4.vax/lcspx.4 b/share/man/man4/man4.vax/lcspx.4
new file mode 100644
index 00000000000..b536b9482bd
--- /dev/null
+++ b/share/man/man4/man4.vax/lcspx.4
@@ -0,0 +1,58 @@
+.\"	$OpenBSD: lcspx.4,v 1.1 2006/07/28 21:25:21 miod Exp $
+.\"
+.\" Copyright (c) 2003 Jason L. Wright (jason@thought.net)
+.\" 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.
+.\"
+.\" 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 July 28, 2006
+.Dt LCSPX 4 vax
+.Os
+.Sh NAME
+.Nm lcspx
+.Nd VAXstation 4000/90 color frame buffer
+.Sh SYNOPSIS
+.Cd "lcspx0 at vsbus0 csr 0x39302000"
+.Cd "wsdisplay* at lcspx?"
+.Sh DESCRIPTION
+The
+.Nm
+is a 8 bit color frame buffer commonly encountered in VAXstation 4000/90
+systems.
+.Pp
+The
+.Nm
+driver interfaces the frame buffer with the
+.Xr wscons 4
+console framework.
+It does not provide direct device driver entry points
+but makes its functions available via the internal
+.Xr wsdisplay 4
+interface.
+.Sh SEE ALSO
+.Xr gpx 4 ,
+.Xr intro 4 ,
+.Xr lcg 4 ,
+.Xr smg 4 ,
+.Xr vsbus 4 ,
+.Xr wscons 4 ,
+.Xr wsdisplay 4
diff --git a/share/man/man4/man4.vax/smg.4 b/share/man/man4/man4.vax/smg.4
index 39915e0f1e4..d56d5ade2fb 100644
--- a/share/man/man4/man4.vax/smg.4
+++ b/share/man/man4/man4.vax/smg.4
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: smg.4,v 1.4 2003/06/06 10:29:42 jmc Exp $
+.\"	$OpenBSD: smg.4,v 1.5 2006/07/28 21:25:21 miod Exp $
 .\"
 .\" Copyright (c) 2003 Jason L. Wright (jason@thought.net)
 .\" All rights reserved.
@@ -24,7 +24,7 @@
 .\" ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
 .\" POSSIBILITY OF SUCH DAMAGE.
 .\"
-.Dd March 6, 2003
+.Dd July 28, 2006
 .Dt SMG 4 vax
 .Os
 .Sh NAME
@@ -36,15 +36,38 @@
 .Sh DESCRIPTION
 The
 .Nm
-is a memory based monochrome frame buffer driver for the
+is a monochrome frame buffer found on-board most VAXstation 3100 systems.
+.Pp
+The
+.Nm
+driver interfaces the frame buffer with the
 .Xr wscons 4
 console framework.
 It does not provide direct device driver entry points
 but makes its functions available via the internal
 .Xr wsdisplay 4
 interface.
+.Pp
+When a color option board (either a
+.Xr gpx 4
+or a spx frame buffer) is installed, the
+.Nm
+driver will not attach by default, since the color option takes over the
+video connector on the back of the system.
+However, the output signal pins are independent, and it is possible to
+connect a monochrome video cable even if a color option board is installed.
+To force the
+.Nm
+driver to attach in this case, change the device flags to 1.
+It will however not be possible to use the monochrome frame buffer
+as the
+.Ox
+console in this case.
 .Sh SEE ALSO
+.Xr gpx 4 ,
 .Xr intro 4 ,
+.Xr lcg 4 ,
+.Xr lcspx 4 ,
 .Xr vsbus 4 ,
 .Xr wscons 4 ,
 .Xr wsdisplay 4
diff --git a/share/man/man4/man4.vax/vsbus.4 b/share/man/man4/man4.vax/vsbus.4
index 0cf79f0551a..74203cf9b39 100644
--- a/share/man/man4/man4.vax/vsbus.4
+++ b/share/man/man4/man4.vax/vsbus.4
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: vsbus.4,v 1.9 2004/08/15 22:52:41 jmc Exp $
+.\"	$OpenBSD: vsbus.4,v 1.10 2006/07/28 21:25:21 miod Exp $
 .\"
 .\" Copyright (c) 2003 Jason L. Wright (jason@thought.net)
 .\" All rights reserved.
@@ -24,7 +24,7 @@
 .\" ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
 .\" POSSIBILITY OF SUCH DAMAGE.
 .\"
-.Dd March 6, 2003
+.Dd July 28, 2006
 .Dt VSBUS 4 vax
 .Os
 .Sh NAME
@@ -41,11 +41,17 @@ class systems.
 .Sh SUPPORTED DEVICES
 The following devices are supported on
 .Nm vsbus .
-.Bl -tag -width asc(4) -compact -offset indent
+.Bl -tag -width 8n -compact -offset indent
 .It Xr asc 4
 NCR 53c94 SCSI controller.
 .It Xr dz 4
 DZ-11 terminal multiplexer.
+.It Xr gpx 4
+GPX color frame buffer.
+.It Xr lcg 4
+VAXstation 4000/60 and VLC color frame buffer.
+.It Xr lcspx 4
+VAXstation 4000/90 color frame buffer.
 .It Xr le 4
 LANCE Ethernet interface.
 .It Xr ncr 4
@@ -58,7 +64,10 @@ SGEC Ethernet interface.
 .Sh SEE ALSO
 .Xr asc 4 ,
 .Xr dz 4 ,
+.Xr gpx 4 ,
 .Xr intro 4 ,
+.Xr lcg 4 ,
+.Xr lcspx 4 ,
 .Xr le 4 ,
 .Xr ncr 4 ,
 .Xr smg 4 ,