]> git.donarmstrong.com Git - lilypond.git/blobdiff - INSTALL.txt
release: 1.5.27
[lilypond.git] / INSTALL.txt
index 65765b509d36b6f6acb701bf8229caeb71096be2..058e0d97e771b06880d166e4fba5b2ed33cb6c4e 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
@@ -127,9 +129,10 @@ Compilation
    * 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/).
 
-   * Python 1.5, Check out the python website (http://www.python.org).
+   * Python (version 1.5 or newer; not 2.1.x) Check out the python
+     website (http://www.python.org).
 
-   * GUILE 1.3.4 or newer,  check out the GUILE webpage
+   * GUILE 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 +163,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 +175,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
 --------------------
@@ -224,17 +233,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
@@ -332,13 +330,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
 --------
 
@@ -399,18 +390,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
@@ -462,8 +463,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
@@ -487,9 +486,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
@@ -519,6 +519,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
 ------