can be forced by adding an exclamation mark @code{!}
after the pitch. A cautionary accidental
(i.e., an accidental within parentheses) can be obtained by adding the
-question mark `@code{?}' after the pitch.
+question mark `@code{?}' after the pitch. These extra accidentals
+can be used to produce natural signs, too.
@lilypond[quote,raggedright,fragment,verbatim]
-cis' cis' cis'! cis'?
+cis' cis' cis'! cis'? c c? c! c
@end lilypond
@end lilypond
Whole bar rests, centered in middle of the bar,
-must be done with multi-measure rests. They are discussed in
+must be done with multi-measure rests. They can be used for a
+single bar as well as many bars, and are discussed in
@ref{Multi measure rests}.
g'4 \times 2/3 {c'4 c' c'} d'4 d'4
@end lilypond
+Tuplets may be nested, for example,
+
+@lilypond[fragment,raggedright,verbatim,relative=2]
+\set tupletNumberFormatFunction = #fraction-tuplet-formatter
+\times 4/6 {
+ a4 a
+ \times 3/5 { a a a a a }
+}
+@end lilypond
+
@refcommands
@cindex @code{\tupletUp}
instead.
+
+
+
@seealso
Program reference: @internalsref{TupletBracket}, and @internalsref{TimeScaledMusic}.
+Examples: @inputfileref{input/@/regression,tuplet@/-nest@/.ly}.
-@refbugs
-
-Nested tuplets are not formatted automatically. In this case, outer
-tuplet brackets should be moved manually, which is demonstrated in
-@inputfileref{input/@/regression,tuplet@/-nest@/.ly}.
@node Scaling durations
* Octave check::
* Transpose::
* Bar check::
+* Barnumber check::
* Skipping corrected music::
* Automatic note splitting::
@end menu
@seealso
-Program reference: @internalsref{TransposedMusic}, and
-@internalsref{UntransposableMusic}.
+Program reference: @internalsref{TransposedMusic}.
@refbugs
@end lilypond
+@node Barnumber check
+@subsection Barnumber check
+
+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
+@end verbatim
+
+@noindent
+will print a warning if the @code{currentBarNumber} is not 123 when it
+is processed.
+
+
@node Skipping corrected music
@subsection Skipping corrected music
+
@cindex @code{skipTypesetting}
+@cindex @code{showLastLength}
-The property @code{Score.skipTypesetting} can be used to switch on and
-off typesetting completely during the interpretation phase. When
-typesetting is switched off, the music is processed much more
-quickly. This can be used to skip over the parts of a score that
-have already been checked for errors
+When entering or copying music, only the music near the end (where you
+are adding notes) is interesting to view and correct. To speed up
+this correction process, it is possible to skip typesetting of all but
+the last few measures. This is achieved by putting
+
+@verbatim
+showLastLength = R1*5
+\score { ... }
+@end verbatim
+
+@noindent
+in your source file. This will render only the last 5 measures
+(assuming 4/4 time signature) of every @code{\score} in the input
+file. For longer pieces, rendering only a small part is often an order
+of magnitude quicker than rendering it completely
+
+Skipping parts of a score can be controlled in a more fine-grained
+fashing with the property @code{Score.skipTypesetting}. When it is
+set, no typesetting is performed at all.
@lilypond[quote,fragment,raggedright,verbatim]
\relative c'' {
@seealso
-Program reference: @internalsref{TimeSignature}, and @internalsref{Timing_engraver}.
+Program reference: @internalsref{TimeSignature}, and @internalsref{Timing_translator}.
@refbugs
>>
@end lilypond
+
+@commonprop
+
@cindex @code{whichBar}
@cindex @code{repeatCommands}
@cindex @code{defaultBarType}
@cindex brace, vertical
@cindex grand staff
@cindex staff group
+@cindex staff, choir
Many scores consist of more than one staff. These staves can be
-joined in three different ways
+joined in four different ways
@itemize @bullet
@item The group is started with a brace at the left, and bar lines are
>>
@end lilypond
+@item The group is started with a bracket, but bar lines are not
+connected. This is done with the @internalsref{ChoirStaff} context.
+
+@lilypond[verbatim,raggedright,quote]
+\new ChoirStaff
+\relative <<
+ \new Staff { c1 c }
+ \new Staff { c c }
+>>
+@end lilypond
+
@item The group is started with a vertical line. Bar lines are not
connected. This is the default for the score.
Ties are sometimes used to write out arpeggios. In this case, two tied
notes need not be consecutive. This can be achieved by setting the
-@code{tieWaitForNote} property to true. For example,
+@code{tieWaitForNote} property to true. The same feature is also useful,
+for example, to tie a tremolo to a chord. For example,
@lilypond[fragment,verbatim,relative=1,raggedright]
\set tieWaitForNote = ##t
-\grace { c16[~ e~ g]~ } <c, e g>4
+\grace { c16[~ e~ g]~ } <c, e g>2
+\repeat "tremolo" 8 { c32~ c'~ } <c c,>1
@end lilypond
@code{\tieNeutral},
@cindex @code{\tieDotted}
@code{\tieDotted},
+@cindex @code{\tieDashed}
+@code{\tieDashed},
@cindex @code{\tieSolid}
@code{\tieSolid}.
@seealso
+This manual: @ref{Pitched trills}.
+
Program reference: @internalsref{TrillSpanner}.
@lilypond[quote,verbatim,fragment,linewidth=8.0\cm]
\unfoldRepeats {
\repeat tremolo 8 {c'32 e' }
- \repeat percent 4 { c''8 d'' }
+ \repeat percent 2 { c''8 d'' }
\repeat volta 2 {c'4 d' e' f'}
\alternative {
{ g' a' a' g' }
@seealso
-Program reference: @internalsref{RepeatSlash}, @internalsref{PercentRepeat},
+Program reference: @internalsref{RepeatSlash},
+@internalsref{PercentRepeat}, @internalsref{DoublePercentRepeat},
+@internalsref{DoublePercentRepeatCounter},
+@internalsref{PercentRepeatCounter},
@internalsref{PercentRepeatedMusic}, and
-@internalsref{DoublePercentRepeat}.