* Documentation/topdocs/NEWS.tely (Top): add entry for percent

[lilypond.git] / Documentation / user / basic-notation.itely

diff --git a/Documentation/user/basic-notation.itely b/Documentation/user/basic-notation.itely
index d9eb97974f42d9d1e42244dd5aa79e7d57cc4a9b..607054fc3d998f6daa58dd99b550c584f36891cb 100644 (file)
--- a/Documentation/user/basic-notation.itely
+++ b/Documentation/user/basic-notation.itely
@@ -163,10 +163,11 @@ print them manually.  A reminder accidental
 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
 
 
@@ -231,7 +232,8 @@ r1 r2 r4 r8
 @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}.
 
 
@@ -404,6 +406,16 @@ length
 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}
@@ -437,16 +449,15 @@ denominator, but if it is set to the Scheme function
 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
@@ -1460,11 +1471,13 @@ lines.
 
 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
 
 
@@ -2204,6 +2217,8 @@ Long running trills are made with @code{\startTrillSpan} and
 
 @seealso
 
+This manual: @ref{Pitched trills}.
+
 Program reference: @internalsref{TrillSpanner}.
 
 
@@ -2922,7 +2937,9 @@ Percent repeats must be declared within a @code{Voice} context.
 
 @seealso
 
-Program reference: @internalsref{RepeatSlash}, @internalsref{PercentRepeat},
+Program reference: @internalsref{RepeatSlash},
+@internalsref{PercentRepeat}, @internalsref{DoublePercentRepeat},
+@internalsref{DoublePercentRepeatCounter},
+@internalsref{PercentRepeatCounter},
 @internalsref{PercentRepeatedMusic}, and
-@internalsref{DoublePercentRepeat}.