document the ESS Allegro-1 and Maestro-3 driver

6 files changed, 75 insertions, 7 deletions

diff --git a/share/man/man4/Makefile b/share/man/man4/Makefile
index 0bc2adbf74a..b3e0ead00ae 100644
--- a/share/man/man4/Makefile
+++ b/share/man/man4/Makefile
@@ -1,4 +1,4 @@
-#	$OpenBSD: Makefile,v 1.199 2002/04/03 23:02:00 mickey Exp $
+#	$OpenBSD: Makefile,v 1.200 2002/04/08 01:51:25 frantzen Exp $
 
 MAN=	aac.4 ac97.4 addcom.4 adv.4 aha.4 ahb.4 ahc.4 aic.4 ami.4 amphy.4 \
 	an.4 aria.4 ast.4 atalk.4 atapiscsi.4 \
@@ -7,7 +7,7 @@ MAN=	aac.4 ac97.4 addcom.4 adv.4 aha.4 ahb.4 ahc.4 aic.4 ami.4 amphy.4 \
 	ch.4 clnp.4 clcs.4 clct.4 cltp.4 \
 	cmpci.4 cnw.4 com.4 crypto.4 \
 	cue.4 cy.4 cz.4 dc.4 ddb.4 de.4 dpt.4 drum.4 eap.4 ec.4 \
-	eephy.4 ef.4 eg.4 eisa.4 el.4 emu.4 enc.4 ep.4 esis.4 \
+	eephy.4 ef.4 eg.4 eisa.4 el.4 emu.4 enc.4 ep.4 esa.4 esis.4 \
 	eso.4 ess.4 exphy.4 fd.4 fdc.4 fpa.4 \
 	fms.4 fxp.4 gdt.4 gre.4 gx.4 hifn.4 hsq.4 icmp.4 icsphy.4 \
 	idp.4 iha.4 ifmedia.4 \
diff --git a/share/man/man4/audio.4 b/share/man/man4/audio.4
index ac8980ce98d..97428ab499d 100644
--- a/share/man/man4/audio.4
+++ b/share/man/man4/audio.4
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: audio.4,v 1.23 2002/02/12 18:03:44 mpech Exp $
+.\"	$OpenBSD: audio.4,v 1.24 2002/04/08 01:51:25 frantzen Exp $
 .\"	$NetBSD: audio.4,v 1.20 1998/05/28 17:27:15 augustss Exp $
 .\"
 .\" Copyright (c) 1996 The NetBSD Foundation, Inc.
@@ -651,6 +651,7 @@ For ports using the PCI bus:
 .Xr cmpci 4 ,
 .Xr eap 4 ,
 .Xr emu 4 ,
+.Xr esa 4 ,
 .Xr eso 4 ,
 .Xr maestro 4 ,
 .Xr neo 4 ,
diff --git a/share/man/man4/esa.4 b/share/man/man4/esa.4
new file mode 100644
index 00000000000..77876d9126b
--- /dev/null
+++ b/share/man/man4/esa.4
@@ -0,0 +1,59 @@
+.\"	$OpenBSD: esa.4,v 1.1 2002/04/08 01:51:25 frantzen Exp $
+.\"	$NetBSD: esa.4,v 1.4 2002/01/24 22:24:19 he Exp $
+.\"
+.\" Copyright (c) 2001, 2002 Jared D. McNeill <jmcneill@invisible.yi.org>
+.\" 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. Neither the name of the author nor the names of any
+.\"    contributors may be used to endorse or promote products derived
+.\"    from this software without specific prior written permission.
+.\"
+.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS
+.\" ``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 FOUNDATION OR CONTRIBUTORS
+.\" 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 April 7, 2002
+.Dt ESA 4
+.Os
+.Sh NAME
+.Nm esa
+.Nd ESS Technology Allegro-1 / Maestro-3 family audio device driver
+.Sh SYNOPSIS
+.Cd "esa*   at pci? dev ? function ?"
+.Cd "audio* at esa?"
+.Sh DESCRIPTION
+The
+.Nm
+driver provides support for the ESS Allegro-1 and Maestro-3 audio devices
+on the PCI bus. These devices are popular in laptop systems.
+.Pp
+The Allegro-1 and the Maestro-3 are full-duplex devices that allow
+independent playback and recording at sample rates between 8000Hz and
+48000Hz and are capable of playback at 8 and 16 bit in mono and stereo.
+.Sh SEE ALSO
+.Xr ac97 4 ,
+.Xr audio 4 ,
+.Xr maestro 4 ,
+.Xr pci 4
+.Sh HISTORY
+The
+.Nm
+device driver appeared in NetBSD 1.5.3 And was ported for
+.Ox 3.1 .
+.Sh AUTHORS
+.An Jared D. McNeill Aq jmcneill@invisible.yi.org
+.Sh BUGS
+Hardware volume control is not yet supported by this driver.
diff --git a/share/man/man4/maestro.4 b/share/man/man4/maestro.4
index e2e4e82739c..0bb1043ea65 100644
--- a/share/man/man4/maestro.4
+++ b/share/man/man4/maestro.4
@@ -1,4 +1,4 @@
-.\"   $OpenBSD: maestro.4,v 1.8 2001/12/05 10:00:18 deraadt Exp $
+.\"   $OpenBSD: maestro.4,v 1.9 2002/04/08 01:51:25 frantzen Exp $
 .\"
 .\" Copyright (c) 2001 Marc Espie.
 .\" All rights reserved.
@@ -39,7 +39,10 @@ driver supports ESS maestro 1, 2 and 2E, including OEM products that
 identify as NEC Versa, or NEC VersaProNX VA26D, as long as they use
 an AC97 compliant codec, which is always the case, except for very
 early models. 
-It does not support maestro 3 cards, which are entirely different.
+It does not support maestro 3 cards, which are entirely different and
+supported by the
+.Xr esa 4
+driver.
 .Pp
 Maestro cards have direct support for 16 bit signed little-endian
 mono and stereo, 8 bit signed and unsigned mono and stereo.
@@ -61,6 +64,7 @@ David Leonard and Marc Espie.
 .Sh SEE ALSO
 .Xr ac97 4 ,
 .Xr audio 4 ,
+.Xr esa 4 ,
 .Xr pci 4
 .Sh BUGS
 Very old cards with a PT101 mixer component should have partial support, e.g.,
diff --git a/share/man/man4/man4.i386/intro.4 b/share/man/man4/man4.i386/intro.4
index 22e8046341d..7ad45c46ae3 100644
--- a/share/man/man4/man4.i386/intro.4
+++ b/share/man/man4/man4.i386/intro.4
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: intro.4,v 1.32 2002/04/02 18:08:04 nate Exp $
+.\"	$OpenBSD: intro.4,v 1.33 2002/04/08 01:51:25 frantzen Exp $
 .\"
 .\" Copyright (c) 1994 Christopher G. Demetriou
 .\" All rights reserved.
@@ -178,6 +178,8 @@ Ensoniq AudioPCI (ES137x) audio.
 Creative Labs SBLive! and PCI 512 audio.
 .It Xr ep 4
 3Com Etherlink III Ethernet (3C5x9, 3C59x).
+.It Xr esa 4
+ESS Alegro 1 and Maestro 3 audio.
 .It Xr eso 4
 ESS Technology Solo-1 PCI AudioDrive (ES1938/ES1946) audio.
 .It Xr ess 4
diff --git a/share/man/man4/pci.4 b/share/man/man4/pci.4
index 9984adba6b0..0caf97c342c 100644
--- a/share/man/man4/pci.4
+++ b/share/man/man4/pci.4
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: pci.4,v 1.60 2002/04/02 13:37:04 nate Exp $
+.\"	$OpenBSD: pci.4,v 1.61 2002/04/08 01:51:25 frantzen Exp $
 .\"	$NetBSD: pci.4,v 1.29 2000/04/01 00:32:23 tsarna Exp $
 .\"
 .\" Copyright (c) 2000 Theo de Raadt.  All rights reserved.
@@ -280,6 +280,8 @@ C-Media CMI8x38 sound devices.
 Ensoniq AudioPCI sound devices.
 .It Xr emu 4
 Creative Labs SBLive! and PCI 512 audio device driver.
+.It Xr esa 4
+ESS Alegro 1 and Maestro 3 sound devices.
 .It Xr eso 4
 ESS Solo-1 PCI AudioDrive sound devices.
 .It Xr fms 4