Manual page for vga(4); from NetBSD.

2 files changed, 118 insertions, 2 deletions

diff --git a/share/man/man4/Makefile b/share/man/man4/Makefile
index 07746dba414..65d23545aa1 100644
--- a/share/man/man4/Makefile
+++ b/share/man/man4/Makefile
@@ -1,4 +1,4 @@
-#	$OpenBSD: Makefile,v 1.134 2000/11/10 09:39:37 niklas Exp $
+#	$OpenBSD: Makefile,v 1.135 2000/11/15 21:03:00 aaron Exp $
 
 MAN=	aac.4 ac97.4 adv.4 aha.4 ahb.4 ahc.4 aic.4 amphy.4 an.4 aria.4 ast.4 \
 	atalk.4 atapiscsi.4 audio.4 aue.4 auvia.4 awi.4 bpf.4 bridge.4 \
@@ -16,7 +16,7 @@ MAN=	aac.4 ac97.4 adv.4 aha.4 ahb.4 ahc.4 aic.4 amphy.4 an.4 aria.4 ast.4 \
 	tty.4 tun.4 twe.4 tx.4 txphy.4 \
 	uaudio.4 ubsec.4 ucom.4 udp.4 ugen.4 uhci.4 uhid.4 \
 	uk.4 ukbd.4 ukphy.4 ulpt.4 umodem.4 ums.4 umass.4 unix.4 urio.4 usb.4 \
-	uvisor.4 vlan.4 vnd.4 vr.4 \
+	uvisor.4 vga.4 vlan.4 vnd.4 vr.4 \
 	wb.4 wd.4 wdc.4 we.4 wi.4 \
 	wscons.4 wsdisplay.4 wskbd.4 wsmouse.4 wsmux.4 \
 	wx.4 xe.4 xl.4 xmphy.4 ym.4 zero.4
diff --git a/share/man/man4/vga.4 b/share/man/man4/vga.4
new file mode 100644
index 00000000000..d98543e5bb6
--- /dev/null
+++ b/share/man/man4/vga.4
@@ -0,0 +1,116 @@
+.\" $OpenBSD: vga.4,v 1.1 2000/11/15 21:03:00 aaron Exp $
+.\" $NetBSD: vga.4,v 1.2.4.1 2000/08/09 07:48:40 drochner Exp $
+.Dd March 20, 1999
+.Os
+.Dt VGA 4
+.Sh NAME
+.Nm vga
+.Nd VGA graphics driver for wscons
+.Sh SYNOPSIS
+.Cd "vga0 at isa?"
+.Cd "vga* at pci?"
+.Cd "wsdisplay* at vga? console ?"
+.Sh DESCRIPTION
+This driver handles VGA graphics hardware within the
+.Xr wscons 4
+console framework.
+It doesn't provide direct device driver entry points but makes its
+functions available via the internal
+.Xr wsdisplay 4
+interface.
+.Pp
+The
+.Nm
+driver supports multiple virtual screens on one physical display.
+The screens allocated on one display can be of different
+.Dq types ,
+where a type refers to various display properties.
+The type is determined at the time the virtual screen is created and can't
+be changed later.
+Screens are either created at kernel startup (then the default type is used)
+or later with help of the
+.Xr wsconscfg 8
+utility.
+.Pp
+Currently, the following screen types are supported:
+.Bl -hang
+.It 80x25
+This is the standard VGA text mode with 80 columns and 25 rows.
+16 different colors can be displayed at the same time.
+Characters are 8 x 16 pixels large, and a font consists of 256 characters.
+A built-in font of this size is always present on a VGA card.
+It's also possible to use a downloaded font instead.
+.It 80x25bf
+A modified version of the previous.
+It only allows 8 colors to be displayed.
+In exchange, it can access two fonts at the same time, so that 512
+different characters can be displayed.
+.It 80x40
+A text mode with 80 colums and 40 rows.
+Similar to the standard mode, 16 colors and 256 characters are available.
+Characters are 8 x 10 pixels large.
+For this mode to be useful, a font of that character size must be downloaded.
+.It 80x40bf
+A modified version of the previous.
+It only allows 8 colors to be displayed.
+In exchange, it can access two fonts at the same time, so that 512
+different characters can be displayed.
+.It 80x50
+A text mode with 80 colums and 50 rows.
+Similar to the standard mode, 16 colors and 256 characters are available.
+Characters are 8 x 8 pixels large.
+For this mode to be useful, a font of that character size must be downloaded.
+.It 80x50bf
+A modified version of the previous.
+It only allows 8 colors to be displayed.
+In exchange, it can access two fonts at the same time, so that 512
+different characters can be displayed.
+.It 80x24
+A variant of the
+.Dq 80x25
+screen type which displays 24 lines only.
+It uses the standard 8x16 VGA font.
+This mode might be useful for applications which depend on closer
+DEC VT100 compatibility.
+.It 80x24bf
+A modified version of the previous.
+It only allows 8 colors to be displayed.
+In exchange, it can access two fonts at the same time, so that 512
+different characters can be displayed.
+.El
+.Pp
+The
+.Nm
+driver can display fonts of the original IBM type and ISO-8859-1 encoded fonts.
+As an experimental feature, the
+.Dq higher half
+fonts of the former OpenBSD/i386
+.Xr pcvt 4
+driver distribution can be used too if
+.Em option WSCONS_SUPPORT_PCVTFONTS
+was set at kernel compile time.
+This is only useful with the
+.Dq *bf
+screen types; a font containing the ASCII
+range of characters must be available too on this screen.
+.Sh SEE ALSO
+.Xr isa 4 ,
+.Xr pcdisplay 4 ,
+.Xr pci 4 ,
+.Xr wscons 4 ,
+.Xr wsconscfg 8 ,
+.Xr wsfontload 8
+.Sh BUGS
+Only a subset of the possible text modes is supported.
+.Pp
+VGA cards are supposed to emulate an MDA if a monochrome display is connected.
+In this case, the device will naturally not support colors at all, but
+offer the capability to display underlined characters instead.
+The
+.Dq 80x25bf ,
+.Dq 80x40bf ,
+.Dq 80x50bf ,
+and
+.Dq 80x24bf
+screen types will not be available.
+This mode of operation is not tested.