From fb3aeb95f481f17cae530e73391303b102899a5b Mon Sep 17 00:00:00 2001
From: gpercival <gpercival>
Date: Tue, 9 Aug 2005 07:42:06 +0000
Subject: [PATCH] Document \score{\header{}} behavior.

---
 ChangeLog                       |  3 +++
 Documentation/user/global.itely | 31 +++++++++++++++++++++++++++++--
 2 files changed, 32 insertions(+), 2 deletions(-)

diff --git a/ChangeLog b/ChangeLog
index 6e0fc9fdd2..b65adb8180 100644
--- 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 b27bdac94a..8b0cca4251 100644
--- 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.
-- 
2.39.5