* lily/context-property.cc (execute_general_pushpop_property):

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

diff --git a/Documentation/user/basic-notation.itely b/Documentation/user/basic-notation.itely
index 999ef0bf8e2a0c3ec6331f68b7f59c26c1d20438..bde43e6dcd8878595a96d5cd0d3216d13592ad02 100644 (file)
--- a/Documentation/user/basic-notation.itely
+++ b/Documentation/user/basic-notation.itely
@@ -1,4 +1,4 @@
-@c -*- coding: latin-1; mode: texinfo; -*-
+@c -*- coding: utf-8; mode: texinfo; -*-
 @c This file is part of lilypond.tely
 
 @c A menu is needed before every deeper *section nesting of @node's; run
@@ -42,6 +42,7 @@ related constructs, such as stems, tuplets and ties.
 * Augmentation dots::           
 * Tuplets::                     
 * Scaling durations::           
+* Stems::
 @end menu
 
 
@@ -482,6 +483,22 @@ b16*4 c4
 This manual: @ref{Tuplets}
 
 
+@node Stems
+@subsection Stems
+
+Whenever a note is found, a @internalsref{Stem} object is created
+automatically.  For whole notes and rests, they are also created but
+made invisible.
+
+@refcommands
+
+@cindex @code{\stemUp}
+@code{\stemUp},
+@cindex @code{\stemDown}
+@code{\stemDown},
+@cindex @code{\stemNeutral}
+@code{\stemNeutral}.
+
 
 @node Alternate music entry
 @section Alternate music entry
@@ -537,8 +554,9 @@ between this and the last note is always taken to be a fourth or
 less.  This distance is determined without regarding alterations; a
 @code{fisis} following a @code{ceses} will be put above the
 @code{ceses}.  In other words, a doubly-augmented fourth is considered
-a smaller interval than a diminshed fifth, even though the fourth is
-seven semitones while the fifth is only six semitones.
+a smaller interval than a diminished fifth, even though the
+doubly-augmented fourth spans seven semitones while the diminished
+fifth only spans six semitones.
 
 The octave changing marks @code{'} and @code{,} can be added to raise
 or lower the pitch by an extra octave.  Upon entering relative mode,
@@ -1509,9 +1527,6 @@ Program reference: @internalsref{Tie}.
 
 Switching staves when a tie is active will not produce a slanted tie.
 
-Formatting of ties is a difficult subject.  The results are often not
-optimal.
-
 
 @node Slurs
 @subsection Slurs
@@ -1785,6 +1800,8 @@ every eighth grace note
    \new Staff { c4 \grace { g8[ b] } c4 } >>
 @end lilypond
 
+@cindex @code{\afterGrace}
+
 If you want to end a note with a grace, use the @code{\afterGrace}
 command.  It takes two arguments: the main note, and the grace notes
 following the main note. 
@@ -1855,6 +1872,9 @@ Another option is to change the variables @code{startGraceMusic},
 @code{stopAppoggiaturaMusic}.  More information is in the file
 @file{ly/@/grace@/-init@/.ly}.
 
+@noindent
+The slash through the stem in acciaccaturas can be obtained
+in other situations by @code{\override Stem  #'stroke-style = #"grace"}.
 
 @seealso
 
@@ -1877,7 +1897,8 @@ care when you mix staves with grace notes and staves without, for example,
 @end lilypond
 
 @noindent
-This can be remedied by inserting grace skips, for the above example
+This can be remedied by inserting grace skips of the corresponding
+durations in the other staves. For the above example
 
 @example
 \new Staff @{ c4 \bar "|:" \grace s16 d4 @}
@@ -2110,6 +2131,11 @@ use spacer notes if multiple marks are needed during one note
 c\< c\! d\> e\!
 << f1 { s4 s4\< s4\! \> s4\! } >>
 @end lilypond
+
+@noindent
+A hairpin starts at the left edge of the beginning note and ends on the
+right edge of the ending note.
+
 This may give rise to very short hairpins.  Use @code{minimum-length}
 in @internalsref{Voice}.@internalsref{Hairpin} to lengthen them, for
 example
@@ -2146,6 +2172,18 @@ To create new dynamic marks or text that should be aligned
 with dynamics, see @ref{New dynamic marks}.
 
 
+@commonprop
+
+Dynamics that occur at, begin on, or end on, the same note
+will be vertically aligned.  If you want to ensure that dynamics
+are aligned when they do not occur on the same note, you can
+increase the @code{staff-padding} property.
+
+@example
+\override DynamicLineSpanner #'staff-padding = 4
+@end example
+
+
 @refcommands
 
 @cindex @code{\dynamicUp}
@@ -2934,9 +2972,19 @@ Percent repeats must be declared within a @code{Voice} context.
 }
 @end lilypond
 
-Isolated percents can also be printed. This is done by putting a multi
-measure rest, with a different print function,
+Measure repeats of more than 2 measures get a counter, if you switch
+on the @code{countPercentRepeats} property,
 
+@lilypond[relative=2,fragment,quote,verbatim,raggedright]
+\set countPercentRepeats = ##t
+\new Voice
+  \repeat "percent" 4 { c1 }
+@end lilypond
+
+
+
+Isolated percents can also be printed. This is done by putting a multi
+measure rest with a different print function,
 
 @lilypond[fragment,verbatim]
 \override MultiMeasureRest #'print-function
@@ -2945,6 +2993,8 @@ R1
 @end lilypond
 
 
+
+
 @seealso
 
 Program reference: @internalsref{RepeatSlash},