This allows the user to apply the same set of options
to different files, or to apply different settings to
the same score without modifying the score itself.
In particular,
lilypond -dinclude-settings=myinclude.ily file.ly
will compile file.ly, but read and execute myinclude.ily
before file.ly is processed. That way, e.g. global paper
changes can be easily done, and a file can be run several
times, each time with a different include-settings file
containing different settings.
This feature is similar to the --init=DATEI feature,
except that --init will replace the whole init sequence
(thus your init file will need to copy all of lilypond's
init.ly), while -dinclude-settings will only add some
definitions to the normal init sequence in init.ly (i.e.
the file is included in init.ly, so the normal init sequence
takes place).
Unfortunately, it is not possible to add lilypond variable
definitions for use in the score... This is probably due
to the way the init sequence works.
@end ignore
+@item
+New option @code{-dinclude-settings=INCLUDEFILE.ly}, which causes lilypond
+to include the given file before the score is processed. This allows the
+user to change global settings without the need to change the score itself.
+That way, several different editions/version (e.g. different page sizes)
+can be generated from a file without having to modify the score for each
+version.
+
@item
The autobeaming settings syntax has been changed. beatLength,
beatGrouping, beamSettings, and measureGrouping have all been eliminated.
#(define book-filename #f)
#(define book-output-suffix #f)
#(use-modules (scm clip-region))
+
+#(if (ly:get-option 'include-settings)
+ (ly:parser-include-string parser
+ (format "\\include \"~a\"" (ly:get-option 'include-settings))))
+
\maininput
%% there is a problem at the end of the input file
"Include book titles in preview images.")
(include-eps-fonts #t
"Include fonts in separate-system EPS files.")
+ (include-settings #f
+"Include file for global settings, included before the score is processed.")
(job-count #f
"Process in parallel, using the given number of
jobs.")