[src/trunk]: src/share/man/man4 audio.4: O_NONBLOCK isn't the actual problem

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

details:   https://anonhg.NetBSD.org/src/rev/a5c57a9aabb8
branches:  trunk
changeset: 745918:a5c57a9aabb8
user:      nia <nia%NetBSD.org@localhost>
date:      Mon Mar 16 09:20:01 2020 +0000

description:
audio.4: O_NONBLOCK isn't the actual problem

diffstat:

 share/man/man4/audio.4 |  10 ++++++----
 1 files changed, 6 insertions(+), 4 deletions(-)

diffs (21 lines):

diff -r 58b8fefbde3c -r a5c57a9aabb8 share/man/man4/audio.4
--- a/share/man/man4/audio.4    Mon Mar 16 08:50:06 2020 +0000
+++ b/share/man/man4/audio.4    Mon Mar 16 09:20:01 2020 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: audio.4,v 1.96 2020/03/16 08:50:06 nia Exp $
+.\"    $NetBSD: audio.4,v 1.97 2020/03/16 09:20:01 nia Exp $
 .\"
 .\" Copyright (c) 1996 The NetBSD Foundation, Inc.
 .\" All rights reserved.
@@ -818,6 +818,8 @@
 .Xr mmap 2
 it is currently always mapped for writing (playing) due to VM system weirdness.
 .Sh CAVEATS
-The audio device cannot be reliably used with O_NONBLOCK or event notification
-mechanisms. Users are generally expected to only read and write a limited number
-of samples at a time, limiting the time spent in the system call. 
+The audio device cannot be reliably used with event notification mechanisms
+such as
+.Xr poll 2 .
+Most users are expected to only read and write a limited number of samples at
+a time, limiting the time spent in the system call.