From: Colin Campbell <cpkc@shaw.ca>
Date: Mon, 14 Feb 2011 02:50:56 +0000 (-0700)
Subject: DOC: add description of -dinclude-settings
X-Git-Tag: release/2.13.51-1~33
X-Git-Url: https://git.donarmstrong.com/?a=commitdiff_plain;h=c30bc6ca8f37c48f8d2d0b38d0175fb458a47167;p=lilypond.git

DOC: add description of -dinclude-settings

Adds menu reverences and a description of using -dinclude-settings
on the comand line, to change among various global parameters
such as paper or font size.
---

diff --git a/Documentation/notation/input.itely b/Documentation/notation/input.itely
index 1ef4354423..50f61545fe 100644
--- a/Documentation/notation/input.itely
+++ b/Documentation/notation/input.itely
@@ -1113,6 +1113,7 @@ structure while leaving the notation untouched.
 @menu
 * Using variables::
 * Using tags::
+* Using global settings::
 @end menu
 
 @node Using variables
@@ -1331,6 +1332,33 @@ than one tagged section at the same place.
 
 @end ignore
 
+@node Using global settings
+@unnumberedsubsubsec Using global settings
+
+@cindex include-settings
+
+Global settings can be incuded from a separate file:
+
+@example
+lilypond -dinclude-settings=MY_SETTINGS.ly MY_SCORE.ly
+@end example
+
+Groups of settings such as page size, font or type face can be stored
+in separate files. This allows different editions from the same score
+as well as standard settings to be applied to many scores, simply by
+specifying the proper settings file.
+
+This technique also works well with the use of style sheets, as
+discussed in @rlearning{Style sheets}.
+
+@seealso
+Learning Manual:
+@rlearning{Organizing pieces with variables},
+@rlearning{Style sheets}.
+
+Notation Reference:
+@ref{Including LilyPond files}.
+
 @node Text encoding
 @subsection Text encoding