From: Urs Liska <ul@openlilylib.org>
Date: Mon, 28 Dec 2015 15:08:11 +0000 (+0100)
Subject: 4704: Update doc-snippet through makelsr.py
X-Git-Tag: release/2.19.35-1~9^2~2
X-Git-Url: https://git.donarmstrong.com/lilypond.git?a=commitdiff_plain;h=706d797884199982b6b849ba11942865d0b17fd2;p=lilypond.git

4704: Update doc-snippet through makelsr.py
---

diff --git a/Documentation/snippets/subdividing-beams.ly b/Documentation/snippets/subdividing-beams.ly
index d1def01815..b15e1b1dfa 100644
--- a/Documentation/snippets/subdividing-beams.ly
+++ b/Documentation/snippets/subdividing-beams.ly
@@ -1,10 +1,11 @@
-%% DO NOT EDIT this file manually; it is automatically
-%% generated from LSR http://lsr.di.unimi.it
-%% Make any changes in LSR itself, or in Documentation/snippets/new/ ,
-%% and then run scripts/auxiliar/makelsr.py
-%%
-%% This file is in the public domain.
-\version "2.18.0"
+% DO NOT EDIT this file manually; it is automatically
+% generated from Documentation/snippets/new
+% Make any changes in Documentation/snippets/new/
+% and then run scripts/auxiliar/makelsr.py
+%
+% This file is in the public domain.
+%% Note: this file works from version 2.19.34
+\version "2.19.34"
 
 \header {
   lsrtags = "rhythms"
@@ -16,8 +17,12 @@ entire groups of notes.  This behavior can be modified to subdivide the
 beams into sub-groups by setting the property @code{subdivideBeams}.
 When set, multiple beams will be subdivided at intervals defined by the
 current value of @code{baseMoment} by reducing the multiple beams to
-the number of beams that indicates the length of the sub-group. Note
-that @code{baseMoment} defaults to one over the denominator of the
+the number of beams that indicates the metric value of the subdivision.
+If the group following the division is shorter than the current metric
+value (usually because the beam is incomplete) the number of beams
+reflects the longest possible subdivision group.  However, if there is
+only one note left after the division this restriction isn't applied.
+Note that @code{baseMoment} defaults to one over the denominator of the
 current time signature if not set explicitly. It must be set to a
 fraction giving the duration of the beam sub-group using the
 @code{ly:make-moment} function, as shown in this snippet. Also, when
@@ -42,4 +47,15 @@ changed to match the new @code{baseMoment}:
   \set baseMoment = #(ly:make-moment 1/16)
   \set beatStructure = #'(4 4 4 4)
   c32[ c c c c c c c]
-}
+
+  % Shorten beam by 1/32
+  \set baseMoment = #(ly:make-moment 1/8)
+  \set beatStructure = #'(2 2 2 2)
+  c32[ c c c c c c] r32
+
+  % Shorten beam by 3/32
+  \set baseMoment = #(ly:make-moment 1/8)
+  \set beatStructure = #'(2 2 2 2)
+  c32[ c c c c] r16.
+
+} % begin verbatim