Document \score{\header{}} behavior.

diff --git a/ChangeLog b/ChangeLog
index 6e0fc9fdd2aa175f4186139e63250d0a63683f3f..b65adb8180b8bd8d4832e4bfe3d1b0deb04c6022 100644 (file)
--- a/ChangeLog
+++ b/ChangeLog
@@ -16,6 +16,9 @@
 
        * THANKS: add Bruce Fairchild, alphabetise.
 
+       * Documentation/user/global.itely: document \score{\header{}}
+       behavior.
+
 2005-08-08  Mats Bengtsson  <mabe@drongo.s3.kth.se>
 
        * Documentation/user/programming-interface.itely (Markup

diff --git a/Documentation/user/global.itely b/Documentation/user/global.itely
index b27bdac94a647254c3861bd784ed536af5da4cbe..8b0cca4251541e2d1260ae8a70a9792a89365984 100644 (file)
--- a/Documentation/user/global.itely
+++ b/Documentation/user/global.itely
@@ -949,7 +949,7 @@ As demonstrated before, you can use multiple @code{\header} blocks.
 When same fields appear in different blocks, the latter is used.  
 Here is a short example.
 
-@example 
+a@example 
 \header @{
   composer = "Composer"
 @}
@@ -959,11 +959,38 @@ Here is a short example.
 \score @{
   \new Staff @{ c'4 @}
   \header @{
-    title = "New title" %overwrite previous one
+    title = "New title"  % overwrite previous one
   @}
 @}
 @end example
 
+If you define the @code{\header} inside the @code{\score} block, then
+normally only the @code{piece} and @code{opus} headers will be printed.
+
+@lilypond[quote,verbatim,linewidth=11.0\cm]
+\score {
+  { c'4 }
+  \header {
+    title = "title"  % not printed
+    piece = "piece"
+    opus = "opus"
+  }
+}
+@end lilypond
+
+@noindent
+You may change this behavior (and print all the headers when defining
+@code{\header} inside @code{\score}) by using
+
+@example
+\paper@{
+   scoreTitleMarkup = \bookTitleMarkup
+@}
+@end example
+
+
+@commonprop
+
 A more advanced option is to change the definitions of the following
 variables in the @code{\paper} block.  The init file
 @file{ly/titling-init.ly} lists the default layout.