INSTALL.text

   1
   2
   3
   4 INSTALL(1)            LilyPond documentation           INSTALL(1)
   5
   6
   7 N\bN\bN\bNA\bA\bA\bAM\bM\bM\bME\bE\bE\bE
   8        INSTALL - installing GNU LilyPond
   9
  10 D\bD\bD\bDE\bE\bE\bES\bS\bS\bSC\bC\bC\bCR\bR\bR\bRI\bI\bI\bIP\bP\bP\bPT\bT\bT\bTI\bI\bI\bIO\bO\bO\bON\bN\bN\bN
  11        This page documents installation  and compilation of GNU
  12        LilyPond
  13
  14 I\bI\bI\bIM\bM\bM\bMP\bP\bP\bPO\bO\bO\bOR\bR\bR\bRT\bT\bT\bTA\bA\bA\bAN\bN\bN\bNT\bT\bT\bT
  15        if you have downloaded a
  16
  17                *.pre*
  18
  19        version, then this is version is _\bn_\bo_\bt meant for producing
  20        nice output, but to keep your patchsets up to date.  It
  21        might not even compile.
  22
  23 P\bP\bP\bPR\bR\bR\bRE\bE\bE\bER\bR\bR\bRE\bE\bE\bEQ\bQ\bQ\bQU\bU\bU\bUI\bI\bI\bIS\bS\bS\bSI\bI\bI\bIT\bT\bT\bTE\bE\bE\bES\bS\bS\bS
  24        For compilation you need.
  25
  26        +\bo    Unix. GNU LilyPond is known to run on Linux, AIX,
  27             Digital Unix and Solaris
  28
  29             If you have the Cygnus WIN32 port of the GNU utils,
  30             it will even work in Lose NT/95, but don't promise to
  31             support it.
  32
  33        +\bo    GNU C++ v2.7 or better, with libg++ installed.
  34             Version 2.7.2 or better recommended. I almost
  35             positive that it will not compile with AT&T CC.
  36
  37        +\bo    GNU make.
  38
  39        +\bo    Flex (2.5.1 or better).
  40
  41        +\bo    Bison.
  42
  43 R\bR\bR\bRE\bE\bE\bEC\bC\bC\bCO\bO\bO\bOM\bM\bM\bMM\bM\bM\bME\bE\bE\bEN\bN\bN\bND\bD\bD\bDE\bE\bE\bED\bD\bD\bD
  44        +\bo    Perl.  Most scripts are written in Perl. The
  45             documentation was created with the perl's Plain Old
  46             Documentation.
  47
  48        +\bo (GNU) find
  49
  50 C\bC\bC\bCO\bO\bO\bON\bN\bN\bNF\bF\bF\bFI\bI\bI\bIG\bG\bG\bGU\bU\bU\bUR\bR\bR\bRI\bI\bI\bIN\bN\bN\bNG\bG\bG\bG a\ba\ba\ban\bn\bn\bnd\bd\bd\bd C\bC\bC\bCO\bO\bO\bOM\bM\bM\bMP\bP\bP\bPI\bI\bI\bIL\bL\bL\bLI\bI\bI\bIN\bN\bN\bNG\bG\bG\bG
  51        to install GNU LilyPond, simply type:
  52
  53                configure
  54                make install
  55
  56        This will install the following files:
  57
  58
  59
  60
  61
  62
  63
  64 17/Apr/97                LilyPond 0.0.52                        1
  65
  66
  67
  68
  69
  70 INSTALL(1)            LilyPond documentation           INSTALL(1)
  71
  72
  73                /usr/local/man/man1/lilypond.1
  74                /usr/local/lib/libflower.{so,a}
  75                /usr/local/bin/lilypond
  76                /usr/local/bin/mi2mu
  77                /usr/local/share/lilypond/*
  78                /usr/lib/texmf/texmf/tex/lilypond/*
  79
  80        The TeX include directory is detected dynamically, but it
  81        can be adjusted with -\b-\b-\b--\b-\b-\b-e\be\be\ben\bn\bn\bna\ba\ba\bab\bb\bb\bbl\bl\bl\ble\be\be\be-\b-\b-\b-t\bt\bt\bte\be\be\bex\bx\bx\bx-\b-\b-\b-p\bp\bp\bpr\br\br\bre\be\be\bef\bf\bf\bfi\bi\bi\bix\bx\bx\bx and -\b-\b-\b--\b-\b-\b-e\be\be\ben\bn\bn\bna\ba\ba\bab\bb\bb\bbl\bl\bl\ble\be\be\be-\b-\b-\b-t\bt\bt\bte\be\be\bex\bx\bx\bx-\b-\b-\b-
  82        d\bd\bd\bdi\bi\bi\bir\br\br\br. The above assumes that you are root and have the gnu
  83        development tools, and your make is gnu make.  If this is
  84        not the case, you can adjust your environment variables to
  85        your taste:
  86
  87                export CPPFLAGS="-I /home/me/my_include -DWEIRD_FOOBAR"
  88                configure
  89
  90        CPPFLAGS are the preprocessor flags.
  91
  92        the configure script is Cygnus configure, and it will
  93        accept -\b-\b-\b--\b-\b-\b-h\bh\bh\bhe\be\be\bel\bl\bl\blp\bp\bp\bp. If you are not root, you will probably have
  94        to make it with
  95
  96                configure --prefix=/home/me_myself_and_I/
  97
  98        If you want to install GNU LilyPond in _\b/_\bu_\bs_\br_\b/_\bl_\bo_\bc_\ba_\bl, and
  99        your TeX has no default hooks for local stuff (mine is
 100        broken too), you can do:
 101
 102                configure --prefix=/usr/local --enable-tex-prefix=/usr/lib/texmf
 103
 104        Since GNU LilyPond currently is beta, you are advised to
 105        also use
 106
 107                --enable-debug
 108                --enable-checking
 109
 110        other options include:
 111
 112                --enable-shared
 113                --enable-printing
 114                --enable-optimise
 115                --enable-profiling
 116                --enable-tex-prefix
 117                --enable-tex-dir
 118
 119        The option -\b-\b-\b--\b-\b-\b-e\be\be\ben\bn\bn\bna\ba\ba\bab\bb\bb\bbl\bl\bl\ble\be\be\be-\b-\b-\b-o\bo\bo\bop\bp\bp\bpt\bt\bt\bti\bi\bi\bim\bm\bm\bmi\bi\bi\bis\bs\bs\bse\be\be\be is recommended for Real Life
 120        usage.
 121
 122        If you do
 123
 124                make all
 125
 126        everything will be compiled, but nothing will be
 127
 128
 129
 130 17/Apr/97                LilyPond 0.0.52                        2
 131
 132
 133
 134
 135
 136 INSTALL(1)            LilyPond documentation           INSTALL(1)
 137
 138
 139        installed.  The resulting binaries can be found in the
 140        subdirectory _\bb_\bi_\bn_\b/.
 141
 142 R\bR\bR\bRU\bU\bU\bUN\bN\bN\bNN\bN\bN\bNI\bI\bI\bIN\bN\bN\bNG\bG\bG\bG
 143        GNU LilyPond does use a lot of resources. For operation
 144        you need the following:
 145
 146        +\bo A fast computer (a full page of music typically takes 1
 147             minute on my 486/66, using the -\b-\b-\b--\b-\b-\b-e\be\be\ben\bn\bn\bna\ba\ba\bab\bb\bb\bbl\bl\bl\ble\be\be\be-\b-\b-\b-c\bc\bc\bch\bh\bh\bhe\be\be\bec\bc\bc\bck\bk\bk\bki\bi\bi\bin\bn\bn\bng\bg\bg\bg
 148             compile. It's lot slower than most MusiXTeX
 149             preprocessors)
 150
 151        +\bo TeX
 152
 153        +\bo The MusixTeX fonts. (I use those found in MusixTeX T.59)
 154
 155        Please refer to the man page for more information.
 156
 157 R\bR\bR\bRE\bE\bE\bED\bD\bD\bDH\bH\bH\bHA\bA\bA\bAT\bT\bT\bT L\bL\bL\bLI\bI\bI\bIN\bN\bN\bNU\bU\bU\bUX\bX\bX\bX
 158        RedHat Linux users should be able to get a RPM. A spec
 159        file is in _\bm_\ba_\bk_\be_\b/_\bl_\bi_\bl_\by_\bp_\bo_\bn_\bd_\b._\bs_\bp_\be_\bc. You should be able to
 160        create an rpm as a normal user. Be sure you have a
 161        ~/.rpmrc, and edit the RPM-dir in _\bV_\ba_\br_\bi_\ba_\bb_\bl_\be_\bs_\b._\bm_\ba_\bk_\be
 162
 163 W\bW\bW\bWI\bI\bI\bIN\bN\bN\bND\bD\bD\bDO\bO\bO\bOZ\bZ\bZ\bZE\bE\bE\bE
 164        Windows NT:
 165
 166        you need the cygnus win32 gnu port development stuff; have
 167        a look at http://www.cygnus.com/gnu-win32.
 168
 169        to make GNU LilyPond under, brr, aargh, well, simply type:
 170
 171                bash configure
 172                make win32
 173
 174
 175 P\bP\bP\bPL\bL\bL\bLA\bA\bA\bAT\bT\bT\bTF\bF\bF\bFO\bO\bO\bOR\bR\bR\bRM\bM\bM\bMS\bS\bS\bS
 176        GNU LilyPond (pl 0.0.39) is known to compile on the
 177        following platforms:
 178
 179                * linux 2.0.x, g++ 2.7.2[.1]
 180                * aix 4.1, g++ 2.7.2
 181                * windows-nt 4.0, cygnus gnu-win32 beta17.1 (~=g++ 2.7.2)
 182                * linux 2.0.28 X to doze, gcc-go32 (~=g++ 2.7.2) [exec. untested]
 183
 184
 185 A\bA\bA\bAU\bU\bU\bUT\bT\bT\bTH\bH\bH\bHO\bO\bO\bOR\bR\bR\bRS\bS\bS\bS
 186        Han-Wen Nienhuys <hanwen@stack.nl>
 187
 188        Jan Nieuwenhuizen <jan@digicash.com>
 189
 190        Have fun!
 191
 192
 193
 194
 195
 196 17/Apr/97                LilyPond 0.0.52                        3
 197
 198