]> git.donarmstrong.com Git - lilypond.git/blobdiff - INSTALL.txt
release: 1.5.32
[lilypond.git] / INSTALL.txt
index 7fa5e4fe7ccffb7859c1dce59d6def02372f8f46..9cc58b4f139767d09cf6dc419e58cc06f3de5bd4 100644 (file)
@@ -27,6 +27,8 @@ INSTALL - compiling and installing GNU LilyPond
     Debian GNU/Linux
   Problems
     FLex-2.5.4a and gcc-3.0
+    Python-2.1[.1]
+    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.
 
@@ -173,21 +177,8 @@ 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/public/software/pktrace-0.1.tar.gz'
-
-   * autotrace-0.27a, [OPTIONAL], needed for generating PostScript Type1
-     fonts. You must apply the patch included pktrace-0.1 first.
-     `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='.
+     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
@@ -232,17 +223,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
@@ -400,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
@@ -463,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
@@ -491,7 +479,7 @@ by running \`apt-get' as root before building the package:
        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 \
+               tetex-extra flex bison texinfo  groff gs \
                netpbm m4 gettext
 
    And, just so that old fonts from previous versions of LilyPond won't
@@ -521,6 +509,23 @@ LilyPond with gcc-3.0 you may do:
 
    Note that this is fixed in Debian/unstable for flex >= 2.5.4a-13.
 
+Python-2.1[.1]
+--------------
+
+   Regular expressions are broken in Python 2.1.[.1], either upgrade or
+downgrade python.
+
+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
 ------