


INSTALL(1)            LilyPond documentation           INSTALL(1)


NNNNAAAAMMMMEEEE
       INSTALL - installing GNU LilyPond

DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
       This page documents installation  and compilation of GNU
       LilyPond

IIIIMMMMPPPPOOOORRRRTTTTAAAANNNNTTTT
       if you have downloaded a

               *.pre*

       version, then this is version is _n_o_t meant for producing
       nice output, but to keep your patchsets up to date.  It
       might not even compile.

PPPPRRRREEEERRRREEEEQQQQUUUUIIIISSSSIIIITTTTEEEESSSS
       For compilation you need.

       +o    Unix. GNU LilyPond is known to run on Linux, AIX,
            Digital Unix and Solaris

            If you have the Cygnus WIN32 port of the GNU utils,
            it will even work in Lose NT/95, but don't promise to
            support it.

       +o    GNU C++ v2.7 or better, with libg++ installed.
            Version 2.7.2 or better recommended. I almost
            positive that it will not compile with AT&T CC.

       +o    GNU make.

       +o    Flex (2.5.1 or better).

       +o    Bison.

RRRREEEECCCCOOOOMMMMMMMMEEEENNNNDDDDEEEEDDDD
       +o    Perl.  Most scripts are written in Perl. The
            documentation was created with the perl's Plain Old
            Documentation.

       +o (GNU) find

CCCCOOOONNNNFFFFIIIIGGGGUUUURRRRIIIINNNNGGGG aaaannnndddd CCCCOOOOMMMMPPPPIIIILLLLIIIINNNNGGGG
       to install GNU LilyPond, simply type:

               configure
               make install

       This will install the following files:







17/Apr/97                LilyPond 0.0.52                        1





INSTALL(1)            LilyPond documentation           INSTALL(1)


               /usr/local/man/man1/lilypond.1
               /usr/local/lib/libflower.{so,a}
               /usr/local/bin/lilypond
               /usr/local/bin/mi2mu
               /usr/local/share/lilypond/*
               /usr/lib/texmf/texmf/tex/lilypond/*

       The TeX include directory is detected dynamically, but it
       can be adjusted with --------eeeennnnaaaabbbblllleeee----tttteeeexxxx----pppprrrreeeeffffiiiixxxx and --------eeeennnnaaaabbbblllleeee----tttteeeexxxx----
       ddddiiiirrrr. 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 adjust your environment variables to
       your taste:

               export CPPFLAGS="-I /home/me/my_include -DWEIRD_FOOBAR"
               configure

       CPPFLAGS are the preprocessor flags.

       the configure script is Cygnus configure, and it will
       accept --------hhhheeeellllpppp. If you are not root, you will probably have
       to make it with

               configure --prefix=/home/me_myself_and_I/

       If you want to install GNU LilyPond in _/_u_s_r_/_l_o_c_a_l, and
       your TeX has no default hooks for local stuff (mine is
       broken too), you can do:

               configure --prefix=/usr/local --enable-tex-prefix=/usr/lib/texmf

       Since GNU LilyPond currently is beta, you are advised to
       also use

               --enable-debug
               --enable-checking

       other options include:

               --enable-shared
               --enable-printing
               --enable-optimise
               --enable-profiling
               --enable-tex-prefix
               --enable-tex-dir

       The option --------eeeennnnaaaabbbblllleeee----ooooppppttttiiiimmmmiiiisssseeee is recommended for Real Life
       usage.

       If you do

               make all

       everything will be compiled, but nothing will be



17/Apr/97                LilyPond 0.0.52                        2





INSTALL(1)            LilyPond documentation           INSTALL(1)


       installed.  The resulting binaries can be found in the
       subdirectory _b_i_n_/.

RRRRUUUUNNNNNNNNIIIINNNNGGGG
       GNU LilyPond does use a lot of resources. For operation
       you need the following:

       +o A fast computer (a full page of music typically takes 1
            minute on my 486/66, using the --------eeeennnnaaaabbbblllleeee----cccchhhheeeecccckkkkiiiinnnngggg
            compile. It's lot slower than most MusiXTeX
            preprocessors)

       +o TeX

       +o The MusixTeX fonts. (I use those found in MusixTeX T.59)

       Please refer to the man page for more information.

RRRREEEEDDDDHHHHAAAATTTT LLLLIIIINNNNUUUUXXXX
       RedHat Linux users should be able to get a RPM. A spec
       file is in _m_a_k_e_/_l_i_l_y_p_o_n_d_._s_p_e_c. You should be able to
       create an rpm as a normal user. Be sure you have a
       ~/.rpmrc, and edit the RPM-dir in _V_a_r_i_a_b_l_e_s_._m_a_k_e

WWWWIIIINNNNDDDDOOOOZZZZEEEE
       Windows NT:

       you need the cygnus win32 gnu port development stuff; have
       a look at http://www.cygnus.com/gnu-win32.

       to make GNU LilyPond under, brr, aargh, well, simply type:

               bash configure
               make win32


PPPPLLLLAAAATTTTFFFFOOOORRRRMMMMSSSS
       GNU LilyPond (pl 0.0.39) is known to compile on the
       following platforms:

               * linux 2.0.x, g++ 2.7.2[.1]
               * aix 4.1, g++ 2.7.2
               * windows-nt 4.0, cygnus gnu-win32 beta17.1 (~=g++ 2.7.2)
               * linux 2.0.28 X to doze, gcc-go32 (~=g++ 2.7.2) [exec. untested]


AAAAUUUUTTTTHHHHOOOORRRRSSSS
       Han-Wen Nienhuys <hanwen@stack.nl>

       Jan Nieuwenhuizen <jan@digicash.com>

       Have fun!





17/Apr/97                LilyPond 0.0.52                        3


