Re: Doc: NR 1.2.6 added slashedGrace function (issue 5133043)

[pkx166h]

Reviewers: Neil Puttock,

Message:
Second draft with Neil's suggestions. Thank you Neil.


http://codereview.appspot.com/5133043/diff/1/Documentation/changes.tely
File Documentation/changes.tely (right):

http://codereview.appspot.com/5133043/diff/1/Documentation/changes.tely#newcode65
Documentation/changes.tely:65: There is a new @code{\slashedGrace}
function:
On 2011/09/25 14:37:17, Neil Puttock wrote:
> This is already documented in changes.itely

Thanks, I didn't notice. Removed.

http://codereview.appspot.com/5133043/diff/1/Documentation/notation/rhythms.itely
File Documentation/notation/rhythms.itely (right):

http://codereview.appspot.com/5133043/diff/1/Documentation/notation/rhythms.itely#newcode3051
Documentation/notation/rhythms.itely:3051: grace notes with a slashed
stem using the @code{\slashedGrace} function.
On 2011/09/25 14:37:17, Neil Puttock wrote:
> Need to explain why.  \slashedGrace doesn't have a slur, so its main
use would
> be to show a note sounded early via a tie.

Redid the paragraph and included, I hope, a better example.

Thanks

Description:
Doc: NR 1.2.6 added slashedGrace function

New \slashedGrace function added to NR and Changes.

This is for Tracker issue 1778

Please review this at http://codereview.appspot.com/5133043/

Affected files:
  M Documentation/notation/rhythms.itely


Index: Documentation/notation/rhythms.itely
diff --git a/Documentation/notation/rhythms.itely  
b/Documentation/notation/rhythms.itely
index  
d91a40de99ee97d3df414e083c56569320ca6045..89232888ae7c622a17a4f62611e40e0bc37e1a96  
100644
--- a/Documentation/notation/rhythms.itely
+++ b/Documentation/notation/rhythms.itely
@@ -3043,33 +3043,39 @@ Internals Reference:
 @cindex acciaccatura

 @funindex \grace
address@hidden grace
address@hidden \slashedGrace
address@hidden \acciaccatura
address@hidden \appoggiatura

-Grace notes are ornaments that are written out.  Grace notes
-are printed in a smaller font and take up no logical time
-in a measure.
+Grace notes are musical ornaments, printed in a smaller font, that take
+up no additional logical time in a measure.

 @lilypond[quote,relative=2,verbatim]
-c4 \grace c16 c4
-\grace { c16[ d16] } c2
+c4 \grace b16 a4(
+\grace { b16[ c16] } a2)
 @end lilypond

-LilyPond also supports two special types of grace notes, the
+There are three other types of grace notes possible; the
 @emph{acciaccatura} -- an unmeasured grace note indicated by a slurred
-small note with a slashed stem -- and the @emph{appoggiatura}, which
-takes a fixed fraction of the main note and appears in small print
-without a slash.
+note with a slashed stem -- and the @emph{appoggiatura}, which takes a
+fixed fraction of the main note it is attached to and prints without the
+slash.  It is also possible to write a grace note with a slashed stem,
+like the @emph{acciaccatura} but without the slur, so as to place it
+between notes that are slurred themselves, using the
address@hidden function.

 @lilypond[quote,relative=2,verbatim]
-\grace c8 b4
 \acciaccatura d8 c4
 \appoggiatura e8 d4
-\acciaccatura { g16[ f] } e4
+\acciaccatura { g16[ f] } e2
+\slashedGrace a,8 g4
+\slashedGrace b16 a4(
+\slashedGrace b8 a2)
 @end lilypond

-The placement of grace notes is synchronized between different
-staves.  In the following example, there are two sixteenth grace
-notes for every eighth grace note
+The placement of grace notes is synchronized between different staves.
+In the following example, there are two sixteenth grace notes for every
+eighth grace note

 @lilypond[quote,relative=2,verbatim]
 <<