Docs: NR 2.1.7 Choral: add dynamics

diff --git a/Documentation/notation/vocal.itely b/Documentation/notation/vocal.itely
index 2d43f8c0c398405e40c54f2215f7548132dc96bb..27f515a24f756f2ce23b87cf78e45772ad2f676a 100644 (file)
--- a/Documentation/notation/vocal.itely
+++ b/Documentation/notation/vocal.itely
@@ -1468,9 +1468,31 @@ may be activated with
 @}
 @end example
 
+@noindent
 For details of this and other page formatting properties, see
 @ref{Page formatting}.
 
+Dynamic markings by default are placed below the staff, but in
+choral music they are often placed above the staff in order to
+avoid the lyrics.  The predefined command @code{\dynamicUp} does
+this for the dynamic markings in a single @code{Voice} context.
+To place all dynamic markings in the score above their respective
+staves use the following in a @code{\layout} block within the
+@code{\score} block:
+
+@example
+\layout @{
+  \context @{
+    \Score
+    \override DynamicText #'direction = #UP
+    \override DynamicLineSpanner #'direction = #UP
+  @}
+@}
+@end example
+
+@predefined
+@code{\dynamicUp}.
+
 @seealso
 Notation Reference:
 @ref{Setting the staff size},