resolve merge

[lilypond.git] / Documentation / snippets / new / conducting-signs,-measure-grouping-signs.ly

diff --git a/Documentation/snippets/new/conducting-signs,-measure-grouping-signs.ly b/Documentation/snippets/new/conducting-signs,-measure-grouping-signs.ly
new file mode 100644 (file)
index 0000000..72ce8c8
--- /dev/null
+++ b/Documentation/snippets/new/conducting-signs,-measure-grouping-signs.ly
@@ -0,0 +1,50 @@
+\version "2.14.0"
+
+\header {
+  lsrtags = "rhythms"
+  texidoc = "
+Beat grouping within a measure is controlled by the context property
+@code{beatStructure}.  Values of @code{beatStructure} are
+established for many time signatures in
+@file{scm/time-signature-settings.scm}.  Values of @code{beatStructure}
+can be changed or set with @code{\set}.
+Alternatively, the
+Scheme function @code{set-time-signature} can be used to both
+set the time signature and establish the beat structure.
+@code{set-time-signature}, takes three arguments: the
+number of beats, the beat length, and the internal grouping of beats in
+the measure.  @code{\time} and @code{set-time-signature} both apply
+to the @code{Timing} context, so they will not reset values of
+@code{beatStructure} or @code{baseMoment} that are set in
+other lower-level contexts, such as @code{Voice}.
+
+If the @code{Measure_grouping_engraver} is included
+in one of the display contexts, measure grouping signs will be
+created.  Such signs ease reading rhythmically complex modern music.
+In the example, the 9/8 measure is grouped in two different
+patterns using the two different methods, while the 5/8 measure
+is grouped according to the default setting in
+@file{scm/time-signature-settings.scm}:
+"
+  doctitle = "Conducting signs, measure grouping signs"
+}
+
+
+\score {
+  \new Voice \relative c'' {
+    \time 9/8
+    g8 g d d g g a( bes g) |
+    \set Timing.beatStructure = #'(2 2 2 3)
+    g8 g d d g g a( bes g) |
+    #(set-time-signature 9 8 '(4 5))
+    g8 g d d g g a( bes g) |
+    \time 5/8
+    a4. g4 |
+  }
+  \layout {
+    \context {
+      \Staff
+      \consists "Measure_grouping_engraver"
+    }
+  }
+}