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 If you invoke LilyPond with a file `@file{foo.}@var{ext}' that doesn't
54 have the `@file{.ly}' extension, then LilyPond will look for a file
55 called `@file{init.}@var{ext}' and process this file. The file
56 `@file{init.}@var{ext}' must contain the @code{\maininput} keyword or
57 LilyPond will not read the user specified file.
59 When LilyPond processes @file{filename.ly} it will produce
60 @file{filename.tex} as output. If @file{filename.ly} contains a second
61 @code{\paper} keyword, then LilyPond will produce @file{filename-1.tex}
62 as well. Subsequent @code{\paper} keywords will produce sequentially
63 numbered file names. Several files can be specified; they will each
64 be processed independently.@footnote{Not entirely true: The status of
69 @section Environment variables
73 additional directories for finding lilypond data. The
74 format is like the format of @file{PATH}.
78 selects the language for the warning messages of LilyPond.