+\version "2.18.0"
+
+\header {
+ lsrtags = "rhythms"
+
+ texidoc = "
+The beams of consecutive 16th (or shorter) notes are, by default, not
+subdivided. That is, the three (or more) beams stretch unbroken over
+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 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 @code{baseMoment} is changed,
+@code{beatStructure} should also be changed to match the new
+@code{baseMoment}:
+
+"
+ doctitle = "Subdividing beams"
+} % begin verbatim
+
+\relative c'' {
+ c32[ c c c c c c c]
+ \set subdivideBeams = ##t
+ c32[ c c c c c c c]
+
+ % Set beam sub-group length to an eighth note
+ \set baseMoment = #(ly:make-moment 1/8)
+ \set beatStructure = #'(2 2 2 2)
+ c32[ c c c c c c c]
+
+ % Set beam sub-group length to a sixteenth note
+ \set baseMoment = #(ly:make-moment 1/16)
+ \set beatStructure = #'(4 4 4 4)
+ c32[ c c c c c c c]
+}