From d741c8e444fbdc7e254360a9644d1ea03c341739 Mon Sep 17 00:00:00 2001
From: Graham Percival <graham@percival-music.ca>
Date: Tue, 3 May 2005 11:10:54 +0000
Subject: [PATCH] Better docs for \header.
---
ChangeLog | 2 ++
Documentation/user/global.itely | 29 +++++++++++++----------------
2 files changed, 15 insertions(+), 16 deletions(-)
diff --git a/ChangeLog b/ChangeLog
index 11fa9664cd..cbd058f4aa 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -13,6 +13,8 @@
changing-defaults.itely: consolidate Text stuff in
advanced notation.
+ * Documentation/user/global.itely: better docs for \header.
+
2005-05-03 Han-Wen Nienhuys <hanwen@xs4all.nl>
* scm/framework-ps.scm (write-preamble): extract CFF from OTF
diff --git a/Documentation/user/global.itely b/Documentation/user/global.itely
index aa2c15997a..f3b855e960 100644
--- a/Documentation/user/global.itely
+++ b/Documentation/user/global.itely
@@ -748,8 +748,11 @@ Titles are created for each @code{\score} block, and over a
The contents of the titles are taken from the @code{\header} blocks.
The header block for a book supports the following
@table @code
+@item dedication
+The dedicatee of the music, centered at the top of the first page.
+
@item title
-The title of the music. Centered on top of the first page.
+The title of the music, centered just below the dedication.
@item subtitle
Subtitle, centered below the title.
@@ -786,7 +789,8 @@ Name of the piece, flush-left below the instrument.
This forces the title to start on a new page (set to ##t or ##f).
@end table
-Here is a demonstration of the fields available,
+Here is a demonstration of the fields available. Note that you
+may use any @ref{Text markup} commands in the header.
@lilypond[quote,verbatim,linewidth=11.0\cm]
\paper {
@@ -796,15 +800,17 @@ Here is a demonstration of the fields available,
\book {
\header {
- title = "Title,"
+ dedication = "dedicated to me"
+ title = \markup \center-align < "Title first line" "Title second line, longer" >
subtitle = "the subtitle,"
- subsubtitle = "and the sub sub title"
+ subsubtitle = #(string-append "subsubtitle LilyPond version " (lilypond-version))
poet = "Poet"
- composer = "Composer"
+ composer = \markup \center-align < "composer" \small "(1847-1973)" >
texttranslator = "Text Translator"
- meter = "Meter"
+ meter = \markup { \teeny "m" \tiny "e" \normalsize "t" \large "e" \huge "r" }
arranger = "Arranger"
- instrument = "Instrument"
+ opus = \markup { \fontsize #8.5 "o" \fontsize #2.5 "p" \fontsize #-2.5 "u" \fontsize #-5.3 "s" \fontsize #7.5 " " }
+ instrument = \markup \bold \italic "instrument"
piece = "Piece"
}
@@ -828,15 +834,6 @@ Here is a demonstration of the fields available,
}
@end lilypond
-Different fonts may be selected for each element by using
-@code{\markup}, e.g.,
-
-@example
-\header @{
- title = \markup @{ \italic @{ The italic title @} @}
-@}
-@end example
-
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