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