=================================================================== RCS file: /cvsrepo/anoncvs/cvs/src/usr.bin/mixerctl/mixerctl.8,v retrieving revision 1.2 retrieving revision 1.3 diff -u -r1.2 -r1.3 --- src/usr.bin/mixerctl/mixerctl.8 2020/04/22 05:37:00 1.2 +++ src/usr.bin/mixerctl/mixerctl.8 2020/04/22 08:25:27 1.3 @@ -1,4 +1,4 @@ -.\" $OpenBSD: mixerctl.8,v 1.2 2020/04/22 05:37:00 jmc Exp $ +.\" $OpenBSD: mixerctl.8,v 1.3 2020/04/22 08:25:27 ratchov Exp $ .\" $NetBSD: mixerctl.1,v 1.8 1998/05/09 12:41:16 augustss Exp $ .\" .\" Copyright (c) 1997 The NetBSD Foundation, Inc. @@ -32,7 +32,7 @@ .Os .Sh NAME .Nm mixerctl -.Nd control audio mixing +.Nd manipulate audio hardware controls .Sh SYNOPSIS .Nm mixerctl .Op Fl anv @@ -52,7 +52,7 @@ .Sh DESCRIPTION The .Nm -command displays or sets various audio system mixing variables. +command displays or sets various audio device variables. If a list of variables is present on the command line, .Nm prints the current value of those variables for the specified device. @@ -66,7 +66,7 @@ This is the default, if no parameters are given to .Nm . .It Fl f Ar file -Specify an alternative audio mixing device. +Specify an alternative audio control device. The default is .Pa /dev/audioctl0 . .It Fl n @@ -93,7 +93,7 @@ .El .Pp The exact set of controls that can be manipulated depends on -the mixer. +the device. The general format (in both getting and setting a value) is: .Pp .D1 class.name=value @@ -105,17 +105,17 @@ or .Dq outputs , indicating that the control affects the input or output, respectively, -to the mixer. +to the device. The .Ar name -indicates what part of the mixer the control affects. -Continuous mixer values, e.g. volume, +indicates what part of the device the control affects. +Continuous values, e.g. volume, have numeric values in the range 0\-255. If .Ar value can be set for each channel independently, the values are printed separated by commas. -Discrete mixer values, e.g. the recording source, +Discrete values, e.g. the recording source, have symbolic names. .Pp Variables may take one of three types, @@ -149,18 +149,18 @@ .Sh ENVIRONMENT .Bl -tag -width "MIXERDEVICEXXX" .It Ev MIXERDEVICE -The audio mixer device to use. +The audio control device to use. .El .Sh FILES .Bl -tag -width "/etc/mixerctl.confXXX" -compact .It Pa /dev/audioctl0 -Default mixer audio device. +Default audio control device. .It Pa /etc/mixerctl.conf .Nm configuration file. .El .Sh EXAMPLES -Show possible values for all mixer variables, +Show possible values for all device variables, and their current settings: .Bd -literal -offset indent $ mixerctl -av