]> git.donarmstrong.com Git - lilypond.git/blobdiff - Documentation/user/rhythms.itely
Merge branch 'original' into HEAD
[lilypond.git] / Documentation / user / rhythms.itely
index 49263ce4c68cd073d2db8b31f7c820853a0ab9bf..cf4c1a205d9624c119e3fb2f4e6941de1a55723f 100644 (file)
@@ -108,7 +108,7 @@ Optionally, notes can be spaced strictly proportionately to their
 duration.  For details of this and other settings which control
 proportional notation, see @ref{Proportional notation}.
 
-@refcommands
+@predefined
 
 Dots are normally moved up to avoid staff lines, except in
 polyphonic situations.  The following commands may be used to
@@ -138,7 +138,7 @@ Internals Reference: @internalsref{Dots},
 @internalsref{DotColumn}.
 
 
-@refbugs
+@knownissues
 
 @c Deliberately duplicated in Durations and Rests.  -gp
 There is no fundamental limit to rest durations (both in terms of
@@ -153,7 +153,7 @@ rests from 128th to maxima (8 x whole) may be printed.
 @cindex triplets
 @funindex \times
 
-Tuplets are made out of a music expression by multiplying all
+Tuplets are made from a music expression by multiplying all the
 durations with a fraction:
 
 @example
@@ -164,7 +164,7 @@ durations with a fraction:
 The duration of @var{musicexpr} will be multiplied by the 
 fraction.  The fraction's denominator will be printed over or 
 under the notes, optionally with a bracket.  The most common 
-tuplet is the triplet in which 3 notes have the length of 2, so 
+tuplet is the triplet in which 3 notes have the duration of 2, so
 the notes are 2/3 of their written length.
 
 @lilypond[quote,ragged-right,fragment,verbatim,relative=2]
@@ -175,14 +175,16 @@ c4 c \times 2/3 {b4 a g}
 
 Tuplets may be nested:
 
-@lilypond[fragment,ragged-right,verbatim,relative=2]
-\relative c'' {
-  \autoBeamOff
-  c4 \times 4/5 { f8 e f \times 2/3 {e[ f g] } } f4 |
-}
+@lilypond[quote,fragment,ragged-right,verbatim,relative=2]
+\autoBeamOff
+c4 \times 4/5 { f8 e f \times 2/3 {e[ f g] } } f4 |
 @end lilypond
 
-@refcommands
+Modifying nested tuplets which begin at the same musical moment
+must be done with @code{\tweak}.
+@c TODO Add link to LM section which deals with this.
+
+@predefined
 
 @funindex \tupletUp
 @code{\tupletUp},
@@ -192,7 +194,7 @@ Tuplets may be nested:
 @code{\tupletNeutral}.
 
 
-@commonprop
+@snippets
 
 @cindex tuplet formatting
 @cindex triplet formatting
@@ -200,24 +202,8 @@ Tuplets may be nested:
 @funindex tupletNumberFormatFunction
 @funindex tupletSpannerDuration
 
-@c when available
-@c @lilypondfile [ragged-right,line-width=16\cm,staffsize=14,quote]
-@c {Entering-several-tuplets-using-only-one-\times-command.ly}
-
-@ignore
-@c TODO Remove when snippet works ok
-@c Sent to Snippet 5 Feb 08
-The property @code{tupletSpannerDuration} specifies how long each
-bracket should last.  With this, you can make lots of tuplets
-while typing @code{\times} only once, thus saving lots of typing.
-In the next example, there are two triplets shown, while
-@code{\times} was only used once.
-
-@lilypond[quote,fragment,relative=2,ragged-right,verbatim]
-\set tupletSpannerDuration = #(ly:make-moment 1 4)
-\times 2/3 { c8 c c c c c }
-@end lilypond
-@end ignore
+@lilypondfile [verbatim,lilyquote,ragged-right,texidoc]
+{entering-several-tuplets-using-only-one--times-command.ly}
 
 @noindent
 For more information about @code{make-moment}, see
@@ -245,6 +231,8 @@ Tuplets may extend over bar lines, but they will inhibit a
 line break unless the @code{Forbid_line_break_engraver} is
 removed from the @code{Voice context}.
 
+@c TODO Move to LM 4
+@ignore
 @subheading Modifying nested tuplets
 
 @cindex tuplets, nested
@@ -322,7 +310,16 @@ below the staff, we can use @code{\override} in the usual way.
    \times 2/3 { c8[ c8 c8] }
 }
 @end lilypond
+@end ignore
 
+@c TODO - tidy up
+@c Sent to Valentin for LSR (general list of Rhythm snippets) 22 Feb
+@c Maybe try referencing with:
+@c For example of modifying bracket length see @lsr{..}
+@c Index entries could then be added above this.
+@c Delete ignore block when available in LSR
+
+@ignore
 @subheading Modifying tuplet bracket length
 
 @cindex tuplet bracket length
@@ -358,20 +355,19 @@ full length mode and how to modify what material they cover.
   c4
 }
 @end lilypond
+@end ignore
 
-@subheading Compressing music
+@c Compressing music
 
 @cindex compressing music
 @funindex \compressMusic
 
 @code{\compressMusic} works similarly to \times, but does not
 create a tuplet bracket.  One application is in polymetric
-notation, as shown in the following example.  See
-@ref{Polymetric notation}.
+notation, see @ref{Polymetric notation}.
 
-@c when available
-@c @lilypondfile [ragged-right,line-width=16\cm,staffsize=14,quote]
-@c {printing-music-with-different-time-signatures.ly}
+@lilypondfile [verbatim,lilyquote,ragged-right,texidoc]
+{printing-music-with-different-time-signatures.ly}
 
 
 @seealso
@@ -387,7 +383,7 @@ Snippets: @lsrdir{Rhythms,Rhythms}.
 Internals Reference: @internalsref{TupletBracket},
 @internalsref{TupletNumber}, @internalsref{TimeScaledMusic}.
 
-@refbugs
+@knownissues
 
 Lines may be broken within a tuplet with @code{\bar "" \break},
 but the tuplet bracket does not correctly carry over.
@@ -501,7 +497,7 @@ be entered using @code{\laissezVibrer}:
 @end lilypond
 
 The vertical placement of ties may be controlled; see
-@ref{Controlling direction}.
+@ref{Controlling direction and placement}.
 
 @quotation
 DELETE THIS ?
@@ -517,7 +513,7 @@ c4_~ c c^~ c)
 @end lilypond
 @end quotation
 
-@refcommands
+@predefined
 
 @funindex \tieUp
 @code{\tieUp},
@@ -533,7 +529,7 @@ c4_~ c c^~ c)
 @code{\tieSolid}.
 
 
-@commonprop
+@snippets
 
 Ties are sometimes used to write out arpeggios.  In this case, two
 tied notes need not be consecutive.  This can be achieved by
@@ -589,7 +585,7 @@ Snippets: @lsrdir{Rhythms,Rhythms}
 Internals Reference: @internalsref{Tie}.
 
 
-@refbugs
+@knownissues
 
 Switching staves when a tie is active will not produce a slanted
 tie.
@@ -661,7 +657,7 @@ Snippets: @lsrdir{Rhythms,Rhythms}.
 Internals Reference: @internalsref{Rest}.
 
 
-@refbugs
+@knownissues
 
 @c Deliberately duplicated in Durations and Rests.  -gp
 There is no fundamental limit to rest durations (both in terms of
@@ -879,7 +875,7 @@ default number, and @internalsref{MultiMeasureRestText} for user
 specified texts.
 
 
-@refbugs
+@knownissues
 
 If an attempt is made to use fingerings (e.g., 
 @code{R1*10-4}) to put numbers over multi-measure rests, the
@@ -925,7 +921,7 @@ The time signature is set with the @code{\time} command:
 \time 2/4 c2 \time 3/4 c2.
 @end lilypond
 
-@commonprop
+@snippets
 
 The symbol that is printed can be customized with the @code{style}
 property.  Setting it to @code{#'()} uses fraction style for 4/4
@@ -1015,7 +1011,7 @@ Internals Reference: @internalsref{TimeSignature}, and
 Examples: @c @lsr{contemporary,compound-time-signature.ly}.
 
 
-@refbugs
+@knownissues
 
 Automatic beaming does not use the measure grouping specified with
 @code{set-time-signature}.
@@ -1058,7 +1054,7 @@ that this is a negative number; @code{\partial 4} is internally
 translated to mean @qq{there is a quarter note left in the bar.}
 
 
-@refbugs
+@knownissues
 
 This command does not take into account grace notes at the start
 of the music.  When a piece starts with grace notes in the
@@ -1113,7 +1109,7 @@ c4 c d8 d d f4 g4.
 d4 e d c
 @end lilypond
 
-@refbugs
+@knownissues
 
 LilyPond will only insert line breaks and page breaks at a
 bar line.  Unless the unmetered music ends before the end of the
@@ -1257,7 +1253,7 @@ staff, shown durations are multiplied by 3/5, so that 3/5 * 10/8 =
 @end lilypond
 
 
-@refbugs
+@knownissues
 
 When using different time signatures in parallel, the spacing is
 aligned vertically, but bar lines distort the regular spacing.
@@ -1297,7 +1293,7 @@ If you want to allow line breaking on the bar lines where
 also remove @internalsref{Forbid_line_break_engraver}.
 
 
-@refbugs
+@knownissues
 
 Not all durations (especially those containing tuplets) can be
 represented exactly with normal notes and dots, but the engraver
@@ -1364,7 +1360,7 @@ c16 c8
 @end lilypond
 
 
-@commonprop
+@snippets
 
 Beaming patterns may be altered with the @code{beatGrouping} property,
 
@@ -1447,7 +1443,7 @@ Snippets: @lsrdir{Rhythms,Rhythms}
 Internals Reference: @internalsref{Beam}.
 
 
-@refbugs
+@knownissues
 
 Automatically kneed cross-staff beams cannot be used together with
 hidden staves.  See @ref{Hiding staves}.
@@ -1621,7 +1617,7 @@ If beams are used to indicate melismata in songs, then automatic
 beaming should be switched off with @code{\autoBeamOff}.
 
 
-@refcommands
+@predefined
 
 @funindex \autoBeamOff
 @code{\autoBeamOff},
@@ -1629,7 +1625,7 @@ beaming should be switched off with @code{\autoBeamOff}.
 @code{\autoBeamOn}.
 
 
-@refbugs
+@knownissues
 
 If a score ends while an automatic beam has not been ended and is
 still accepting notes, this last beam will not be typeset at all.
@@ -1693,7 +1689,7 @@ the group as a whole.
 @end lilypond
 
 
-@commonprop
+@snippets
 
 @node Feathered beams
 @subsubsection Feathered beams
@@ -1743,7 +1739,7 @@ the last four 32nd notes are at a constant tempo.
 The spacing in the printed output represents the 
 note durations only approximately, but the midi output is exact.
 
-@refbugs
+@knownissues
 
 The @code{\featherDurations} command only works with very short
 music snippets, and when numbers in the fraction are small.
@@ -1886,7 +1882,7 @@ connected between different staves of a @code{StaffGroup},
 @end lilypond
 
 
-@commonprop
+@snippets
 
 @funindex whichBar
 @funindex defaultBarType
@@ -1933,7 +1929,7 @@ c1 c c c
 @end lilypond
 
 
-@commonprop
+@snippets
 
 @funindex barNumberVisibility
 @cindex bar numbers, regular spacing
@@ -2052,7 +2048,7 @@ Snippets: @lsrdir{Rhythms,Rhythms}
 Internals Reference: @internalsref{BarNumber}.
 
 
-@refbugs
+@knownissues
 
 Bar numbers may collide with the top of the
 @internalsref{StaffGroup} bracket, if there is one.  To solve
@@ -2406,7 +2402,7 @@ other situations by @code{\override Stem  #'stroke-style =
 #"grace"}.
 
 
-@commonprop
+@snippets
 
 Grace notes may be forced to use align with regular notes
 in other staves by setting @code{strict-grace-spacing} to
@@ -2443,7 +2439,7 @@ Snippets: @lsrdir{Rhythms,Rhythms}
 Internals Reference: @internalsref{GraceMusic}.
 
 
-@refbugs
+@knownissues
 
 A multi-note beamed @emph{acciaccatura} is printed without a slash, 
 and looks exactly the same as a multi-note beamed
@@ -2600,3 +2596,6 @@ Internals Reference: @internalsref{Timing_translator},
 
 
 
+
+
+