X-Git-Url: https://git.donarmstrong.com/?a=blobdiff_plain;f=INSTALL.txt;h=9a95ed6b0d5d048eda106932abccb3a2bb0569d5;hb=44db43814df6d3d9d11d5f84a2b894ff386024aa;hp=a5d6534d996aa533dbc0725626a69cfab7a0bec4;hpb=c21d49df60cb97801ab33ab8a1bad6f2c81cd820;p=lilypond.git diff --git a/INSTALL.txt b/INSTALL.txt index a5d6534d99..9a95ed6b0d 100644 --- a/INSTALL.txt +++ b/INSTALL.txt @@ -3,16 +3,6 @@ INSTALL - compiling and installing GNU LilyPond *********************************************** -Abstract -======== - - 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 -`buildscripts/set-lily.sh' script. It sets some environment variables -and symlinks, which comes in handy when you have to compile LilyPond -more often. - Obtaining ========= @@ -39,7 +29,7 @@ Prerequisites * A GNU system: GNU LilyPond is known to run on these GNU systems: Linux (PPC, intel), FreeBSD, AIX, NeXTStep, IRIX, Digital Unix - and Solaris. + and Solaris. * Lots of disk space: LilyPond takes between 30 and 100 mb to compile if you use debugging information. If you are short on @@ -61,12 +51,16 @@ Prerequisites * GNU Make. Check out ftp://ftp.gnu.org/gnu/make/ (ftp://ftp.gnu.org/gnu/make/). - * Flex (version 2.5.4 or newer). Check out + * Flex (version 2.5.4a or newer). Check out ftp://ftp.gnu.org/gnu/flex/ (ftp://ftp.gnu.org/gnu/flex/). * Bison (version 1.25 or newer). Check out ftp://ftp.gnu.org/gnu/bison/ (ftp://ftp.gnu.org/gnu/bison/). + * 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. + * Texinfo (version 4.0 or newer). Check out ftp://ftp.gnu.org/gnu/texinfo/ (ftp://ftp.gnu.org/gnu/texinfo/). Most documentation is in texinfo. @@ -82,7 +76,11 @@ Prerequisites `mfplain.mp', which is needed for producing the scalable font files. - If you do not want to use PostScript output, edit `mf/GNUmakefile'. + If you do not want to use PostScript output, 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. Running @@ -91,7 +89,7 @@ Running GNU LilyPond does use a lot of resources. For operation you need the following software - * TeX + * TeX. * A PostScript printer and/or viewer (such as Ghostscript) is strongly recommended. Xdvi will show all embedded PostScript @@ -102,18 +100,17 @@ following software For running LilyPond successfully you have to help TeX and MetaFont find various files. The recommended way of doing so is adjusting the -environment variables in the start-up scripts of your shell. An -example is given here for the Bourne shell: - export MFINPUTS="/usr/local/share/lilypond/mf:" - export TEXINPUTS="/usr/local/share/lilypond/tex:/usr/local/share/lilypond/ps:" +environment variables in the start-up scripts of your shell. Appropriate +Csh and sh scripts are left in `buildscripts/out/lilypond-profile' and +`buildscripts/out/lilypond-login' after compilation. - The empty path component represents TeX and MetaFont's default -search paths. Scripts with the proper paths for the bourne and C-shell + The empty path component represents TeX and MetaFont's default search +paths. Scripts with the proper paths for the bourne and C-shell respectively are generated in `buildscripts/out/lilypond-profile' and `buildscripts/out/lilypond-login' during compilation. - LilyPond is a hiddeously big, slow and bloated program. A fast CPU -and plenty of RAM is recommended for comfortable use. + LilyPond is a big and slow program. A fast CPU and plenty of RAM is +recommended for comfortable use. Website ======= @@ -141,18 +138,7 @@ additional conversion tools. The version of `pnmtopng' that is distributed with RedHat 5.1 and 5.2 contains a bug: pnmtopng is dynamically linked to the wrong - version of libpng, which results in cropped images. Recompile it - from source, and make sure that the pnmtopng binary is linked - statically to the libpng that is included in libgr. RedHat 6.0 - does not have this problem. - - tar xzf libgr-2.0.13.tar.gz - make - cd png - rm libpng.so* - make pnmtopng - - You can then install the new pnmtopng into `/usr/local/bin/' + version of libpng. * Bib2html (http://pertsserver.cs.uiuc.edu/~hull/bib2html). Which, in turn depends on man2html for proper installation. @@ -163,15 +149,11 @@ additional conversion tools. The website will build without this utility, but you will not see our hypertextified bibliography. - * DOC++ (http://www.zib.de/Visual/software/doc++/index.html) A - documentation system for C++ sources, which is used for the - LilyPond sources. Configuring and compiling ========================= to install GNU LilyPond, simply type: - gunzip -c lilypond-x.y.z | tar xf - cd lilypond-x.y.z ./configure # fill in your standard prefix with --prefix @@ -180,17 +162,22 @@ Configuring and compiling This will install a number of files, something close to: - /usr/local/man/man1/mi2mu.1 - /usr/local/man/man1/convert-mudela.1 - /usr/local/man/man1/mudela-book.1 + /usr/local/man/man1/midi2ly.1 + /usr/local/man/man1/abc2ly.1 + /usr/local/man/man1/etf2ly.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/mi2mu - /usr/local/bin/convert-mudela - /usr/local/bin/mudela-book + /usr/local/bin/midi2ly + /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/{it,nl}/LC_MESSAGES/lilypond.mo + /usr/local/share/locale/{....}/LC_MESSAGES/lilypond.mo The above assumes that you are root and have the GNU development tools, and your make is GNU make. If this is not the case, you can @@ -263,9 +250,9 @@ following for the normal build, and for the profiling version, I specify a different configuration. - ./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 Installing ========== @@ -293,10 +280,7 @@ Redhat linux rpm -i /usr/src/redhat/RPMS/i386/lilypond-x.y.z Precompiled i386 RedHat RPMS are available from -ftp://freshmeat.net/pub/rpms/lilypond/ -(ftp://freshmeat.net/pub/rpms/lilypond/) and -http://linux.umbc.edu/software/lilypond/rpms/ -(http://linux.umbc.edu/software/lilypond/rpms/). +`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: @@ -312,14 +296,44 @@ addition to the those needed for running: * texinfo + * tetex-devel + Debian GNU/linux ================ A Debian package is also available; see http://packages.debian.org/lilypond (http://packages.debian.org/lilypond) or contact Anthony Fok - for more information. The build scripts are in the -subdirectory `debian/'. + for more information. + + The build scripts are in the subdirectory `debian/'; you can make +the .deb by doing + + + tar xzf lilypond-x.y.z.tar.gz + cd lilypond-x.y.z + dpkg-buildpackage + dpkg -i ../lilypond_x.y.z*deb + + For compilation on a Debian GNU/Linux system you need these packages, +in addition to the those needed for running: + * libc6-dev + + * libstdc++-dev + + * libguile-dev + + * flex + + * bison + + * gettext + + * texinfo + + * tetex-dev + + * debhelper Windows NT/95 ============= @@ -336,10 +350,10 @@ your problems. If you find bugs, please send bug reports to . - Known bugs that are LilyPond's fault are listed in `TODO', or -demonstrated in `input/bugs/'. + Bugs that are LilyPond's fault are listed in our TODO list on the +web, or demonstrated in `input/bugs/'. - Known bugs that are not LilyPond's fault are documented here. + Bugs that are not LilyPond's fault are documented here. LinuxPPC Bugs: **************