Added \layout docs.

diff --git a/ChangeLog b/ChangeLog
index eb035eeeb4a130e0f9c8d16b55394805b094cd41..c8d26480455e525b94e36c20cf34acc023e7ba65 100644 (file)
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,7 @@
+2005-06-09  Graham Percival  <gperlist@shaw.ca>
+
+       * Documentation/user/global.itely: added \layout docs.
+
 2005-06-09  Han-Wen Nienhuys  <hanwen@xs4all.nl>
 
        * lily/lily-parser-scheme.cc: add unistd.h

diff --git a/Documentation/user/global.itely b/Documentation/user/global.itely
index b6fe0bc45ba77416ec6d273b97bdcd468fb64d59..cdc6cc005d5829e0702aa4b5266ea3da7947c2c7 100644 (file)
--- a/Documentation/user/global.itely
+++ b/Documentation/user/global.itely
@@ -40,7 +40,8 @@ titles.
 @menu
 * Setting global staff size::   
 * Paper size::                  
-* Page layout::                 
+* Page formatting::             
+* Score layout::                
 * Vertical spacing::            
 * Vertical spacing of piano staves::  
 * Horizontal spacing::          
@@ -176,10 +177,10 @@ and wider line widths will be set correspondingly.
 @end example 
 
 
-@node Page layout
-@subsection Page layout
+@node Page formatting
+@subsection Page formatting
 
-@cindex page layout
+@cindex page formatting
 @cindex margins
 @cindex header, page
 @cindex footer, page
@@ -190,7 +191,7 @@ footers to each page.
 The default layout responds to the following settings in the
 @code{\paper} block.
 
-@cindex \paper
+@cindex @code{\paper}
 
 @quotation
 @table @code
@@ -336,6 +337,34 @@ The default page header puts the page number and the @code{instrument}
 field from the @code{\header} block on a line.
 
 
+@node Score layout
+@subsection Score layout
+
+@cindex @code{\layout}
+
+While @code{\paper} contains settings that relate to the page formatting
+of the whole document, @code{\layout} contains settings for score-specific
+layout.
+
+@example
+\layout @{
+  indent = 2.0\cm
+  \context @{ \Staff
+    minimumVerticalExtent = #'(-6 . 6
+  @}
+  \context @{ \Voice
+    \override TextScript #'padding = #1.0
+    \override Glissando #'thickness = #3
+  @}
+@}
+@end example
+
+
+@seealso
+
+This manual: @ref{Changing context default settings}
+
+
 @node Vertical spacing
 @subsection Vertical spacing