From 4e532de1fcb1fda2822fe1429a2b57009b6553bf Mon Sep 17 00:00:00 2001
From: Graham Percival <graham@percival-music.ca>
Date: Tue, 11 Mar 2008 05:47:13 -0700
Subject: [PATCH] Update from Valentin.

---
 Documentation/user/text.itely | 31 ++++++++++++++++++++-----------
 1 file changed, 20 insertions(+), 11 deletions(-)

diff --git a/Documentation/user/text.itely b/Documentation/user/text.itely
index 9a7aa02457..e2fd3ee2dd 100644
--- a/Documentation/user/text.itely
+++ b/Documentation/user/text.itely
@@ -93,9 +93,15 @@ Snippets: @lsrdir{Text,Text}
 @cindex non-empty texts
 
 It is possible to add arbitrary text indications with
-@var{note}@code{-"}@var{text}@code{"}. Such indications can be
-placed above or below the staff, using the simple syntax described
-in @ref{Controlling direction and placement}.
+@var{note}@code{-"}@var{text}@code{"}.
+
+@lilypond[quote,fragment,ragged-right,verbatim,relative=1]
+d8-"scherzando" e f g a4 f
+@end lilypond
+
+Text indications can be placed above or below the staff, using the
+simple syntax described in @ref{Controlling direction and
+placement}:
 
 @lilypond[quote,fragment,ragged-right,verbatim,relative=1]
 d8^"pizz." e f g a4_"scherz." f
@@ -106,7 +112,7 @@ objects.  This syntax is actually a shorthand; more complex text
 formatting may be added to a note by explicitly using the
 @code{\markup} command, as described in @ref{Text markup}.
 
-@lilypond[fragment,ragged-right,verbatim,quote]
+@lilypond[quote,fragment,ragged-right,verbatim,relative=1]
 d8^\markup { \italic pizz. } e f g 
 a4_\markup { \tiny scherz. \bold molto } f
 @end lilypond
@@ -119,18 +125,21 @@ a4_\markup { \tiny scherz. \bold molto } f
 @code{\textLengthOff}.
 
 By default, text indications do not influence the note spacing.
-However, by using the command @code{\textLengthOn}, the widths
-will be taken into account: in the following example, the first
-text string does not affect spacing, whereas the second one does.
+However, their widths can be taken into account using the following
+syntax (the first command allows text to influence spacing, the
+second one goes back to the default behavior):
+
+@example
+\textLengthOn @var{note}@code{-"text"} \textLengthOff
+@end example
+
+In the following example, the first text string does not affect 
+spacing, whereas the second one does.
 
 @lilypond[quote,fragment,ragged-right,verbatim,relative=1]
 d8^"pizz." e f g \textLengthOn a4_"scherzando" f
 @end lilypond
 
-@noindent
-After having used such a command, to go back to the default behavior
-and prevent text from influencing spacing, use @code{\textLengthOff}.
-
 
 @snippets
 
-- 
2.39.5