A short documentation on what frame buffer resolutions are available,

how to change them, and a link to the Sun Frame Buffer FAQ.
Contents partially borrowed from the aforementioned FAQ.

a few tweaks and ok deraadt@

2 files changed, 133 insertions, 4 deletions

diff --git a/share/man/man4/man4.sparc64/cgsix.4 b/share/man/man4/man4.sparc64/cgsix.4
index fcbc96b3c34..b2d1e29ddb8 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.6 2002/10/01 21:03:27 miod Exp $
+.\"	$OpenBSD: cgsix.4,v 1.7 2003/01/05 02:18:33 miod Exp $
 .\"
 .\" Copyright (c) 2001 Jason L. Wright (jason@thought.net)
 .\" All rights reserved.
@@ -29,7 +29,7 @@
 .\" ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
 .\" POSSIBILITY OF SUCH DAMAGE.
 .\"
-.Dd December 4, 2001
+.Dd January 5, 2003
 .Dt CGSIX 4 sparc64
 .Os
 .Sh NAME
@@ -49,6 +49,21 @@ but makes its functions available via the internal
 .Xr wsdisplay 4
 interface.
 .Pp
+Different models exist, with various memory sizes and capabilities.
+The
+.Nm
+driver supports the four flavours:
+.Bl -item -offset indent -compact
+.It
+GX
+.It
+GX+
+.It
+Turbo GX (or TGX)
+.It
+Turbo GX+ (or TGX+)
+.El
+.Pp
 By default hardware acceleration is used to erase the screen and
 scroll text.
 By setting
@@ -60,6 +75,70 @@ to
 or
 .Xr boot_config 8 )
 this acceleration can be disabled.
+.Sh DISPLAY RESOLUTION
+If the
+.Nm
+frame buffer is used as the console display, a different resolution than the
+default 1152x900 can be selected by changing the OpenPROM environment.
+To change the default resolution, type the following:
+.Pp
+.Em \   ok
+setenv
+.Ev Em output-device
+screen:r1280x1024x76
+.Pp
+to change to a 76Hz 1280x1024 resolution.
+.Pp
+If the
+.Nm
+frame buffer is a secondary display, or a serial console is used, the
+display resolution can not be changed without using an
+.Ev Em nvramrc
+OpenPROM script.
+Refer to the
+.Em Sun Frame Buffer FAQ
+for details.
+.Pp
+The
+.Nm
+frame buffer accepts the following resolutions:
+.Pp
+.Bl -tag -width screen:r1280x1024x76 -compact
+.It screen:r1024x768x60
+Super VGA 1024x768, with a refresh rate of 60Hz.
+Only available on TGX and TGX+.
+.It screen:r1024x768x70
+Super VGA 1024x768, with a refresh rate of 70Hz.
+Only available on TGX and TGX+.
+.It screen:r1024x768x76
+Super VGA 1024x768, with a refresh rate of 76Hz.
+Only available on TGX and TGX+.
+.It screen:r1024x800x74
+1024x800, with a refresh rate of 74Hz.
+Only available on TGX and TGX+.
+.It screen:r1024x800x85
+1024x800, with a refresh rate of 85Hz.
+Only available on GX+, TGX and TGX+.
+.It screen:r1152x900x66
+Standard 1152x900, with a refresh rate of 66Hz.
+.It screen:r1152x900x76
+Standard 1152x900, with a refresh rate of 76Hz.
+This is the default setting on GX and TGX.
+.It screen:r1280x1024x67
+High res 1280x1024, with a refresh rate of 67Hz.
+Only available on GX+ and TGX+.
+This is the default on GX+.
+.It screen:r1280x1024x76
+High res 1280x1024, with a refresh rate of 76Hz.
+Only available on TGX+, where this is the default setting.
+.It screen:r1600x1280x76
+High res 1600x1280, with a refresh rate of 76Hz.
+Only available on GX+ and TGX+.
+.El
+.Pp
+The 1600x1280 resolution is not officially supported by
+.Tn Sun
+on the GX+.
 .Sh SEE ALSO
 .Xr bwtwo 4 ,
 .Xr cgthree 4 ,
@@ -71,3 +150,7 @@ this acceleration can be disabled.
 .Xr wsdisplay 4 ,
 .Xr boot_config 8 ,
 .Xr config 8
+.Rs
+.%T Sun Frame Buffer FAQ
+.%O http://www.sunhelp.org/faq/FrameBuffer.html
+.Re
diff --git a/share/man/man4/man4.sparc64/cgthree.4 b/share/man/man4/man4.sparc64/cgthree.4
index 11ea8836f57..0617ba99443 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.5 2002/10/01 21:03:27 miod Exp $
+.\"	$OpenBSD: cgthree.4,v 1.6 2003/01/05 02:18:33 miod Exp $
 .\"
 .\" Copyright (c) 2001 Jason L. Wright (jason@thought.net)
 .\" All rights reserved.
@@ -29,7 +29,7 @@
 .\" ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
 .\" POSSIBILITY OF SUCH DAMAGE.
 .\"
-.Dd December 4, 2001
+.Dd January 5, 2003
 .Dt CGTHREE 4 sparc64
 .Os
 .Sh NAME
@@ -48,6 +48,48 @@ It does not provide direct device driver entry points
 but makes its functions available via the internal
 .Xr wsdisplay 4
 interface.
+.Sh DISPLAY RESOLUTION
+If the
+.Nm
+frame buffer is used as the console display, it is possible, for some models,
+to select a different resolution than the default 1152x900 or 1024x768
+by changing the OpenPROM environment.
+To change the default resolution, type the following:
+.Pp
+.Em \   ok
+setenv
+.Ev Em output-device
+screen:r1152x1024x66
+.Pp
+to change to a 66Hz 1280x1024 resolution.
+.Pp
+If the
+.Nm
+frame buffer is a secondary display, or a serial console is used, the
+display resolution can not be changed without using an
+.Ev Em nvramrc
+OpenPROM script.
+Refer to the
+.Em Sun Frame Buffer FAQ
+for details.
+.Pp
+The
+.Nm
+frame buffer accepts the following resolutions:
+.Pp
+.Bl -tag -width screen:r1280x1024x76 -compact
+.It screen:r1024x768x77
+Super VGA 1024x768, with a refresh rate of 77Hz.
+This is the default setting on model 501-2691.
+.It screen:r1152x900x66
+Standard 1152x900, with a refresh rate of 66Hz.
+This is the default setting on older models (501-1415 and 501-8044).
+.It screen:r1152x900x76
+Standard 1152x900, with a refresh rate of 76Hz.
+This is the default setting on more recent models (501-1718 and 501-1909).
+.El
+.Pp
+Note that not all models support settings other than their default setting.
 .Sh SEE ALSO
 .Xr bwtwo 4 ,
 .Xr cgsix 4 ,
@@ -57,3 +99,7 @@ interface.
 .Xr vgafb 4 ,
 .Xr wscons 4 ,
 .Xr wsdisplay 4
+.Rs
+.%T Sun Frame Buffer FAQ
+.%O http://www.sunhelp.org/faq/FrameBuffer.html
+.Re