Docs: NR 2.1.5 Stanzas: Add warning

 - \once with \set ignoreMelismata = ##t does not work

diff --git a/Documentation/user/vocal.itely b/Documentation/user/vocal.itely
index a58503b2f2a72e0d2a026de4927a728b3de94054..7f68e263fe211d016cd88f0b3c5569b780a9a3ae 100644 (file)
--- a/Documentation/user/vocal.itely
+++ b/Documentation/user/vocal.itely
@@ -1096,9 +1096,6 @@ multiple syllables in another one.  One solution is to make the faster
 voice ignore the melisma.  This is done by setting
 @code{ignoreMelismata} in the Lyrics context.
 
-
-@c  TODO: breaks compile
-@c seems to be fixed, does not break compile anymore --FV
 @lilypond[verbatim,ragged-right,quote]
 <<
   \relative c' \new Voice = "lahlah" {
@@ -1121,6 +1118,11 @@ voice ignore the melisma.  This is done by setting
 >>
 @end lilypond
 
+@knownissues
+Unlike most @code{\set} commands, @code{\set ignoreMelismata} does
+not work if prefixed with @code{\once}.  It is necessary to use
+@code{\set} and @code{\unset} to bracket the lyrics where melismata
+are to be ignored.
 
 @subsubheading Switching to an alternative melody