From: Graham Percival <graham@percival-music.ca>
Date: Thu, 9 Jun 2005 08:07:40 +0000 (+0000)
Subject: Added \layout docs.
X-Git-Tag: release/2.5.30~22
X-Git-Url: https://git.donarmstrong.com/?a=commitdiff_plain;h=9d2b0b96a7c49958f63e02812e5801a3b2b9aa55;p=lilypond.git

Added \layout docs.
---

diff --git a/ChangeLog b/ChangeLog
index eb035eeeb4..c8d2648045 100644
--- 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 b6fe0bc45b..cdc6cc005d 100644
--- 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