Better frame buffer manual pages: attempt to better describe the frame buffers

supported by the various drivers, and provide more accurate information
about them.

Some feedback and fixes from jmc@ and deraadt@

13 files changed, 109 insertions, 41 deletions

diff --git a/share/man/man4/man4.sparc/agten.4 b/share/man/man4/man4.sparc/agten.4
index fbfe9f1d933..ca80c76c829 100644
--- a/share/man/man4/man4.sparc/agten.4
+++ b/share/man/man4/man4.sparc/agten.4
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: agten.4,v 1.2 2003/03/09 02:39:27 miod Exp $
+.\"	$OpenBSD: agten.4,v 1.3 2003/03/10 20:11:33 miod Exp $
 .\" Copyright (c) 2003 Miodrag Vallat.  All rights reserved.
 .\"
 .\" Redistribution and use in source and binary forms, with or without
@@ -27,18 +27,20 @@
 .Os
 .Sh NAME
 .Nm agten
-.Nd accelerated 24-bit color frame buffer
+.Nd Fujitsu AG-10e accelerated 24-bit color frame buffer
 .Sh SYNOPSIS
 .Cd "agten* at sbus? slot ? offset ?"
 .Cd "wsdisplay* at agten?"
 .Sh DESCRIPTION
 The
-.Nm
-is a memory based color frame buffer, with graphics acceleration
-and overlay capabilities, and hardware OpenGL capabilities.
+.Tn Fujitsu
+AG-10e
+is a two-slot SBus color frame buffer, with graphics acceleration
+and overlay capabilities, including hardware OpenGL processing.
+.Pp
 The
 .Nm
-driver interfaces the frame buffer to the
+driver interfaces the frame buffer with the
 .Xr wscons 4
 console framework.
 It does not provide direct device driver entry points
diff --git a/share/man/man4/man4.sparc/bwtwo.4 b/share/man/man4/man4.sparc/bwtwo.4
index 03e8b3c696e..d2ecef0bfc6 100644
--- a/share/man/man4/man4.sparc/bwtwo.4
+++ b/share/man/man4/man4.sparc/bwtwo.4
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: bwtwo.4,v 1.17 2003/03/09 02:39:27 miod Exp $
+.\"	$OpenBSD: bwtwo.4,v 1.18 2003/03/10 20:11:33 miod Exp $
 .\" Copyright (c) 1992, 1993
 .\"	The Regents of the University of California.  All rights reserved.
 .\"
@@ -53,7 +53,14 @@
 .Sh DESCRIPTION
 The
 .Nm
-is a memory based black and white frame buffer for the
+is a black and white frame buffer commonly encountered
+as the on-board frame buffer on sun4 and some sun4c class workstations.
+It is also available as an SBus card for sun4c and sun4m, or as a P4 bus
+card for sun4 workstations.
+.Pp
+The
+.Nm
+driver interfaces the frame buffer with the
 .Xr wscons 4
 console framework.
 It does not provide direct device driver entry points
diff --git a/share/man/man4/man4.sparc/cgeight.4 b/share/man/man4/man4.sparc/cgeight.4
index e497eb1e514..1e0970ae62d 100644
--- a/share/man/man4/man4.sparc/cgeight.4
+++ b/share/man/man4/man4.sparc/cgeight.4
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: cgeight.4,v 1.16 2003/03/09 02:39:27 miod Exp $
+.\"	$OpenBSD: cgeight.4,v 1.17 2003/03/10 20:11:33 miod Exp $
 .\"	$NetBSD: cgeight.4,v 1.2 1997/10/08 22:00:03 jtc Exp $
 .\"
 .\" Copyright (c) 1996 The NetBSD Foundation, Inc.
@@ -48,7 +48,12 @@
 .Sh DESCRIPTION
 The
 .Nm
-is a memory based color frame buffer for the
+is a color frame buffer for the P4 bus
+of sun4 class workstations.
+.Pp
+The
+.Nm
+driver interfaces the frame buffer with the
 .Xr wscons 4
 console framework.
 It does not provide direct device driver entry points
diff --git a/share/man/man4/man4.sparc/cgfour.4 b/share/man/man4/man4.sparc/cgfour.4
index a8e7b3e2627..eab7705bf5e 100644
--- a/share/man/man4/man4.sparc/cgfour.4
+++ b/share/man/man4/man4.sparc/cgfour.4
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: cgfour.4,v 1.15 2003/03/09 02:39:27 miod Exp $
+.\"	$OpenBSD: cgfour.4,v 1.16 2003/03/10 20:11:33 miod Exp $
 .\"	$NetBSD: cgfour.4,v 1.2 1997/10/08 22:00:05 jtc Exp $
 .\"
 .\" Copyright (c) 1996 The NetBSD Foundation, Inc.
@@ -48,9 +48,18 @@
 .Sh DESCRIPTION
 The
 .Nm
-is a memory based color frame buffer with overlay plane for the
+is a color frame buffer with overlay plane for the P4 bus
+of sun4 class workstations.
+.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 agten 4 ,
 .Xr bwtwo 4 ,
diff --git a/share/man/man4/man4.sparc/cgfourteen.4 b/share/man/man4/man4.sparc/cgfourteen.4
index 814301562d5..0b5a6687b34 100644
--- a/share/man/man4/man4.sparc/cgfourteen.4
+++ b/share/man/man4/man4.sparc/cgfourteen.4
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: cgfourteen.4,v 1.21 2003/03/10 11:35:06 jmc Exp $
+.\"	$OpenBSD: cgfourteen.4,v 1.22 2003/03/10 20:11:33 miod Exp $
 .\"	$NetBSD: cgfourteen.4,v 1.3 1998/06/11 08:32:20 fair Exp $
 .\"
 .\" Copyright (c) 1996 The President and Fellows of Harvard College.
@@ -54,8 +54,19 @@
 .Sh DESCRIPTION
 The
 .Nm
-is a memory based color frame buffer, with graphics acceleration and
-overlay capabilities, for the
+is the on-board color frame buffer, with graphics acceleration and
+overlay capabilities, found on the
+SPARCstation 10SX and SPARCstation 20 workstations.
+The frame buffer will not be enabled unless a VSIMM memory module is
+installed.
+.Pp
+The second frame buffer will also require an
+.Sq Auxiliary Video Board
+to be installed.
+.Pp
+The
+.Nm
+driver interfaces the frame buffer with the
 .Xr wscons 4
 console framework.
 It does not provide direct device driver entry points
diff --git a/share/man/man4/man4.sparc/cgsix.4 b/share/man/man4/man4.sparc/cgsix.4
index 0261d4860d5..3f5edf382f8 100644
--- a/share/man/man4/man4.sparc/cgsix.4
+++ b/share/man/man4/man4.sparc/cgsix.4
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: cgsix.4,v 1.20 2003/03/09 02:39:27 miod Exp $
+.\"	$OpenBSD: cgsix.4,v 1.21 2003/03/10 20:11:33 miod Exp $
 .\"	$NetBSD: cgsix.4,v 1.4 1998/06/11 08:32:20 fair Exp $
 .\"
 .\" Copyright 1994
@@ -52,7 +52,13 @@
 .Sh DESCRIPTION
 The
 .Nm
-is a memory based color frame buffer for the
+is a color frame buffer with graphics acceleration,
+available as an SBus card for sun4c and sun4m, or as a P4 bus
+card for sun4 workstations.
+.Pp
+The
+.Nm
+driver interfaces the frame buffer with the
 .Xr wscons 4
 console framework.
 It does not provide direct device driver entry points
@@ -60,7 +66,9 @@ but makes its functions available via the internal
 .Xr wsdisplay 4
 interface.
 .Pp
-Different models exist, with various memory sizes and capabilities.
+Different
+.Nm
+frame buffer models exist, with various memory sizes and capabilities.
 The
 .Nm
 driver supports the four flavours:
diff --git a/share/man/man4/man4.sparc/cgthree.4 b/share/man/man4/man4.sparc/cgthree.4
index 35fb593e8b6..1c446f65006 100644
--- a/share/man/man4/man4.sparc/cgthree.4
+++ b/share/man/man4/man4.sparc/cgthree.4
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: cgthree.4,v 1.18 2003/03/09 02:39:27 miod Exp $
+.\"	$OpenBSD: cgthree.4,v 1.19 2003/03/10 20:11:33 miod Exp $
 .\"	$NetBSD: cgthree.4,v 1.4 1998/06/11 08:32:20 fair Exp $
 .\"
 .\" Copyright (c) 1992, 1993
@@ -52,7 +52,12 @@
 .Sh DESCRIPTION
 The
 .Nm
-is a memory based color frame buffer for the
+is a color frame buffer, available as an SBus card or on-board on some sun4c
+and sun4m workstations.
+.Pp
+The
+.Nm
+driver interfaces the frame buffer with the
 .Xr wscons 4
 console framework.
 It does not provide direct device driver entry points
diff --git a/share/man/man4/man4.sparc/cgtwelve.4 b/share/man/man4/man4.sparc/cgtwelve.4
index b5251343937..c0c6b3e62ec 100644
--- a/share/man/man4/man4.sparc/cgtwelve.4
+++ b/share/man/man4/man4.sparc/cgtwelve.4
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: cgtwelve.4,v 1.7 2003/03/09 02:39:27 miod Exp $
+.\"	$OpenBSD: cgtwelve.4,v 1.8 2003/03/10 20:11:33 miod Exp $
 .\" Copyright (c) 2002 Miodrag Vallat.  All rights reserved.
 .\"
 .\" Redistribution and use in source and binary forms, with or without
@@ -34,8 +34,12 @@
 .Sh DESCRIPTION
 The
 .Nm
-is a memory based color frame buffer, with graphics acceleration
-and overlay capabilities, for the
+is a triple-slot SBus color frame buffer, with graphics acceleration
+and overlay capabilities.
+.Pp
+The
+.Nm
+driver interfaces the frame buffer with the
 .Xr wscons 4
 console framework.
 It does not provide direct device driver entry points
diff --git a/share/man/man4/man4.sparc/cgtwo.4 b/share/man/man4/man4.sparc/cgtwo.4
index f218dd88337..a09216d3246 100644
--- a/share/man/man4/man4.sparc/cgtwo.4
+++ b/share/man/man4/man4.sparc/cgtwo.4
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: cgtwo.4,v 1.15 2003/03/09 02:39:27 miod Exp $
+.\"	$OpenBSD: cgtwo.4,v 1.16 2003/03/10 20:11:33 miod Exp $
 .\"	$NetBSD: cgtwo.4,v 1.3 1997/10/08 22:00:08 jtc Exp $
 .\"
 .\" Copyright (c) 1996 The NetBSD Foundation, Inc.
@@ -47,7 +47,11 @@
 .Sh DESCRIPTION
 The
 .Nm
-is a memory based color frame buffer for the
+is a VME color frame buffer for the sun4 class workstations.
+.Pp
+The
+.Nm
+driver interfaces the frame buffer with the
 .Xr wscons 4
 console framework.
 It does not provide direct device driver entry points
diff --git a/share/man/man4/man4.sparc/pnozz.4 b/share/man/man4/man4.sparc/pnozz.4
index f0ca2132ee0..36c12ceff20 100644
--- a/share/man/man4/man4.sparc/pnozz.4
+++ b/share/man/man4/man4.sparc/pnozz.4
@@ -1,4 +1,4 @@
-.\"     $OpenBSD: pnozz.4,v 1.12 2003/03/09 02:39:27 miod Exp $
+.\"     $OpenBSD: pnozz.4,v 1.13 2003/03/10 20:11:33 miod Exp $
 .\"
 .\" Copyright (c) 1999 Jason L. Wright (jason@thought.net)
 .\" All rights reserved.
@@ -34,16 +34,14 @@
 .Os
 .Sh NAME
 .Nm pnozz
-.Nd Tadpole Weitek p9100 frame buffer
+.Nd Tadpole Weitek P9100 frame buffer
 .Sh SYNOPSIS
 .Cd "pnozz0 at sbus? slot ? offset ?"
 .Cd "wsdisplay* at pnozz?"
 .Sh DESCRIPTION
 The
 .Nm
-is a memory based color frame buffer for the
-.Xr wscons 4
-console framework, and found on
+is a color frame buffer found on
 .Tn "Tadpole SPARCbook 3GS and 3GX"
 laptops.
 It is based on the
@@ -51,6 +49,12 @@ It is based on the
 and an
 .Tn "IBM RGB528"
 RAMDAC.
+.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
@@ -59,7 +63,7 @@ interface.
 If the
 .Xr tctrl 4
 device is also configured, the
-.Nm pnozz
+.Nm
 will be powered down when the lid of the laptop
 is closed or the screen is blanked.
 .Sh SEE ALSO
diff --git a/share/man/man4/man4.sparc/tcx.4 b/share/man/man4/man4.sparc/tcx.4
index 8da90bb827e..50cce91b986 100644
--- a/share/man/man4/man4.sparc/tcx.4
+++ b/share/man/man4/man4.sparc/tcx.4
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: tcx.4,v 1.20 2003/03/10 11:35:06 jmc Exp $
+.\"	$OpenBSD: tcx.4,v 1.21 2003/03/10 20:11:33 miod Exp $
 .\"	$NetBSD: tcx.4,v 1.3 1997/10/08 22:00:14 jtc Exp $
 .\"
 .\" Copyright (c) 1996 The NetBSD Foundation, Inc.
@@ -47,8 +47,13 @@
 .Sh DESCRIPTION
 The
 .Nm
-is a memory based color frame buffer, with graphics acceleration and
-overlay capabilities, for the
+is an 8 bit color frame buffer, with graphics acceleration,
+found on-board the SPARCstation 4, and also available in a 24 bit version
+as an AFX board for the SPARCstation 5.
+.Pp
+The
+.Nm
+driver interfaces the frame buffer with the
 .Xr wscons 4
 console framework.
 It does not provide direct device driver entry points
diff --git a/share/man/man4/man4.sparc/vigra.4 b/share/man/man4/man4.sparc/vigra.4
index 3c92b3b61b8..14ebe758b03 100644
--- a/share/man/man4/man4.sparc/vigra.4
+++ b/share/man/man4/man4.sparc/vigra.4
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: vigra.4,v 1.7 2003/03/10 11:35:06 jmc Exp $
+.\"	$OpenBSD: vigra.4,v 1.8 2003/03/10 20:11:33 miod Exp $
 .\" Copyright (c) 2002 Miodrag Vallat.  All rights reserved.
 .\"
 .\" Redistribution and use in source and binary forms, with or without
@@ -33,10 +33,13 @@
 .Cd "wsdisplay* at vigra?"
 .Sh DESCRIPTION
 The
+.Tn "Vigra VS10 and VS12"
+are 8 bit color frame buffers with user-selectable video modes, and a
+VGA-compatible connector.
+.Pp
+The
 .Nm
-driver handles the
-.Tm Vigra
-VS10 and VS12 framebuffers within the
+driver interfaces the frame buffer with the
 .Xr wscons 4
 console framework.
 It does not provide direct device driver entry points
diff --git a/share/man/man4/man4.sparc/zx.4 b/share/man/man4/man4.sparc/zx.4
index 7dff0efc9ab..bf72e368aa4 100644
--- a/share/man/man4/man4.sparc/zx.4
+++ b/share/man/man4/man4.sparc/zx.4
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: zx.4,v 1.1 2003/03/09 02:39:28 miod Exp $
+.\"	$OpenBSD: zx.4,v 1.2 2003/03/10 20:11:33 miod Exp $
 .\" Copyright (c) 2003 Miodrag Vallat.  All rights reserved.
 .\"
 .\" Redistribution and use in source and binary forms, with or without
@@ -34,15 +34,16 @@
 .Sh DESCRIPTION
 The
 .Nm
-is a memory based color frame buffer, with graphics acceleration
+is a color frame buffer, with graphics acceleration
 and overlay capabilities.
 It is also known as the
 .Tn Sun
 .Dq Leo
 graphics card.
+.Pp
 The
 .Nm
-driver interfaces the frame buffer to the
+driver interfaces the frame buffer with the
 .Xr wscons 4
 console framework.
 It does not provide direct device driver entry points