X-Git-Url: https://git.donarmstrong.com/?a=blobdiff_plain;f=Documentation%2Ftopdocs%2FINSTALL.texi;h=689828a969b53e6ece56add2c39d14860cd2496b;hb=31d56b0bdf6082dacbf95e514f5d729d764e4998;hp=b0a5d56567b1f25c52f89391819f6dc043a5a11a;hpb=1ac137fdab1f1be8a5621599664008107b5a9a6a;p=lilypond.git diff --git a/Documentation/topdocs/INSTALL.texi b/Documentation/topdocs/INSTALL.texi index b0a5d56567..689828a969 100644 --- a/Documentation/topdocs/INSTALL.texi +++ b/Documentation/topdocs/INSTALL.texi @@ -12,10 +12,10 @@ This document explains what you need to install LilyPond, and what you should do. If you are going to compile and install LilyPond often, -e.g. when doing development, you might want to check out the -@file{buildscripts/set-lily.sh} script. It sets some environment -variables and symlinks, which comes in handly when you have to compile -LilyPond more often. +e.g. when doing development, you might want to check out the +@file{buildscripts/set-lily.sh} script. It sets some environment +variables and symlinks, which comes in handy when you have to compile +LilyPond more often. @section Obtaining @@ -55,25 +55,32 @@ disk-space run configure with @code{--disable-debugging}. Although we recommend to use Unix, LilyPond is known to run on Windows NT/95/98 as well. See Section Windows NT/95,es. -@item EGCS 1.1 or newer. Check out @uref{ftp://ftp.gnu.org/pub/gcc/}. +@item EGCS 1.1 or newer. Check out @uref{ftp://ftp.gnu.org/gnu/gcc/}. @item Python 1.5, Check out @uref{ftp://ftp.python.org} or @uref{ftp://ftp.cwi.nl/pub/python}. -@item GUILE 1.3.4, check out @uref{http://www.gnu.org/software/guile/guile.html,http://www.gnu.org/software/guile/guile.html}. +@item GUILE 1.3.4 or newer, check out +@uref{http://www.gnu.org/software/guile/guile.html,http://www.gnu.org/software/guile/guile.html}. +Version 1.4 is recommended for better performance. -@item GNU make. -Check out @uref{ftp://ftp.gnu.org/make/,ftp://ftp.gnu.org/make/}. +@item GNU Make. +Check out +@uref{ftp://ftp.gnu.org/gnu/make/,ftp://ftp.gnu.org/gnu/make/}. @item Flex (version 2.5.4 or newer). -Check out @uref{ftp://ftp.gnu.org/flex/,ftp://ftp.gnu.org/flex/}. +Check out @uref{ftp://ftp.gnu.org/gnu/flex/,ftp://ftp.gnu.org/gnu/flex/}. @item Bison (version 1.25 or newer). -Check out @uref{ftp://ftp.gnu.org/bison/,ftp://ftp.gnu.org/bison/}. +Check out @uref{ftp://ftp.gnu.org/gnu/bison/,ftp://ftp.gnu.org/gnu/bison/}. + +@item TeX. If you want LilyPond to use kpathsea support (recommended), +make sure you have tetex 1.0 or newer (1.0.6 is known to work). You may +need to install a tetex-devel or tetex-dev package too. @item Texinfo (version 4.0 or newer). -Check out @uref{ftp://ftp.gnu.org/pub/texinfo/,ftp://ftp.gnu.org/pub/texinfo/}. +Check out @uref{ftp://ftp.gnu.org/gnu/texinfo/,ftp://ftp.gnu.org/gnu/texinfo/}. Most documentation is in texinfo. @item The geometry package for LaTeX is needed to use ly2dvi. @@ -88,6 +95,9 @@ files. If you do not want to use PostScript output, edit @file{mf/GNUmakefile}. +@item kpathsea, a library for searching (TeX) files. @code{kpathsea} is +usually included with your installation of TeX. + @end itemize @@ -97,7 +107,7 @@ GNU LilyPond does use a lot of resources. For operation you need the following software @itemize @bullet -@item TeX +@item TeX. @item A PostScript printer and/or viewer (such as Ghostscript) is strongly recommended. Xdvi will show all embedded PostScript too if you have Ghostscript installed. @@ -172,9 +182,6 @@ man2html can be had from @uref{http://askdonald.ask.uni-karlsruhe.de/hppd/hpux/N The website will build without this utility, but you will not see our hypertextified bibliography. -@item @uref{http://www.zib.de/Visual/software/doc++/index.html,DOC++} - A documentation system for C++ sources, which is used for the - LilyPond sources. @end itemize @section Configuring and compiling @@ -193,17 +200,20 @@ to install GNU LilyPond, simply type: This will install a number of files, something close to: @example - /usr/local/man/man1/mi2mu.1 + /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/lilypond.1 /usr/local/bin/lilypond - /usr/local/bin/mi2mu + /usr/local/bin/midi2ly /usr/local/bin/convert-mudela /usr/local/bin/mudela-book /usr/local/bin/abc2ly + /usr/local/bin/etf2ly /usr/local/share/lilypond/* - /usr/local/share/locale/@{it,nl@}/LC_MESSAGES/lilypond.mo + /usr/local/share/locale/@{....@}/LC_MESSAGES/lilypond.mo @end example @@ -290,9 +300,9 @@ and for the profiling version, I specify a different configuration. @example - ./configure --prefix=~ --enable-profiling --enable-config=optprof --enable-optimise --disable-checking - make config=optprof - make config=optprof install + ./configure --prefix=~ --enable-profiling --enable-config=prof --enable-optimise --disable-checking + make config=prof + make config=prof install @end example @@ -329,8 +339,7 @@ You can make the rpm by issuing @end example Precompiled i386 RedHat RPMS are available from -@uref{ftp://freshmeat.net/pub/rpms/lilypond/,ftp://freshmeat.net/pub/rpms/lilypond/} and -@uref{http://linux.umbc.edu/software/lilypond/rpms/,http://linux.umbc.edu/software/lilypond/rpms/}. +@uref{ftp://ftp.cs.uu.nl/pub/GNU/LilyPond/RedHat/}. For compilation on a RedHat system you need these packages, in addition to the those needed for running: @@ -341,13 +350,41 @@ in addition to the those needed for running: @item flex @item bison @item texinfo +@item tetex-devel @end itemize @section Debian GNU/linux -A Debian package is also available; contact Anthony Fok -@email{foka@@debian.org}. The build scripts are in the subdirectory -@file{debian/}. +A Debian package is also available; see +@uref{http://packages.debian.org/lilypond,http://packages.debian.org/lilypond} +or contact Anthony Fok @email{foka@@debian.org} for more information. + +The build scripts are in the subdirectory @file{debian/}; you can +make the .deb by doing + +@example + + tar xzf lilypond-x.y.z.tar.gz + cd lilypond-x.y.z + dpkg-buildpackage + dpkg -i ../lilypond_x.y.z*deb + +@end example + +For compilation on a Debian GNU/Linux system you need these packages, +in addition to the those needed for running: +@itemize @bullet +@item libc6-dev +@item libstdc++-dev +@item libguile-dev +@item flex +@item bison +@item gettext +@item texinfo +@item tetex-dev +@item debhelper +@end itemize + @section Windows NT/95 @@ -363,10 +400,10 @@ mailing your problems. If you find bugs, please send bug reports to @email{bug-gnu-music@@gnu.org}. -Known bugs that are LilyPond's fault are listed in @file{TODO}, or -demonstrated in @file{input/bugs/}. +Bugs that are LilyPond's fault are listed in our TODO list on the +web, or demonstrated in @file{input/bugs/}. -Known bugs that are not LilyPond's fault are documented here. +Bugs that are not LilyPond's fault are documented here. @unnumbered LinuxPPC Bugs: