X-Git-Url: https://git.donarmstrong.com/?a=blobdiff_plain;f=Documentation%2Ftopdocs%2FREADME.texi;h=20a051f983d79a0c86d19e5eac90a962acdcf9bb;hb=3e0974be7b4d4ae1cedebeee8376093fe8816740;hp=6b9fd0db794029de96016139d7a3f658dfbf8d16;hpb=fc707bc9d993a3891029b87e1243de93b570bd6d;p=lilypond.git diff --git a/Documentation/topdocs/README.texi b/Documentation/topdocs/README.texi index 6b9fd0db79..20a051f983 100644 --- a/Documentation/topdocs/README.texi +++ b/Documentation/topdocs/README.texi @@ -1,125 +1,89 @@ \input texinfo @c -*-texinfo-*- +@documentencoding utf-8 +@documentlanguage en @setfilename README.info -@settitle This is the toplevel README to LilyPond +@settitle Toplevel README -@html - -@end html -@node Top, , , +@node Top @top -@chapter This is the toplevel README to LilyPond +@chapter Toplevel README LilyPond is a music typesetter. It produces beautiful sheet music -using a high level description file as input. LilyPond is part of -the GNU Project. +using a description file as input. LilyPond is part of the GNU +Project. @section 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. +LilyPond uses a versioning scheme that easily identifies stable and +development releases. In a version "x.y.z", an even second number 'y' +denotes a stable version. For development versions 'y' is odd. -Version 1.4 is the latest stable release. +@section Downloading +The primary download site for sourcecode is +@uref{http://lilypond.org/download/}. @section Compilation -For compiling and running LilyPond please refer to the installation -instructions. These instructions can be found when you unpack lilypond, -as @file{lilypond-x.y.z/INSTALL.txt}. - - -NOTE: If you downloaded a binary (.rpm or a W95/NT .zip file), -you don't have to compile LilyPond. - +For compiling and running LilyPond see the installation instructions. +These instructions can be found when you unpack lilypond, as +@file{lilypond-x.y.z/INSTALL.txt}. They are also available on the web +at +@uref{http://lilypond.org/doc/v2.12/Documentation/topdocs/INSTALL.html}. @section Documentation The documentation is available online at -@uref{http://www.lilypond.org/}. You can also build it locally. This -does require a working LilyPond binary. The following formats are -supported: -@itemize @bullet +@uref{http://lilypond.org/doc/}. -@item HTML. Refer to INSTALL.txt for information -on how to make the HTML documentation. - -@item @file{.dvi}, for the tutorial and reference manual. Do -@example - - make -C Documentation/user/ dvi - -@end example -The printable documentation is left in @file{Documentation/user/out/}. - -@item paper. Create the .dvi documentation, and print it with dvips. - -@end itemize +You can also build it locally: follow the instructions under `Building +documentation' in the installation instructions. @section Comments -LilyPond is a long way from finished and polished, so please send your -criticism, comments, bugreports, patches, etc., to the mailing list, -@emph{not} to us personally. +Send your criticism, comments, bugreports, patches, etc. to the mailing +list, not to us personally. @html @end html - - We have the following mailing lists: @itemize @bullet -@item @uref{http://mail.gnu.org/mailman/listinfo/info-lilypond,info-lilypond@@gnu.org} -is a low-volume list for information on the GNU Music project. - This list is moderated; ask +@item @uref{http://lists.gnu.org/mailman/listinfo/info-lilypond,info-lilypond@@gnu.org} +is a low-volume list for information on LilyPond project. + This list is moderated; ask @email{drl@@gnu.org, David R. Linn} or - @email{hanwen@@cs.uu.nl, Han-Wen} to send announcements for this + @email{hanwen@@xs4all.nl, Han-Wen} to send announcements for this list. + @item -@uref{http://mail.gnu.org/mailman/listinfo/lilypond-devel,lilypond-devel@@gnu.org} - For discussions about developing lilypond, in particular the unstable series. +@uref{http://lists.gnu.org/mailman/listinfo/lilypond-devel,lilypond-devel@@gnu.org} + for discussions about developing LilyPond, in particular the unstable series. -@item @uref{http://mail.gnu.org/mailman/listinfo/lilypond-user,lilypond-user@@gnu.org} - For discussions about using lilypond, in particular the stable series. +@item @uref{http://lists.gnu.org/mailman/listinfo/lilypond-user,lilypond-user@@gnu.org} + for discussions about using LilyPond, in particular the stable series. -@item @uref{http://mail.gnu.org/mailman/listinfo/bug-lilypond,bug-lilypond@@gnu.org} -If you have bugreports, you should send them to this list. +@item @uref{http://lists.gnu.org/mailman/listinfo/bug-lilypond,bug-lilypond@@gnu.org} +for sending bugreports. -@item @uref{http://mail.gnu.org/mailman/listinfo/lilypond-cvs,lilypond-cvs@@gnu.org} - Commit messages for CVS development. This is a high-volume moderated - list. +@item @uref{http://lists.gnu.org/mailman/listinfo/lilypond-cvs,lilypond-cvs@@gnu.org} + for log files from the +autobuild. @end itemize - -@section Windows 32 - -If you have received this file as part of a DOS/Window32 distribution -(@file{LilyPond-*.zip}), it is advisable to also download the -@uref{ftp://ftp.cs.uu.nl/pub/GNU/LilyPond/,source package}, since it -might contain more documentation - -@section Caveats - -If you have installed a previous version, be sure to remove old font -files, eg., -@example -rm `find /var/lib/texmf/fonts -name 'feta*'` -@end example - -a script to do this for you is in @file{buildscripts/out/clean-fonts} +You can search the lists from our @uref{http://lilypond.org/search, +searching facilities}. @section Bugs Send bug reports to @email{bug-lilypond@@gnu.org}. For help and -questions use @email{lilypond-user@@gnu.org}. Please consult the FAQ -and installation instructions before mailing your problems. - +questions use @email{lilypond-user@@gnu.org}. @bye