From 33c0ec977d6b812f7f2109763632a7874a9853a4 Mon Sep 17 00:00:00 2001 From: Carl Sorensen Date: Sat, 4 Apr 2009 14:48:29 -0600 Subject: [PATCH] Docs: Rhythms indexed by Ralph Palmer --- Documentation/user/rhythms.itely | 128 ++++++++++++++++++++++++------- 1 file changed, 99 insertions(+), 29 deletions(-) diff --git a/Documentation/user/rhythms.itely b/Documentation/user/rhythms.itely index 57f40f02ab..2c63d75d21 100644 --- a/Documentation/user/rhythms.itely +++ b/Documentation/user/rhythms.itely @@ -81,6 +81,10 @@ A note with the duration of a quadruple breve may be entered with @code{\maxima}, but this is supported only within ancient music notation. For details, see @ref{Ancient notation}. +@cindex duration, default +@cindex default note duration +@cindex note duration, default + If the duration is omitted, it is set to the previously entered duration. The default for the first note is a quarter note. @@ -198,6 +202,8 @@ a2 \times 2/3 { b4 b b } c4 c \times 2/3 { b4 a g } @end lilypond +@cindex tuplet bracket placement + @funindex \tupletUp @funindex tupletUp @funindex \tupletDown @@ -241,6 +247,8 @@ see @ref{Scaling durations}. @lilypondfile[verbatim,lilyquote,ragged-right,texidoc,doctitle] {entering-several-tuplets-using-only-one--times-command.ly} +@cindex Tuplet number changes + @funindex TupletNumber @lilypondfile[verbatim,lilyquote,ragged-right,texidoc,doctitle] @@ -275,9 +283,9 @@ Internals Reference: @rinternals{TupletNumber}, @rinternals{TimeScaledMusic}. +@cindex grace notes within tuplet brackets @knownissues -@cindex grace notes within tuplet brackets When the first note on a staff is a grace note followed by a tuplet the grace note must be placed before the @code{\times} command to avoid errors. Anywhere else, grace notes may be @@ -318,6 +326,7 @@ a multiplier. This is useful for skipping many measures, e.g., @code{s1*23}. @cindex compressing music +@cindex expanding music @funindex \scaleDurations @funindex scaleDurations @@ -535,6 +544,7 @@ Rests are entered as part of the music in music expressions. @node Rests @unnumberedsubsubsec Rests + @cindex rest @cindex rest, entering durations @cindex maxima rest @@ -774,9 +784,12 @@ R2.*2 | @cindex multi-measure rest, script @cindex fermata on multi-measure rest @cindex multi-measure rest, attaching fermata +@cindex markup on multi-measure rest +@cindex multi-measure rest with markup @funindex \fermataMarkup @funindex fermataMarkup +@funindex MultiMeasureRestText Markups can be added to multi-measure rests. The predefined command @code{\fermataMarkup} @@ -809,6 +822,17 @@ When a multi-measure rest immediately follows a @code{\partial} setting, resulting bar-check warnings may not be displayed. +@funindex \textLengthOn +@funindex textLengthOn +@funindex \textLengthOff +@funindex textLenthOff +@funindex \fermataMarkup +@funindex fermataMarkup +@funindex \compressFullBarRests +@funindex compressFullBarRests +@funindex \expandFullBarRests +@funindex expandFullBarRests + @predefined @code{\textLengthOn}, @code{\textLengthOff}, @@ -995,8 +1019,8 @@ Internals Reference: @cindex measure, partial @cindex pickup measure @cindex measure, change length -@cindex measurePosition +@funindex measurePosition @funindex \partial @funindex partial @@ -1115,6 +1139,16 @@ Snippets: @rlsr{Rhythms}. +@cindex cadenza line breaks +@cindex cadenza page breaks +@cindex unmetered music, line breaks +@cindex unmetered music, page breaks +@cindex breaks in unmetered music +@cindex line breaks in cadenzas +@cindex page breaks in cadenzas +@cindex line breaks in unmetered music +@cindex page breaks in unmetered music + @knownissues LilyPond will insert line breaks and page breaks only at a @@ -1463,6 +1497,9 @@ c4 c8 c8. c16 c8. c16 c8 @end lilypond +@cindex melismata, beams +@cindex beams and melismata + @warning{If beams are used to indicate melismata in songs, then automatic beaming should be switched off with @code{\autoBeamOff} and the beams indicated manually.} @@ -1563,13 +1600,12 @@ group notes with beams, otherwise If there are no beam-ending rules defined for the beam duration of a 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 -@code{Voice} contexts to delimit their scope. The default values -are set while processing @code{\time} commands, so any @code{\set} -commands to modify their value must be placed after all @code{\time} -commands. +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. The default values are set while processing +@code{\time} commands, so any @code{\set} commands to modify their +value must be placed after all @code{\time} commands. @warning{These three properties become effective for a particular beam @strong{only} if there are no beam-ending rules predefined for @@ -1636,6 +1672,12 @@ beats in each group. @cindex grouping beats @cindex measure sub-grouping +@funindex autoBeamSettings +@funindex beam-limit +@funindex beam-numerator +@funindex beam-denominator + + @lilypondfile[verbatim,lilyquote,ragged-right,texidoc,doctitle] {conducting-signs,-measure-grouping-signs.ly} @@ -1677,20 +1719,28 @@ defined. This can be either @code{begin} or @code{end} but only @code{end} is effective. @item @code{beam-numerator/beam-denominator} is the beam duration -to which the rule is to apply. A beam is considered to have -the duration of its shortest note. Set @code{beam-numerator} -and @code{beam-denominator} to @code{'*'} to have this rule apply -to beams of any duration. +to which the rule is to apply. A beam is considered to have the +duration of its shortest note. Set @code{beam-numerator} and +@code{beam-denominator} to @code{'*'} to have this rule apply to beams +of any duration. + +@funindex time-signature-numerator +@funindex time-signature-denominator @item @code{time-signature-numerator/time-signature-denominator} -specifies the time signature to which this rule should apply. -If @code{time-signature-numerator} and -@code{time-signature-denominator} are set to @code{'*'} this rule -will apply in any time signature. +specifies the time signature to which this rule should apply. If +@code{time-signature-numerator} and @code{time-signature-denominator} +are set to @code{'*'} this rule will apply in any time signature. -@item @code{monent-numerator/moment-denominator} is the position +@funindex moment-numerator +@funindex moment-denominator + +@item @code{moment-numerator/moment-denominator} is the position in the bar at which the beam should end. +@funindex score-override-auto-beam-setting +@funindex override-auto-beam-setting + @item @code{context} is optional, and it specifies the context at which the change should be made. The default is @code{'Voice}. @@ -1761,6 +1811,8 @@ automatic beam settings in @file{scm/@/auto@/-beam@/.scm} for possible interference, because the beam endings defined there will still apply in addition to your own.} +@funindex revert-auto-beam-setting + Any unwanted or conflicting default endings must be reverted for your time signature(s). Existing default or user-defined beam-ending rules are removed by using @@ -1905,6 +1957,7 @@ g a] @unnumberedsubsubsec Feathered beams @cindex beams, feathered +@cindex feathered beams @funindex \featherDurations @funindex featherDurations @@ -1917,12 +1970,12 @@ feathered beam must be indicated manually using @code{[} and @code{]}, and the beam feathering is turned on by specifying a direction to the @code{Beam} property @code{grow-direction}. -If the placement of the notes and the sound in the MIDI output -is to reflect the ritardando or accelerando indicated by the -feathered beam the notes must be grouped as a -music expression delimited by braces and preceded by a -@code{featheredDurations} command which specifies the ratio -between the durations of the first and last notes in the group. +If the placement of the notes and the sound in the MIDI output is to +reflect the ritardando or accelerando indicated by the feathered beam +the notes must be grouped as a music expression delimited by braces +and preceded by a @code{featherDurations} command which specifies +the ratio between the durations of the first and last notes in the +group. The square brackets show the extent of the beam and the braces show which notes are to have their durations modified. Normally these @@ -1978,6 +2031,10 @@ Snippets: @cindex bar lines @cindex measure lines +@cindex closing bar lines +@cindex bar lines, closing +@cindex double bar lines +@cindex bar lines, double @cindex repeat bars @funindex \bar @@ -2111,6 +2168,9 @@ connected between different staves of a @code{StaffGroup}, @end lilypond +@cindex default bar lines, changing +@cindex bar lines, default, changing + @snippets @funindex whichBar @@ -2169,6 +2229,7 @@ c1 c c c @cindex bar numbers, regular spacing @funindex barNumberVisibility +@funindex BarNumber Bar numbers can be typeset at regular intervals instead of just at the beginning of every line. To do this the default behavior @@ -2299,10 +2360,10 @@ pipeSymbol = \bar "||" @funindex \barNumberCheck @funindex barNumberCheck -When copying large pieces of music, it can be helpful to check -that the LilyPond bar number corresponds to the original that you -are entering from. This can be checked with -@code{\barNumberCheck}, for example, +When copying large pieces of music, it can be helpful to check that +the LilyPond bar number corresponds to the original that you are +entering from. This can be checked with @code{\barNumberCheck}, for +example, @verbatim \barNumberCheck #123 @@ -2359,6 +2420,7 @@ mark manually. The value to use is stored in the property @cindex rehearsal mark, manual @cindex mark, rehearsal, manual @cindex custom rehearsal mark +@cindex manual rehearsal mark The style is defined by the property @code{markFormatter}. It is a function taking the current mark (an integer) and the current @@ -2407,7 +2469,7 @@ string. @cindex segno @cindex coda -@cindex D.S al Fine +@cindex D.S. al Fine @cindex fermata @cindex music glyphs @cindex glyphs, music @@ -2549,6 +2611,10 @@ note after a space lasting 7/8 of the main note. } @end lilypond +@cindex tweaking grace notes +@cindex grace notes, tweaking +@cindex grace notes, changing layout settings + A @code{\grace} music expression will introduce special typesetting settings, for example, to produce smaller type, and set directions. Hence, when introducing layout tweaks to @@ -2602,6 +2668,10 @@ Internals Reference: @rinternals{GraceMusic}. @knownissues +@cindex acciaccatura, multi-note +@cindex multi-note acciaccatura +@cindex grace-note synchronization + A multi-note beamed @i{acciaccatura} is printed without a slash, and looks exactly the same as a multi-note beamed @i{appoggiatura}. -- 2.39.5