From 3930f57e6ccb6e7b1190d80055031733a45eae32 Mon Sep 17 00:00:00 2001
From: jlowe <james.lowe@datacore.com>
Date: Sat, 5 Mar 2011 14:04:52 +0000
Subject: [PATCH] DOC: NR at another @knownissue for Grace Notes

Add known issue for Grace Notes used in 'many' voices

Currently this is Tracker Issue 667

@lilypond example shows how to overcome grace note issues in 'complex' voice settings
---
 Documentation/notation/rhythms.itely | 28 ++++++++++++++++++++++++++++
 1 file changed, 28 insertions(+)

diff --git a/Documentation/notation/rhythms.itely b/Documentation/notation/rhythms.itely
index 40fc4ec610..e2ab6d2230 100644
--- a/Documentation/notation/rhythms.itely
+++ b/Documentation/notation/rhythms.itely
@@ -3212,10 +3212,38 @@ durations in the other staves.  For the above example
 >>
 @end lilypond
 
+The use of grace notes within voice contexts confuses the way the
+voice is typeset. This can be overcome by inserting a rest or note
+between the voice command and the grace note.
+
+@lilypond[quote,verbatim]
+accMusic = {
+  \acciaccatura { f8 } e8 r8 \acciaccatura { f8 } e8 r4
+}
+
+\new Staff {
+  <<
+    \new Voice {
+      \relative c'' {
+        r8 r8 \voiceOne \accMusic \oneVoice r8 |
+        r8 \voiceOne r8 \accMusic \oneVoice r8 |
+      }
+    }
+    \new Voice {
+      \relative c' {
+        s8 s8 \voiceTwo \accMusic \oneVoice s8 |
+        s8 \voiceTwo r8 \accMusic \oneVoice s8 |
+      }
+    }
+  >>
+}
+@end lilypond
+
 Grace sections should only be used within sequential music
 expressions.  Nesting or juxtaposing grace sections is not
 supported, and might produce crashes or other errors.
 
+
 @node Aligning to cadenzas
 @unnumberedsubsubsec Aligning to cadenzas
 
-- 
2.39.5