X-Git-Url: https://git.donarmstrong.com/?a=blobdiff_plain;f=Documentation%2Fuser%2Frefman.itely;h=83d2c3d9f37e693e80c192791c86b62b92a1fd8e;hb=c7ca1a2ef47d12320d184852e9eaf38b290d0ff1;hp=a474382d0a824f5aa19c942d6f348991535982d7;hpb=d766d2b4b3881f9b067173f44b25b758431e1517;p=lilypond.git

diff --git a/Documentation/user/refman.itely b/Documentation/user/refman.itely
index a474382d0a..83d2c3d9f3 100644
--- a/Documentation/user/refman.itely
+++ b/Documentation/user/refman.itely
@@ -967,7 +967,7 @@ The @code{set-octavation} function also takes -1 (for 8va bassa) and 2
 
 @seealso
 
-Internals: @internalsref{OttavaSpanner}.
+Internals: @internalsref{OttavaBracket}.
 
 Examples: @inputfileref{input/regression,ottava.ly},
 @inputfileref{input/regression,ottava-broken.ly}.
@@ -7482,7 +7482,33 @@ such as fermatas to a @code{\notes@{@}} block.
 @node Balloon help
 @subsection Balloon help
 
+Elements of notation can be marked and named with the help of a square
+balloon.  The primary purpose of this feature is to explain notation.
 
+The following example demonstrates its use.
+
+@lilypond[verbatim,fragment,singleline,relative 1]
+  \context Voice
+     \applyoutput
+        #(add-balloon-text 'NoteHead "heads, or tails?"
+          '(1 . -3))
+  c8
+@end lilypond
+
+@noindent
+The function @code{add-balloon-text} takes the name of a grob, the
+label to print and where to put the label relative to the object. In
+the above example, the text ``heads or tails?'' ends 3 spaces below
+the `balloon.' 
+
+@cindex balloon
+@cindex notation, explaining
+
+@seealso
+
+Internals: @internalsref{text-balloon-interface}
+
+Examples: @inputfileref{input/regression,balloon.ly}
 
 @node Easy Notation note heads
 @subsection Easy Notation note heads
@@ -7500,19 +7526,14 @@ used in music aimed at beginners:
 }
 @end lilypond
 
-The @code{EasyNotation} variable overrides a @internalsref{Score} context.  
-You probably will want to print it with magnification or a
-large font size to make it more readable.  To print with
-magnification, you must create a DVI file (with @file{lilypond}) and
-then enlarge it with something like @file{dvips -x 2000 file.dvi}.
-See the @code{dvips} documentation for more details.  To print with a
-larger font, see @ref{Font Size}.
-
+The @code{EasyNotation} variable overrides a @internalsref{Score}
+context.  To make the letters readable, it has to be printed in a
+large font size.  To print with a larger font, see @ref{Font Size}.
 
 @cindex Xdvi
 @cindex ghostscript
 
-If you view the result with Xdvi, then staff lines will show through
+If you view the result with Xdvi, then staff lines may show through
 the letters.  Printing the PostScript file obtained does produce the
 correct result.
 
@@ -8564,7 +8585,7 @@ staffs. The size of individual staffs are relative to the global size,
 which can be set   in the following manner:
 
 @example
-  #(set-staff-size 14)
+  #(set-global-staff-size 14)
 @end example
 
 This sets the global default size to 14pt staff height, and scales all