From 4ecef06e22df3293a2bf246e1ebccb300ce90b3e Mon Sep 17 00:00:00 2001
From: James Lowe <james.lowe@datacore.com>
Date: Sat, 14 Aug 2010 20:19:23 +0100
Subject: [PATCH] Doc: 989 - 4 more reg tests added

Dynamics-context-textspan.ly
Dynamics-custom-text-spanner-postfix.ly
Dymanics-hairpin-length.ly
Dynamics-text-spanner-postfix.ly

Removed extremely poor (and confusing) example of what was already covered by \espressivo

Removed index reference to Hal Leonard
---
 Documentation/notation/expressive.itely | 31 +++++++++++++++++++------
 Documentation/notation/pitches.itely    |  1 -
 Documentation/notation/text.itely       | 16 +++++++++++--
 3 files changed, 38 insertions(+), 10 deletions(-)

diff --git a/Documentation/notation/expressive.itely b/Documentation/notation/expressive.itely
index 072aa2e402..34934d710c 100644
--- a/Documentation/notation/expressive.itely
+++ b/Documentation/notation/expressive.itely
@@ -200,7 +200,6 @@ Music Glossary:
 Learning Manual:
 @rlearning{Placement of objects}.
 
-
 Notation Reference:
 @ref{Text scripts},
 @ref{Direction and placement},
@@ -311,10 +310,29 @@ d2\> d\>
 c1\!
 @end lilypond
 
-Spacer rests are needed to engrave multiple marks on one note.
+A hairpin that is terminated with @code{\!} will end at the
+right edge of the note that has the @code{\!} assigned to it.  In the
+case where it is terminated with the start of another @notation{crescendo}
+or @notation{decrescendo} mark, it will end at the centre of the note
+that has the next @code{\<} or @code{\>} assigned to it.  The next
+hairpin will then start at the right edge of the same note
+instead of the usual left edge had it been terminated with @code{\!}
+before.
+
+@lilypond[verbatim,quote,relative=2]
+c1\< | c4 a c\< a | c4 a c\! a\< | c4 a c a\!
+@end lilypond
 
-@cindex multiple dynamic marks on one note
-@cindex dynamic marks, multiple on one note
+Hairpins that are terminated with absolute dynamic marks instead of
+@code{\!} will also be engraved in a similar way.  However, the length
+of the absolute dynamic itself can alter where the preceding hairpin
+ends.
+
+@lilypond[verbatim,quote,relative=2]
+c1\< | c4 a c\mf a | c1\< | c4 a c\ffff a
+@end lilypond
+
+Spacer rests are needed to engrave multiple marks on one note.
 
 @lilypond[verbatim,quote,relative=2]
 c4\< c\! d\> e\!
@@ -326,9 +344,8 @@ c4\< c\! d\> e\!
 @funindex \espressivo
 @funindex espressivo
 
-In some situations the @code{\espressivo} articulation mark may be
-the appropriate choice to indicate a crescendo and decrescendo on
-one note:
+The @code{\espressivo} command can be used to indicate a crescendo
+and decrescendo on the same note:
 
 @lilypond[verbatim,quote,relative=2]
 c2 b4 a
diff --git a/Documentation/notation/pitches.itely b/Documentation/notation/pitches.itely
index 6cd5969633..793144df09 100644
--- a/Documentation/notation/pitches.itely
+++ b/Documentation/notation/pitches.itely
@@ -2625,7 +2625,6 @@ Internals Reference:
 @cindex practice note heads
 @cindex note heads, easy notation
 @cindex easy notation
-@cindex Hal Leonard
 @cindex beginners' music
 @cindex music, beginners'
 @cindex easy play note heads
diff --git a/Documentation/notation/text.itely b/Documentation/notation/text.itely
index c2cf111a68..09337c43f0 100644
--- a/Documentation/notation/text.itely
+++ b/Documentation/notation/text.itely
@@ -167,6 +167,8 @@ e,\stopTextSpan
 
 The line style, as well as the text string, can be defined as an
 object property.  This syntax is described in @ref{Line styles}.
+Text spanners are part of the @code{Dynamics} context; see
+@rinternals{Dynamics}.
 
 
 @funindex \textSpannerUp
@@ -186,16 +188,26 @@ object property.  This syntax is described in @ref{Line styles}.
 @knownissues
 LilyPond is only able to handle one text spanner per voice.
 
+@snippets
+
+@lilypondfile[verbatim,lilyquote,texidoc,doctitle]
+{dynamics-text-spanner-postfix.ly}
+
+@lilypondfile[verbatim,lilyquote,texidoc,doctitle]
+{dynamics-custom-text-spanner-postfix.ly}
+
 @seealso
 Notation Reference:
 @ref{Line styles},
 @ref{Dynamics}.
 
 Snippets:
-@rlsr{Text}.
+@rlsr{Text},
+@rlsr{Expressive marks}.
 
 Internals Reference:
-@rinternals{TextSpanner}.
+@rinternals{TextSpanner},
+@rinternals{Dynamics}.
 
 
 @node Text marks
-- 
2.39.2