Doc: NR 2.1 Vocal: remove one TODO and add four more :(

 - \lyrics is not documented anywhere else, and is
   deprecated

 - Issue 329 is marked Verified so is presumably fixed.
   Even if it isn't, we don't document bugs.  This example
   shows why not.  It takes years for the docs to catch up.

diff --git a/Documentation/notation/vocal.itely b/Documentation/notation/vocal.itely
index 1962fe5d143a709be0848f18ea0957096ffb7402..c1441d085da920cfbec6af7ebc29f565b5c9742a 100644 (file)
--- a/Documentation/notation/vocal.itely
+++ b/Documentation/notation/vocal.itely
@@ -681,6 +681,8 @@ Internals Reference:
 @node Working with lyrics and variables
 @unnumberedsubsubsec Working with lyrics and variables
 
+@c TODO rewrite this section
+
 @cindex lyrics, variables
 
 To define variables containing lyrics, the function @code{\lyricmode}
@@ -731,39 +733,6 @@ The final input would resemble
 >>
 @end example
 
-@ignore
-@c TODO
-http://code.google.com/p/lilypond/issues/detail?id=329
-The problem cannot be reproduced.
-The following has no sense, because the issue seems to be fixed.
-A comment is in tracker waiting for response ---FV
-
-
-Be careful when defining a variable with lyrics that creates a new
-context, for example, using the deprecated @code{\lyrics} command.  See
-the next erroneous example:
-
-@example
-words = \lyrics{ %warning: this creates a new context
- one two
-}
-<<
-  \new Voice = "sop" { c1 }
-  \new Lyrics \lyricsto "sop" { \words }
-  \new Voice = "alt" { c2 c }
-  \new Lyrics \lyricsto "alt" { \words }
->>
-@end example
-
-the problem is that \lyricsto will try to connect the "sop" melody with the context
-created by "\new Lyrics".
-
-Then \lyrics in \words creates another context, and the original "\new Lyrics" one
-remains empty.
-
-@end ignore
-
-
 @seealso
 @c TODO: document \new Staff << Voice \lyricsto >> bug
 Internals Reference:
@@ -1163,6 +1132,7 @@ contexts and attaching lyrics to those specific contexts.
 >> }
 @end lilypond
 
+@c TODO remove this example - it's already shown in Repeats
 
 You can use this trick to display different lyrics for a repeated
 section.
@@ -1189,6 +1159,9 @@ section.
 @node Lyrics independent of notes
 @unnumberedsubsubsec Lyrics independent of notes
 
+@c TODO remove this section?  Don't use DevNull 
+@c should be all in Manual Syllable durations
+
 @cindex Devnull context
 
 In some complex vocal music, it may be desirable to place
@@ -1230,6 +1203,8 @@ the implicit melismata get ignored.
 @node Spacing out syllables
 @unnumberedsubsubsec Spacing out syllables
 
+@c TODO move to second item
+
 @cindex Spacing lyrics
 @cindex Lyrics, increasing space between