+Table of Contents
+*****************
+
+
+
+
+INSTALL - compiling and installing GNU LilyPond
+ Downloading
+ source code
+ Binaries
+ Upgrading
+ Requirements
+ Compilation
+ Running requirements
+ Website requirements
+ Building LilyPond
+ Configuring for multiple platforms
+ Emacs mode
+ Compiling for distributions
+ Red Hat Linux
+ SuSE
+ Mandrake
+ Debian GNU/Linux
+ Problems
+ NetBSD
+ Solaris:
+ AIX
+
+
INSTALL - compiling and installing GNU LilyPond
***********************************************
-Downloading source code
-=======================
+ This document describes how to build LilyPond on Unix platforms. It
+is also known to run and compile on Windows NT/95/98 as well. More
+information on this topic can be found at the LilyPond on Windows page
+(ftp://ftp.lilypond.org/pub/LilyPond/gnu-windows/).
- If you want to compile LilyPond from source, download here:
- * Download stable releases at GNU (ftp://ftp.gnu.org/gnu/lilypond/)
+Downloading
+===========
- * Download development releases from by FTP
- (ftp://ftp.cs.uu.nl/pub/GNU/LilyPond/development/) and by HTTP
- (http://ftp.cs.uu.nl/pub/GNU/LilyPond/development/).
+ Even numbered versions are `stable'. The webpages for the stable
+version (1.2) reside on the GNU servers
+(http://www.gnu.org/software/lilypond). Big enhancements go into the
+latest odd numbered version (1.3), whose webpages are on the lilypond
+site (http://www.lilypond.org/).
- * ftp (Canadian mirror) (ftp://sca.uwaterloo.ca/pub/)
+source code
+-----------
- * at `lilypond.org' by FTP (ftp://ftp.lilypond.org/pub/LilyPond/) and
- HTTP (http://www.lilypond.org/ftp/).
+ If you want to compile LilyPond from source, download here:
+ * Download development releases from
+ `ftp://ftp.cs.uu.nl/pub/GNU/LilyPond/development/' by FTP and
+ `http://ftp.cs.uu.nl/pub/GNU/LilyPond/development/', by HTTP.
+
+ * `ftp://sca.uwaterloo.ca/pub/' by FTP (Canadian mirror)
- Installing and compiling requires many additional packages, which are
-listed in the installation instructions
-(Documentation/topdocs/out-www/INSTALL.html).
+ * at `lilypond.org' `ftp://ftp.lilypond.org/pub/LilyPond/' by FTP and
+ `http://www.lilypond.org/ftp/' by HTTP.
-Downloading binaries
-====================
+Binaries
+--------
Binaries are available, but are not updated for every version
released.
- * RedHat i386 (ftp://ftp.cs.uu.nl/pub/GNU/LilyPond/RedHat/RPMS/)
+ * RedHat i386
+ (ftp://ftp.cs.uu.nl/pub/GNU/LilyPond/binaries/RedHat/RPMS/)
- * LinuxPPC (ftp://ftp.cs.uu.nl/pub/GNU/LilyPond/linuxppc)
+ * LinuxPPC (ftp://ftp.lilypond.org/pub/LilyPond/binaries/linuxppc)
* Debian GNU/Linux Stable
(ftp://ftp.debian.org/debian/pool/main/l/lilypond)
(ftp://ftp.debian.org/debian/pool/main/l/lilypond1.3)
* Windows Stable (http://home.austin.rr.com/jbr/jeff/lilypond/)
+ Windows Testing (http://www.lilypond.org/gnu-windows)
- * Windows Testing (ftp://ftp.lilypond.org/pub/lilypond/gnu-windows)
Upgrading
-=========
+---------
There are two options for upgrading sources.
on the FTP site.
xdelta patch lilypond-1.3.121-1.3.122.xd lilypond-1.3.121.tar.gz
-Build requirements
-==================
+Requirements
+============
- This document describes how to build LilyPond on Unix platforms. It
-is also known to run and compile on Windows NT/95/98 as well. More
-information on this topic can be found at the LilyPond on Windows page
-(ftp://ftp.lilypond.org/pub/LilyPond/gnu-windows/).
+Compilation
+-----------
You need the following packages to compile Lilypond.
Running requirements
-====================
+--------------------
GNU LilyPond does use a lot of resources. For operation you need the
following software
recommended for comfortable use.
Website requirements
-====================
+--------------------
The documentation comes in the form of a website. You can view this
website on the internet, but you can also build it locally. This process
not see our hypertextified bibliography.
-Configuring and compiling
-=========================
+Building LilyPond
+==================
to install GNU LilyPond, type:
gunzip -c lilypond-x.y.z | tar xf -
`buildscripts/out/lilypond-profile' into your start up scripts by hand.
Configuring for multiple platforms
-==================================
+----------------------------------
If you want to build multiple versions of LilyPond with different
configuration settings, you can use the `--enable-config=CONF' option
`lilypond-mode.el' and `lilypond-font-lock.el'. If you have an RPM, it
is in `/usr/share/doc/lilypond-X/'. You have to install it yourself.
- Add this to your ~/.emacs or ~/.emacs.el:
+ Add this to your `~/.emacs' or `~/.emacs.el':
(load-library "lilypond-mode.el")
(setq auto-mode-alist
(cons '("\\.ly$" . LilyPond-mode) auto-mode-alist))
If you have the latest LilyPond-1.3.x Debian package, LilyPond-mode
is automatically loaded, so you need not modify your `~/.emacs' file.
+Compiling for distributions
+===========================
+
Red Hat Linux
-=============
+-------------
Red Hat 7.0 i386 RPMS are available from
`ftp://ftp.cs.uu.nl/pub/GNU/LilyPond/RedHat/'.
You can also compile them yourself. A spec file is in
-`make/out/lilypond.spec'. This file is distributed along with the
+`make/out/redhat.spec'. This file is distributed along with the
sources. You can make the rpm by issuing
rpm -tb lilypond-x.y.z.tar.gz
rpm -i /usr/src/redhat/RPMS/i386/lilypond-x.y.z
For running on a Red Hat system you need these packages: guile,
-tetex, tetex-dvips, libstdc++, python, ghostscript.
+tetex, tetex-latex, tetex-dvips, libstdc++, python, ghostscript.
For compilation on a Red Hat system you need these packages, in
addition to the those needed for running: glibc-devel, gcc-c++,
libgr-progs.
SuSE
-====
+----
- [TODO: document this]
+ You can also compile them yourself. A spec file is in
+`make/out/suse.spec'. This file is distributed along with the sources.
- Install `tetex', `te_mpost', `te_kpath'.
+ You must have the following packages: guile tcsh tetex te_latex
+te_kpath te_mpost libpng python gpp libgpp gettext autoconf netpbm
+libnetpb gs_serv gs_lib gs_fonts guile
Mandrake
-========
+--------
[TODO]
Debian GNU/Linux
-================
+----------------
A Debian package is also available. You may install it easily by
using apt-get as root:
Bugs that are not fault of LilyPond are documented here.
NetBSD
-******
+------
* The flex precompiled in NetBSD-1.4.2 is broken. Download
flex-2.5.4a, build, install.
Solaris:
-********
+--------
* Sparc64/Solaris 2.6, GNU make-3.77
Not yet resolved.
AIX
-***
+---
* AIX 4.3 ld