From: James Lowe <pkx166h@gmail.com>
Date: Thu, 19 Dec 2013 23:35:50 +0000 (+0000)
Subject: Doc: Add @knownissue for AddLyrics with Nullvoice
X-Git-Tag: release/2.19.0-1~39
X-Git-Url: https://git.donarmstrong.com/?a=commitdiff_plain;h=196a1ace684e52c3f6bab452780f90ff405b5564;p=lilypond.git

Doc: Add @knownissue for AddLyrics with Nullvoice

Issue 3654
---

diff --git a/Documentation/notation/vocal.itely b/Documentation/notation/vocal.itely
index f168dc9e13..06aa65d46d 100644
--- a/Documentation/notation/vocal.itely
+++ b/Documentation/notation/vocal.itely
@@ -1694,9 +1694,8 @@ words = \lyricmode { la __ la __ }
 >>
 @end lilypond
 
-The @code{NullVoice} context must be inside a @code{Staff}
-context, and should only contain notes that are already being
-displayed in that staff, and in the same octave.  Otherwise the
+The @code{NullVoice} context must be placed within a @code{Staff}
+context and contain notes that are already being displayed in that staff and that are also in the same octave.  Otherwise the
 @code{NullVoice} may interact with the printed voices in
 unexpected ways.  For example, arbitrary notes in the
 @code{NullVoice} may cause accidentals to appear (or disappear) on
@@ -1718,6 +1717,10 @@ words = \lyricmode { la __ la __ }
 >>
 @end lilypond
 
+@knownissues
+The @code{\addLyrics} function only works with @code{Voice} lyrics
+and so cannot be used with @code{NullVoice}.
+
 @noindent
 The @code{\partcombine} function is described in
 @ref{Automatic part combining}.