(Text markup): add note about

raise/lower with ^ or _ .

diff --git a/ChangeLog b/ChangeLog
index b368a9256f6fe0f80bcddaaf672753db92bda308..556bd0397e6d9b7a05948065fd03dd628947b8bd 100644 (file)
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,5 +1,8 @@
 2003-08-04  Han-Wen Nienhuys  <hanwen@cs.uu.nl>
 
+       * Documentation/user/refman.itely (Text markup): add note about
+       raise/lower with ^ or _ .
+       
        * po/fi.po: fix \\apply strings.
 
        * lily/parser.yy (open_event): warn for prefix articulations.

diff --git a/Documentation/user/refman.itely b/Documentation/user/refman.itely
index 849e9b0a302145e07d5d485a4088a39eb9ce1cf8..b764eb3ccd0aa6c21ec1ca3ac21a7d69ad50e1df 100644 (file)
--- a/Documentation/user/refman.itely
+++ b/Documentation/user/refman.itely
@@ -7020,6 +7020,9 @@ For the vertical placement, we have to look under
   support).  In this case, the direction signifies where to put the
   victim object relative to the support (left or right, up or down?)
 @end quotation
+
+@cindex padding
+@noindent
 below this description, the variable @code{padding} is described as
 @quotation
 @table @code
@@ -7359,7 +7362,12 @@ a markup object as second argument:
  c1^\markup { C \small \raise #1.0 \bold { "9/7+" }}
 @end lilypond
 The argument to @code{\raise} is the vertical displacement amount,
-measured in (global) staff spaces.
+measured in (global) staff spaces.  @code{\raise} and @code{\super}
+raise objects in relation to their surrounding markups. They cannot be
+used to move a single text up or down, when it is above or below a
+note, since the mechanism that positions it next to the note cancels
+any vertical shift. For vertical positioning, use @code{padding}
+and/or @code{extra-offset} properties.
 
 Other commands taking  single arguments include
 @table @code
@@ -7444,8 +7452,7 @@ their center lines:
 @end lilypond
 
 The markup mechanism is extensible.  Refer to
-@file{scm/new-markup.scm} for more information on extending the markup
-mode.
+@file{scm/new-markup.scm} for more information.
 
 
 
@@ -7465,6 +7472,8 @@ spaced slightly too wide.
 Syntax errors for markup mode are confusing.
 
 
+
+
 @node Global layout
 @section Global layout
 

diff --git a/Documentation/user/tutorial.itely b/Documentation/user/tutorial.itely
index fc65e33cc66c7de2bf1183418c791426e3b72687..0070b0031969cda4e0f474cd47167314d3684c2d 100644 (file)
--- a/Documentation/user/tutorial.itely
+++ b/Documentation/user/tutorial.itely
@@ -1461,8 +1461,8 @@ object. However, many layout objects share properties, which can be
 used to apply generic tweaks.  We mention a couple of these:
 
 @itemize @bullet
-@cindex @code{extra-offset}
 @item The @code{extra-offset} property, which
+@cindex @code{extra-offset}
 has a pair of numbers as value, moves around objects in the printout.
 The first number controls left-right movement; a positive number will
 move the object to the right.  The second number controls up-down
@@ -1509,6 +1509,7 @@ in that voice, the tie appears to cross voices:
 
 @item
 The @code{padding} property for objects with
+@cindex @code{padding}
 @code{side-position-interface} can be set to increase distance between
 symbols that are printed above or below notes. We only give an
 example; a more elaborate explanation is in @ref{Constructing a

diff --git a/input/test/bar-lines-lyric-only.ly b/input/test/bar-lines-lyric-only.ly
index 9d389e5e40ff217f699e0b707a963f705d86b03b..1d71b4315bb4ff15beede563d67029bacd045317 100644 (file)
--- a/input/test/bar-lines-lyric-only.ly
+++ b/input/test/bar-lines-lyric-only.ly
@@ -38,5 +38,9 @@ You can move around @code{Bar_engraver} and
   \StaffGroupContext
   \remove "Span_bar_engraver"
 }
+       \translator {
+           \StaffContext
+           \remove "Bar_engraver"
+           }
 }}