Add todos.

diff --git a/Documentation/user/keyboards.itely b/Documentation/user/keyboards.itely
index d31b67a552f6e246b0b3a444b4d5e101ff80d15a..60a7ad89ea35a618fbaf50aaf592a7136b301aa0 100644 (file)
--- a/Documentation/user/keyboards.itely
+++ b/Documentation/user/keyboards.itely
@@ -11,6 +11,22 @@
 @node Keyboard instruments
 @section Keyboard instruments
 
+TODO
+My suggestion is this: in section 7.1.1 and/or 7.1.2 of the
+manual,
+about staff switching, add a sentence or two plus a simple example
+showing how the beams are handled automatically if you enter notes
+that
+require beaming (i.e. 8ths or shorter).  Anyone coming from Finale
+will
+be looking for "cross-staff beaming" instead of staff switching.
+If I
+had seen an example of notes switching staves, beamed together
+like
+that, I would have known immediately that that was what I was
+looking for.
+
+
 @menu
 * Common notation for keyboards::
 * Piano::

diff --git a/Documentation/user/vocal.itely b/Documentation/user/vocal.itely
index 6f9089de8c1bd2983890d376f214a607fb052692..91604b8f9d587fc538cf5f209f5e69689887663b 100644 (file)
--- a/Documentation/user/vocal.itely
+++ b/Documentation/user/vocal.itely
@@ -11,6 +11,31 @@
 @node Vocal music
 @section Vocal music
 
+TODO
+CLARIFY
+http://code.google.com/p/lilypond/issues/detail?id=248
+http://code.google.com/p/lilypond/issues/detail?id=329
+
+
+
+> I think the issue here is that changing the associatedVoice
+> happens one step
+> later than expected.  I could be wrong, but I don't think this
+> is obviously
+> documented.
+
+If you read section "Switching the melody associated with a lyrics
+line"
+it indeed says "Again, the command must be one syllable too
+early,..."!
+One problem with the current formulation is that the "Again"
+refers to what's described 2 subsections earlier in "Lyrics to
+multiple notes of a melisma", which isn't obvious unless you have
+read all the sections
+sequentially.
+
+
+
 Since LilyPond input files are text, there are two issues to
 consider when working with vocal music: