]> git.donarmstrong.com Git - lilypond.git/commitdiff
Merge branch 'master' of carldsorensen@git.sv.gnu.org:/srv/git/lilypond
authorCarl Sorensen <c_sorensen@byu.edu>
Thu, 9 Oct 2008 09:56:36 +0000 (03:56 -0600)
committerCarl Sorensen <c_sorensen@byu.edu>
Thu, 9 Oct 2008 09:56:36 +0000 (03:56 -0600)
1  2 
Documentation/user/rhythms.itely

index 22d86d69c7ce1f85d04b91b05eac816cd68819fc,c5eeb57a23538b203064aebefd555172e613e666..11b06392341981571c0d08ee723ca25b70e88c49
@@@ -6,7 -6,7 +6,7 @@@
      version that you are working on.  See TRANSLATION for details.
  @end ignore
  
- @c \version "2.11.51"
+ @c \version "2.11.61"
  
  @ignore
  GDP TODO list
@@@ -59,7 -59,7 +59,7 @@@ This section discusses rhythms, rests, 
  @end menu
  
  @node Durations
- @subsubsection Durations
+ @unnumberedsubsubsec Durations
  
  @cindex durations, of notes
  @cindex note durations
@@@ -183,7 -183,7 +183,7 @@@ rests from 128th to maxima (8 x whole) 
  
  
  @node Tuplets
- @subsubsection Tuplets
+ @unnumberedsubsubsec Tuplets
  
  @cindex tuplets
  @cindex triplets
@@@ -287,7 -287,7 +287,7 @@@ placed within tuplet brackets
  
  
  @node Scaling durations
- @subsubsection Scaling durations
+ @unnumberedsubsubsec Scaling durations
  
  @cindex scaling durations
  @cindex durations, scaling
@@@ -361,7 -361,7 +361,7 @@@ Snippets
  
  
  @node Ties
- @subsubsection Ties
+ @unnumberedsubsubsec Ties
  
  @cindex tie
  @funindex ~
@@@ -521,7 -521,7 +521,7 @@@ Rests are entered as part of the music 
  @end menu
  
  @node Rests
- @subsubsection Rests
+ @unnumberedsubsubsec Rests
  @cindex rest
  @cindex rest, entering durations
  @cindex maxima
@@@ -602,7 -602,7 +602,7 @@@ are rests from 128th to maxima (8 x who
  
  
  @node Invisible rests
- @subsubsection Invisible rests
+ @unnumberedsubsubsec Invisible rests
  
  @cindex skip
  @cindex invisible rest
@@@ -664,7 -664,7 +664,7 @@@ Internals Reference: @rinternals{SkipMu
  
  
  @node Full measure rests
- @subsubsection Full measure rests
+ @unnumberedsubsubsec Full measure rests
  
  @cindex multi-measure rests
  @cindex full-measure rests
@@@ -799,8 -799,30 +799,8 @@@ setting, resulting bar-check warnings m
  @lilypondfile[verbatim,lilyquote,ragged-right,texidoc,doctitle]
  {positioning-multi--measure-rests.ly}
  
 -@c TODO -- convert to snippet -- submitted to Neil
 -Markups attached to a multi-measure rest will be centered above or
 -below it.  Long markups attached to multi-measure rests do not cause
 -the measure to expand. To expand a multi-measure rest to fit the markup,
 -use a spacer rest with an attached markup before the multi-measure rest:
 -
 -@lilypond[quote,ragged-right,verbatim,fragment,relative=2]
 -\compressFullBarRests
 -\textLengthOn
 -s1*0^\markup { [MAJOR GENERAL] }
 -R1*19
 -s1*0_\markup { \italic { Cue: ... it is yours } }
 -s1*0^\markup { A }
 -R1*30^\markup { [MABEL] }
 -\textLengthOff
 -c4^\markup { CHORUS } d f c
 -@end lilypond
 -
 -@noindent
 -Note that the spacer rest causes a bar to be inserted.
 -Text attached to a spacer rest in this way is left-aligned to the
 -position where the note would be placed in the measure, but if the
 -measure length is determined by the length of the text, the text will
 -appear to be centered.
 +@lilypondfile[verbatim,lilyquote,ragged-right,texidoc,doctitle]
 +{multi--measure-rest-markup.ly}
  
  @seealso
  
@@@ -852,7 -874,7 +852,7 @@@ Multi-measure rests do not take part i
  @end menu
  
  @node Time signature
- @subsubsection Time signature
+ @unnumberedsubsubsec Time signature
  
  @cindex time signature
  @cindex meter
@@@ -871,7 -893,7 +871,7 @@@ Time signatures are printed at the begi
  and whenever the time signature changes.  If a change takes place
  at the end of a line a warning time signature sign is printed
  there.  This default behavior may be changed, see
 -@ref{Visibility of objects}.
 +@c ref{Controlling visibility of objects}.
  
  @lilypond[quote,ragged-right,fragment,verbatim,relative=2]
  \time 2/4
@@@ -905,8 -927,8 +905,8 @@@ changed to a numeric style
  @end lilypond
  
  
Ancient time signatures are covered in
- @ref{Ancient time signatures}.
Mensural time signatures are covered in
+ @ref{Mensural time signatures}.
  
  @predefined
  
@@@ -923,27 -945,11 +923,27 @@@ context, which is normally aliased to @
  value of @code{timeSignatureFraction} causes the new time
  signature symbol to be printed without changing the other
  properties.  The property @code{measureLength} determines where
 -bar lines should be inserted and, with @code{beatLength}, how
 +bar lines should be inserted and, with @code{beatLength}
 +and @code{beatGrouping}, how
  automatic beams should be generated.
  
 -TODO Add example of using beatLength.
 -@c beatLength is broken - see bug 511
 +@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
  
@@@ -994,7 -1000,7 +994,7 @@@ Music Glossary
  @rglos{time signature}
  
  Notation Reference:
- @ref{Ancient time signatures},
+ @ref{Mensural time signatures},
  @ref{Time administration}.
  
  Snippets:
@@@ -1005,8 -1011,14 +1005,8 @@@ Internals Reference
  @rinternals{Timing_translator}.
  
  
 -@knownissues
 -
 -Automatic beaming does not use the measure grouping specified with
 -@code{set-time-signature}.
 -
 -
  @node Upbeats
- @subsubsection Upbeats
+ @unnumberedsubsubsec Upbeats
  
  @cindex anacrusis
  @cindex upbeat
@@@ -1053,26 -1065,26 +1053,26 @@@ command: i.e., @code{\partial 4} is int
  
  @seealso
  
 -Music Glossary: @rglos{anacrusis}
 +Music Glossary: 
 +@rglos{anacrusis}.
  
 -Notation Reference: @ref{Grace notes}
 +Notation Reference: 
 +@ref{Grace notes}.
  
  Snippets:
  @rlsr{Rhythms}.
  
  Internal Reference:
 -@rinternals{Timing_translator}
 +@rinternals{Timing_translator}.
  
  @knownissues
  
 -@cindex grace notes, in anacruses
 -
  The @code{\partial} command is intended to be used only at the
  beginning of a piece.  If you use it after the beginning, some
  odd warnings may occur.
  
  @node Unmetered music
- @subsubsection Unmetered music
+ @unnumberedsubsubsec Unmetered music
  
  @funindex \cadenzaOn
  @funindex \cadenzaOff
@@@ -1118,10 -1130,10 +1118,10 @@@ d4 e d 
  @seealso
  
  Music Glossary:
 -@rglos{cadenza}
 +@rglos{cadenza}.
  
  Notation Reference:
 -@ref{Visibility of objects}
 +@c ref{Controlling visibility of objects}.
  
  Snippets:
  @rlsr{Rhythms}.
@@@ -1141,7 -1153,7 +1141,7 @@@ to indicate where breaks can occur
  
  
  @node Polymetric notation
- @subsubsection Polymetric notation
+ @unnumberedsubsubsec Polymetric notation
  
  @cindex double time signatures
  @cindex signatures, polymetric
@@@ -1236,8 -1248,34 +1236,8 @@@ moving the @code{Timing_translator} to 
  
  @snippets
  
 -@c TODO -- Convert to snippet. -- Sent to Neil 8/14/08
 -
 -@strong{Alternating time signatures}
 -
 -Regularly alternating double time signatures are not supported
 -explicitly, but they can be faked.  In the next example, the
 -double time signature is created with markup text, while the
 -real time signature is set in the usual way with @code{\time}.
 -
 -@lilypond[verbatim,ragged-right]
 -% Create 9/8 split into 2/4 + 5/8
 -tsMarkup = \markup {
 -  \override #'(baseline-skip . 2) \number {
 -    \column { "2" "4" }
 -    \vcenter "+"
 -    \bracket \column { "5" "8" }
 -  }
 -}
 -
 -{
 -  \override Staff.TimeSignature #'stencil =
 -    #ly:text-interface::print
 -  \override Staff.TimeSignature #'text = #tsMarkup
 -  \time 9/8
 -  c'2 \bar ":" c'4 c'4.
 -  c'2 \bar ":" c'4 c'4.
 -}
 -@end lilypond
 +@lilypondfile[verbatim,lilyquote,ragged-right,texidoc,doctitle]
 +{compound-time-signatures.ly}
  
  
  @seealso
@@@ -1251,6 -1289,8 +1251,6 @@@ Notation Reference: @ref{Scaling durati
  
  Snippets:
  @rlsr{Rhythms}.
 -@c Is this still permitted?
 -@c @lsr{contemporary,compound-time-signature}
  
  Internals Reference:
  @rinternals{TimeSignature},
@@@ -1267,7 -1307,7 +1267,7 @@@ individual staves than would be normal 
  time signatures.
  
  @node Automatic note splitting
- @subsubsection Automatic note splitting
+ @unnumberedsubsubsec Automatic note splitting
  
  @cindex notes, splitting
  @cindex splitting notes
@@@ -1320,7 -1360,7 +1320,7 @@@ split rests
  
  
  @node Showing melody rhythms
- @subsubsection Showing melody rhythms
+ @unnumberedsubsubsec Showing melody rhythms
  
  Sometimes you might want to show only the rhythm of a melody.  This
  can be done with the rhythmic staff.  All pitches of notes on such a
@@@ -1448,7 -1488,7 +1448,7 @@@ Internals Reference
  @end menu
  
  @node Automatic beams
- @subsubsection Automatic beams
+ @unnumberedsubsubsec Automatic beams
  
  By default, beams are inserted automatically:
  
@@@ -1587,7 -1627,7 +1587,7 @@@ Beams can collide with note heads and a
  
  
  @node Setting automatic beam behavior
- @subsubsection Setting automatic beam behavior
+ @unnumberedsubsubsec Setting automatic beam behavior
  
  @funindex autoBeamSettings
  @funindex (end * * * *)
@@@ -1795,7 -1835,7 +1795,7 @@@ Snippets
  
  
  @node Manual beams
- @subsubsection Manual beams
+ @unnumberedsubsubsec Manual beams
  
  @cindex beams, manual
  @funindex ]
@@@ -1814,6 -1854,7 +1814,6 @@@ marking the begin and end point with @c
  }
  @end lilypond
  
 -@funindex \noBeam
  
  Individual notes may be marked with @code{\noBeam} to prevent them
  from being beamed:
@@@ -1848,7 -1889,7 +1848,7 @@@ TODO -- no difference based on stemLeft
  @snippets
  
  @node Feathered beams
- @subsubsection Feathered beams
+ @unnumberedsubsubsec Feathered beams
  
  @cindex beams, feathered
  @funindex \featherDurations
@@@ -1928,7 -1969,7 +1928,7 @@@ Snippets
  @end menu
  
  @node Bar lines
- @subsubsection Bar lines
+ @unnumberedsubsubsec Bar lines
  
  @cindex bar lines
  @funindex \bar
@@@ -1990,11 -2031,11 +1990,11 @@@ with the end of a measure the specifie
  point in the printed output.  Such insertions do not affect
  the calculation and placement of subsequent automatic bar lines.
  
- The simple bar line and four types of double bar line are available
+ The simple bar line and five types of double bar line are available
  for manual insertion:
  
  @lilypond[quote,ragged-right,fragment,relative=1,verbatim]
- f1 \bar "|" g \bar "||" a \bar ".|" b \bar ".|." c \bar "|." d
+ f1 \bar "|" g \bar "||" a \bar ".|" b \bar ".|." c \bar "|.|" d \bar "|." e
  @end lilypond
  
  @noindent
@@@ -2005,10 -2046,10 +2005,10 @@@ f1 \bar ":" g \bar "dashed" 
  @end lilypond
  
  @noindent
- and three types of repeat bar line:
+ and five types of repeat bar line:
  
  @lilypond[quote,ragged-right,fragment,relative=1,verbatim]
- f1 \bar "|:" g \bar ":|:" a \bar ":|" b
+ f1 \bar "|:" g \bar ":|:" a \bar ":|.|:" b \bar ":|.:" c \bar ":|" d
  @end lilypond
  
  @cindex repeats
@@@ -2083,7 -2124,7 +2083,7 @@@ properties)
  
  
  @node Bar numbers
- @subsubsection Bar numbers
+ @unnumberedsubsubsec Bar numbers
  
  @cindex bar numbers
  @cindex measure numbers
@@@ -2245,7 -2286,7 +2245,7 @@@ c1 c c 
  
  
  @node Bar and bar number checks
- @subsubsection Bar and bar number checks
+ @unnumberedsubsubsec Bar and bar number checks
  
  @cindex bar check
  @funindex barCheckSynchronize
@@@ -2324,7 -2365,7 +2324,7 @@@ Snippets
  
  
  @node Rehearsal marks
- @subsubsection Rehearsal marks
+ @unnumberedsubsubsec Rehearsal marks
  
  @cindex rehearsal marks
  @cindex mark, rehearsal
@@@ -2454,7 -2495,7 +2454,7 @@@ Examples: @c @lsr{parts,rehearsal-mark-
  @end menu
  
  @node Grace notes
- @subsubsection Grace notes
+ @unnumberedsubsubsec Grace notes
  
  @funindex \grace
  @cindex ornaments
@@@ -2660,12 -2701,17 +2660,12 @@@ durations in the other staves.  For th
     \new Staff { c4 \bar "|:" \grace s16 d2. } >>
  @end lilypond
  
 -Predefined commands, like @code{\voiceOne}, which are intended to
 -change the behaviour of the notation after a grace note, may not
 -be effective if placed immediately before the grace note -- they
 -should be placed after it.
 -
  Grace sections should only be used within sequential music
  expressions.  Nesting or juxtaposing grace sections is not
  supported, and might produce crashes or other errors.
  
  @node Aligning to cadenzas
- @subsubsection Aligning to cadenzas
+ @unnumberedsubsubsec Aligning to cadenzas
  
  @cindex cadenza
  @cindex cadenza, aligning to
@@@ -2711,7 -2757,7 +2711,7 @@@ Snippets
  
  
  @node Time administration
- @subsubsection Time administration
+ @unnumberedsubsubsec Time administration
  
  @cindex time administration
  @cindex timing (within the score)