-This method leads to strange beamings and warnings if the pieces of
-music do not have the same rhythm. To typeset multiple, truly
-independent voices in a single staff, the @code{<<@{...@} \\
-@{...@}>>} construction is used, where the two (or more) voices are
-separated by double backslashes.
+Here, voices are instantiated explicitly and are given a name. The
+@code{\voiceOne} ... @code{\voiceFour} commands set up the voices so
+that first and third voices get stems up, second and fourth voices get
+stems down, third and fourth voice note heads are horizontally
+shifted, and rests in the respective voices are automatically moved to
+avoid collisions. Using the @code{\oneVoice} command, all the voice
+settings are put back to the neutral directions typical of a
+single-voice passage.
+
+We can make a voice to be in the same @code{Voice} context before
+and after a temporary polyphonic passage. For example, the following
+construct keeps a voice alive throughout the polyphonic section. Said
+voice is the first one inside of the two-voice section, and the extra
+voice is the second one.
+
+@example
+<< @{ \voiceOne ... @} \new Voice @{ \voiceTwo ... @} >> \oneVoice
+@end example
+
+Using the name given when created, this allows lyrics to be assigned
+to one consistent voice.
+
+@lilypond[quote, verbatim, relative=2]
+<<
+ \new Voice = "melody" {
+ a4
+ <<
+ {
+ \voiceOne
+ g f
+ }
+ \new Voice {
+ \voiceTwo
+ e d
+ }
+ >>
+ \oneVoice
+ e
+ }
+ \new Lyrics \lyricsto "melody" {
+ This is my song.
+ }
+>>
+@end lilypond
+
+Here, the \voiceOne and \voiceTwo commands help to make clear what
+settings does each voice receive.
+
+The @code{<<@{...@} \\ @{...@}>>} construction, where the two (or
+more) voices are separated by double backslashes, can be used as a
+simplified method to print multiple voices in a single staff. Our
+first example could be typeset as follows: