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             If you have the Cygnus WIN32 port of the GNU utils,
  29             it will even work in Lose NT/95, but don't promise to
  30             support it.
  31
  32        +\bo GNU C++ v2.7 or better, with libg++ installed.  Version
  33             2.7.2 or better recommended. I almost positive that
  34             it will not compile with AT&T CC.
  35
  36        +\bo Bash. Most scripts will continue to work with a stock
  37             sh, but they might generate (harmless) syntax errors
  38
  39        +\bo GNU make.
  40
  41        +\bo Flex (2.5.1 or better).
  42
  43        +\bo Bison.
  44
  45 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
  46        +\bo Perl.  Some (mostly unimportant scripts) use Perl for
  47             trivial operations. The documentation was created
  48             with the perl's Plain Old Documentation.
  49
  50        +\bo (GNU) find
  51
  52 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
  53        to install GNU LilyPond, simply type:
  54
  55                configure
  56                make install
  57
  58        This will install the following files:
  59
  60
  61
  62
  63
  64 14/Apr/97                LilyPond 0.0.51                        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\bxp\bp\bp\bpr\br\br\bre\be\be\bef\bf\bf\bfi\bi\bi\bix\bx\bx\bx. The above assumes
  82        that you are root and have the gnu development tools, and
  83        your make is gnu make.  If this is not the case, you can
  84        adjust your environment variables to your taste:
  85
  86                export CPPFLAGS="-I /home/me/my_include -DWEIRD_FOOBAR"
  87                configure
  88
  89        CPPFLAGS are the preprocessor flags.
  90
  91        the configure script is Cygnus configure, and it will
  92        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
  93        to make it with
  94
  95                configure --prefix=/home/me_myself_and_I/
  96
  97        Since GNU LilyPond currently is beta, You are advised to
  98        also use
  99
 100                --enable-debug
 101                --enable-checking
 102
 103        other options include:
 104
 105                --enable-shared
 106                --enable-printing
 107                --enable-optimise
 108                --enable-profiling
 109
 110        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
 111        usage.
 112
 113        If you do
 114
 115                make all
 116
 117        everything will be compiled, but nothing will be
 118        installed.  The resulting binaries can be found in the
 119        subdirectory _\bb_\bi_\bn_\b/.
 120
 121 R\bR\bR\bRU\bU\bU\bUN\bN\bN\bNN\bN\bN\bNI\bI\bI\bIN\bN\bN\bNG\bG\bG\bG
 122        GNU LilyPond does use a lot of resources. For operation
 123        you need the following:
 124
 125        +\bo A fast computer (a full page of music typically takes 1
 126             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
 127
 128
 129
 130 14/Apr/97                LilyPond 0.0.51                        2
 131
 132
 133
 134
 135
 136 INSTALL(1)            LilyPond documentation           INSTALL(1)
 137
 138
 139             compile. It's lot slower than most MusiXTeX
 140             preprocessors)
 141
 142        +\bo TeX
 143
 144        +\bo The MusixTeX fonts. (I use those found in MusixTeX T.59)
 145
 146        Please refer to the man page for more information.
 147
 148 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
 149        RedHat Linux users should be able to get a RPM. A spec
 150        file is in _\bm_\ba_\bk_\be_\b/_\bl_\bi_\bl_\by_\bp_\bo_\bn_\bd_\b._\bs_\bp_\be_\bc.
 151
 152 W\bW\bW\bWI\bI\bI\bIN\bN\bN\bND\bD\bD\bDO\bO\bO\bOZ\bZ\bZ\bZE\bE\bE\bE
 153        Windows NT:
 154
 155        you need the cygnus win32 gnu port development stuff; have
 156        a look at http://www.cygnus.com/gnu-win32.
 157
 158        to make GNU LilyPond under, brr, aargh, well, simply type:
 159
 160                bash configure
 161                make win32
 162
 163
 164 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
 165        GNU LilyPond (pl 0.0.39) is known to compile on the
 166        following platforms:
 167
 168                * linux 2.0.28, g++ 2.7.2[.1]
 169                * aix 4.1, g++ 2.7.2
 170                * windows-nt 4.0, cygnus gnu-win32 beta17.1 (~=g++ 2.7.2)
 171                * linux 2.0.28 X to doze, gcc-go32 (~=g++ 2.7.2) [exec. untested]
 172
 173
 174 A\bA\bA\bAU\bU\bU\bUT\bT\bT\bTH\bH\bH\bHO\bO\bO\bOR\bR\bR\bRS\bS\bS\bS
 175                Han-Wen Nienhuys <hanwen@stack.nl>
 176
 177                Jan Nieuwenhuizen <jan@digicash.com>
 178
 179        Have fun!
 180
 181
 182
 183
 184
 185
 186
 187
 188
 189
 190
 191
 192
 193
 194
 195
 196 14/Apr/97                LilyPond 0.0.51                        3
 197
 198