1 .TH "LilyPond" "1" "1999" "The LilyPond package" "The GNU Project Music Typesetter"
5 LilyPond \- the GNU Music Typesetter
8 \fBlilypond\fP [OPTION]\&.\&.\&. [MUDELA-FILE]\&.\&.\&.
12 LilyPond is a music typesetter\&. It produces beautiful sheet music
13 using a high level description file as input\&. LilyPond is part of
19 Output format for sheet music\&. Choices are tex (for TeX
20 output), ps (for PostScript) and scm (for GUILE)
22 add \fBFILE\fP to the search path for input files\&.
24 Disable TeX output\&. If you have a \emidi definition, it will do the
26 .IP "-M,--dependencies"
27 Also output rules to be included in Makefile\&.
29 Turn debugging info on\&. GNU LilyPond reads the file \fB\&.dstreamrc\fP,
30 which lists what functions and classes may produce copious debugging
33 Disallow untrusted \f(CW\einclude\fP directives, backslashes in
34 code and named output\&.
36 Switch on any experimental features\&. Not for general public use\&.
38 Show the warranty with which GNU LilyPond comes\&. (It comes with
40 .IP "-o,--output=FILE"
41 Set the default output file to \fBFILE\fP\&.
43 Show a summary of usage\&.
45 Set init file to \fBFILE\fP (default: \fBinit\&.ly\fP)\&.
46 .IP "--include, -I=DIRECTORY"
47 Add \fBDIRECTORY\fP to the search path for input files\&.
48 .IP "--ignore-version, -V"
49 Make the incompatible mudela version warning non-fatal\&.
53 This is an overview of the features that GNU LilyPond supports\&. For
54 details on how to use them, you should consult the Mudela tutorial,
55 which is included with the package\&.
58 ASCII script input, with identifiers (for music reuse),
59 customizable notenames, customisable fontset\&.
61 MIDI output lets you check if you have entered the correct notes\&.
63 MIDI to Mudela conversion through the mi2mu program\&.
65 Multiple staffs in one score\&. Each staff can have different time signatures\&.
67 Beams, slurs, ties, chords, super/subscripts (accents and text)
68 triplets, general n-plet (triplet, quadruplets, etc\&.), lyrics,
69 transposition, dynamics (both absolute and hairpin style)\&.
71 Multiple voices within one staff; beams optionally shared
72 between voices\&. Up to four voices is handled cleanly\&.
74 Multiple scores within one input file\&. Each score is output to
77 Clef changes, meter changes, cadenza-mode, key changes, repeat bars\&.
81 GNU LilyPond is copyright 1996-1999 by its authors\&. GNU LilyPond is
82 distributed under the terms of the GNU General Public License\&. GNU LilyPond
83 is provided without any warranty what so ever\&.
84 GNU LilyPond may be freely distributed\&. For further information consult
85 the GNU General Public License, from the file \fBCOPYING\fP\&.
89 There is an extensive list of todoes and bugs\&. See the file
90 \fBTODO\fP distributed with the sources\&. If you have a problem you
91 should try to find out
94 If the bug has been fixed in a newer release\&.
96 If the bug has been found earlier, consult \fBTODO\fP and \fBBUGS\fP\&.
98 If you have found a bug, then we would appreciate it if you sent a
102 Send a copy of the input which causes the error\&.
104 Send a description of the platform you use\&.
106 Send a description of the LilyPond version you use
107 (with compile/configure options please)\&.
109 Send a description of the bug itself\&.
111 Send it to bug-gnu-music@gnu\&.org; you don\'t have to be subscribed
112 to this mailinglist\&.
115 .IP "\fBinit\&.ly\fP"
116 The initialisation file with symbol tables etc\&. It
117 includes files from the directory
118 \fBPREFIX/share/lilypond/ly/\fP\&. (\fBPREFIX\fP typically is \fB/usr/local\fP
124 additional directories for finding lilypond data\&. The
125 format is like the format of \fBPATH\fP\&.
129 selects the language for the warning messages of LilyPond\&.
133 Lots of them\&. See \fBTODO\fP and \fBBUGS\fP
137 LilyPond comes with various other documentation files\&. They are
138 included in the source package\&.
140 A further source for information is the website, which can be found at
141 http://www\&.lilypond\&.org/\&. The website contains on-line versions
144 GNU LilyPond is updated very frequently, the latest version is always
145 available at: ftp://ftp\&.cs\&.uu\&.nl/pub/GNU/LilyPond\&. This FTP
146 site is mirrored at a number of sites; consult the project web pages
147 for information about mirrors\&.
149 For programs which are part of the GNU music project, the following
150 mailing list have been setup:
152 .IP "info-gnu-music@gnu\&.org"
153 For information on the GNU Music project, to subscribe: send mail with
154 subject "subscribe" to info-gnu-music-request@gnu\&.org
155 .IP "help-gnu-music@gnu\&.org"
156 For help with programs from the GNU music project\&. To subscribe: send
157 mail with subject "subscribe" to help-gnu-music-request@gnu\&.org
158 .IP "bug-gnu-music@gnu\&.org"
159 If you have bugreports, you should send them to this list\&. If you want
160 to read all bugreports, you should subscribe to this list\&. To
161 subscribe: send mail with subject "subscribe" to
162 bug-gnu-music-request@gnu\&.org
163 .IP "gnu-music-discuss@gnu\&.org"
164 For discussions concerning the GNU Music project, to subscribe: send
165 mail with subject "subscribe" to
166 gnu-music-discuss-request@gnu\&.org
168 Announces of new versions will be sent to info-gnu-music and
173 GNU LilyPond has no connection with the music package Rosegarden, other
174 than the names being similar :-)
179 Han-Wen Nienhuys <hanwen@cs\&.uu\&.nl>
180 http://www\&.cs\&.uu\&.nl/people/hanwen
182 Jan Nieuwenhuizen <janneke@gnu\&.org>
183 http://www\&.xs4all\&.nl/~jantien
185 Please consult the documentation file \fBAUTHORS\fP for more detailed
186 information, and small contributions\&.