2 @node Invoking LilyPond, , , Top
3 @chapter Invoking LilyPond
4 @cindex Invoking LilyPond
8 @strong{lilypond} [OPTION]... [MUDELA-FILE]...
15 Output format for sheet music. Choices are tex (for @TeX{}
16 output), ps (for PostScript) and scm (for GUILE)
18 add @file{FILE} to the search path for input files.
20 Disable @TeX{} output. If you have a \midi definition, it will do the
22 @item -M,--dependencies
23 Also output rules to be included in Makefile.
25 Turn debugging info on. GNU LilyPond reads the file @file{.dstreamrc},
26 which lists what functions and classes may produce copious debugging
29 Disallow untrusted @code{\include} directives, backslashes in @TeX{}
30 code and named output.
32 Switch on any experimental features. Not for general public use.
34 Show the warranty with which GNU LilyPond comes. (It comes with
35 @strong{NO WARRANTY}!)
36 @item -o,--output=FILE
37 Set the default output file to @file{FILE}.
39 Show a summary of usage.
41 Set init file to @file{FILE} (default: @file{init.ly}).
42 @item --include, -I=DIRECTORY
43 Add @file{DIRECTORY} to the search path for input files.
44 @item --ignore-version, -V
45 Make the incompatible mudela version warning non-fatal.
50 When invoked with a filename that has no extension, LilyPond will try
51 adding `@file{.ly}' as an extension first.
53 @c ****** Is the following on its way out? /MB
54 If you invoke LilyPond with a file `@file{foo.}@var{ext}' that doesn't
55 have the `@file{.ly}' extension, then LilyPond will look for a file
56 called `@file{init.}@var{ext}' and process this file. The file
57 `@file{init.}@var{ext}' must contain the @code{\maininput} keyword or
58 LilyPond will not read the user specified file.
60 When LilyPond processes @file{filename.ly} it will produce
61 @file{filename.tex} as output. If @file{filename.ly} contains a second
62 @code{\paper} keyword, then LilyPond will produce @file{filename-1.tex}
63 as well. Subsequent @code{\paper} keywords will produce sequentially
64 numbered file names. Several files can be specified; they will each
65 be processed independently.@footnote{Not entirely true: The status of
70 @section Environment variables
74 additional directories for finding lilypond data. The
75 format is like the format of @file{PATH}.
79 selects the language for the warning messages of LilyPond.