1 @node Invoking LilyPond
3 @chapter Invoking LilyPond
4 @cindex Invoking LilyPond
5 @cindex command line options
6 @cindex options, command line
11 lilypond [OPTION]... [MUDELA-FILE]...
14 @unnumberedsec Lilypond Command Options
18 Output format for sheet music. Choices are tex (for @TeX{}
19 output), ps (for PostScript) and scm (for a Scheme
23 Show a summary of usage.
24 @item --include, -I=DIRECTORY
25 Add @file{DIRECTORY} to the search path for input files.
26 @cindex file searching
29 Set init file to @file{FILE} (default: @file{init.ly}).
32 Disable @TeX{} output. If you have a @code{\midi} definition, it will do the
34 @item -M,--dependencies
35 Output rules to be included in Makefile.
36 @item -o,--output=FILE
37 Set the default output file to @file{FILE}.
38 @item -Q,--find-old-relative
39 show all changes needed to convert a file to relative octave syntax.
42 Disallow untrusted @code{\include} directives, in-line
43 Scheme evaluation, backslashes in @TeX{}, code.
45 @strong{WARNING}: the @code{--safe} option has not been reviewed for
46 over a year; do not rely on it for automatic invocation (e.g. over the
47 web). Volunteers are welcome to do a new audit.
49 @item -T,--no-timestamps
50 don't timestamp the output
53 Switch on any experimental features. Not for general public use.
55 Show version information
59 Show the warranty with which GNU LilyPond comes. (It comes with
60 @strong{NO WARRANTY}!)
64 When invoked with a filename that has no extension, LilyPond will try
65 adding `@file{.ly}' as an extension first.
67 When LilyPond processes @file{filename.ly} it will produce
68 @file{filename.tex} as output (or @file{filename.ps} for PostScript
69 output). If @file{filename.ly} contains more than one @code{\score}
70 block, then LilyPond will output the rest in numbered files, starting
71 with @file{filename-1.tex}. Several files can be specified; they will
72 each be processed independently. @footnote{The status of GUILE is not
73 reset across invocations, so be careful not to change any default
74 settings from within Scheme .}
76 @section Environment variables
80 additional directories for finding lilypond data. The
81 format is like the format of @file{PATH}.
83 This specifies a directory where locale messages and
84 data files will be looked up by default. The directory should contain
85 subdirectories called @file{ly/}, @file{ps/}, @file{tex/}, etc.
88 selects the language for the warning messages of LilyPond.