add info about raising text.

diff --git a/ChangeLog b/ChangeLog
index 17fe81e40c0e216018b2e13fc252fc66516ee93e..e6ef8b37797f3f58bfedd68a7bf07ff396aa8c94 100644 (file)
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,8 @@
+2005-08-24  Graham Percival  <gpermus@gmail.com>
+
+       * Documentation/user/advanced-notation.itely: add info about
+       raising text.
+
 2005-08-24  Han-Wen Nienhuys  <hanwen@xs4all.nl>
 
        * lily/beam.cc (print): fix X start/end points of isolated

diff --git a/Documentation/user/advanced-notation.itely b/Documentation/user/advanced-notation.itely
index 98ca3ae1ed3e6dcbe511004ccf311e20a1546a04..8effe24b71956b9ead47bdcfd287c1294fa9ff8e 100644 (file)
--- a/Documentation/user/advanced-notation.itely
+++ b/Documentation/user/advanced-notation.itely
@@ -297,6 +297,19 @@ whole.  For example, the @internalsref{RehearsalMark} is horizontally
 centered, so using @code{\mark \markup @{ \left-align .. @}} has no
 effect.
 
+In addition, vertical placement is performed after creating the
+text markup object.  If you wish to move an entire piece of markup,
+you need to use the #'padding property or create an "anchor" point
+inside the markup (generally with @code{\hspace #0}).
+
+@lilypond[quote,verbatim,fragment,relative=1]
+\fatText
+c'4^\markup{ \raise #5 "not raised" }
+\once \override TextScript #'padding = #3
+c'4^\markup{ raised }
+c'4^\markup{ \hspace #0 \raise #1.5 raised }
+@end lilypond
+
 
 @seealso