]> git.donarmstrong.com Git - lilypond.git/blobdiff - INSTALL.txt
* stepmake/aclocal.m4: version check patch (thanks MWD)
[lilypond.git] / INSTALL.txt
index db0ba70a3c7110b40a85d36885bece99d660b6f2..2a431f3a5c0a8c6d9eb00db2c5f15db14fcb0160 100644 (file)
@@ -10,7 +10,7 @@ Abstract
 you should do.  If you are going to compile and install LilyPond often,
 e.g. when doing development, you might want to check out the
 `buildscripts/set-lily.sh' script.  It sets some environment variables
-and symlinks, which comes in handy when you have to compile LilyPond
+and symlinks, which comes in handly when you have to compile LilyPond
 more often.
 
 Obtaining
@@ -48,32 +48,27 @@ Prerequisites
    * Although we recommend to use Unix, LilyPond is known to run on
      Windows NT/95/98 as well.  See Section Windows NT/95,es.
 
-   * EGCS 1.1 or newer. Check out `ftp://ftp.gnu.org/gnu/gcc/'.
+   * EGCS 1.1 or newer. Check out `ftp://ftp.gnu.org/pub/gcc/'.
 
    * Python 1.5, Check out `ftp://ftp.python.org' or
      `ftp://ftp.cwi.nl/pub/python'.
 
-   * GUILE 1.3.4 or newer,  check out
+   * GUILE 1.3.4,  check out
      http://www.gnu.org/software/guile/guile.html
-     (http://www.gnu.org/software/guile/guile.html).  Version 1.4 is
-     recommended for better performance.
+     (http://www.gnu.org/software/guile/guile.html).
 
-   * GNU Make.  Check out ftp://ftp.gnu.org/gnu/make/
-     (ftp://ftp.gnu.org/gnu/make/).
+   * GNU make.  Check out ftp://ftp.gnu.org/make/
+     (ftp://ftp.gnu.org/make/).
 
-   * Flex (version 2.5.4 or newer).  Check out
-     ftp://ftp.gnu.org/gnu/flex/ (ftp://ftp.gnu.org/gnu/flex/).
+   * Flex (version 2.5.4 or newer).  Check out ftp://ftp.gnu.org/flex/
+     (ftp://ftp.gnu.org/flex/).
 
-   * Bison (version 1.25 or newer).  Check out
-     ftp://ftp.gnu.org/gnu/bison/ (ftp://ftp.gnu.org/gnu/bison/).
+   * Bison (version 1.25 or newer).  Check out ftp://ftp.gnu.org/bison/
+     (ftp://ftp.gnu.org/bison/).
 
-   * TeX.  If you want LilyPond to use kpathsea support (recommended),
-     make sure you have tetex 1.0 or newer (1.0.6 is known to work).
-     You may need to install a tetex-devel or tetex-dev package too.
-
-   * Texinfo (version 4.0 or newer).  Check out
-     ftp://ftp.gnu.org/gnu/texinfo/ (ftp://ftp.gnu.org/gnu/texinfo/).
-     Most documentation is in texinfo.
+   * Texinfo. Check out ftp://ftp.gnu.org/pub/texinfo/
+     (ftp://ftp.gnu.org/pub/texinfo/).  Most documentation is in
+     texinfo.
 
    * The geometry package for LaTeX is needed to use ly2dvi.  Available
      at
@@ -81,16 +76,11 @@ Prerequisites
      (ftp://ftp.ctan.org/tex-archive/macros/latex/contrib/supported/geometry)
      or at mirror site ftp://ftp.dante.de (ftp://ftp.dante.de)
 
-   * MetaPost, needed for generating PostScript fonts. Please note that
-     tetex-0.4pl8 (included with Redhat 5.x) does not include
-     `mfplain.mp', which is needed for producing the scalable font
+   * MetaPost, if you want to use direct PostScript output. Please note
+     that  tetex-0.4pl8 (included with Redhat 5.x) does not include
+     `mfplain.mp', which is needed  for producing the scaleable font
      files.
 
-     If you do not want to use PostScript output, edit `mf/GNUmakefile'.
-
-   * kpathsea, a library for searching (TeX) files.  `kpathsea' is
-     usually included with your installation of TeX.
-
 
 Running
 =======
@@ -98,7 +88,7 @@ Running
    GNU LilyPond does use a lot of resources. For operation you need the
 following software
 
-   * TeX.
+   * TeX
 
    * A PostScript printer and/or viewer (such as Ghostscript) is
      strongly     recommended.  Xdvi will show all embedded PostScript
@@ -128,9 +118,8 @@ Website
    The website is the most convenient form to use for reading the
 documentation on-line documentation. It is made by entering
 
-       make htmldoc
-   This does require a  functioning  LilyPond. The binary doesn't have
-to be installed.
+       make website
+   This does require a fully functioning
 
    If you want to auto-generate Lily's website, you'll need some
 additional conversion tools.
@@ -161,15 +150,18 @@ additional conversion tools.
 
      You can then install the new pnmtopng into `/usr/local/bin/'
 
-   * Bib2html (http://pertsserver.cs.uiuc.edu/~hull/bib2html).
-     Which, in turn depends on man2html for proper installation.
-     man2html can be had from
+   * Bib2html http://pertsserver.cs.uiuc.edu/~hull/bib2html.
+     (http://pertsserver.cs.uiuc.edu/~hull/bib2html.)      Which, in
+     turn depends on man2html for proper installation.  man2html can be
+     had from
      http://askdonald.ask.uni-karlsruhe.de/hppd/hpux/Networking/WWW/Man2html-1.05
      (http://askdonald.ask.uni-karlsruhe.de/hppd/hpux/Networking/WWW/Man2html-1.05).
 
      The website will build without this utility, but you will not see
      our hypertextified bibliography.
 
+   * Doc++ (optional) to read the source code.
+
 
 Configuring and compiling
 =========================
@@ -184,20 +176,17 @@ Configuring and compiling
 
    This will install a number of files, something close to:
 
-       /usr/local/man/man1/midi2ly.1
-       /usr/local/man/man1/abc2ly.1
-       /usr/local/man/man1/etf2ly.1
+       /usr/local/man/man1/mi2mu.1
        /usr/local/man/man1/convert-mudela.1
        /usr/local/man/man1/mudela-book.1
        /usr/local/man/man1/lilypond.1
        /usr/local/bin/lilypond
-       /usr/local/bin/midi2ly
+       /usr/local/bin/mi2mu
        /usr/local/bin/convert-mudela
        /usr/local/bin/mudela-book
        /usr/local/bin/abc2ly
-       /usr/local/bin/etf2ly
        /usr/local/share/lilypond/*
-       /usr/local/share/locale/{....}/LC_MESSAGES/lilypond.mo
+       /usr/local/share/locale/{it,nl}/LC_MESSAGES/lilypond.mo
 
    The above assumes that you are root and have the GNU development
 tools, and your make is GNU make.  If this is not the case, you can
@@ -270,9 +259,9 @@ following for the normal build,
    and for the profiling version, I specify a different configuration.
 
 
-           ./configure --prefix=~ --enable-profiling --enable-config=prof --enable-optimise --disable-checking
-           make config=prof
-           make config=prof install
+           ./configure --prefix=~ --enable-profiling --enable-config=optprof --enable-optimise --disable-checking
+           make config=optprof
+           make config=optprof install
 
 Installing
 ==========
@@ -300,7 +289,10 @@ Redhat linux
        rpm -i /usr/src/redhat/RPMS/i386/lilypond-x.y.z
 
    Precompiled i386 RedHat RPMS are available from
-`ftp://ftp.cs.uu.nl/pub/GNU/LilyPond/RedHat/'.
+ftp://freshmeat.net/pub/rpms/lilypond/
+(ftp://freshmeat.net/pub/rpms/lilypond/) and
+http://linux.umbc.edu/software/lilypond/rpms/
+(http://linux.umbc.edu/software/lilypond/rpms/).
 
    For compilation on a RedHat system you need these packages, in
 addition to the those needed for running:
@@ -316,44 +308,11 @@ addition to the those needed for running:
 
    * texinfo
 
-   * tetex-devel
-
 Debian GNU/linux
 ================
 
-   A Debian package is also available; see
-http://packages.debian.org/lilypond
-(http://packages.debian.org/lilypond) or contact Anthony Fok
-<foka@debian.org> for more information.
-
-   The build scripts are in the subdirectory `debian/'; you can make
-the .deb by doing
-
-
-       tar xzf lilypond-x.y.z.tar.gz
-       cd lilypond-x.y.z
-       dpkg-buildpackage
-       dpkg -i ../lilypond_x.y.z*deb
-
-   For compilation on a Debian GNU/Linux system you need these packages,
-in addition to the those needed for running:
-   * libc6-dev
-
-   * libstdc++<your-libstdc++-version-here>-dev
-
-   * libguile<your-libguile-version-here>-dev
-
-   * flex
-
-   * bison
-
-   * gettext
-
-   * texinfo
-
-   * tetex-dev
-
-   * debhelper
+   A Debian package is also available; contact Anthony Fok
+<foka@debian.org>.  The build scripts are in the subdirectory `debian/'.
 
 Windows NT/95
 =============
@@ -370,10 +329,10 @@ your problems.
 
    If you find bugs, please send bug reports to <bug-gnu-music@gnu.org>.
 
-   Bugs that are LilyPond's fault are listed in our TODO list on the
-web, or demonstrated in `input/bugs/'.
+   Known bugs that are LilyPond's fault are listed in `TODO', or
+demonstrated in `input/bugs/'.
 
-   Bugs that are not LilyPond's fault are documented here.
+   Known bugs that are not LilyPond's fault are documented here.
 
 LinuxPPC Bugs:
 **************