X-Git-Url: https://git.donarmstrong.com/?a=blobdiff_plain;f=README.txt;h=c22267cdb82eb69a7b902d125d0e2328761de7e0;hb=a37548f8282019dfb02bca9043e7fbf2a344d560;hp=ba79af36ac7ebe31584dce9c1ed0a877439e13d8;hpb=5b6181075e3615dce049711973d3cd5caa60e5db;p=lilypond.git diff --git a/README.txt b/README.txt index ba79af36ac..c22267cdb8 100644 --- a/README.txt +++ b/README.txt @@ -12,72 +12,66 @@ Versioning LilyPond uses a versioning scheme similar to the Linux kernel. In a version "x.y.z", an even second number 'y' denotes a stable version. -For development versions 'y' is odd. +For development versions 'y' is odd. For using straightforward score +production, please use the latest stable version. Development versions +may not produce good or nice scores. - Version 1.4 is the latest stable release. +Requirements +============ -Compilation -=========== - - For compiling and running LilyPond please refer to the installation -instructions. These instructions can be found when you unpack lilypond, -as `lilypond-x.y.z/INSTALL.txt'. + For the compilation and running of LilyPond you need some additional +packages. Please refer to the installation instructions. NOTE: If you downloaded a binary (.rpm or a W95/NT .zip file), you don't have to compile LilyPond. +Installation +============ + + For your convenience, a formatted copy of the INSTALL instructions +are in the toplevel directory, as INSTALL.txt + Documentation ============= - The documentation is available online at `http://www.lilypond.org/'. -You can also build it locally. This does require a working LilyPond -binary. The following formats are supported: - * HTML. Refer to INSTALL.txt for information on how to make the HTML - documentation. + The real documentation is the directory Documentation/ - * `.dvi', for the tutorial and reference manual. Do + If you want to read the documentation online, these are options: + * use `.html'. Refer to INSTALL.txt for info on how to make the + .html documentation. - make -C Documentation/user/ dvi - The printable documentation is left in `Documentation/user/out/'. + * use `.html'. Point your browser to + `http://www.cs.uu.nl/~hanwen/lilypond/index.html'. - * paper. Create the .dvi documentation, and print it with dvips. + * use `.dvi', for the tutorial and reference manual. Do + make -C Documentation/user/ dvi -Comments -======== - - LilyPond is a long way from finished and polished, so please send -your criticism, comments, bugreports, patches, etc., to the mailing -list, _not_ to us personally. + * use ASCII. Do using + make -C doc - We have the following mailing lists: - * info-lilypond@gnu.org - (http://mail.gnu.org/mailman/listinfo/info-lilypond) is a - low-volume list for information on the GNU Music project. - This list is moderated; ask David R. Linn or - Han-Wen to send announcements for this list. +Comments +======== - * lilypond-devel@gnu.org - (http://mail.gnu.org/mailman/listinfo/lilypond-devel) For - discussions about developing lilypond, in particular the unstable - series. + LilyPond is a long way from finished and polished. We do appreciate +criticism, comments, bugreports, patches, etc. - * lilypond-user@gnu.org - (http://mail.gnu.org/mailman/listinfo/lilypond-user) For - discussions about using lilypond, in particular the stable series. + Please send your e-mail to one of the MAILING LISTS - * bug-lilypond@gnu.org - (http://mail.gnu.org/mailman/listinfo/bug-lilypond) If you have - bugreports, you should send them to this list. + and _not_ to us personally. See `Documentation/mail.texi' for more +info. Windows 32 ========== If you have received this file as part of a DOS/Window32 distribution -(`LilyPond-*.zip'), it is advisable to also download the source package -(ftp://ftp.cs.uu.nl/pub/GNU/LilyPond/), since it might contain more -documentation +(`LilyPond-*.zip'), it is advisable to also download the source +package, since it might contain more documentation +`ftp://ftp.cs.uu.nl/pub/GNU/LilyPond/' + + If you decide to build LilyPond from source, please read the +INSTALL.txt document first, especially the Windows NT/95 section. Caveats ======= @@ -91,8 +85,15 @@ files, eg., Bugs ==== - Send bug reports to . For help and questions -use and . Please + Send bug reports to . For help and questions +use and . Please consult the FAQ and installation instructions before mailing your problems. +CDROM distributions +=================== + + If you have received LilyPond on a cdrom, chances are that +development has moved some patchlevels up. Please check the latest +version of LilyPond before reporting bugs. +