Use english words instead of file names.
authorratchov <ratchov@openbsd.org>
Sun, 5 Aug 2018 11:41:50 +0000 (11:41 +0000)
committerratchov <ratchov@openbsd.org>
Sun, 5 Aug 2018 11:41:50 +0000 (11:41 +0000)
ok jmc

share/man/man4/audio.4

index 199ffca..8065b88 100644 (file)
@@ -1,4 +1,4 @@
-.\"    $OpenBSD: audio.4,v 1.80 2018/08/05 10:31:49 ratchov Exp $
+.\"    $OpenBSD: audio.4,v 1.81 2018/08/05 11:41:50 ratchov Exp $
 .\"    $NetBSD: audio.4,v 1.20 1998/05/28 17:27:15 augustss Exp $
 .\"
 .\" Copyright (c) 1996 The NetBSD Foundation, Inc.
@@ -76,23 +76,18 @@ This is the default.
 .El
 .Pp
 There are three types of device files available for audio operation:
-.Pa /dev/audio Ns Ar N ,
-.Pa /dev/audioctl Ns Ar N ,
-and
-.Pa /dev/mixer Ns Ar N .
+.Bl -dash -offset indent
+.It
 Audio devices are used for recording or playback of digital samples.
-Mixer devices are used to manipulate volume, recording source, or other audio mixer
-functions.
-Audio control devices accept the same
-.Xr ioctl 2
-operations as audio devices,
-but no other operations.
-In contrast to audio devices,
-which have the exclusive open property,
-audioctl devices can be opened at any time and can be used to read the
-.Nm audio
-device variables while it is in use.
-.Sh SAMPLING DEVICES
+.It
+Control devices can be used to read the
+.Nm
+driver variables while it is in use.
+.It
+Mixer devices are used to manipulate volume, recording source,
+or other audio mixer functions.
+.El
+.Sh AUDIO DEVICES
 When audio devices are opened,
 they attempt to maintain the previous audio sample format and record/playback mode.
 In addition, if one is opened read-only
@@ -288,14 +283,22 @@ was called, and the device is not attempting to start.
 If set, indicates that the device is playing and/or recording.
 .El
 .El
-.Sh MIXER DEVICE
+.Sh CONTROL DEVICES
+Audio control devices accept the same
+.Xr ioctl 2
+operations as audio devices,
+but no other operations.
+In contrast to audio devices,
+which have the exclusive open property,
+control devices can be opened at any time.
+.Sh MIXER DEVICES
 Mixer devices support the following
 .Xr ioctl 2
 commands:
 .Pp
 .Bl -tag -width Ds -compact
 .It Dv AUDIO_GETDEV Fa "audio_device_t *"
-This command is the same as described above for the sampling devices.
+This command is the same as described above for the audio devices.
 .Pp
 .It Dv AUDIO_MIXER_READ Fa "mixer_ctrl_t *"
 .It Dv AUDIO_MIXER_WRITE Fa "mixer_ctrl_t *"
@@ -486,10 +489,13 @@ mixer controls because they use a name from one of the
 .Dv AudioC*
 string values.
 .Sh FILES
-.Bl -tag -width /dev/audioctl -compact
+.Bl -tag -width /dev/audioctlN -compact
 .It Pa /dev/audio Ns Ar N
+Audio device.
 .It Pa /dev/audioctl Ns Ar N
+Control device.
 .It Pa /dev/mixer Ns Ar N
+Mixer device.
 .El
 .Sh SEE ALSO
 .Xr aucat 1 ,