From c20e5df6da652c0ad16e1d15a86c10006482520f Mon Sep 17 00:00:00 2001
From: Trevor Daniels <t.daniels@treda.co.uk>
Date: Tue, 2 Nov 2010 21:45:08 +0000
Subject: [PATCH] Doc: NR 2.1 Vocal: Placing dynamics above staff

 - Add ref to section in Choral where this is already
   explained

 - Do some tidying
---
 Documentation/notation/vocal.itely | 28 +++++++++++++++++++++-------
 1 file changed, 21 insertions(+), 7 deletions(-)

diff --git a/Documentation/notation/vocal.itely b/Documentation/notation/vocal.itely
index 0372b8ab3b..93bab4abb7 100644
--- 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}.
 
-- 
2.39.2