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. (Version 1.25 or better)
  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 28/Apr/97                LilyPond 0.0.57                        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        In this case, you will have to set MFINPUTS, and TEINPUTS
  99        accordingly.
 100
 101        If you want to install GNU LilyPond in _\b/_\bu_\bs_\br_\b/_\bl_\bo_\bc_\ba_\bl, and
 102        your TeX has no default hooks for local stuff (mine is
 103        broken too), you can do:
 104
 105                configure --prefix=/usr/local --enable-tex-prefix=/usr/lib/texmf
 106
 107        Since GNU LilyPond currently is beta, you are advised to
 108        also use
 109
 110                --enable-debugging
 111                --enable-checking
 112
 113        other options include:
 114
 115        --enable-shared
 116            Make a shared library (linux, solaris (?) only )
 117
 118        --enable-printing
 119            Enable debugging print routines (-\b-\b-\b-d\bd\bd\bd option)
 120
 121        --enable-optimise
 122            Set maximum optimisation
 123
 124        --enable-profiling
 125            Compile with support for profiling
 126
 127
 128
 129
 130 28/Apr/97                LilyPond 0.0.57                        2
 131
 132
 133
 134
 135
 136 INSTALL(1)            LilyPond documentation           INSTALL(1)
 137
 138
 139        --enable-tex-prefix
 140            Set the directory where texmf lives
 141
 142        --enable-tex-dir
 143            Set then directory tex input is in
 144
 145        --enable-mf-dir
 146            Set then directory tex input is in
 147
 148        All options are documented in the _\bc_\bo_\bn_\bf_\bi_\bg_\bu_\br_\be help The
 149        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
 150        usage.
 151
 152        If you do
 153
 154                make all
 155
 156        everything will be compiled, but nothing will be
 157        installed.  The resulting binaries can be found in the
 158        subdirectory _\bb_\bi_\bn_\b/.
 159
 160 I\bI\bI\bIN\bN\bN\bNS\bS\bS\bST\bT\bT\bTA\bA\bA\bAL\bL\bL\bLL\bL\bL\bLI\bI\bI\bIN\bN\bN\bNG\bG\bG\bG
 161        If you have done a successful make, then a simple
 162
 163                make install
 164
 165        should do the trick.
 166
 167        [todo]
 168
 169        Install the musixtex fonts in a directory which TeX and MF
 170        knows (if you are root, look for a directory which
 171        contains the directories with AMS and CM source (*.mf)
 172        files. Create a subdir lilypond or musixtex and copy the
 173        fonts into that). Do not forget to rehash TeX (if
 174        applicable)
 175
 176        Example: my fonts are in
 177        _\b/_\bu_\bs_\br_\b/_\bl_\bo_\bc_\ba_\bl_\b/_\bl_\bi_\bb_\b/_\bt_\be_\bx_\bf_\bo_\bn_\bt_\bs_\b/_\bm_\bu_\bs_\bi_\bx_\bt_\be_\bx_\b/, and I have a symlink
 178        pointing to that in
 179        _\b/_\bu_\bs_\br_\b/_\bl_\bi_\bb_\b/_\bt_\be_\bx_\bm_\bf_\b/_\bt_\be_\bx_\bm_\bf_\b/_\bf_\bo_\bn_\bt_\bs_\b/_\bs_\bo_\bu_\br_\bc_\be_\b/_\bp_\bu_\bb_\bl_\bi_\bc_\b/
 180
 181 C\bC\bC\bCA\bA\bA\bAV\bV\bV\bVE\bE\bE\bEA\bA\bA\bAT\bT\bT\bTS\bS\bS\bS
 182        +\bo    The -O2 option to gcc triggers a gcc bug on DEC Alpha
 183             in dstream.cc. You should turn off this flag for this
 184             file.
 185
 186 R\bR\bR\bRU\bU\bU\bUN\bN\bN\bNN\bN\bN\bNI\bI\bI\bIN\bN\bN\bNG\bG\bG\bG
 187        GNU LilyPond does use a lot of resources. For operation
 188        you need the following:
 189
 190        +\bo    A fast computer (a full page of music typically takes
 191             1 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
 192             compile. It's lot slower than most MusiXTeX
 193
 194
 195
 196 28/Apr/97                LilyPond 0.0.57                        3
 197
 198
 199
 200
 201
 202 INSTALL(1)            LilyPond documentation           INSTALL(1)
 203
 204
 205             preprocessors)
 206
 207        +\bo    TeX
 208
 209        +\bo    The MusixTeX fonts. (I use those found in MusixTeX
 210             T.59). Beware, the clef symbol has changed position
 211             in recent versions of MusixTeX)
 212
 213        Please refer to the man page for more information.
 214
 215 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
 216        RedHat Linux users should be able to get a RPM. A spec
 217        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
 218        create an rpm as a normal user. Be sure you have a
 219        ~/.rpmrc, and edit the RPM-dir in _\bV_\ba_\br_\bi_\ba_\bb_\bl_\be_\bs_\b._\bm_\ba_\bk_\be
 220
 221 W\bW\bW\bWI\bI\bI\bIN\bN\bN\bND\bD\bD\bDO\bO\bO\bOZ\bZ\bZ\bZE\bE\bE\bE
 222        Windows NT:
 223
 224        you need the cygnus win32 gnu port development stuff; have
 225        a look at http://www.cygnus.com/gnu-win32.
 226
 227        to make GNU LilyPond under, brr, aargh, well, simply type:
 228
 229                bash configure
 230                make win32
 231
 232
 233 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
 234        GNU LilyPond (pl 0.0.39) is known to compile on the
 235        following platforms:
 236
 237                * linux 2.0.x, g++ 2.7.2[.1]
 238                * aix 4.1, g++ 2.7.2
 239                * windows-nt 4.0, cygnus gnu-win32 beta17.1 (~=g++ 2.7.2)
 240                * linux 2.0.28 X to doze, gcc-go32 (~=g++ 2.7.2) [exec. untested]
 241
 242
 243 A\bA\bA\bAU\bU\bU\bUT\bT\bT\bTH\bH\bH\bHO\bO\bO\bOR\bR\bR\bRS\bS\bS\bS
 244        Han-Wen Nienhuys <hanwen@stack.nl>
 245
 246        Jan Nieuwenhuizen <jan@digicash.com>
 247
 248        Have fun!
 249
 250
 251
 252
 253
 254
 255
 256
 257
 258
 259
 260
 261
 262 28/Apr/97                LilyPond 0.0.57                        4
 263
 264