From: Jean-Charles Malahieude <lilyfan@orange.fr>
Date: Sat, 20 Aug 2011 14:30:10 +0000 (+0200)
Subject: Doc: NR-3.2 titling
X-Git-Tag: release/2.15.9-1~9^2~33
X-Git-Url: https://git.donarmstrong.com/?a=commitdiff_plain;h=6810d727b278d15825eecb2b497d1a966241d4eb;p=lilypond.git

Doc: NR-3.2 titling
Reinstate that normally only piece & opus are printed
when \header is within \score.
---

diff --git a/Documentation/notation/input.itely b/Documentation/notation/input.itely
index d6d586062a..59b9c1d9cf 100644
--- a/Documentation/notation/input.itely
+++ b/Documentation/notation/input.itely
@@ -546,6 +546,32 @@ both types are entered using a @code{\header} block.
 If the book only has a single score, the @code{\header} block may be
 placed inside or outside of the @code{\score} block.
 
+The default behavior, when the @code{\header} has been defined inside
+the @code{\score} block, is to print only the @code{piece} and
+@code{opus} fields:
+
+@lilypond[papersize=a5,quote,verbatim,noragged-right]
+\score {
+  { c'4 }
+  \header {
+    title = "title"  % not printed
+    piece = "piece"
+    opus = "opus"
+  }
+}
+@end lilypond
+
+@funindex print-all-headers
+@noindent
+You may change this behavior (and print all the headers when defining
+@code{\header} inside @code{\score}) by using
+
+@example
+\paper@{
+  print-all-headers = ##t
+@}
+@end example
+
 @warning{Remember when adding a @bs{}@code{header} block inside a
 @bs{}@code{score} block, that the music expression must come before the
 @bs{}@code{header} block.}
@@ -799,7 +825,7 @@ footer and title text within the @code{\header} block.
   { s1 }
   \header {
     piece = \markup { \fontsize #4 \bold "PRAELUDIUM I" }
-    subtitle = \markup { \italic "(Excerpt)" }
+    opus = \markup { \italic "(Excerpt)" }
   }
 }
 @end lilypond