]> git.donarmstrong.com Git - lilypond.git/blobdiff - INSTALL.txt
patch::: 1.3.126.jcn3
[lilypond.git] / INSTALL.txt
index cf0e511331e8e1ce4525bea0c0ce2e0e41a7b681..971cd7d7aa7030c30725746d13b131a2b4637c6d 100644 (file)
@@ -17,10 +17,10 @@ applying the patch_.
 the safest method for upgrading is to use `xdelta', see
 `ftp://ftp.xcf.berkeley.edu/pub/xdelta/'.
 
-   The following command produces `lilypond-1.1.55.tar.gz' from
-`lilypond-1.1.54' identical (up to compression dates) to the .55 on the
-FTP site.
-       xdelta patch lilypond-1.1.54-1.1.55.xd lilypond-1.1.54.tar.gz
+   The following command produces `lilypond-1.3.122.tar.gz' from
+`lilypond-1.3.121' identical (up to compression dates) to the .122 on
+the FTP site.
+       xdelta patch lilypond-1.3.121-1.3.122.xd lilypond-1.3.121.tar.gz
 
 Prerequisites
 =============
@@ -38,7 +38,8 @@ 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/'.
+   * A reasonable C++ compiler:  EGCS 1.1, GCC 2.95.2 or newer. Check
+     out `ftp://ftp.gnu.org/gnu/gcc/'.
 
    * Python 1.5, Check out `ftp://ftp.python.org' or
      `ftp://ftp.cwi.nl/pub/python'.
@@ -52,7 +53,8 @@ Prerequisites
      (ftp://ftp.gnu.org/gnu/make/).
 
    * Flex (version 2.5.4a or newer).  Check out
-     ftp://ftp.gnu.org/gnu/flex/ (ftp://ftp.gnu.org/gnu/flex/).
+     ftp://ftp.gnu.org/pub/gnu/non-gnu/flex/
+     (ftp://ftp.gnu.org/pub/gnu/non-gnu/flex/).
 
    * Bison (version 1.25 or newer).  Check out
      ftp://ftp.gnu.org/gnu/bison/ (ftp://ftp.gnu.org/gnu/bison/).
@@ -72,7 +74,7 @@ Prerequisites
      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
+     tetex-0.4pl8 (included with Red Hat 5.x) does not include
      `mfplain.mp', which is needed for producing the scalable font
      files.
 
@@ -95,7 +97,8 @@ following software
      strongly     recommended.  Xdvi will show all embedded PostScript
      too if you have     Ghostscript installed.
 
-   * GUILE 1.3.4, check out http://www.gnu.org/software/guile/
+   * GUILE 1.3.4, or newer.  Check out
+     http://www.gnu.org/software/guile/
      (http://www.gnu.org/programs/guile.html)
 
    For running LilyPond successfully you have to help TeX and MetaFont
@@ -119,35 +122,36 @@ Website
 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.
+   This does require a functioning LilyPond.  The binary doesn't have to
+be installed.
 
    If you want to auto-generate Lily's website, you'll need some
 additional conversion tools.
 
-   * xpmtoppm (from the Portable Bitmap Utilities) (For RedHat Linux
-      users: it is included within the package libgr-progs).
-     the original is at
+   * xpmtoppm (from the netpbm package: the Portable Bitmap Utilities)
+     (For Red Hat Linux             users: it is included within the
+     package libgr-progs).     The original is at
      ftp://ftp.x.org/contrib/utilities/netpbm-1mar1994.p1.tar.gz
      (ftp://ftp.x.org/contrib/utilities/netpbm-1mar1994.p1.tar.gz)
 
-   * pnmtopng, which is also in libgr-progs for RedHat. The original is
-     at
+   * pnmtopng (also in libgr-progs for Red Hat). The original is at
      ftp://swrinde.nde.swri.edu/pub/png/applications/pnmtopng-2.37.2.tar.gz
      (ftp://swrinde.nde.swri.edu/pub/png/applications/pnmtopng-2.37.2.tar.gz).i
 
-     The version of `pnmtopng' that is distributed with RedHat 5.1 and
+     The version of `pnmtopng' that is distributed with Red Hat 5.1 and
      5.2 contains a bug: pnmtopng is dynamically linked to the wrong
      version of libpng.
 
-   * Bib2html (http://pertsserver.cs.uiuc.edu/~hull/bib2html).
-     Which, in turn depends on man2html for proper installation.
-     man2html can be had from
+   * Bibtex2html (http://www.lri.fr/~filliatr/ftp/bibtex2html/), or
+     Bib2html (http://www.uni-koblenz.de/ag-ki/ftp/bib2html/).
+     Bibtex2html is available in debian, while bib2html is in some rpm
+     based distributions.  Bib2html, 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.
+     The website will build without bib converter utility, but you will
+     not see our hypertextified bibliography.
 
 
 Configuring and compiling
@@ -165,14 +169,16 @@ Configuring and compiling
        /usr/local/man/man1/midi2ly.1
        /usr/local/man/man1/abc2ly.1
        /usr/local/man/man1/etf2ly.1
-       /usr/local/man/man1/convert-mudela.1
-       /usr/local/man/man1/mudela-book.1
+       /usr/local/man/man1/convert-ly.1
+       /usr/local/man/man1/lilypond-book.1
        /usr/local/man/man1/lilypond.1
        /usr/local/bin/lilypond
        /usr/local/bin/midi2ly
-       /usr/local/bin/convert-mudela
-       /usr/local/bin/mudela-book
+       /usr/local/bin/convert-ly
+       /usr/local/bin/lilypond-book
        /usr/local/bin/abc2ly
+       /usr/local/bin/pmx2ly
+       /usr/local/bin/musedata2ly
        /usr/local/bin/etf2ly
        /usr/local/share/lilypond/*
        /usr/local/share/locale/{....}/LC_MESSAGES/lilypond.mo
@@ -266,21 +272,21 @@ Installing
 `.pk' and `.tfm' files of the fonts.  A script has been provided to do
 the work for you, see `bin/clean-fonts.sh'.
 
-Redhat linux
-============
+Red Hat Linux
+=============
 
-   RedHat Linux users can compile an RPM. A spec file is in
-`make/out/lilypond.spec', it is distributed along with the sources.
+   Red Hat Linux users can compile an RPM.  A spec file is in
+`make/out/lilypond.spec'; it 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
 
-   Precompiled i386 RedHat RPMS are available from
+   Precompiled Red Hat 7.0 i386 RPMS are available from
 `ftp://ftp.cs.uu.nl/pub/GNU/LilyPond/RedHat/'.
 
-   For compilation on a RedHat system you need these packages, in
+   For compilation on a Red Hat system you need these packages, in
 addition to the those needed for running:
    * glibc-devel
 
@@ -296,42 +302,88 @@ addition to the those needed for running:
 
    * tetex-devel
 
-Debian GNU/linux
+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.
+   A Debian package is also available.  You may install it easily by
+using apt-get as root:
 
-   The build scripts are in the subdirectory `debian/'; you can make
-the .deb by doing
+       apt-get install lilypond1.3
 
+   Alternatively, visit
 
-       tar xzf lilypond-x.y.z.tar.gz
-       cd lilypond-x.y.z
-       dpkg-buildpackage
-       dpkg -i ../lilypond_x.y.z*deb
+   * http://packages.debian.org/lilypond
+     (http://packages.debian.org/lilypond)
+
+   * http://ftp.debian.org/debian/pool/main/l/lilypond1.3/
+     (http://ftp.debian.org/debian/pool/main/l/lilypond1.3/) for latest
+     package uploaded to Debian unstable;
+
+   * http://people.debian.org/~foka/lilypond/
+     (http://people.debian.org/~foka/lilypond/) for latest
+     semi-unofficial build of LilyPond 1.3.121 for Debian 2.2r2
+     (potato) users.  The official stable Debian 2.2r2 is stuck with
+     the old LilyPond-1.3.24.
+
+   You may contact Anthony Fok <foka@debian.org> for more information.
+
+   The build scripts are in the subdirectory `debian/'; you can make
+the .deb by doing, for example:
+
+       $ su - root
+       # dpkg --purge lilypond lilypond1.3
+       # exit
+       $ tar xzf lilypond-1.3.122.tar.gz
+       $ cd lilypond-1.3.122
+       $ dch -p -v 1.3.122-0.local.1 "Local build."
+       $ debuild
+       $ su - root
+       # dpkg -i ../lilypond1.3_1.3.122*.deb
+       # exit
+       $
 
    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
+   * g++, cpp, libc6-dev, libstdc++<your-libstdc++-version-here>-dev
 
    * libguile<your-libguile-version-here>-dev
 
-   * flex
-
-   * bison
+   * make, m4, flex, bison
 
    * gettext
 
-   * texinfo
+   * groff, texinfo, bibtex2html (not in 2.2r2)
+
+   * tetex-base, tetex-bin, tetex-extra, libkpathsea-dev or tetex-dev
+
+   * dpkg-dev, debhelper, fakeroot
+
+   * gs, netpbm, pnmtopng
+
+   Most of these are listed on the Build-Depends line in the
+debian/control file.  To ensure the creation of the lilypond deb is
+trouble-free, we recommend that you first install the following packages
+before starting dpkg-buildpackage by running apt-get as root.
+
+   For Debian 2.2 (or 2.2r2, 2.2r3):
+
+       apt-get install task-debian-devel task-c++-dev \
+               python-base libguile6-dev tetex-bin tetex-dev \
+               tetex-extra flex bison texinfo groff gs \
+               netpbm pnmtopng m4 gettext
+
+   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 \
+               tetex-extra flex bison texinfo bibtex2html groff gs \
+               netpbm pnmtopng m4 gettext
 
-   * tetex-dev
+   And, just so that old fonts from previous versions of LilyPond won't
+interfere with your build, you may want to do this before the build too:
 
-   * debhelper
+       dpkg --purge lilypond lilypond1.3
 
 Windows NT/95
 =============
@@ -395,7 +447,7 @@ Linux-i386
                Includable_lexer::new_input (this=0x8209a00, s={strh_ = {
 
      This behaviour has been observed with machines that have old libg++
-     versions (LinuxPPC feb '98, RedHat 4.x).
+     versions (LinuxPPC feb '98, Red Hat 4.x).
 
 Solaris:
 ********
@@ -418,7 +470,7 @@ AIX
              Some versions of the AIX binder (linker) can fail with a
           relocation    overflow severe error when the -bbigtoc option
           is used to link    GCC-produced object files into an
-          executable that overflows the TOC. A    fix for APAR IX75823
+          executable that overflows the TOC.     A fix for APAR IX75823
           (OVERFLOW DURING LINK WHEN USING GCC AND    -BBIGTOC) is
           available from IBM Customer Support and from its
           27service.boulder.ibm.com website as PTF U455193.