@funindex \stopTrillSpan
@funindex stopTrillSpan
-Short @notation{trills} without an extender line are printed with
+Short trills without an extender line are printed with
@code{\trill}; see @ref{Articulations and ornamentations}.
Longer trills with an extender line are made with
@code{\startTrillSpan} and @code{\stopTrillSpan}:
@lilypond[verbatim,quote,relative=2]
-d1~\startTrillSpan
+d1\startTrillSpan
d1
-c2\stopTrillSpan r2
+c2\stopTrillSpan
+r2
@end lilypond
-In the following example, a trill is combined with grace notes.
-The syntax of this construct and the method to precisely position
-the grace notes are described in @ref{Grace notes}.
+A trill spanner crossing a line break will restart exactly above
+the first note on the new line.
+
+@lilypond[ragged-right,verbatim,quote,relative=2]
+d1\startTrillSpan
+\break
+d1
+c2\stopTrillSpan
+r2
+@end lilypond
+
+Consecutive trill spans will work without explicit
+@code{\stopTrillSpan} commands, since successive trill spanners will
+automatically become the right bound of the previous trill.
+
+@lilypond[verbatim,quote,relative=2]
+d1\startTrillSpan
+d1
+b1\startTrillSpan
+d2\stopTrillSpan
+r2
+@end lilypond
+
+Trills can also be combined with grace notes. The syntax of this
+construct and the method to precisely position the grace notes are
+described in @ref{Grace notes}.
@lilypond[verbatim,quote,relative=2]
-c1 \afterGrace
+d1~\afterGrace
d1\startTrillSpan { c32[ d]\stopTrillSpan }
-e2 r2
+c2 r2
@end lilypond
@cindex pitched trills
argument is the main note, and the second is the @emph{trilled}
note, printed as a stemless note head in parentheses.
-@lilypond[verbatim,quote,relative=1]
-\pitchedTrill e2\startTrillSpan fis
-d\stopTrillSpan
+@lilypond[verbatim,quote,relative=2]
+\pitchedTrill
+d2\startTrillSpan fis
+d2
+c2\stopTrillSpan
+r2
@end lilypond
-@cindex pitched trill with forced accidental
-@cindex trill, pitched with forced accidental
-@cindex accidental, forced for pitched trill
+@cindex pitched trill with accidental
+@cindex trill with accidental
-In the following example, the second pitched trill is ambiguous;
-the accidental of the trilled note is not printed. As a
-workaround, the accidentals of the trilled notes can be forced.
-The second measure illustrates this method:
+Subsequent accidentals of the same note in the same measure will need
+to be added manually. Only the accidental of the first pitched trill
+in a measure is printed.
@lilypond[verbatim,quote,relative=2]
-\pitchedTrill eis4\startTrillSpan fis
-g\stopTrillSpan
-\pitchedTrill eis4\startTrillSpan fis
-g\stopTrillSpan
-\pitchedTrill eis4\startTrillSpan fis
-g\stopTrillSpan
-\pitchedTrill eis4\startTrillSpan fis!
-g\stopTrillSpan
+\pitchedTrill
+eis4\startTrillSpan fis
+eis4\stopTrillSpan
+\pitchedTrill
+eis4\startTrillSpan cis
+eis4\stopTrillSpan
+\pitchedTrill
+eis4\startTrillSpan fis
+eis4\stopTrillSpan
+\pitchedTrill
+eis4\startTrillSpan fis!
+eis4\stopTrillSpan
@end lilypond
@code{\stopTrillSpan}.
@endpredefined
-
@seealso
Music Glossary:
@rglos{trill}.
@lilypondfile[verbatim,lilyquote,texidoc,doctitle]
{ambitus-with-multiple-voices.ly}
+@lilypondfile[verbatim,lilyquote,texidoc,doctitle]
+{change-ambitus-gap.ly}
+
@seealso
Music Glossary:
@end example
@noindent
-where @var{musicexpr} is a music expression. Alternate endings can be
-produced using @code{\alternative}. In order to delimit the alternate
-endings, the group of alternatives must be enclosed in a set of
-braces. If there are more repeats than there are alternate endings,
-the earliest repeats are given the first alternative.
+where @var{musicexpr} is a music expression.
-Normal repeats without alternate endings:
+A single repeat without an alternate ending:
@lilypond[verbatim,quote,relative=2]
\repeat volta 2 { c4 d e f }
\repeat volta 2 { d4 e f g }
@end lilypond
-Normal repeats with alternate endings:
+Alternative endings can be produced using @code{\alternative}. Each
+group of alternatives must be themselves, enclosed in a set of braces.
+
+@example
+\repeat volta @var{repeatcount} @var{musicexpr}
+\alternative @{
+ @{ @var{musicexpr} @}
+@}
+@end example
+
+@noindent
+where @var{musicexpr} is a music expression.
+
+If there are more repeats than there are alternate endings, the earliest
+repeats are given the first alternative.
+
+A single repeat with one alternate ending:
+
+@lilypond[verbatim,quote,relative=2]
+\repeat volta 2 { c4 d e f }
+\alternative {
+ { c2 e }
+ { f2 g }
+}
+c1
+@end lilypond
+
+A single repeat with more than one alternate ending:
@lilypond[verbatim,quote,relative=2]
\repeat volta 4 { c4 d e f }
\alternative {
- { d2 e }
+ { c2 e }
+ { f2 g }
+}
+c1
+@end lilypond
+
+Multiple repeats with more than one alternate ending:
+
+@lilypond[verbatim,quote,relative=2]
+\repeat volta 3 { c4 d e f }
+\alternative {
+ { c2 e }
{ f2 g }
+ { a2 g }
}
c1
@end lilypond
@lilypondfile[verbatim,lilyquote,texidoc,doctitle]
{adding-volta-brackets-to-additional-staves.ly}
+@lilypondfile[verbatim,lilyquote,texidoc,doctitle]
+{set-double-repeat-default-volta.ly}
@seealso
Music Glossary:
--- /dev/null
+% Do not edit this file; it is automatically
+% generated from Documentation/snippets/new
+% This file is in the public domain.
+%% Note: this file works from version 2.13.26
+\version "2.13.26"
+\header {
+ lsrtags = "pitches"
+ texidoc = "It is possible to change the default gap setting for
+Ambitus."
+
+ doctitle = "change-ambitus-gap.ly"
+} % begin verbatim
+
+
+\layout {
+ \context {
+ \Voice
+ \consists "Ambitus_engraver"
+ } % begin verbatim
+
+}
+
+\new Staff {
+ \time 2/4
+ % Default setting
+ c'4 g''
+}
+
+\new Staff {
+ \time 2/4
+ \override AmbitusLine #'gap = #0
+ c'4 g''
+}
+
+\new Staff {
+ \time 2/4
+ \override AmbitusLine #'gap = #1
+ c'4 g''
+}
+
+\new Staff {
+ \time 2/4
+ \override AmbitusLine #'gap = #1.5
+ c'4 g''
+}
--- /dev/null
+\version "2.13.26"
+\header {
+ lsrtags = "pitches"
+ texidoc = "It is possible to change the default gap setting for
+ambitus."
+
+ doctitle = "Changing the ambitus gap"
+}
+
+
+\layout {
+ \context {
+ \Voice
+ \consists "Ambitus_engraver"
+ }
+}
+
+\new Staff {
+ \time 2/4
+ % Default setting
+ c'4 g''
+}
+
+\new Staff {
+ \time 2/4
+ \override AmbitusLine #'gap = #0
+ c'4 g''
+}
+
+\new Staff {
+ \time 2/4
+ \override AmbitusLine #'gap = #1
+ c'4 g''
+}
+
+\new Staff {
+ \time 2/4
+ \override AmbitusLine #'gap = #1.5
+ c'4 g''
+}
--- /dev/null
+\version "2.13.26"
+\header {
+ lsrtags = "repeats"
+ texidoc = "There are three different styles of double repeats for
+volte, that can be set using @code{doubleRepeatType}."
+
+ doctitle = "Setting the double repeat default for volte"
+}
+
+
+\relative c'' {
+ \repeat volta 1 { c1 }
+ \set Score.doubleRepeatType = #":|:"
+ \repeat volta 1 { c1 }
+ \set Score.doubleRepeatType = #":|.|:"
+ \repeat volta 1 { c1 }
+ \set Score.doubleRepeatType = #":|.:"
+ \repeat volta 1 { c1 }
+}
ambitus-with-multiple-voices.ly
ambitus.ly
applying-note-head-styles-depending-on-the-step-of-the-scale.ly
+change-ambitus-gap.ly
changing-the-interval-of-lines-on-the-stave.ly
clefs-can-be-transposed-by-arbitrary-amounts.ly
coloring-notes-depending-on-their-pitch.ly
percent-repeat-counter.ly
positioning-segno-and-coda-with-line-break.ly
printing-a-repeat-sign-at-the-beginning-of-a-piece.ly
+set-double-repeat-default-volta.ly
shortening-volta-brackets.ly
volta-below-chords.ly
volta-multi-staff.ly
--- /dev/null
+% Do not edit this file; it is automatically
+% generated from Documentation/snippets/new
+% This file is in the public domain.
+%% Note: this file works from version 2.13.26
+% Do not edit this file; it is automatically
+% generated from Documentation/snippets/new
+% This file is in the public domain.
+%% Note: this file works from version 2.13.26
+\version "2.13.26"
+\header {
+ lsrtags = "repeats"
+ texidoc = "There are three different styles of double repeats for
+volte, that can be set using @code{doubleRepeatType}."
+
+ doctitle = "set-double-repeat-volta.ly"
+} % begin verbatim
+
+
+\relative c'' {
+ \repeat volta 1 { c1 } % begin verbatim
+
+ \set Score.doubleRepeatType = #":|:"
+ \repeat volta 1 { c1 } % begin verbatim
+
+ \set Score.doubleRepeatType = #":|.|:"
+ \repeat volta 1 { c1 }
+ \set Score.doubleRepeatType = #":|.:"
+ \repeat volta 1 { c1 }
+}