Doc: NR 2.1 Vocal: Reposition Placement of lyrics

 - this is a higher level concept and should be earlier

diff --git a/Documentation/notation/vocal.itely b/Documentation/notation/vocal.itely
index d18e96817dcc464df24fcf0f3b66db096aab3e88..4ecaacfdfd8896c534a8e745a4e428b181ce56ca 100644 (file)
--- a/Documentation/notation/vocal.itely
+++ b/Documentation/notation/vocal.itely
@@ -673,11 +673,11 @@ Internals Reference:
 
 @menu
 * Working with lyrics and variables::
+* Placement of lyrics::
 * Lyrics and repeats::
 * Divisi lyrics::
 * Lyrics independent of notes::
 * Spacing out syllables::
-* Placement of lyrics::
 @end menu
 
 
@@ -744,6 +744,122 @@ Internals Reference:
 @rinternals{Lyrics}.
 
 
+@node Placement of lyrics
+@unnumberedsubsubsec Placement of lyrics
+
+@cindex placement of lyrics
+@cindex lyrics, positioning
+
+Lyrics are positioned above the staff, below the staff, or between
+staves, depending on the type of music.  To place lyrics below the
+associated staff simply define the Lyrics context below the Staff
+context:
+
+@lilypond[quote,verbatim]
+\score {
+  <<
+    \new Staff {
+      \new Voice = "melody" {
+        \relative c'' { c4 c c c }
+      }
+    }
+    \new Lyrics {
+      \lyricsto "melody" {
+        Here are the words
+      }
+    }
+  >>
+}
+@end lilypond
+
+To position lyrics above the staff, place the declaration of the
+Lyrics context before the Staff and Voice contexts, but the
+@code{\lyricsto} command must come after the Voice declaration it
+references, like this:
+
+@lilypond[quote,verbatim]
+\score {
+  <<
+    \new Lyrics = "lyrics"
+    \new Staff {
+      \new Voice = "melody" {
+        \relative c'' { c4 c c c }
+      }
+    }
+    \context Lyrics = "lyrics" {
+      \lyricsto "melody" {
+        Here are the words
+      }
+    }
+  >>
+}
+@end lilypond
+
+Alternatively, the position of the lyrics may be specified
+explicitly:
+
+@lilypond[quote,verbatim]
+\score {
+  <<
+    \new Staff = "staff" {
+      \new Voice = "melody" {
+        \relative c'' { c4 c c c }
+      }
+    }
+    \new Lyrics \with { alignAboveContext = "staff" } {
+      \lyricsto "melody" {
+        Here are the words
+      }
+    }
+  >>
+}
+@end lilypond
+
+When there are two voices on separate staves the lyrics may be
+placed between the staves using either of these methods.  Here
+is an example of the first method:
+
+@lilypond[quote,verbatim]
+\score {
+  \new ChoirStaff <<
+    \new Staff {
+      \new Voice = "sopranos" {
+        \relative c'' { c4 c c c }
+      }
+    }
+    \new Lyrics = "sopranos"
+    \new Lyrics = "contraltos"
+    \new Staff {
+      \new Voice = "contraltos" {
+        \relative c'' { a4 a a a }
+      }
+    }
+    \context Lyrics = "sopranos" {
+      \lyricsto "sopranos" {
+        Sop -- ra -- no words
+      }
+    }
+    \context Lyrics = "contraltos" {
+      \lyricsto "contraltos" {
+        Con -- tral -- to words
+      }
+    }
+  >>
+}
+@end lilypond
+
+Other combinations of lyrics and staves may be generated by
+elaborating these examples, or by examining the SATB templates in
+the Learning Manual.
+
+@seealso
+Learning Manual:
+@rlearning{Vocal ensembles}.
+
+Notation Reference:
+@ref{Aligning contexts},
+@ref{Creating contexts}.
+
 @node Lyrics and repeats
 @unnumberedsubsubsec Lyrics and repeats
 
@@ -1225,12 +1341,11 @@ the implicit melismata get ignored.
 @c Conclusion: do not use devnull for lyrics -FV
 
 @c this clarifies http://code.google.com/p/lilypond/issues/detail?id=248
+@c see also feature request 777 - show how to do this in manual durations
 
 @node Spacing out syllables
 @unnumberedsubsubsec Spacing out syllables
 
-@c TODO move to second item
-
 @cindex Spacing lyrics
 @cindex Lyrics, increasing space between
 
@@ -1314,124 +1429,6 @@ To make lyrics avoid bar lines as well, use
 @end ignore
 
 
-@node Placement of lyrics
-@unnumberedsubsubsec Placement of lyrics
-
-@cindex placement of lyrics
-@cindex lyrics, positioning
-
-@c TODO Add text from -user
-
-Lyrics are positioned above the staff, below the staff, or between
-staves, depending on the type of music.  To place lyrics below the
-associated staff simply define the Lyrics context below the Staff
-context:
-
-@lilypond[quote,verbatim]
-\score {
-  <<
-    \new Staff {
-      \new Voice = "melody" {
-        \relative c'' { c4 c c c }
-      }
-    }
-    \new Lyrics {
-      \lyricsto "melody" {
-        Here are the words
-      }
-    }
-  >>
-}
-@end lilypond
-
-To position lyrics above the staff, place the declaration of the
-Lyrics context before the Staff and Voice contexts, but the
-@code{\lyricsto} command must come after the Voice declaration it
-references, like this:
-
-@lilypond[quote,verbatim]
-\score {
-  <<
-    \new Lyrics = "lyrics"
-    \new Staff {
-      \new Voice = "melody" {
-        \relative c'' { c4 c c c }
-      }
-    }
-    \context Lyrics = "lyrics" {
-      \lyricsto "melody" {
-        Here are the words
-      }
-    }
-  >>
-}
-@end lilypond
-
-Alternatively, the position of the lyrics may be specified
-explicitly:
-
-@lilypond[quote,verbatim]
-\score {
-  <<
-    \new Staff = "staff" {
-      \new Voice = "melody" {
-        \relative c'' { c4 c c c }
-      }
-    }
-    \new Lyrics \with { alignAboveContext = "staff" } {
-      \lyricsto "melody" {
-        Here are the words
-      }
-    }
-  >>
-}
-@end lilypond
-
-When there are two voices on separate staves the lyrics may be
-placed between the staves using either of these methods.  Here
-is an example of the first method:
-
-@lilypond[quote,verbatim]
-\score {
-  \new ChoirStaff <<
-    \new Staff {
-      \new Voice = "sopranos" {
-        \relative c'' { c4 c c c }
-      }
-    }
-    \new Lyrics = "sopranos"
-    \new Lyrics = "contraltos"
-    \new Staff {
-      \new Voice = "contraltos" {
-        \relative c'' { a4 a a a }
-      }
-    }
-    \context Lyrics = "sopranos" {
-      \lyricsto "sopranos" {
-        Sop -- ra -- no words
-      }
-    }
-    \context Lyrics = "contraltos" {
-      \lyricsto "contraltos" {
-        Con -- tral -- to words
-      }
-    }
-  >>
-}
-@end lilypond
-
-Other combinations of lyrics and staves may be generated by
-elaborating these examples, or by examining the SATB templates in
-the Learning Manual.
-
-@seealso
-Learning Manual:
-@rlearning{Vocal ensembles}.
-
-Notation Reference:
-@ref{Aligning contexts},
-@ref{Creating contexts}.
-
 @node Stanzas
 @subsection Stanzas