3 This is the toplevel README to LilyPond
4 ***************************************
6 LilyPond is a music typesetter. It produces beautiful sheet music
7 using a high level description file as input. LilyPond is part of the
13 LilyPond uses a versioning scheme similar to the Linux kernel. In a
14 version "x.y.z", an even second number 'y' denotes a stable version.
15 For development versions 'y' is odd. So, in theory, version 1.2 is
16 stable, which means that there are no glaring errors in it. In practice
17 1.2.x is also unmaintained.
19 1.3.x is in healthy development: lots of problems turn up, but
20 they're fixed quickly. Therefore we recommend you try 1.2.x, if you
21 have any problem with it, upgrade to the latest 1.3.x release.
26 For the compilation and running of LilyPond you need some additional
27 packages. Please refer to the installation instructions in
30 NOTE: If you downloaded a binary (.rpm or a W95/NT .zip file), you
31 don't have to compile LilyPond.
36 For your convenience, a formatted copy of the INSTALL instructions
37 are in the toplevel directory, as INSTALL.txt
42 The documentation is available online at
43 `http://www.cs.uu.nl/~hanwen/lilypond/index.html'. You can also build
44 it locally. This does require a working LilyPond binary. The following
45 formats are supported:
46 * HTML. Refer to INSTALL.txt for information on how to make the HTML
49 * `.dvi', for the tutorial and reference manual. Do
51 make -C Documentation/user/ dvi
52 The printable documentation is left in `Documentation/user/out/'.
54 * paper. Create the .dvi documentation, and print it with dvips.
60 LilyPond is a long way from finished and polished, so we please send
61 your criticism, comments, bugreports, patches, etc., to the mailing
62 list. and _not_ to us personally.
64 We have the following mailing lists:
66 * info-gnu-music@gnu.org
67 (http://mail.gnu.org/mailman/listinfo/info-gnu-music) is a
68 low-volume list for information on the GNU Music project.
69 This list is moderated; ask David R. Linn <drl@gnu.org> or
70 Han-Wen <hanwen@cs.uu.nl> to send announcements for this list.
72 * gnu-music-discuss@gnu.org
73 (http://mail.gnu.org/mailman/listinfo/gnu-music-discuss) For
74 general discussions concerning LilyPond.
76 * help-gnu-music@gnu.org
77 (http://mail.gnu.org/mailman/listinfo/help-gnu-music) For help
80 * bug-gnu-music@gnu.org
81 (http://mail.gnu.org/mailman/listinfo/bug-gnu-music) If you have
82 bugreports, you should send them to this list.
87 If you have received this file as part of a DOS/Window32 distribution
88 (`LilyPond-*.zip'), it is advisable to also download the source
89 package, since it might contain more documentation
90 `ftp://ftp.cs.uu.nl/pub/GNU/LilyPond/'
95 If you have installed a previous version, be sure to remove old font
97 rm `find /var/lib/texmf/fonts -name 'feta*'`
99 a script to do this for you is in `buildscripts/clean-fonts.sh'
104 Send bug reports to <bug-gnu-music@gnu.org>. For help and questions
105 use <help-gnu-music@gnu.org> and <gnu-music-discuss@gnu.org>. Please
106 consult the FAQ and installation instructions before mailing your