Doc: cleanup @file{}, take 2: remove all @/ escaping sequences.

[lilypond.git] / Documentation / notation / vocal.itely

diff --git a/Documentation/notation/vocal.itely b/Documentation/notation/vocal.itely
index 05d76e698d1da5a8bf7dbc6c3f0984244875a03b..aa33746150899da70b0e05f33fa8b41f3b6fe120 100644 (file)
--- a/Documentation/notation/vocal.itely
+++ b/Documentation/notation/vocal.itely
@@ -57,17 +57,23 @@ that may arise in any type of vocal music.
 @itemize
 
 @item
-Most styles of vocal music use written text as lyrics.  An introduction
-to this notation is to be found in @rlearning{Setting simple songs}.
+Most styles of vocal music use written text as lyrics.  An
+introduction to this notation is to be found in
+@rlearning{Setting simple songs}.
 
 @item
-Vocal music is likely to require the use of @code{markup} mode, either
-for lyrics of for other text elements (character's names, etc.).
-This syntax is described in @ref{Text markup introduction}.
+Vocal music is likely to require the use of @code{markup} mode,
+either for lyrics or for other text elements (characters' names,
+etc.)  This syntax is described in @ref{Text markup introduction}.
 
 @item
-@notation{Ambitus} may be added at the beginning of vocal staves, as explained
-in @ref{Ambitus}.
+@notation{Ambitus} may be added at the beginning of vocal staves,
+as explained in @ref{Ambitus}.
+
+@item
+Dynamic markings by default are placed below the staff, but in
+choral music they are usually placed above the staff in order to
+avoid the lyrics, as explained in @ref{Score layouts for choral}.
 
 @end itemize
 
@@ -75,6 +81,14 @@ in @ref{Ambitus}.
 Music Glossary:
 @rglos{ambitus}.
 
+Learning Manual:
+@rlearning{Setting simple songs}.
+
+Notation Reference:
+@ref{Text markup introduction},
+@ref{Ambitus},
+@ref{Score layouts for choral}.
+
 Snippets:
 @rlsr{Vocal music}.
 
@@ -416,12 +430,14 @@ More stanzas can be added by adding more
 @code{\addlyrics} sections:
 
 
-@lilypond[ragged-right,verbatim,fragment,quote]
-\time 3/4
-\relative c' { c2 e4 g2. }
-\addlyrics { play the game }
-\addlyrics { speel het spel }
-\addlyrics { joue le jeu }
+@lilypond[ragged-right,verbatim,quote]
+{
+  \time 3/4
+  \relative c' { c2 e4 g2. }
+  \addlyrics { play the game }
+  \addlyrics { speel het spel }
+  \addlyrics { joue le jeu }
+}
 @end lilypond
 
 The command @code{\addlyrics} cannot handle polyphonic settings.
@@ -574,12 +590,14 @@ tie is implemented with the Unicode character U+203F, so be
 sure to have a font (like DejaVuLGC) installed that includes this
 glyph.
 
-@lilypond[quote,ragged-right,fragment,verbatim]
-\time 3/4
-\relative c' { c2 e4 g2 e4 }
-\addlyrics { gran- de_a- mi- go }
-\addlyrics { pu- "ro y ho-" nes- to }
-\addlyrics { pu- ro~y~ho- nes- to }
+@lilypond[quote,ragged-right,verbatim]
+{
+  \time 3/4
+  \relative c' { c2 e4 g2 e4 }
+  \addlyrics { gran- de_a- mi- go }
+  \addlyrics { pu- "ro y ho-" nes- to }
+  \addlyrics { pu- ro~y~ho- nes- to }
+}
 @end lilypond
 
 
@@ -629,7 +647,7 @@ together:
     e8
   }
   \new Lyrics \lyricsto "melody" {
-    Ki -- ri -- e __
+    Ky -- ri -- e __
   }
 >>
 @end lilypond
@@ -647,7 +665,7 @@ entering lyrics:
     e8 ( d e2 )
   }
   \new Lyrics \lyricsto "melody" {
-    Ki -- ri -- e __
+    Ky -- ri -- e __
   }
 >>
 @end lilypond
@@ -666,7 +684,7 @@ providing automatic beaming is switched off.  See
     e2.
   }
   \new Lyrics \lyricsto "melody" {
-    Ki -- ri -- e
+    Ky -- ri -- e
   }
 >>
 @end lilypond
@@ -689,7 +707,7 @@ are bracketed between @code{\melisma} and @code{\melismaEnd}.
     e2.
   }
   \new Lyrics \lyricsto "melody" {
-    Ki -- ri -- e
+    Ky -- ri -- e
   }
 >>
 @end lilypond
@@ -710,7 +728,7 @@ to be added to the melisma.
     e8 d e2
   }
   \new Lyrics \lyricsto "melody" {
-    Ki -- ri -- _ _ _ e __ _ _
+    Ky -- ri -- _ _ _ e __ _ _
   }
 >>
 @end lilypond
@@ -1057,7 +1075,7 @@ Notation Reference:
 To increase the spacing between lyrics, set the @code{minimum-distance}
 property of @code{LyricSpace}.
 
-@lilypond[relative,verbatim,fragment,quote,ragged-right]
+@lilypond[relative=1,verbatim,quote,ragged-right]
 {
   c c c c
   \override Lyrics.LyricSpace #'minimum-distance = #1.0
@@ -1589,7 +1607,7 @@ attaching lyrics to those specific contexts:
 
 Stanza numbers can be added by setting @code{stanza}, e.g.,
 
-@lilypond[quote,ragged-right,verbatim,relative=2,fragment]
+@lilypond[quote,ragged-right,verbatim,relative=2]
 \new Voice {
   \time 3/4 g2 e4 a2 f4 g2.
 } \addlyrics {
@@ -1673,7 +1691,7 @@ Names of singers can also be added.  They are printed at the start of
 the line, just like instrument names.  They are created by setting
 @code{vocalName}.  A short version may be entered as @code{shortVocalName}.
 
-@lilypond[fragment,ragged-right,quote,verbatim,relative=2]
+@lilypond[ragged-right,quote,verbatim,relative=2]
 \new Voice {
   \time 3/4 g2 e4 a2 f4 g2.
 } \addlyrics {
@@ -2169,7 +2187,7 @@ the two systems.  See @ref{Separating systems}.
 
 @item
 For details of other page formatting properties, see
-@ref{Page formatting}.
+@ref{Page layout}.
 
 @end itemize
 
@@ -2215,7 +2233,7 @@ Notation Reference:
 @ref{Changing spacing},
 @ref{Displaying spacing},
 @ref{Fitting music onto fewer pages},
-@ref{Page formatting},
+@ref{Page layout},
 @ref{Score layout},
 @ref{Separating systems},
 @ref{Setting the staff size},
@@ -2318,7 +2336,7 @@ See @ref{Separating systems}.
 
 @item
 For details of other page formatting properties, see
-@ref{Page formatting}.
+@ref{Page layout}.
 
 @item
 Dialogue cues and stage directions can be inserted with markup.
@@ -2339,7 +2357,7 @@ Notation Reference:
 @ref{Hiding staves},
 @ref{Instrument transpositions},
 @ref{Nested staff groups},
-@ref{Page formatting},
+@ref{Page layout},
 @ref{Separating systems},
 @ref{Transpose},
 @ref{Writing parts},