From 3fb9a2e064d11cb895c998b4dab862e3867f32f6 Mon Sep 17 00:00:00 2001
From: Miod Vallat <miod@cvs.openbsd.org>
Date: Sun, 25 Dec 2011 00:07:28 +0000
Subject: Fix the documented CAVEAT by forcing the TX gain to minus infinity
 when the user asks to only keep the input source enabled, and remember this
 to keep reporting the previously configured volume values in mixerctl. While
 there, document the supported encodings and the supported mixer items in the
 manual page, and the fact that all output sources share the same volume (GX
 gain) setting.

---
 share/man/man4/arcofi.4 | 58 +++++++++++++++++++++++++++++++++++++++----------
 1 file changed, 46 insertions(+), 12 deletions(-)

(limited to 'share')

diff --git a/share/man/man4/arcofi.4 b/share/man/man4/arcofi.4
index 56dabadf511..397f3fdfae7 100644
--- a/share/man/man4/arcofi.4
+++ b/share/man/man4/arcofi.4
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: arcofi.4,v 1.2 2011/12/23 09:12:33 jmc Exp $
+.\"	$OpenBSD: arcofi.4,v 1.3 2011/12/25 00:07:27 miod Exp $
 .\"
 .\"
 .\" Copyright (c) 2011 Miodrag Vallat.
@@ -15,7 +15,7 @@
 .\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
 .\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
 .\"
-.Dd $Mdocdate: December 23 2011 $
+.Dd $Mdocdate: December 25 2011 $
 .Dt ARCOFI 4
 .Os
 .Sh NAME
@@ -39,8 +39,51 @@ This device is found onboard HP 9000 workstations models 425e, 705 and 710.
 .Pp
 The
 .Nm
-is limited to a phone-quality mono, 8-bit, 8000 KHz sound.
+is limited to a phone-quality mono, 8000 KHz sound.
+.Ss AUDIOCTL SETTINGS
+The following encodings are supported:
+.Bl -tag -width AUDIO_ENCODING_SLINEAR_BE, -compact
+.It Li AUDIO_ENCODING_ULAW,
+.It Li AUDIO_ENCODING_ALAW,
+.It Li AUDIO_ENCODING_SLINEAR_BE
+Natively supported.
+.It Li AUDIO_ENCODING_SLINEAR
+Software converted to
+.Li AUDIO_ENCODING_ULAW
+encoding.
+.It Li AUDIO_ENCODING_SLINEAR_LE,
+.It Li AUDIO_ENCODING_ULINEAR_LE,
+.It Li AUDIO_ENCODING_ULINEAR_BE
+Software converted to
+.Li AUDIO_ENCODING_SLINEAR_BE
+encoding.
+.El
+.Ss MIXERCTL SETTINGS
+The
+.Nm
+has three audio ports:
+.Bl -tag -compact
+.It Cm inputs.line
+The
+.Sq line in
+jack connector.
+.It Cm outputs.line
+The
+.Sq line out
+jack connector.
+.It Cm outputs.spkr
+The built-in speaker.
+.El
+Each port has a volume control, and can be muted.
+.Pp
+The
+.Cm outputs.line
+and
+.Cm outputs.spkr
+volume settings are tied to the same hardware setting.
 .Sh SEE ALSO
+.Xr audioctl 1 ,
+.Xr mixerctl 1 ,
 .Xr ioctl 2 ,
 .Xr audio 4 ,
 .Xr dio 4 ,
@@ -52,12 +95,3 @@ support for
 .Nm
 first appeared in
 .Ox 5.1 .
-.Sh CAVEATS
-Due to the
-.Dq ARCOFI
-chip being designed for phones, it is not possible to unmute the
-.Sq line in
-channel while muting
-.Em all
-output channels.
-Attempting to do this will cause all channels (input and output) to be unmuted.
-- 
cgit v1.2.3