Doc: NR added @knownissue for beam properties

Used Carl S's wording from comment #3 of Tracker 1566

Also collated to separate @warnings together as they looked odd in the doc
as two separate 'note' boxes one after the other.

diff --git a/Documentation/notation/rhythms.itely b/Documentation/notation/rhythms.itely
index c26305c9d94d6de8a3c443d94eb7920654154871..a3707bf42a4d84ff2e53e770e189effd490e9353 100644 (file)
--- a/Documentation/notation/rhythms.itely
+++ b/Documentation/notation/rhythms.itely
@@ -1908,10 +1908,9 @@ c16 c8
 
 @warning{If beams are used to indicate melismata in songs, then
 automatic beaming should be switched off with @code{\autoBeamOff}
-and the beams indicated manually.}
-
-@warning{Using @code{@bs{}partcombine} with @code{@bs{}autoBeamOff} can
-produce unintended results.  See the snippet below for more information.}
+and the beams indicated manually.  Using @code{@bs{}partcombine} with
+@code{@bs{}autoBeamOff} can produce unintended results.  See the
+snippets for more information.}
 
 Beaming patterns that differ from the automatic defaults can be
 created; see @ref{Setting automatic beam behavior}.
@@ -1960,6 +1959,13 @@ Internals Reference:
 @rinternals{beam-interface},
 @rinternals{unbreakable-spanner-interface}.
 
+@knownissues
+The properties of a beam are determined at the @emph{start} of its
+construction and any additional beam-property changes that occur before
+the beam has been completed will not take effect until the @emph{next},
+new beam starts.
+
+
 @node Setting automatic beam behavior
 @unnumberedsubsubsec Setting automatic beam behavior