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.

1 files changed, 46 insertions, 12 deletions

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.