1 \input texinfo @c -*-texinfo-*-
2 @setfilename README.info
3 @settitle This is the toplevel README to LilyPond
6 <!--- @@WEB-TITLE@@=README --->
12 @chapter This is the toplevel README to LilyPond
15 LilyPond is a music typesetter. It produces beautiful sheet music
16 using a high level description file as input. LilyPond is part of
21 LilyPond uses a versioning scheme similar to the Linux kernel. In a
22 version "x.y.z", an even second number 'y' denotes a stable version.
23 For development versions 'y' is odd.
25 Version 1.4 is the latest stable release.
30 For compiling and running LilyPond please refer to the installation
31 instructions. These instructions can be found when you unpack lilypond,
32 as @file{lilypond-x.y.z/INSTALL.txt}.
35 NOTE: If you downloaded a binary (.rpm or a W95/NT .zip file),
36 you don't have to compile LilyPond.
39 @section Documentation
41 The documentation is available online at
42 @uref{http://www.lilypond.org/}. You can also build it locally. This
43 does require a working LilyPond binary. The following formats are
47 @item HTML. Refer to INSTALL.txt for information
48 on how to make the HTML documentation.
50 @item @file{.dvi}, for the tutorial and reference manual. Do
53 make -C Documentation/user/ dvi
56 The printable documentation is left in @file{Documentation/user/out/}.
58 @item paper. Create the .dvi documentation, and print it with dvips.
65 LilyPond is a long way from finished and polished, so please send your
66 criticism, comments, bugreports, patches, etc., to the mailing list,
67 @emph{not} to us personally.
70 <a name="mailing-lists">
75 We have the following mailing lists:
78 @item @uref{http://mail.gnu.org/mailman/listinfo/info-lilypond,info-lilypond@@gnu.org}
79 is a low-volume list for information on the GNU Music project.
80 This list is moderated; ask
81 @email{drl@@gnu.org, David R. Linn} or
82 @email{hanwen@@cs.uu.nl, Han-Wen} to send announcements for this
85 @uref{http://mail.gnu.org/mailman/listinfo/lilypond-devel,lilypond-devel@@gnu.org}
86 For discussions about developing lilypond, in particular the unstable series.
88 @item @uref{http://mail.gnu.org/mailman/listinfo/lilypond-user,lilypond-user@@gnu.org}
89 For discussions about using lilypond, in particular the stable series.
91 @item @uref{http://mail.gnu.org/mailman/listinfo/bug-lilypond,bug-lilypond@@gnu.org}
92 If you have bugreports, you should send them to this list.
94 @item @uref{http://mail.gnu.org/mailman/listinfo/lilypond-cvs,lilypond-cvs@@gnu.org}
95 Commit messages for CVS development. This is a high-volume moderated
102 If you have received this file as part of a DOS/Window32 distribution
103 (@file{LilyPond-*.zip}), it is advisable to also download the
104 @uref{ftp://ftp.cs.uu.nl/pub/GNU/LilyPond/,source package}, since it
105 might contain more documentation
109 If you have installed a previous version, be sure to remove old font
112 rm `find /var/lib/texmf/fonts -name 'feta*'`
115 a script to do this for you is in @file{buildscripts/out/clean-fonts}
119 Send bug reports to @email{bug-lilypond@@gnu.org}. For help and
120 questions use @email{lilypond-user@@gnu.org}. Please consult the FAQ
121 and installation instructions before mailing your problems.