From: Mats Bengtsson <mats.bengtsson@s3.kth.se>
Date: Fri, 8 Dec 2006 19:04:26 +0000 (+0100)
Subject: Document the layout-set-staff-size function and rename the section
X-Git-Tag: release/2.11.2-1~42^2~1
X-Git-Url: https://git.donarmstrong.com/?a=commitdiff_plain;h=ff49b8eaa875189f9615f9d8cc72aa5089bcdbb4;p=lilypond.git

Document the layout-set-staff-size function and rename the section
title (and references to it) correspondingly.
---

diff --git a/Documentation/user/advanced-notation.itely b/Documentation/user/advanced-notation.itely
index 8b64117d85..a89b258501 100644
--- a/Documentation/user/advanced-notation.itely
+++ b/Documentation/user/advanced-notation.itely
@@ -2221,7 +2221,7 @@ used in music for beginners
 The command @code{\setEasyHeads} overrides settings for the
 @internalsref{NoteHead} object.  To make the letters readable, it has
 to be printed in a large font size.  To print with a larger font, see
-@ref{Setting global staff size}.
+@ref{Setting the staff size}.
 
 @refcommands
 
diff --git a/Documentation/user/spacing.itely b/Documentation/user/spacing.itely
index 6e22cf1a78..35902501a9 100644
--- a/Documentation/user/spacing.itely
+++ b/Documentation/user/spacing.itely
@@ -332,19 +332,20 @@ add space between the titles and the first system of the score.
 @section Music layout
 
 @menu
-* Setting global staff size::   
+* Setting the staff size::   
 * Score layout::                
 @end menu
 
 
-@node Setting global staff size
-@subsection Setting global staff size
+@node Setting the staff size
+@subsection Setting the staff size
 
 @cindex font size, setting
 @cindex staff size, setting
 @funindex layout file
 
-To set the global staff size, use @code{set-global-staff-size}.
+To set the staff size globally for all scores in a file (or
+in a @code{book} block, to be precise), use @code{set-global-staff-size}.
 
 @example
 #(set-global-staff-size 14)
@@ -354,6 +355,16 @@ To set the global staff size, use @code{set-global-staff-size}.
 This sets the global default size to 14pt staff height and scales all
 fonts accordingly.
 
+To set the staff size individually for each score, use 
+@example
+\score@{
+  ...
+  \layout@{
+  #(layout-set-staff-size 15)
+  @}
+@}
+@end example
+
 The Feta font provides musical symbols at eight different
 sizes.  Each font is tuned for a different staff size: at a smaller size
 the font becomes heavier, to match the relatively heavier staff lines.