]> git.donarmstrong.com Git - lilypond.git/blobdiff - INSTALL.txt
release: 1.5.23
[lilypond.git] / INSTALL.txt
index 22e59ba08c786630ccde8b0561bc391cfaa1ce5e..972e0c14e503a87bd52cfb9e6aeecae45c7a7e3c 100644 (file)
@@ -8,8 +8,8 @@ Table of Contents
 
 INSTALL - compiling and installing GNU LilyPond
   Downloading
-    source code
-    Binaries
+    Source code
+    Precompiled binaries
     Upgrading
   Requirements
     Compilation
@@ -49,7 +49,7 @@ version (1.2) reside on the GNU servers
 latest odd numbered version (1.3), whose webpages are on the lilypond
 site (http://www.lilypond.org/).
 
-source code
+Source code
 -----------
 
    If you want to compile LilyPond from source, download here:
@@ -62,21 +62,39 @@ source code
    * at `lilypond.org' `ftp://ftp.lilypond.org/pub/LilyPond/' by FTP and
      `http://www.lilypond.org/ftp/' by HTTP.
 
-Binaries
---------
+   Of course, if your platform supports LilyPond, such as Debian
+GNU/Linux, FreeBSD, OpenBSD or NetBSD, you're encouraged to use the
+native build from source drill.
+
+   For Red Hat Linux and SuSE Linux, `.spec' files are included in the
+tarball; see instructions below.
+
+Precompiled binaries
+--------------------
+
+   If you want to track bleeding edge development, try:
 
-   Binaries are available, but are not updated for every version
+   * Debian GNU/Linux
+     (ftp://ftp.debian.org/debian/pool/main/l/lilypond/) usually has
+     the latest binaries for the most useful stable and development
+     versions, while
+
+   * Mandrake Cooker
+     (http://rpmfind.net/linux/mandrake/cooker/contrib/RPMS/) also
+     provides fairly recent versions.
+
+   Binaries are made available for other popular platforms, but as we
+need to compile them ourselves, they are not updated for every version
 released.
+
    * Red Hat i386
      (ftp://ftp.cs.uu.nl/pub/GNU/LilyPond/binaries/RedHat/RPMS/)
 
-   * LinuxPPC (ftp://ftp.lilypond.org/pub/LilyPond/binaries/linuxppc/)
-
-   * Debian GNU/Linux
-     (ftp://ftp.debian.org/debian/pool/main/l/lilypond/)
+   * SuSE (ftp://ftp.lilypond.org/pub/LilyPond/binaries/SuSE)
 
-   * Windows Testing (http://www.lilypond.org/gnu-windows/)
+   * LinuxPPC (ftp://ftp.lilypond.org/pub/LilyPond/binaries/linuxppc/)
 
+   * Windows (http://www.lilypond.org/gnu-windows/)
 
 Upgrading
 ---------
@@ -142,15 +160,6 @@ Compilation
      (ftp://ftp.ctan.org/tex-archive/macros/latex/contrib/supported/geometry).
      This package is normally included with the TeX distribution.
 
-   * MetaPost, needed for generating PostScript fonts. Please note that
-     tetex-0.4pl8 (included with Red Hat 5.x) does not include
-     `mfplain.mp', which is needed for producing the scalable font
-     files.
-
-     If you don't have MetaPost and don't want to use PostScript
-     output, then edit `mf/GNUmakefile', removing the line saying
-     `PFA_FILES='.
-
    * kpathsea, a library for searching (TeX) files.  `kpathsea' is
      usually included with your installation of TeX.  You may need to
      install a tetex-devel or tetex-dev package too.
@@ -163,6 +172,21 @@ Compilation
 
           ./configure --without-kpathsea --enable-tfm-path=/usr/share/texmf/fonts/tfm/public/cm/:/usr/share/texmf/fonts/tfm/ams/symbols
 
+   * pktrace, [OPTIONAL], needed for generating PostScript Type1 fonts.
+     Get it from  `http://www.cs.uu.nl/~hanwen/pktrace/'
+
+   * autotrace-0.27a, [OPTIONAL], needed for generating PostScript Type1
+     fonts. `http://autotrace.sourceforge.net'.
+
+   * MetaPost [OPTIONAL] needed for generating PostScript Type3 fonts.
+     Please note that tetex-0.4pl8 (included with Red Hat 5.x) does not
+     include `mfplain.mp', which is needed for producing the scalable
+     font files.
+
+     If you don't have MetaPost and don't want to use PostScript
+     output, then edit `mf/GNUmakefile', removing the line saying
+     `PFA_FILES='.
+
 
 Running requirements
 --------------------
@@ -314,13 +338,6 @@ addition to the those needed for running: glibc-devel, gcc-c++,
 libstdc++-devel, guile-devel, flex, bison, texinfo, tetex-devel, groff,
 libgr-progs.
 
-   Warning
-
-   There appears to be a problem with the Xdvi shipped with Red Hat 7.1.
-Symptoms: Xdvi responds very sluggishly or hangs while viewing lilypond
-output. The cause for this problem is unknown; you are advised to
-recompile Xdvi from source.
-
 LinuxPPC
 --------
 
@@ -356,7 +373,11 @@ Mandrake
 --------
 
    Some binaries are available at rpmfind.net. Refer to
-`ftp://ftp.rpmfind.net/linux/Mandrake-devel/cooker/contrib/RPMS/'.
+`http://rpmfind.net/linux/mandrake/cooker/contrib/RPMS/'.
+
+   You can also compile a RPM for Mandrake yourself.  A spec file is in
+`make/out/lilypond.mandrake.spec', see the instructions for building
+the Red Hat RPM.
 
 Debian GNU/Linux
 ----------------
@@ -366,6 +387,15 @@ running `apt-get' as root:
 
        apt-get install lilypond lilypond-doc
 
+   You can also compile the .deb for Debian yourself, do:
+
+       apt-get -b source lilypond
+
+   If you're real impatient, you may even do:
+
+       cd lilypond-x.y.z   # a previous version
+             uscan               # download and build latest directly from upstream
+
    Debian's TeX installation is a bit short on memory, you may want to
 increase it like this:
      --- /etc/texmf/texmf.cnf.dpkg     Sun Jan 28 14:12:14 2001
@@ -456,8 +486,9 @@ by running \`apt-get' as root before building the package:
 
    For Debian in development ("unstable", the future 2.3 or 3.0):
 
-       apt-get install task-debian-devel task-c++-dev \
-               python-base libguile9-dev tetex-bin libkpathsea-dev \
+       apt-get install binutils cpp gcc libc6-dev \
+               g++ libstdc++2.10-dev \
+               python-base libguile-dev tetex-bin libkpathsea-dev \
                tetex-extra flex bison texinfo bibtex2html groff gs \
                netpbm m4 gettext