[src/trunk]: src/share/man/man4 BUGS: note that meaning of sustain dots diffe...

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

details:   https://anonhg.NetBSD.org/src/rev/38f2e06e088e
branches:  trunk
changeset: 973593:38f2e06e088e
user:      uwe <uwe%NetBSD.org@localhost>
date:      Sun Jul 05 00:33:18 2020 +0000

description:
BUGS: note that meaning of sustain dots differs from the standard notation.
>From FreeBSD.

diffstat:

 share/man/man4/speaker.4 |  13 ++++++++++++-
 1 files changed, 12 insertions(+), 1 deletions(-)

diffs (27 lines):

diff -r 3f44fc7619b6 -r 38f2e06e088e share/man/man4/speaker.4
--- a/share/man/man4/speaker.4  Sat Jul 04 23:30:31 2020 +0000
+++ b/share/man/man4/speaker.4  Sun Jul 05 00:33:18 2020 +0000
@@ -1,4 +1,4 @@
-.\" $NetBSD: speaker.4,v 1.26 2020/07/04 23:24:10 uwe Exp $
+.\" $NetBSD: speaker.4,v 1.27 2020/07/05 00:33:18 uwe Exp $
 .\"
 .\" Copyright (c) 2016 Nathanial Sloss <nathanialsloss%yahoo.com.au@localhost>
 .\" All rights reserved.
@@ -302,6 +302,17 @@
 .Pp
 There is no volume control.
 .Pp
+The action of two or more sustain dots does not reflect standard musical
+notation, in which each dot adds half the value of the previous dot
+modifier, not half the value of the note as modified.
+Thus, a note dotted
+once is held for 3/2 of its undotted value; dotted twice, it is held 7/4,
+and three times would give 15/8.
+The multiply-by-3/2 interpretation,
+however, is specified in the
+.Tn IBM BASIC
+manual and has been retained for compatibility.
+.Pp
 In play strings which are very long (longer than your system's physical I/O
 blocks) note suffixes or numbers may occasionally be parsed incorrectly due
 to crossing a block boundary.