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 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
  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. LilyPond is known to run on Linux, AIX, Digital
  27             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 LilyPond, simply type:
  54
  55                configure
  56                make install
  57
  58        This will install the following files:
  59
  60
  61
  62
  63
  64 25/Mar/97                LilyPond 0.0.45                        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/bin/lilypond
  75                /usr/local/bin/mi2mu
  76                /usr/local/share/lilypond/*
  77                /usr/lib/texmf/texmf/tex/lilypond/*
  78
  79        The TeX include directory is detected dynamically, but it
  80        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
  81        that you are root and have the gnu development tools, and
  82        your make is gnu make.  If this is not the case, you can
  83        adjust your environment variables to your taste:
  84
  85                export CPPFLAGS="-I /home/me/my_include -DWEIRD_FOOBAR"
  86                configure
  87
  88        CPPFLAGS are the preprocessor flags.
  89
  90        the configure script is Cygnus configure, and it will
  91        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
  92        to make it with
  93
  94                configure --prefix=/home/me_myself_and_I/
  95
  96        Since LilyPond currently is beta, You are advised to also
  97        use
  98
  99                --enable-debug
 100                --enable-checking
 101
 102        other options include:
 103
 104                --enable-printing
 105                --enable-optimise
 106                --enable-profiling
 107
 108        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
 109        usage.
 110
 111        If you do
 112
 113                make all
 114
 115        everything will be compiled, but nothing will be
 116        installed.  The resulting binaries can be found in the
 117        subdirectory _\bb_\bi_\bn_\b/.
 118
 119 R\bR\bR\bRU\bU\bU\bUN\bN\bN\bNN\bN\bN\bNI\bI\bI\bIN\bN\bN\bNG\bG\bG\bG
 120        LilyPond does use a lot of resources. For operation you
 121        need the following:
 122
 123        +\bo A fast computer (a full page of music typically takes 1
 124             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
 125             compile. It's lot slower than most MusiXTeX
 126             preprocessors)
 127
 128
 129
 130 25/Mar/97                LilyPond 0.0.45                        2
 131
 132
 133
 134
 135
 136 INSTALL(1)            LilyPond documentation           INSTALL(1)
 137
 138
 139        +\bo TeX
 140
 141        +\bo The MusixTeX fonts. (I use those found in MusixTeX T.59)
 142
 143        Please refer to the man page for more information.
 144
 145 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
 146        RedHat Linux users should be able to get a RPM. A spec
 147        file is in _\bm_\ba_\bk_\be_\b/_\bl_\bi_\bl_\by_\bp_\bo_\bn_\bd_\b._\bs_\bp_\be_\bc.
 148
 149 W\bW\bW\bWI\bI\bI\bIN\bN\bN\bND\bD\bD\bDO\bO\bO\bOZ\bZ\bZ\bZE\bE\bE\bE
 150        Windows NT:
 151
 152        you need the cygnus win32 gnu port development stuff; have
 153        a look at http://www.cygnus.com/gnu-win32.
 154
 155        to make LilyPond under, brr, aargh, well, simply type:
 156
 157                bash configure
 158                make win32
 159
 160
 161 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
 162        LilyPond (pl 0.0.39) is known to compile on the following
 163        platforms:
 164
 165                * linux 2.0.28, g++ 2.7.2[.1]
 166                * aix 4.1, g++ 2.7.2
 167                * windows-nt 4.0, cygnus gnu-win32 beta17.1 (~=g++ 2.7.2)
 168                * linux 2.0.28 X to doze, gcc-go32 (~=g++ 2.7.2) [exec. untested]
 169
 170
 171 A\bA\bA\bAU\bU\bU\bUT\bT\bT\bTH\bH\bH\bHO\bO\bO\bOR\bR\bR\bRS\bS\bS\bS
 172                Han-Wen Nienhuys <hanwen@stack.nl>
 173
 174                Jan Nieuwenhuizen <jan@digicash.com>
 175
 176        Have fun!
 177
 178
 179
 180
 181
 182
 183
 184
 185
 186
 187
 188
 189
 190
 191
 192
 193
 194
 195
 196 25/Mar/97                LilyPond 0.0.45                        3
 197
 198