]> git.donarmstrong.com Git - lilypond.git/blobdiff - Documentation/notation/rhythms.itely
Merge branch 'master' into lilypond/translation
[lilypond.git] / Documentation / notation / rhythms.itely
index 4637bd51c51322dc3278615a0d114db8f714480f..c22f55fb52356cc7c0133af219eb2a3c0ce6fb86 100644 (file)
@@ -7,7 +7,7 @@
     Guide, node Updating translation committishes..
 @end ignore
 
-@c \version "2.14.0"
+@c \version "2.15.18"
 
 @node Rhythms
 @section Rhythms
@@ -523,10 +523,24 @@ c2 ~ c
 c2 ~ c
 @end lilypond
 
-Dash pattern definitions for ties have the same structure as
-dash pattern definitions for slurs.
-For more information about complex dash patterns,
-see the snippets under @ref{Slurs}.
+Dash pattern definitions for ties have the same structure as dash
+pattern definitions for slurs. For more information about complex dash
+patterns, see @ref{Slurs}.
+
+Override @var{whiteout} and @var{layer} layout properties for ties that
+collide with other objects in a staff.
+
+@lilypond[verbatim,quote,ragged-right,relative=2]
+\override Tie #'layer = #-2
+\override Staff.TimeSignature #'layer = #-1
+\override Staff.KeySignature #'layer = #-1
+\override Staff.TimeSignature #'whiteout = ##t
+\override Staff.KeySignature #'whiteout = ##t
+b2 b~
+\time 3/4
+\key a \major
+b r4
+@end lilypond
 
 @predefined
 @code{\tieUp},
@@ -540,7 +554,6 @@ see the snippets under @ref{Slurs}.
 @code{\tieSolid}.
 @endpredefined
 
-
 @snippets
 
 @lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle]
@@ -549,7 +562,6 @@ see the snippets under @ref{Slurs}.
 @lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle]
 {engraving-ties-manually.ly}
 
-
 @seealso
 Music Glossary:
 @rglos{tie},
@@ -560,6 +572,7 @@ Notation Reference:
 @ref{Automatic note splitting}.
 
 Snippets:
+@rlsr{Expressive marks},
 @rlsr{Rhythms}.
 
 Internals Reference:
@@ -568,14 +581,11 @@ Internals Reference:
 @rinternals{TieColumn},
 @rinternals{Tie}.
 
-
 @knownissues
-Switching staves when a tie is active will not produce a slanted
-tie.
-
-Changing clefs or ottavations during a tie is not really
-well-defined.  In these cases, a slur may be preferable.
+Switching staves when a tie is active will not produce a slanted tie.
 
+Changing clefs or ottavations during a tie is not really well-defined.
+In these cases, a slur may be preferable.
 
 
 @node Writing rests
@@ -1201,10 +1211,6 @@ for different staves by moving the @code{Timing_translator} and the
 
 
 @snippets
-
-@lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle]
-{changing-the-time-signature-without-affecting-the-beaming.ly}
-
 @lilypondfile[verbatim,quote,texidoc,doctitle]
 {time-signature-printing-only-the-numerator-as-a-number-instead-of-the-fraction.ly}
 
@@ -1635,7 +1641,7 @@ These are created using the @code{\compoundMeter} function.  The syntax
 for this is:
 
 @example
-\compoundMeter #'@var{(list of lists)}
+\compoundMeter #'@code{(list of lists)}
 @end example
 
 The simplest construction is a single list, where the @emph{last} number
@@ -2183,6 +2189,11 @@ The default beaming rules can be found in
 @lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle]
 {subdividing-beams.ly}
 
+@cindex beamlets, orienting
+
+@lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle]
+{strict-beat-beaming.ly}
+
 @cindex measure groupings
 @cindex beats, grouping
 @cindex grouping beats
@@ -2741,9 +2752,7 @@ c1 | c | c | c
 c1 | c | c | c
 @end lilypond
 
-
 @snippets
-
 @lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle]
 {printing-the-bar-number-for-the-first-measure.ly}
 
@@ -2756,6 +2765,12 @@ c1 | c | c | c
 @lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle]
 {printing-bar-numbers-inside-boxes-or-circles.ly}
 
+@cindex bar numbers, with letters
+@cindex bar numbers, with repeats
+
+@lilypondfile[verbatim,quote,texidoc,doctitle]
+{alternative-bar-numbering.ly}
+
 @cindex bar number alignment
 
 @lilypondfile[verbatim,quote,texidoc,doctitle]
@@ -2764,7 +2779,6 @@ c1 | c | c | c
 @lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle]
 {removing-bar-numbers-from-a-score.ly}
 
-
 @seealso
 Snippets:
 @rlsr{Rhythms}.
@@ -2773,7 +2787,6 @@ Internals Reference:
 @rinternals{BarNumber},
 @rinternals{Bar_number_engraver}.
 
-
 @cindex bar number collision
 @cindex collision, bar number
 
@@ -3047,33 +3060,39 @@ Internals Reference:
 @cindex acciaccatura
 
 @funindex \grace
-@funindex grace
+@funindex \slashedGrace
+@funindex \acciaccatura
+@funindex \appoggiatura
 
-Grace notes are ornaments that are written out.  Grace notes
-are printed in a smaller font and take up no logical time
-in a measure.
+Grace notes are musical ornaments, printed in a smaller font, that take
+up no additional logical time in a measure.
 
 @lilypond[quote,relative=2,verbatim]
-c4 \grace c16 c4
-\grace { c16[ d16] } c2
+c4 \grace b16 a4(
+\grace { b16[ c16] } a2)
 @end lilypond
 
-LilyPond also supports two special types of grace notes, the
+There are three other types of grace notes possible; the
 @emph{acciaccatura} -- an unmeasured grace note indicated by a slurred
-small note with a slashed stem -- and the @emph{appoggiatura}, which
-takes a fixed fraction of the main note and appears in small print
-without a slash.
+note with a slashed stem -- and the @emph{appoggiatura}, which takes a
+fixed fraction of the main note it is attached to and prints without the
+slash.  It is also possible to write a grace note with a slashed stem,
+like the @emph{acciaccatura} but without the slur, so as to place it
+between notes that are slurred themselves, using the
+@code{\slashedGrace} function.
 
 @lilypond[quote,relative=2,verbatim]
-\grace c8 b4
 \acciaccatura d8 c4
 \appoggiatura e8 d4
-\acciaccatura { g16[ f] } e4
+\acciaccatura { g16[ f] } e2
+\slashedGrace a,8 g4
+\slashedGrace b16 a4(
+\slashedGrace b8 a2)
 @end lilypond
 
-The placement of grace notes is synchronized between different
-staves.  In the following example, there are two sixteenth grace
-notes for every eighth grace note
+The placement of grace notes is synchronized between different staves.
+In the following example, there are two sixteenth grace notes for every
+eighth grace note
 
 @lilypond[quote,relative=2,verbatim]
 <<
@@ -3315,9 +3334,9 @@ MyCadenza = \relative c' {
     \MyCadenza c'1
   }
   \new Staff {
-    #(ly:export (mmrest-of-length MyCadenza))
+    $(mmrest-of-length MyCadenza)
     c'1
-    #(ly:export (skip-of-length MyCadenza))
+    $(skip-of-length MyCadenza)
     c'1
   }
 >>