Reword and added example from Carl.

diff --git a/Documentation/user/simultaneous.itely b/Documentation/user/simultaneous.itely
index 3a6c66fefcc167e9001b804b940b3ea213c63871..a10dcdd590e578a7f1dd6872c35190883ffc76d5 100644 (file)
--- a/Documentation/user/simultaneous.itely
+++ b/Documentation/user/simultaneous.itely
@@ -194,9 +194,31 @@ these purposes, the @code{\voiceOne} ... @code{\voiceFour}, and
 << @{ \voiceOne ... @} \new Voice @{ \voiceTwo ... @} >> \oneVoice
 @end example
 
-This is a better construct to keep the control of the voices, for
-example, to ease a consistent assign of lyrics to the proper voice
-context.
+This construct keeps a voice alive throughout the polyphonic section.
+For example, this allows lyrics to be assigned to one consistent voice.
+
+@lilypond[quote, verbatim, relative=1]
+<<
+  \new Voice = "melody" {
+    a4
+    <<
+      {
+        \voiceOne
+        g f
+      }
+      \new Voice {
+        \voiceTwo
+        e d
+      }
+    >>
+    \oneVoice
+    e
+  }
+  \new Lyrics \lyricsto "melody" {
+  This is my song.
+  }
+>>
+@end lilypond
 
 @predefined