Docs: NR 1.2.4 Beams: beatGrouping

[lilypond.git] / Documentation / user / rhythms.itely

diff --git a/Documentation/user/rhythms.itely b/Documentation/user/rhythms.itely
index c64ea779a6f6d78ee9d9b4dc75e6de5e114ea940..7e84e74d16858929c6013ca05f6fe59ea285b085 100644 (file)
--- a/Documentation/user/rhythms.itely
+++ b/Documentation/user/rhythms.itely
@@ -51,7 +51,7 @@ quarter note is entered using a @code{4} (since it is a 1/4 note),
 and a half note is entered using a @code{2} (since it is a 1/2
 note).  For notes longer than a whole you must use the
 @code{\longa} (a double breve) and @code{\breve} commands.
 and a half note is entered using a @code{2} (since it is a 1/2
 note).  For notes longer than a whole you must use the
 @code{\longa} (a double breve) and @code{\breve} commands.

-Durations as short as 64th notes may be specified.  Shorter values
+Durations as short as 128th notes may be specified.  Shorter values

 are possible, but only as beamed notes.
 
 @c Two 64th notes are needed to obtain beams
 are possible, but only as beamed notes.
 
 @c Two 64th notes are needed to obtain beams


@@ -118,16 +118,16 @@ polyphonic situations.  Predefined commands are available to
 force a particular direction manually, for details
 see @ref{Direction and placement}.
 
 force a particular direction manually, for details
 see @ref{Direction and placement}.
 

-@predefined

 
 

+@predefined

 @code{\autoBeamOff},
 @code{\dotsUp},
 @code{\dotsDown},
 @code{\dotsNeutral}.
 @code{\autoBeamOff},
 @code{\dotsUp},
 @code{\dotsDown},
 @code{\dotsNeutral}.

+@endpredefined

 
 
 @seealso
 
 
 @seealso

-

 Music Glossary:
 @rglos{breve},
 @rglos{longa},
 Music Glossary:
 @rglos{breve},
 @rglos{longa},


@@ -206,11 +206,12 @@ must be done with @code{\tweak}.
 To modify the duration of notes without printing a tuplet bracket,
 see @ref{Scaling durations}.
 
 To modify the duration of notes without printing a tuplet bracket,
 see @ref{Scaling durations}.
 

-@predefined

 
 

+@predefined

 @code{\tupletUp},
 @code{\tupletDown},
 @code{\tupletNeutral}.
 @code{\tupletUp},
 @code{\tupletDown},
 @code{\tupletNeutral}.

+@endpredefined

 
 
 @snippets
 
 
 @snippets


@@ -232,8 +233,8 @@ see @ref{Scaling durations}.
 @lilypondfile[verbatim,lilyquote,ragged-right,texidoc,doctitle]
 {permitting-line-breaks-within-beamed-tuplets.ly}
 
 @lilypondfile[verbatim,lilyquote,ragged-right,texidoc,doctitle]
 {permitting-line-breaks-within-beamed-tuplets.ly}
 

-@seealso

 
 

+@seealso

 Music Glossary:
 @rglos{triplet},
 @rglos{tuplet},
 Music Glossary:
 @rglos{triplet},
 @rglos{tuplet},


@@ -255,6 +256,7 @@ Internals Reference:
 @rinternals{TupletNumber},
 @rinternals{TimeScaledMusic}.
 
 @rinternals{TupletNumber},
 @rinternals{TimeScaledMusic}.
 

+

 @knownissues
 @cindex grace notes within tuplet brackets
 When the first note on a staff is a grace note followed by a
 @knownissues
 @cindex grace notes within tuplet brackets
 When the first note on a staff is a grace note followed by a


@@ -327,7 +329,6 @@ notation, see @ref{Polymetric notation}.
 
 
 @seealso
 
 
 @seealso

-

 Notation Reference:
 @ref{Tuplets},
 @ref{Invisible rests},
 Notation Reference:
 @ref{Tuplets},
 @ref{Invisible rests},


@@ -438,13 +439,13 @@ commands.
 
 
 @predefined
 
 
 @predefined

-

 @code{\tieUp},
 @code{\tieDown},
 @code{\tieNeutral},
 @code{\tieDotted},
 @code{\tieDashed},
 @code{\tieSolid}.
 @code{\tieUp},
 @code{\tieDown},
 @code{\tieNeutral},
 @code{\tieDotted},
 @code{\tieDashed},
 @code{\tieSolid}.

+@endpredefined

 
 
 @snippets
 
 
 @snippets


@@ -457,7 +458,6 @@ commands.
 
 
 @seealso
 
 
 @seealso

-

 Music Glossary:
 @rglos{tie},
 @rglos{laissez vibrer}.
 Music Glossary:
 @rglos{tie},
 @rglos{laissez vibrer}.


@@ -559,7 +559,6 @@ a4\rest d4\rest
 
 
 @seealso
 
 
 @seealso

-

 Notation Reference:
 @ref{Full measure rests}.
 
 Notation Reference:
 @ref{Full measure rests}.
 


@@ -632,8 +631,8 @@ any kind.
 \skip 1 \skip1 \skip 1
 @end lilypond
 
 \skip 1 \skip1 \skip 1
 @end lilypond
 

-@seealso

 
 

+@seealso

 Snippets:
 @rlsr{Rhythms}.
 
 Snippets:
 @rlsr{Rhythms}.
 


@@ -754,12 +753,15 @@ R1^"right"
 When a multi-measure rest immediately follows a @code{\partial}
 setting, resulting bar-check warnings may not be displayed.
 
 When a multi-measure rest immediately follows a @code{\partial}
 setting, resulting bar-check warnings may not be displayed.
 

+

 @predefined
 @code{\textLengthOn},
 @code{\textLengthOff},
 @code{\fermataMarkup},
 @code{\compressFullBarRests},
 @code{\expandFullBarRests}.
 @predefined
 @code{\textLengthOn},
 @code{\textLengthOff},
 @code{\fermataMarkup},
 @code{\compressFullBarRests},
 @code{\expandFullBarRests}.

+@endpredefined
+

 
 @snippets
 
 
 @snippets
 


@@ -779,8 +781,8 @@ setting, resulting bar-check warnings may not be displayed.
 @lilypondfile[verbatim,lilyquote,ragged-right,texidoc,doctitle]
 {multi--measure-rest-markup.ly}
 
 @lilypondfile[verbatim,lilyquote,ragged-right,texidoc,doctitle]
 {multi--measure-rest-markup.ly}
 

-@seealso

 
 

+@seealso

 Music Glossary:
 @rglos{multi-measure rest}.
 
 Music Glossary:
 @rglos{multi-measure rest}.
 


@@ -885,10 +887,12 @@ changed to a numeric style:
 Mensural time signatures are covered in
 @ref{Mensural time signatures}.
 
 Mensural time signatures are covered in
 @ref{Mensural time signatures}.
 

-@predefined

 
 

+@predefined

 @code{\numericTimeSignature},
 @code{\defaultTimeSignature}.
 @code{\numericTimeSignature},
 @code{\defaultTimeSignature}.

+@endpredefined
+

 
 @snippets
 
 
 @snippets
 


@@ -903,7 +907,6 @@ Mensural time signatures are covered in
 
 
 @seealso
 
 
 @seealso

-

 Music Glossary:
 @rglos{time signature}
 
 Music Glossary:
 @rglos{time signature}
 


@@ -965,8 +968,8 @@ that this is set to a negative number by the @code{\partial}
 command: i.e., @code{\partial 4} is internally translated to
 @code{-4}, meaning @qq{there is a quarter note left in the measure.}
 
 command: i.e., @code{\partial 4} is internally translated to
 @code{-4}, meaning @qq{there is a quarter note left in the measure.}
 

-@seealso

 
 

+@seealso

 Music Glossary:
 @rglos{anacrusis}.
 
 Music Glossary:
 @rglos{anacrusis}.
 


@@ -979,6 +982,7 @@ Snippets:
 Internal Reference:
 @rinternals{Timing_translator}.
 
 Internal Reference:
 @rinternals{Timing_translator}.
 

+

 @knownissues
 
 The @code{\partial} command is intended to be used only at the
 @knownissues
 
 The @code{\partial} command is intended to be used only at the


@@ -1024,13 +1028,14 @@ c4 c d8 d d f4 g4.
 d4 e d c
 @end lilypond
 
 d4 e d c
 @end lilypond
 

-@predefined

 
 

+@predefined

 @code{\cadenzaOn},
 @code{\cadenzaOff}.
 @code{\cadenzaOn},
 @code{\cadenzaOff}.

+@endpredefined

 
 

-@seealso

 
 

+@seealso

 Music Glossary:
 @rglos{cadenza}.
 
 Music Glossary:
 @rglos{cadenza}.
 


@@ -1040,6 +1045,7 @@ Notation Reference:
 Snippets:
 @rlsr{Rhythms}.
 
 Snippets:
 @rlsr{Rhythms}.
 

+

 @knownissues
 
 LilyPond will insert line breaks and page breaks only at a
 @knownissues
 
 LilyPond will insert line breaks and page breaks only at a


@@ -1162,7 +1168,6 @@ moving the @code{Timing_translator} and the
 
 
 @seealso
 
 
 @seealso

-

 Music Glossary:
 @rglos{polymetric},
 @rglos{polymetric time signature},
 Music Glossary:
 @rglos{polymetric},
 @rglos{polymetric time signature},


@@ -1181,6 +1186,7 @@ Internals Reference:
 @rinternals{Default_bar_line_engraver},
 @rinternals{Staff}.
 
 @rinternals{Default_bar_line_engraver},
 @rinternals{Staff}.
 

+

 @knownissues
 
 When using different time signatures in parallel, notes
 @knownissues
 
 When using different time signatures in parallel, notes


@@ -1216,8 +1222,8 @@ inserts ties.  One of its uses is to debug complex scores: if the
 measures are not entirely filled, then the ties show exactly how
 much each measure is off.
 
 measures are not entirely filled, then the ties show exactly how
 much each measure is off.
 

-@seealso

 
 

+@seealso

 Music Glossary: @rglos{tie}
 
 Learning Manual:
 Music Glossary: @rglos{tie}
 
 Learning Manual:


@@ -1294,17 +1300,20 @@ be done with the @code{Pitch_squash_engraver} and
 >>
 @end lilypond
 
 >>
 @end lilypond
 

+

 @predefined
 @code{\improvisationOn},
 @code{\improvisationOff}.
 @predefined
 @code{\improvisationOn},
 @code{\improvisationOff}.

+@endpredefined
+

 
 @snippets
 
 @lilypondfile[verbatim,lilyquote,ragged-right,texidoc,doctitle]
 {guitar-strum-rhythms.ly}
 
 
 @snippets
 
 @lilypondfile[verbatim,lilyquote,ragged-right,texidoc,doctitle]
 {guitar-strum-rhythms.ly}
 

-@seealso

 
 

+@seealso

 Snippets:
 @rlsr{Rhythms}.
 
 Snippets:
 @rlsr{Rhythms}.
 


@@ -1312,6 +1321,7 @@ Internals Reference:
 @rinternals{RhythmicStaff},
 @rinternals{Pitch_squash_engraver}.
 
 @rinternals{RhythmicStaff},
 @rinternals{Pitch_squash_engraver}.
 

+

 @node Beams
 @subsection Beams
 
 @node Beams
 @subsection Beams
 


@@ -1366,9 +1376,12 @@ c4 c8 c8. c16 c8.
 c16 c8
 @end lilypond
 
 c16 c8
 @end lilypond
 

+

 @predefined
 @code{\autoBeamOff},
 @code{\autoBeamOn}.
 @predefined
 @code{\autoBeamOff},
 @code{\autoBeamOn}.

+@endpredefined
+

 
 @snippets
 
 
 @snippets
 


@@ -1382,8 +1395,8 @@ c16 c8
 @lilypondfile[verbatim,lilyquote,ragged-right,texidoc,doctitle]
 {changing-beam-knee-gap.ly}
 
 @lilypondfile[verbatim,lilyquote,ragged-right,texidoc,doctitle]
 {changing-beam-knee-gap.ly}
 

-@seealso

 
 

+@seealso

 Notation Reference:
 @ref{Manual beams},
 @ref{Setting automatic beam behavior}.
 Notation Reference:
 @ref{Manual beams},
 @ref{Setting automatic beam behavior}.


@@ -1440,7 +1453,9 @@ particular beam in the time signature in use, its beaming is
 controlled by three context properties:
 @code{measureLength}, @code{beatLength} and @code{beatGrouping}.
 These properties may be set in the @code{Score}, @code{Staff} or
 controlled by three context properties:
 @code{measureLength}, @code{beatLength} and @code{beatGrouping}.
 These properties may be set in the @code{Score}, @code{Staff} or

-@code{Voice} contexts to delimit their scope.
+@code{Voice} contexts to delimit their scope.  The default values
+are set while processing @code{\time} commands, so the @code{\set}
+commands must be placed after all @code{\time} commands.

 
 These determine the beaming as follows:
 
 
 These determine the beaming as follows:
 


@@ -1678,41 +1693,16 @@ a a a a
 @lilypondfile[verbatim,lilyquote,ragged-right,texidoc,doctitle]
 {reverting-default-beam-endings.ly}
 
 @lilypondfile[verbatim,lilyquote,ragged-right,texidoc,doctitle]
 {reverting-default-beam-endings.ly}
 

-@c TODO Convert to snippet called "Beam endings in Score context"
-@c Submitted to LSR 3 Nov 08
-
-Beam-ending rules specified in the Score context apply to all
-staves, but can be modified at both Staff and Voice levels:
-
-@lilypond[quote,verbatim,relative=2]
-  \time 5/4
-  % Set default beaming for all staves
-  #(override-auto-beam-setting '(end * * 5 4) 3 8 'Score)
-  #(override-auto-beam-setting '(end * * 5 4) 7 8 'Score)
-  <<
-    \new Staff {
-      c8 c c c c c c c c c
-    }
-    \new Staff {
-      % Modify beaming for just this staff
-      #(override-auto-beam-setting '(end * * 5 4) 6 8 'Staff)
-      #(revert-auto-beam-setting '(end * * 5 4) 7 8 'Staff)
-      c8 c c c c c c c c c
-    }
-    \new Staff {
-      % Inherit beaming from Score context
-      c8 c c c c c c c c c
-    }
-  >>
-@end lilypond
+@lilypondfile[verbatim,lilyquote,ragged-right,texidoc,doctitle]
+{beam-endings-in-score-context.ly}

 
 
 @predefined
 
 
 @predefined

-

 @funindex \autoBeamOff
 @code{\autoBeamOff},
 @funindex \autoBeamOn
 @code{\autoBeamOn}.
 @funindex \autoBeamOff
 @code{\autoBeamOff},
 @funindex \autoBeamOn
 @code{\autoBeamOn}.

+@endpredefined

 
 
 @knownissues
 
 
 @knownissues


@@ -1723,8 +1713,8 @@ The same holds for polyphonic voices, entered with @code{<<
 @dots{} \\ @dots{} >>}.  If a polyphonic voice ends while an
 automatic beam is still accepting notes, it is not typeset.
 
 @dots{} \\ @dots{} >>}.  If a polyphonic voice ends while an
 automatic beam is still accepting notes, it is not typeset.
 

-@seealso

 
 

+@seealso

 Snippets:
 @rlsr{Rhythms}.
 
 Snippets:
 @rlsr{Rhythms}.
 


@@ -1838,13 +1828,12 @@ note durations only approximately, but the MIDI output is exact.
 The @code{\featherDurations} command only works with very short
 music snippets, and when numbers in the fraction are small.
 
 The @code{\featherDurations} command only works with very short
 music snippets, and when numbers in the fraction are small.
 

-@seealso

 
 

+@seealso

 Snippets:
 @rlsr{Rhythms}.
 
 
 Snippets:
 @rlsr{Rhythms}.
 
 

-

 @node Bars
 @subsection Bars
 
 @node Bars
 @subsection Bars
 


@@ -1961,7 +1950,7 @@ c c c c
 In scores with many staves, a @code{\bar} command in one staff is
 automatically applied to all staves.  The resulting bar lines are
 connected between different staves of a @code{StaffGroup},
 In scores with many staves, a @code{\bar} command in one staff is
 automatically applied to all staves.  The resulting bar lines are
 connected between different staves of a @code{StaffGroup},

-@code{InnerStaffGroup}, @code{PianoStaff}, or @code{GrandStaff}.
+@code{PianoStaff}, or @code{GrandStaff}.

 
 @lilypond[quote,fragment,verbatim]
 <<
 
 @lilypond[quote,fragment,verbatim]
 <<


@@ -1992,8 +1981,8 @@ The default bar type used for automatically inserted bar lines is
 @code{"|"}.  This may be changed at any time
 with @code{\set Timing.defaultBarType = }@var{bartype}.
 
 @code{"|"}.  This may be changed at any time
 with @code{\set Timing.defaultBarType = }@var{bartype}.
 

-@seealso

 
 

+@seealso

 Notation Reference:
 @ref{Line breaking},
 @ref{Repeats},
 Notation Reference:
 @ref{Line breaking},
 @ref{Repeats},


@@ -2141,7 +2130,6 @@ Bar numbers can be removed entirely by removing the
 
 
 @seealso
 
 
 @seealso

-

 Snippets:
 @rlsr{Rhythms}.
 
 Snippets:
 @rlsr{Rhythms}.
 


@@ -2243,8 +2231,8 @@ are entering from.  This can be checked with
 will print a warning if the @code{currentBarNumber} is not 123
 when it is processed.
 
 will print a warning if the @code{currentBarNumber} is not 123
 when it is processed.
 

-@seealso

 
 

+@seealso

 Snippets:
 @rlsr{Rhythms}.
 
 Snippets:
 @rlsr{Rhythms}.
 


@@ -2352,8 +2340,8 @@ printed with @code{\musicglyph}.
 For common tweaks to the positioning of rehearsal marks, see
 @ref{Formatting text}.
 
 For common tweaks to the positioning of rehearsal marks, see
 @ref{Formatting text}.
 

-@seealso

 
 

+@seealso

 Notation Reference:
 @ref{The Feta font},
 @ref{Formatting text}.
 Notation Reference:
 @ref{The Feta font},
 @ref{Formatting text}.


@@ -2369,6 +2357,7 @@ Snippets:
 
 Internals Reference: @rinternals{RehearsalMark}.
 
 
 Internals Reference: @rinternals{RehearsalMark}.
 

+

 @node Special rhythmic concerns
 @subsection Special rhythmic concerns
 
 @node Special rhythmic concerns
 @subsection Special rhythmic concerns
 


@@ -2547,7 +2536,6 @@ in other staves:
 
 
 @seealso
 
 
 @seealso

-

 Music Glossary:
 @rglos{grace notes},
 @rglos{acciaccatura},
 Music Glossary:
 @rglos{grace notes},
 @rglos{acciaccatura},


@@ -2628,8 +2616,8 @@ MyCadenza = \relative c' {
 >>
 @end lilypond
 
 >>
 @end lilypond
 

-@seealso

 
 

+@seealso

 Music Glossary:
 @rglos{cadenza}.
 
 Music Glossary:
 @rglos{cadenza}.
 


@@ -2710,7 +2698,6 @@ notes.
 
 
 @seealso
 
 
 @seealso

-

 This manual: @ref{Bar numbers}, @ref{Unmetered music}
 
 Snippets:
 This manual: @ref{Bar numbers}, @ref{Unmetered music}
 
 Snippets: