Sun Jul 5 00:33:18 2020 UTC ()
BUGS: note that meaning of sustain dots differs from the standard notation.
>From FreeBSD.


(uwe)
diff -r1.26 -r1.27 src/share/man/man4/speaker.4
cvs diff -r1.26 -r1.27 src/share/man/man4/speaker.4 (expand / switch to unified diff)

--- src/share/man/man4/speaker.4 2020/07/04 23:24:10 1.26
+++ src/share/man/man4/speaker.4 2020/07/05 00:33:18 1.27
@@ -1,14 +1,14 @@ @@ -1,14 +1,14 @@
1.\" $NetBSD: speaker.4,v 1.26 2020/07/04 23:24:10 uwe Exp $ 1.\" $NetBSD: speaker.4,v 1.27 2020/07/05 00:33:18 uwe Exp $
2.\" 2.\"
3.\" Copyright (c) 2016 Nathanial Sloss <nathanialsloss@yahoo.com.au> 3.\" Copyright (c) 2016 Nathanial Sloss <nathanialsloss@yahoo.com.au>
4.\" All rights reserved. 4.\" All rights reserved.
5.\" 5.\"
6.\" Copyright (c) 1993 Christopher G. Demetriou 6.\" Copyright (c) 1993 Christopher G. Demetriou
7.\" All rights reserved. 7.\" All rights reserved.
8.\" 8.\"
9.\" Redistribution and use in source and binary forms, with or without 9.\" Redistribution and use in source and binary forms, with or without
10.\" modification, are permitted provided that the following conditions 10.\" modification, are permitted provided that the following conditions
11.\" are met: 11.\" are met:
12.\" 1. Redistributions of source code must retain the above copyright 12.\" 1. Redistributions of source code must retain the above copyright
13.\" notice, this list of conditions and the following disclaimer. 13.\" notice, this list of conditions and the following disclaimer.
14.\" 2. Redistributions in binary form must reproduce the above copyright 14.\" 2. Redistributions in binary form must reproduce the above copyright
@@ -292,16 +292,27 @@ This @@ -292,16 +292,27 @@ This
292device was originally for the pcppi PC timer interface. 292device was originally for the pcppi PC timer interface.
293Support was added for a synthesized device by Nathanial Sloss, first appearing 293Support was added for a synthesized device by Nathanial Sloss, first appearing
294in 294in
295.Nx 8.0 . 295.Nx 8.0 .
296.Sh AUTHORS 296.Sh AUTHORS
297.An Eric S. Raymond Aq Mt esr@snark.thyrsus.com 297.An Eric S. Raymond Aq Mt esr@snark.thyrsus.com
298.Sh BUGS 298.Sh BUGS
299Due to roundoff in the pitch tables and slop in the tone-generation and timer 299Due to roundoff in the pitch tables and slop in the tone-generation and timer
300hardware (neither of which was designed for precision), neither pitch accuracy 300hardware (neither of which was designed for precision), neither pitch accuracy
301nor timings will be mathematically exact. 301nor timings will be mathematically exact.
302.Pp 302.Pp
303There is no volume control. 303There is no volume control.
304.Pp 304.Pp
 305The action of two or more sustain dots does not reflect standard musical
 306notation, in which each dot adds half the value of the previous dot
 307modifier, not half the value of the note as modified.
 308Thus, a note dotted
 309once is held for 3/2 of its undotted value; dotted twice, it is held 7/4,
 310and three times would give 15/8.
 311The multiply-by-3/2 interpretation,
 312however, is specified in the
 313.Tn IBM BASIC
 314manual and has been retained for compatibility.
 315.Pp
305In play strings which are very long (longer than your system's physical I/O 316In play strings which are very long (longer than your system's physical I/O
306blocks) note suffixes or numbers may occasionally be parsed incorrectly due 317blocks) note suffixes or numbers may occasionally be parsed incorrectly due
307to crossing a block boundary. 318to crossing a block boundary.