summaryrefslogtreecommitdiff
path: root/INSTALL.text
blob: 7c2df20b4e76bd46be1349c8e8d36660590b7ecb (about) (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
INSTALL(1)            LilyPond documentation           INSTALL(1)


NNNNAAAAMMMMEEEE
       INSTALL - installing LilyPond

DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
       This page documents installation  and compilation of
       LilyPond

IIIIMMMMPPPPOOOORRRRTTTTAAAANNNNTTTT
       if you have downloaded a

               *.pre*

       version, then this is version is _n_o_t meant for producing
       nice output, but to keep your patchsets up to date.  It
       might not even compile.

PPPPRRRREEEERRRREEEEQQQQUUUUIIIISSSSIIIITTTTEEEESSSS
       For compilation you need.

       +o Unix. LilyPond is known to run on Linux, AIX, Digital
            Unix and Solaris
            If you have the Cygnus WIN32 port of the GNU utils,
            it will even work in Lose NT/95, but don't promise to
            support it.

       +o GNU C++ v2.7 or better, with libg++ installed.  Version
            2.7.2 or better recommended. I almost positive that
            it will not compile with AT&T CC.

       +o Bash. Most scripts will continue to work with a stock
            sh, but they might generate (harmless) syntax errors

       +o GNU make.

       +o Flex (2.5.1 or better).

       +o Bison.

RRRREEEECCCCOOOOMMMMMMMMEEEENNNNDDDDEEEEDDDD
       +o Perl.  Some (mostly unimportant scripts) use Perl for
            trivial operations. The documentation was created
            with the perl's Plain Old Documentation.

       +o (GNU) find

CCCCOOOONNNNFFFFIIIIGGGGUUUURRRRIIIINNNNGGGG aaaannnndddd CCCCOOOOMMMMPPPPIIIILLLLIIIINNNNGGGG
       to install LilyPond, simply type:

               configure
               make install

       This will install the following files:





3/Apr/97                 LilyPond 0.0.48                        1





INSTALL(1)            LilyPond documentation           INSTALL(1)


               /usr/local/man/man1/lilypond.1
               /usr/local/lib/libflower.{so,a}
               /usr/local/bin/lilypond
               /usr/local/bin/mi2mu
               /usr/local/share/lilypond/*
               /usr/lib/texmf/texmf/tex/lilypond/*

       The TeX include directory is detected dynamically, but it
       can be adjusted with --------eeeennnnaaaabbbblllleeee----tttteeeexxxxpppprrrreeeeffffiiiixxxx. The above assumes
       that you are root and have the gnu development tools, and
       your make is gnu make.  If this is not the case, you can
       adjust your environment variables to your taste:

               export CPPFLAGS="-I /home/me/my_include -DWEIRD_FOOBAR"
               configure

       CPPFLAGS are the preprocessor flags.

       the configure script is Cygnus configure, and it will
       accept --------hhhheeeellllpppp. If you are not root, you will probably have
       to make it with

               configure --prefix=/home/me_myself_and_I/

       Since LilyPond currently is beta, You are advised to also
       use

               --enable-debug
               --enable-checking

       other options include:

               --enable-shared
               --enable-printing
               --enable-optimise
               --enable-profiling

       The option --------eeeennnnaaaabbbblllleeee----ooooppppttttiiiimmmmiiiisssseeee is recommended for Real Life
       usage.

       If you do

               make all

       everything will be compiled, but nothing will be
       installed.  The resulting binaries can be found in the
       subdirectory _b_i_n_/.

RRRRUUUUNNNNNNNNIIIINNNNGGGG
       LilyPond does use a lot of resources. For operation you
       need the following:

       +o A fast computer (a full page of music typically takes 1
            minute on my 486/66, using the --------eeeennnnaaaabbbblllleeee----cccchhhheeeecccckkkkiiiinnnngggg



3/Apr/97                 LilyPond 0.0.48                        2





INSTALL(1)            LilyPond documentation           INSTALL(1)


            compile. It's lot slower than most MusiXTeX
            preprocessors)

       +o TeX

       +o The MusixTeX fonts. (I use those found in MusixTeX T.59)

       Please refer to the man page for more information.

RRRREEEEDDDDHHHHAAAATTTT LLLLIIIINNNNUUUUXXXX
       RedHat Linux users should be able to get a RPM. A spec
       file is in _m_a_k_e_/_l_i_l_y_p_o_n_d_._s_p_e_c.

WWWWIIIINNNNDDDDOOOOZZZZEEEE
       Windows NT:

       you need the cygnus win32 gnu port development stuff; have
       a look at http://www.cygnus.com/gnu-win32.

       to make LilyPond under, brr, aargh, well, simply type:

               bash configure
               make win32


PPPPLLLLAAAATTTTFFFFOOOORRRRMMMMSSSS
       LilyPond (pl 0.0.39) is known to compile on the following
       platforms:

               * linux 2.0.28, g++ 2.7.2[.1]
               * aix 4.1, g++ 2.7.2
               * windows-nt 4.0, cygnus gnu-win32 beta17.1 (~=g++ 2.7.2)
               * linux 2.0.28 X to doze, gcc-go32 (~=g++ 2.7.2) [exec. untested]


AAAAUUUUTTTTHHHHOOOORRRRSSSS
               Han-Wen Nienhuys <hanwen@stack.nl>

               Jan Nieuwenhuizen <jan@digicash.com>

       Have fun!
















3/Apr/97                 LilyPond 0.0.48                        3