Documentation updates for rfx(4) on sparc64.

8 files changed, 133 insertions, 8 deletions

diff --git a/share/man/man4/man4.sparc64/Makefile b/share/man/man4/man4.sparc64/Makefile
index 0803ecac39f..a48e59747b2 100644
--- a/share/man/man4/man4.sparc64/Makefile
+++ b/share/man/man4/man4.sparc64/Makefile
@@ -1,11 +1,11 @@
-#	$OpenBSD: Makefile,v 1.33 2004/06/20 18:20:51 miod Exp $
+#	$OpenBSD: Makefile,v 1.34 2004/06/20 20:53:28 miod Exp $
 
 # TODO: clock.4 timer.4
 MAN=	apio.4 asio.4 audioce.4 audiocs.4 autoconf.4 auxio.4 \
 	be.4 beeper.4 bwtwo.4 \
 	cgsix.4 cgthree.4 comkbd.4 creator.4 \
 	ebus.4 esp.4 intro.4 le.4 magma.4 mem.4 openprom.4 \
-	pcons.4 psycho.4 qe.4 qec.4 sab.4 schizo.4 spif.4 \
+	pcons.4 psycho.4 qe.4 qec.4 rfx.4 sab.4 schizo.4 spif.4 \
 	upa.4 uperf.4 vgafb.4 zs.4 zx.4
 MLINKS=	le.4 lebuffer.4 le.4 ledma.4 \
 	mem.4 kmem.4 \
diff --git a/share/man/man4/man4.sparc64/bwtwo.4 b/share/man/man4/man4.sparc64/bwtwo.4
index 9603e7b94fd..8acd9c15d89 100644
--- a/share/man/man4/man4.sparc64/bwtwo.4
+++ b/share/man/man4/man4.sparc64/bwtwo.4
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: bwtwo.4,v 1.5 2004/06/20 18:20:51 miod Exp $
+.\"	$OpenBSD: bwtwo.4,v 1.6 2004/06/20 20:53:28 miod Exp $
 .\"
 .\" Copyright (c) 2002 Jason L. Wright (jason@thought.net)
 .\" All rights reserved.
@@ -52,6 +52,7 @@ interface.
 .Xr cgthree 4 ,
 .Xr creator 4 ,
 .Xr intro 4 ,
+.Xr rfx 4 ,
 .Xr sbus 4 ,
 .Xr vgafb 4 ,
 .Xr wscons 4 ,
diff --git a/share/man/man4/man4.sparc64/cgsix.4 b/share/man/man4/man4.sparc64/cgsix.4
index 42d3f626660..7d75ef1adac 100644
--- a/share/man/man4/man4.sparc64/cgsix.4
+++ b/share/man/man4/man4.sparc64/cgsix.4
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: cgsix.4,v 1.11 2004/06/20 18:20:51 miod Exp $
+.\"	$OpenBSD: cgsix.4,v 1.12 2004/06/20 20:53:28 miod Exp $
 .\"
 .\" Copyright (c) 2001 Jason L. Wright (jason@thought.net)
 .\" All rights reserved.
@@ -146,6 +146,7 @@ on the GX+.
 .Xr cgthree 4 ,
 .Xr creator 4 ,
 .Xr intro 4 ,
+.Xr rfx 4 ,
 .Xr sbus 4 ,
 .Xr vgafb 4 ,
 .Xr wscons 4 ,
diff --git a/share/man/man4/man4.sparc64/cgthree.4 b/share/man/man4/man4.sparc64/cgthree.4
index 272b404479d..7a39f3cab13 100644
--- a/share/man/man4/man4.sparc64/cgthree.4
+++ b/share/man/man4/man4.sparc64/cgthree.4
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: cgthree.4,v 1.11 2004/06/20 18:20:51 miod Exp $
+.\"	$OpenBSD: cgthree.4,v 1.12 2004/06/20 20:53:28 miod Exp $
 .\"
 .\" Copyright (c) 2001 Jason L. Wright (jason@thought.net)
 .\" All rights reserved.
@@ -94,6 +94,7 @@ Note that not all models support settings other than their default setting.
 .Xr cgsix 4 ,
 .Xr creator 4 ,
 .Xr intro 4 ,
+.Xr rfx 4 ,
 .Xr sbus 4 ,
 .Xr vgafb 4 ,
 .Xr wscons 4 ,
diff --git a/share/man/man4/man4.sparc64/creator.4 b/share/man/man4/man4.sparc64/creator.4
index 1888f295c4e..802b846109e 100644
--- a/share/man/man4/man4.sparc64/creator.4
+++ b/share/man/man4/man4.sparc64/creator.4
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: creator.4,v 1.15 2004/06/20 18:20:51 miod Exp $
+.\"	$OpenBSD: creator.4,v 1.16 2004/06/20 20:53:28 miod Exp $
 .\"
 .\" Copyright (c) 2002 Jason L. Wright (jason@thought.net)
 .\" All rights reserved.
@@ -65,6 +65,7 @@ this acceleration can be disabled.
 .Xr cgsix 4 ,
 .Xr cgthree 4 ,
 .Xr intro 4 ,
+.Xr rfx 4 ,
 .Xr upa 4 ,
 .Xr vgafb 4 ,
 .Xr wscons 4 ,
diff --git a/share/man/man4/man4.sparc64/rfx.4 b/share/man/man4/man4.sparc64/rfx.4
new file mode 100644
index 00000000000..2c6e9c5dca2
--- /dev/null
+++ b/share/man/man4/man4.sparc64/rfx.4
@@ -0,0 +1,119 @@
+.\"	$OpenBSD: rfx.4,v 1.1 2004/06/20 20:53:28 miod Exp $
+.\"
+.\" Copyright (c) 2004, Miodrag Vallat.
+.\" 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 June 20, 2004
+.Dt RFX 4 sparc64
+.Os
+.Sh NAME
+.Nm rfx
+.Nd Vitec/Connectware/AP&D
+.Tn RasterFlex
+framebuffer series
+.Sh SYNOPSIS
+.Cd "rfx* at sbus? slot ? offset ?"
+.Cd "wsdisplay* at rfx?"
+.Sh DESCRIPTION
+The
+.Tn RasterFlex
+series, originally manufactured by Vitec, later bought by Connectware,
+then by Advanced Products & Design, are high-performance frame buffers
+and frame grabber devices.
+.Pp
+The
+.Nm
+driver only supports the
+.Tn RasterFlex
+frame buffers:
+.Bl -tag -width RasterFLEX-HR -offset indent -compact
+.It RasterFlex-24
+.It RasterFlex-32
+.It RasterFlex-HR
+.El
+.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 DISPLAY RESOLUTION
+The
+.Tn RasterFlex
+frame buffers will adapt their resolution to the monitor they are
+connected to.
+However, when not connected to a
+.Tn Sun
+monitor, the device will default to the 1152x900 resolution, with a refresh
+rate of 66Hz.
+A different resolution can be forced using the jumpers J2 to J4, located
+near the video connector on the board itself.
+.Pp
+In the following tables, left
+.Pq L
+and right
+.Pq R
+Jumper positions are described looking at the board with the video connector
+on top.
+If the jumper position is not specified, it means it has to be removed
+.Pq open .
+.Ss RasterFlex-24 and RasterFlex-32 Jumper Settings:
+.Bl -column "Jumpers" "Resolution" "Refresh"
+.It Li "J2 J3 J4" Ta Resolution Ta Refresh Ta Description
+.It " "
+.It Li " R  R  R" Ta 1152x900 Ta 66Hz Ta "Automatic Configuration"
+.It Li "L  L  L " Ta 1024x768 Ta 76Hz Ta "SVGA"
+.It Li "L       " Ta 1152x900 Ta 66Hz
+.It Li "   L  L " Ta 1152x900 Ta 76Hz
+.El
+.Ss RasterFlex-HR Jumper Settings:
+.Bl -column "Jumpers" "Resolution" "Refresh"
+.It Li "J2 J3 J4" Ta Resolution Ta Refresh Ta Description
+.It " "
+.It Li " R  R  R" Ta 1152x900 Ta 66Hz Ta "Automatic Configuration"
+.It Li "L  L  L " Ta 1024x768 Ta 76Hz Ta "SVGA"
+.It Li "L       " Ta 1152x900 Ta 66Hz
+.It Li "L  L    " Ta 1152x900 Ta 76Hz
+.It Li "   L    " Ta 1280x1024 Ta 60Hz
+.It Li "   L  L " Ta 1280x1024 Ta 67Hz
+.It Li "L     L " Ta 1280x1024 Ta 76Hz
+.El
+.Sh SEE ALSO
+.Xr bwtwo 4 ,
+.Xr cgsix 4 ,
+.Xr cgthree 4 ,
+.Xr creator 4 ,
+.Xr intro 4 ,
+.Xr sbus 4 ,
+.Xr vgafb 4 ,
+.Xr wscons 4 ,
+.Xr wsdisplay 4 ,
+.Xr zx 4
+.Sh CAVEATS
+This driver does not support any acceleration features at the moment, and
+drives the card in PROM-compatible, 8 bit, mode only.
diff --git a/share/man/man4/man4.sparc64/vgafb.4 b/share/man/man4/man4.sparc64/vgafb.4
index ddb6e7f5cb7..73041fe5e1d 100644
--- a/share/man/man4/man4.sparc64/vgafb.4
+++ b/share/man/man4/man4.sparc64/vgafb.4
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: vgafb.4,v 1.6 2004/06/20 18:20:51 miod Exp $
+.\"	$OpenBSD: vgafb.4,v 1.7 2004/06/20 20:53:28 miod Exp $
 .\"
 .\" Copyright (c) 2002 Jason L. Wright (jason@thought.net)
 .\" All rights reserved.
@@ -53,6 +53,7 @@ accelerated access methods are provided to
 .Xr creator 4 ,
 .Xr intro 4 ,
 .Xr pci 4 ,
+.Xr rfx 4 ,
 .Xr wscons 4 ,
 .Xr wsdisplay 4 ,
 .Xr zx 4
diff --git a/share/man/man4/man4.sparc64/zx.4 b/share/man/man4/man4.sparc64/zx.4
index 7017c8dea94..e7673d56819 100644
--- a/share/man/man4/man4.sparc64/zx.4
+++ b/share/man/man4/man4.sparc64/zx.4
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: zx.4,v 1.1 2004/06/20 18:20:51 miod Exp $
+.\"	$OpenBSD: zx.4,v 1.2 2004/06/20 20:53:28 miod Exp $
 .\" Copyright (c) 2003 Miodrag Vallat.  All rights reserved.
 .\"
 .\" Redistribution and use in source and binary forms, with or without
@@ -95,6 +95,7 @@ The selected resolutions are:
 .Xr cgthree 4 ,
 .Xr creator 4 ,
 .Xr intro 4 ,
+.Xr rfx 4 ,
 .Xr sbus 4 ,
 .Xr vgafb 4 ,
 .Xr wscons 4 ,