patch::: 1.3.120.jcn1

[lilypond.git] / README.txt

diff --git a/README.txt b/README.txt
index c22267cdb82eb69a7b902d125d0e2328761de7e0..4c9e5742617f797595370e72b4bc687d0a6ca437 100644 (file)
--- a/README.txt
+++ b/README.txt
@@ -12,9 +12,13 @@ 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 using straightforward score
-production, please use the latest stable version.  Development versions
-may not produce good or nice scores.
+For development versions 'y' is odd.  Sh, in theory, version 1.2 is
+stable, which means that there are no glaring errors in it. In practice
+1.2.x is also unmaintained.
+
+   1.3.x is in healthy development: lots of problems turn up, but
+they're fixed quickly. Therefore we recommend you try 1.2.x, if you
+have any problem with it, upgrade to the latest 1.3.x release.
 
 Requirements
 ============
@@ -37,30 +41,46 @@ Documentation
    The real documentation is the directory Documentation/
 
    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.
+   * use HTML. Refer to INSTALL.txt for information on how to make the
+     HTML documentation.
 
-   * use `.html'. Point your browser to
+   * use HTML. Point your browser to
      `http://www.cs.uu.nl/~hanwen/lilypond/index.html'.
 
    * use `.dvi',  for the tutorial and reference manual. Do
 
             make -C Documentation/user/ dvi
 
+     You need a working LilyPond binary to create the DVI and HTML
+     sources.
+
    * use ASCII. Do using
-               make -C doc
+               make doc
 
 
 Comments
 ========
 
    LilyPond is a long way from finished and polished.  We do appreciate
-criticism, comments, bugreports, patches, etc.
+criticism, comments, bugreports, patches, etc., but please,
 
           Please send your e-mail to one of the MAILING LISTS
 
-   and _not_ to us personally.  See `Documentation/mail.texi' for more
-info.
+   and _not_ to us personally. We have the following mailing lists:
+
+   * info-gnu-music@gnu.org
+     (http://mail.gnu.org/mailman/listinfo/info-gnu-music) is a
+     low-volume list for information on the GNU Music project.
+     This list is moderated; ask     David R. Linn <drl@gnu.org> or
+     Han-Wen <hanwen@cs.uu.nl> to send announcements for this list.
+
+   * help-gnu-music@gnu.org
+     (http://mail.gnu.org/mailman/listinfo/help-gnu-music)     For help
+     with using LilyPond.
+
+   * bug-gnu-music@gnu.org
+     (http://mail.gnu.org/mailman/listinfo/bug-gnu-music) If you have
+     bugreports, you should send them to this list.
 
 Windows 32
 ==========