From: David Kastrup <dak@gnu.org>
Date: Sat, 4 Jan 2014 16:22:33 +0000 (+0100)
Subject: Issue 3773: Add Changes entries for bare rhythms and \beamExceptions
X-Git-Tag: release/2.19.0-1~5
X-Git-Url: https://git.donarmstrong.com/?a=commitdiff_plain;h=47e5b060d454d4d125039de2d46a9414a30514ac;p=lilypond.git

Issue 3773: Add Changes entries for bare rhythms and \beamExceptions
---

diff --git a/Documentation/changes.tely b/Documentation/changes.tely
index 5697aa69cb..79e0385b8f 100644
--- a/Documentation/changes.tely
+++ b/Documentation/changes.tely
@@ -60,6 +60,52 @@ which scares away people.
 * only show user-visible changes.
 
 @end ignore
+@item
+Isolated durations in music sequences now stand for unpitched
+notes.  This may be useful for specifying rhythms to music or
+scheme functions.  When encountered in the final score, the
+pitches are provided by the preceding note or chord.  Here are two
+examples where this makes for readable input:
+
+@lilypond[verbatim,quote]
+\new DrumStaff \with { \override StaffSymbol.line-count = 1 }
+\drummode {
+  \time 3/4
+  tambourine 8 \tuplet 3/2 { 16 16 16 }
+             8 \tuplet 3/2 { 16 16 16 } 8 8 |
+}
+@end lilypond
+
+@lilypond[verbatim,quote]
+\new Staff { r16 c'16 ~ 8 ~ 4 ~ 2 | }
+@end lilypond
+
+@item
+Beaming exceptions can now be constructed using the
+@code{\beamExceptions} scheme function.  One can now write
+
+@lilypond[verbatim,quote,relative=1]
+\time #'(2 1) 3/16
+\set Timing.beamExceptions =
+  \beamExceptions { 32[ 32] 32[ 32] 32[ 32] }
+c16 c c |
+\repeat unfold 6 { c32 } |
+@end lilypond
+
+@noindent
+with multiple exceptions separated with @code{|} bar checks
+(writing the exception pattern without pitches is convenient but
+not mandatory).  Previously, setting the beam exceptions would
+have required writing
+
+@example
+\set Timing.beamExceptions =
+#'(                         ;start of alist
+   (end .                   ;entry for end of beams
+    (                       ;start of alist of end points
+     ((1 . 32) . (2 2 2))   ;rule for 1/32 beams -- end each 1/16
+    )))
+@end example
 
 @item
 The most common articulations are now reflected in MIDI output.