]> git.donarmstrong.com Git - lilypond.git/blobdiff - Documentation/user/rhythms.itely
Merge branch 'master' of ssh://jneem@git.sv.gnu.org/srv/git/lilypond into tmp
[lilypond.git] / Documentation / user / rhythms.itely
index 614c887b1e713ff9bd6e9ba78188fc1576437230..435210b4a65d54d29b7527e5f98e5eb620ab650f 100644 (file)
@@ -118,16 +118,16 @@ polyphonic situations.  Predefined commands are available to
 force a particular direction manually, for details
 see @ref{Direction and placement}.
 
-@predefined
 
+@predefined
 @code{\autoBeamOff},
 @code{\dotsUp},
 @code{\dotsDown},
 @code{\dotsNeutral}.
+@endpredefined
 
 
 @seealso
-
 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}.
 
-@predefined
 
+@predefined
 @code{\tupletUp},
 @code{\tupletDown},
 @code{\tupletNeutral}.
+@endpredefined
 
 
 @snippets
@@ -232,8 +233,8 @@ see @ref{Scaling durations}.
 @lilypondfile[verbatim,lilyquote,ragged-right,texidoc,doctitle]
 {permitting-line-breaks-within-beamed-tuplets.ly}
 
-@seealso
 
+@seealso
 Music Glossary:
 @rglos{triplet},
 @rglos{tuplet},
@@ -255,6 +256,7 @@ Internals Reference:
 @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
@@ -327,7 +329,6 @@ notation, see @ref{Polymetric notation}.
 
 
 @seealso
-
 Notation Reference:
 @ref{Tuplets},
 @ref{Invisible rests},
@@ -438,13 +439,13 @@ commands.
 
 
 @predefined
-
 @code{\tieUp},
 @code{\tieDown},
 @code{\tieNeutral},
 @code{\tieDotted},
 @code{\tieDashed},
 @code{\tieSolid}.
+@endpredefined
 
 
 @snippets
@@ -457,7 +458,6 @@ commands.
 
 
 @seealso
-
 Music Glossary:
 @rglos{tie},
 @rglos{laissez vibrer}.
@@ -559,7 +559,6 @@ a4\rest d4\rest
 
 
 @seealso
-
 Notation Reference:
 @ref{Full measure rests}.
 
@@ -632,8 +631,8 @@ any kind.
 \skip 1 \skip1 \skip 1
 @end lilypond
 
-@seealso
 
+@seealso
 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.
 
+
 @predefined
 @code{\textLengthOn},
 @code{\textLengthOff},
 @code{\fermataMarkup},
 @code{\compressFullBarRests},
 @code{\expandFullBarRests}.
+@endpredefined
+
 
 @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}
 
-@seealso
 
+@seealso
 Music Glossary:
 @rglos{multi-measure rest}.
 
@@ -885,34 +887,17 @@ changed to a numeric style:
 Mensural time signatures are covered in
 @ref{Mensural time signatures}.
 
-@predefined
 
+@predefined
 @code{\numericTimeSignature},
 @code{\defaultTimeSignature}.
+@endpredefined
 
-@snippets
-
-@c TODO Replace by snippet called "Changing the time signature without affecting the beaming"
-@c      Submitted to LSR 2 Nov 08
 
-The @code{\time} command sets the properties
-@code{timeSignatureFraction}, @code{beatLength}, @code{beatGrouping}
-and @code{measureLength} in the @code{Timing} context, which is
-normally aliased to @code{Score}.  Changing the value of
-@code{timeSignatureFraction} causes the new time signature symbol
-to be printed without changing any of the other properties:
+@snippets
 
-@lilypond[quote,verbatim,relative=2]
-\time 3/4
-a16 a a a a a a a a a a a
-% Change time signature symbol but keep 3/4 beaming
-% due to unchanged underlying time signature
-\set Score.timeSignatureFraction = #'(12 . 16)
-a16 a a a a a a a a a a a
-\time 12/16
-% Lose 3/4 beaming now \time has been changed
-a16 a a a a a a a a a a a
-@end lilypond
+@lilypondfile[verbatim,lilyquote,ragged-right,texidoc,doctitle]
+{changing-the-time-signature-without-affecting-the-beaming.ly}
 
 @cindex compound time signatures
 @cindex time signature, compound
@@ -922,7 +907,6 @@ a16 a a a a a a a a a a a
 
 
 @seealso
-
 Music Glossary:
 @rglos{time signature}
 
@@ -984,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.}
 
-@seealso
 
+@seealso
 Music Glossary:
 @rglos{anacrusis}.
 
@@ -998,6 +982,7 @@ Snippets:
 Internal Reference:
 @rinternals{Timing_translator}.
 
+
 @knownissues
 
 The @code{\partial} command is intended to be used only at the
@@ -1043,13 +1028,14 @@ c4 c d8 d d f4 g4.
 d4 e d c
 @end lilypond
 
-@predefined
 
+@predefined
 @code{\cadenzaOn},
 @code{\cadenzaOff}.
+@endpredefined
 
-@seealso
 
+@seealso
 Music Glossary:
 @rglos{cadenza}.
 
@@ -1059,6 +1045,7 @@ Notation Reference:
 Snippets:
 @rlsr{Rhythms}.
 
+
 @knownissues
 
 LilyPond will insert line breaks and page breaks only at a
@@ -1181,7 +1168,6 @@ moving the @code{Timing_translator} and the
 
 
 @seealso
-
 Music Glossary:
 @rglos{polymetric},
 @rglos{polymetric time signature},
@@ -1200,6 +1186,7 @@ Internals Reference:
 @rinternals{Default_bar_line_engraver},
 @rinternals{Staff}.
 
+
 @knownissues
 
 When using different time signatures in parallel, notes
@@ -1235,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.
 
-@seealso
 
+@seealso
 Music Glossary: @rglos{tie}
 
 Learning Manual:
@@ -1313,17 +1300,20 @@ be done with the @code{Pitch_squash_engraver} and
 >>
 @end lilypond
 
+
 @predefined
 @code{\improvisationOn},
 @code{\improvisationOff}.
+@endpredefined
+
 
 @snippets
 
 @lilypondfile[verbatim,lilyquote,ragged-right,texidoc,doctitle]
 {guitar-strum-rhythms.ly}
 
-@seealso
 
+@seealso
 Snippets:
 @rlsr{Rhythms}.
 
@@ -1331,6 +1321,7 @@ Internals Reference:
 @rinternals{RhythmicStaff},
 @rinternals{Pitch_squash_engraver}.
 
+
 @node Beams
 @subsection Beams
 
@@ -1385,9 +1376,12 @@ c4 c8 c8. c16 c8.
 c16 c8
 @end lilypond
 
+
 @predefined
 @code{\autoBeamOff},
 @code{\autoBeamOn}.
+@endpredefined
+
 
 @snippets
 
@@ -1401,8 +1395,8 @@ c16 c8
 @lilypondfile[verbatim,lilyquote,ragged-right,texidoc,doctitle]
 {changing-beam-knee-gap.ly}
 
-@seealso
 
+@seealso
 Notation Reference:
 @ref{Manual beams},
 @ref{Setting automatic beam behavior}.
@@ -1512,33 +1506,8 @@ beats in each group.
 @lilypondfile[verbatim,lilyquote,ragged-right,texidoc,doctitle]
 {specifying-context-with-beatgrouping.ly}
 
-
-@c TODO Send as snippet?
-
-The property @code{measureLength} determines where bar lines
-should be inserted and, with @code{beatLength} and
-@code{beatGrouping}, how automatic beams should be generated
-for time signatures for which no beam-ending rules are defined.
-
-@lilypond[quote,verbatim,relative=2]
-\time 3/4 % auto beam on 1/4 note groups
-a16 a a a a a a a a a a a a a a a
-\time 12/16 % no defined auto-beaming for this time sig
-a16 a a a a a a a a a a a a a a a
-\time 3/4
-a16 a a a a a a a a a a a a a a a
-\set Score.timeSignatureFraction = #'(12 . 16) %keep 3/4 beaming
-                                             % due to beatLength
-a16 a a a a a a a a a a a a a a a
-\set Score.beatLength = #(ly:make-moment 1 8) %beam on 1/8 notes
-a16 a a a a a a a a a a a a a a a
-\set Score.beatLength = #(ly:make-moment 1 16)
-\set Score.beatGrouping = #'(3 4 2 3) %beam on 3/16, 7/16, 9/16, 12/16
-a16 a a a a a a a a a a a a a a a
-@end lilypond
-
-
-@c End of snippet
+@lilypondfile[verbatim,lilyquote,ragged-right,texidoc,doctitle]
+{using-beatlength-and-beatgrouping.ly}
 
 @funindex subdivideBeams
 
@@ -1669,9 +1638,6 @@ staff:
 << {a8 a a a16 a a a a8 a} \\ {f4. f8 f f f} >>
 @end lilypond
 
-@c TODO Add example using Score for multiple staves?
-@c Hmm.  Not sure it works correctly.  Needs more investigation.
-
 @warning{If any unexpected beam behavior occurs, check the default
 automatic beam settings in @file{scm/@/auto@/-beam@/.scm} for
 possible interference, because the beam endings defined there will
@@ -1722,34 +1688,19 @@ a a a a
 @lilypondfile[verbatim,lilyquote,ragged-right,texidoc,doctitle]
 {beam-grouping-in-7-8-time.ly}
 
-@ignore
-
-@c TODO Does this example add anything?
-
-In this
-example, automatic beams can only end on a dotted quarter note
-@example
-#(override-auto-beam-setting '(end * * * *) 3 8)
-#(override-auto-beam-setting '(end * * * *) 1 2)
-#(override-auto-beam-setting '(end * * * *) 7 8)
-@end example
-
-In 4/4 time signature, this means that automatic beams could end only on
-3/8 and on the fourth beat of the measure (after 3/4, that is 2 times
-3/8, has passed within the measure).
-
-@end ignore
-
 @lilypondfile[verbatim,lilyquote,ragged-right,texidoc,doctitle]
 {reverting-default-beam-endings.ly}
 
+@lilypondfile[verbatim,lilyquote,ragged-right,texidoc,doctitle]
+{beam-endings-in-score-context.ly}
 
-@predefined
 
+@predefined
 @funindex \autoBeamOff
 @code{\autoBeamOff},
 @funindex \autoBeamOn
 @code{\autoBeamOn}.
+@endpredefined
 
 
 @knownissues
@@ -1760,8 +1711,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.
 
-@seealso
 
+@seealso
 Snippets:
 @rlsr{Rhythms}.
 
@@ -1875,13 +1826,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.
 
-@seealso
 
+@seealso
 Snippets:
 @rlsr{Rhythms}.
 
 
-
 @node Bars
 @subsection Bars
 
@@ -1998,7 +1948,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},
-@code{InnerStaffGroup}, @code{PianoStaff}, or @code{GrandStaff}.
+@code{PianoStaff}, or @code{GrandStaff}.
 
 @lilypond[quote,fragment,verbatim]
 <<
@@ -2029,8 +1979,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}.
 
-@seealso
 
+@seealso
 Notation Reference:
 @ref{Line breaking},
 @ref{Repeats},
@@ -2178,7 +2128,6 @@ Bar numbers can be removed entirely by removing the
 
 
 @seealso
-
 Snippets:
 @rlsr{Rhythms}.
 
@@ -2280,8 +2229,8 @@ are entering from.  This can be checked with
 will print a warning if the @code{currentBarNumber} is not 123
 when it is processed.
 
-@seealso
 
+@seealso
 Snippets:
 @rlsr{Rhythms}.
 
@@ -2389,8 +2338,8 @@ printed with @code{\musicglyph}.
 For common tweaks to the positioning of rehearsal marks, see
 @ref{Formatting text}.
 
-@seealso
 
+@seealso
 Notation Reference:
 @ref{The Feta font},
 @ref{Formatting text}.
@@ -2406,6 +2355,7 @@ Snippets:
 
 Internals Reference: @rinternals{RehearsalMark}.
 
+
 @node Special rhythmic concerns
 @subsection Special rhythmic concerns
 
@@ -2584,7 +2534,6 @@ in other staves:
 
 
 @seealso
-
 Music Glossary:
 @rglos{grace notes},
 @rglos{acciaccatura},
@@ -2665,8 +2614,8 @@ MyCadenza = \relative c' {
 >>
 @end lilypond
 
-@seealso
 
+@seealso
 Music Glossary:
 @rglos{cadenza}.
 
@@ -2747,7 +2696,6 @@ notes.
 
 
 @seealso
-
 This manual: @ref{Bar numbers}, @ref{Unmetered music}
 
 Snippets: