[src/trunk]: src/share/man/man9 Update documents.

[isaki <isaki%NetBSD.org@localhost>]

details:   https://anonhg.NetBSD.org/src/rev/4bd23026333d
branches:  trunk
changeset: 960736:4bd23026333d
user:      isaki <isaki%NetBSD.org@localhost>
date:      Sun Mar 28 07:42:06 2021 +0000

description:
Update documents.
- query_format has been mandatory (since at least Feb 2020).
- set_params has been replaced to set_format (since May 2019).

diffstat:

 share/man/man9/audio.9 |  12 ++++--------
 1 files changed, 4 insertions(+), 8 deletions(-)

diffs (38 lines):

diff -r e30f7b9f1bdb -r 4bd23026333d share/man/man9/audio.9
--- a/share/man/man9/audio.9    Sun Mar 28 03:29:31 2021 +0000
+++ b/share/man/man9/audio.9    Sun Mar 28 07:42:06 2021 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: audio.9,v 1.60 2021/02/06 13:55:40 nia Exp $
+.\"    $NetBSD: audio.9,v 1.61 2021/03/28 07:42:06 isaki Exp $
 .\"
 .\" Copyright (c) 1999, 2000 The NetBSD Foundation, Inc.
 .\" All rights reserved.
@@ -241,17 +241,13 @@
 and
 .Va rec
 structures contain the encoding parameters that should be set to the hardware.
-If the driver has query_format, all parameters on
-.Va play
-and/or
-.Va rec
-are chosen from formats returned by query_format.
+All of these parameters are chosen from formats returned by
+.Va query_format .
 Therefore
 .Va play
 and/or
 .Va rec
 are always settable.
-If the driver does not have query_format, the driver has to validate the format.
 If the hardware does not support
 .Dv AUDIO_ENCODING_SLINEAR_{NE,OE}:16 ,
 conversion information should be filled the
@@ -355,7 +351,7 @@
 It is called in the Attach or Closed phases.
 .It Dv int commit_settings(void *hdl)
 optional, is called after all calls to
-.Va set_params ,
+.Va set_format ,
 and
 .Va set_port ,
 are done.