]> git.donarmstrong.com Git - lilypond.git/blobdiff - INSTALL.txt
release: 1.5.48
[lilypond.git] / INSTALL.txt
index 373eb96146776606c6f1af1113b3a6d5b1d5f864..90ed864e96b1e554e4ed171b355b81ffe1791a24 100644 (file)
@@ -25,8 +25,10 @@ INSTALL - compiling and installing GNU LilyPond
     Slackware
     Mandrake
     Debian GNU/Linux
+    MacOS X
   Problems
     FLex-2.5.4a and gcc-3.0
+    Linux-2.4.0, Guile-1.4 -with-threads
     NetBSD
     Solaris:
     AIX
@@ -124,12 +126,14 @@ Compilation
 
    You need the following packages to compile Lilypond.
 
-   * A reasonably new C++ compiler:  EGCS 1.1, GCC 2.95.2 or newer.
-     Check out the gcc site (ftp://ftp.gnu.org/gnu/gcc/).
+   * A reasonably new version of the GNU C++ compiler:  EGCS 1.1, GCC
+     2.95.2 or newer. Check out the gcc site
+     (ftp://ftp.gnu.org/gnu/gcc/).
 
-   * Python 1.5, Check out the python website (http://www.python.org).
+   * Python (version 1.5 or newer).  Check out the python website
+     (http://www.python.org).
 
-   * GUILE 1.3.4 or newer,  check out the GUILE webpage
+   * GUILE (version 1.4 or newer).  Check out the GUILE webpage
      (http://www.gnu.org/software/guile/guile.html).  Version 1.4 is
      recommended for better performance.
 
@@ -160,15 +164,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.
@@ -181,6 +176,11 @@ Compilation
 
           ./configure --without-kpathsea --enable-tfm-path=/usr/share/texmf/fonts/tfm/public/cm/:/usr/share/texmf/fonts/tfm/ams/symbols
 
+   * pktrace 1.0 or newer, [OPTIONAL], needed for generating PostScript
+     Type1 fonts. Get it from  `http://www.cs.uu.nl/~hanwen/pktrace/'.
+     You will need to install some additional packages to get pktrace
+     to work.
+
 
 Running requirements
 --------------------
@@ -224,17 +224,6 @@ issuing
    * pnmtopng. The original is at in the pnmtopng FTP site
      (ftp://swrinde.nde.swri.edu/pub/png/applications/pnmtopng-2.37.2.tar.gz).
 
-   * 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 bib converter utility, but you will
-     not see our hypertextified bibliography.
-
    * texinfo (a development release) The documentation will build with
      texinfo-4.0, but if you want split html pages, you're best off
      using the lates pretest version from texinfo-4.0b
@@ -329,8 +318,7 @@ 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++,
-libstdc++-devel, guile-devel, flex, bison, texinfo, tetex-devel, groff,
-libgr-progs.
+libstdc++-devel, guile-devel, flex, bison, texinfo, groff, pktrace.
 
 LinuxPPC
 --------
@@ -392,18 +380,28 @@ running `apt-get' as root:
 
    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
-     +++ /etc/texmf/texmf.cnf  Fri Apr 27 11:09:35 2001
-     @ -384,8 +384,8 @
+     --- texmf.cnf.orig        Sun Dec 16 23:47:07 2001
+     +++ texmf.cnf     Sun Dec 16 23:46:34 2001
+     @ -411,8 +411,8 @
       main_memory.context = 1500000
       main_memory.mpost = 1000000
       main_memory = 263000 % words of inimemory available; also applies to inimf&mp
      -extra_mem_top = 0    % extra high memory for chars, tokens, etc.
      -extra_mem_bot = 0    % extra low memory for boxes, glue, breakpoints, etc.
-     +extra_mem_top = 100000    % extra high memory for chars, tokens, etc.
-     +extra_mem_bot = 100000    % extra low memory for boxes, glue, breakpoints, etc.
+     +extra_mem_top = 1000000    % extra high memory for chars, tokens, etc.
+     +extra_mem_bot = 1000000    % extra low memory for boxes, glue, breakpoints, etc.
+     
+      obj_tab_size.context = 300000
      
-      obj_tab_size.context = 256000
+     @ -430,7 +430,7 @
+      % Max number of characters in all strings, including all error messages,
+      % help texts, font names, control sequences.  These values apply to TeX and MP.
+      pool_size.context = 750000
+     -pool_size = 125000
+     +pool_size = 250000
+      % Minimum pool space after TeX/MP's own strings; must be at least
+      % 25000 less than pool_size, but doesn't need to be nearly that large.
+      string_vacancies.context = 45000
 
    You could also export `extra_mem_top' and `extra_mem_bot' as
 environment variables if you do not want to or cannot modify
@@ -455,8 +453,6 @@ in addition to the those needed for running:
 
    * groff, texinfo
 
-   * bibtex2html (not in Debian 2.2)
-
    * tetex-base, tetex-bin, tetex-extra, libkpathsea-dev or tetex-dev
 
    * dpkg-dev, debhelper, fakeroot
@@ -480,9 +476,10 @@ 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 \
-               tetex-extra flex bison texinfo bibtex2html groff gs \
+       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  groff gs \
                netpbm m4 gettext
 
    And, just so that old fonts from previous versions of LilyPond won't
@@ -490,6 +487,43 @@ interfere with your build, you may want to do this before the build too:
 
        dpkg --purge lilypond lilypond1.3
 
+MacOS X
+-------
+
+   LilyPond has been built on Darwin, to be precise, on:
+         Darwin buoux.aspiratie.nl 5.3 Darwin Kernel Version 5.3: Thu Jan 24
+         22:06:02 PST 2002; root:xnu/xnu-201.19.obj~1/RELEASE_PPC  Power Macintosh powerpc
+
+   using:
+
+         Apple Computer, Inc. version gcc-932.1, based on gcc version 2.95.2 19991024 (release)
+
+   To make sure you have all packages needed to build LilyPond
+installed, run as root:
+
+             apt-get install bash python guile debianutils flex bison texinfo \
+                     ghostscript6 netpbm m4 gettext
+
+   and:
+
+             fink install tetex
+
+   For more information about `apt-get' and `fink', see
+fink.sourceforge.net (http://fink.sf.net).
+
+   Then, configure, patch, make and install LilyPond using these
+commands:
+
+             CC="cc -I/sw/include" CXX="c++ -I/sw/include" LDFLAGS="-L/sw/lib" \
+                 ./configure --prefix=/sw
+             make -C lily out/parser.hh out/parser.cc out/config.h
+             patch -p0 < darwin.patch
+             make -C lily out/parser.o
+             make DEPENDENCIES_OUTPUT=/dev/null all
+             make install
+
+   For installing, you must be root, of course.
+
 Problems
 ========
 
@@ -512,6 +546,17 @@ LilyPond with gcc-3.0 you may do:
 
    Note that this is fixed in Debian/unstable for flex >= 2.5.4a-13.
 
+Linux-2.4.0, Guile-1.4 -with-threads
+------------------------------------
+
+   There's a bug in certain kernels around version 2.4.0, that is
+triggered when using Guile 1.4 compiled with pthreads.  You'll see
+random segmentation fault crashes of LilyPond.  Upgrade to a newer
+version of Linux.  If you can't do that, you may try to recompiling
+Guile without threads (YMMV):
+
+              guile-1.4$ ./configure --without-threads; make all install
+
 NetBSD
 ------