Mercurial > hg > xmms-sid

comparison INSTALL @ 559:80f7cafcda0a

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Updated installation instructions, also moved libSIDPlay2 installation tips to www-pages (http://www.tnsp.org/?p=libsidplay2)
author Matti Hamalainen <ccr@tnsp.org>
date Thu, 08 Mar 2007 23:06:01 +0000
parents 3f58a06bc9df
children 36a2d95e4644
comparison
equal deleted inserted replaced
558:19c43bc20d1e 559:80f7cafcda0a
75 you have corresponding xmms-devel -package also. 75 you have corresponding xmms-devel -package also.
76 76
77 77
78 Where to get libSIDPlay1? 78 Where to get libSIDPlay1?
79 ========================= 79 =========================
80 Your OS distribution or some supplementary package repository 80 Typically your OS distribution or some supplementary package
81 may contain libSIDPlay1 packages. Usually those should work 81 repository may contain libSIDPlay1 packages. Usually those work
82 well, but remember to also install the corresponding -dev/-devel 82 well, but remember to also install the corresponding -dev/-devel
83 package. 83 package so that XMMS-SID can be compiled.
84 84
85 If you can't find packages for your OS, source tarballs for 85 If you can't find pre-made packages for your OS, source tarballs
86 libSIDPlay1 are available at SIDPlay's homepage: 86 for libSIDPlay1 are available at SIDPlay's homepage:
87 87
88 http://www.geocities.com/SiliconValley/Lakes/5147/sidplay/linux.html 88 http://www.geocities.com/SiliconValley/Lakes/5147/sidplay/linux.html
89 89
90 You only need libsidplay, the sidplay-base is not necessary 90 You only need libsidplay, the sidplay-base is not necessary
91 if you think that you do not need the commandline player. 91 for building or using XMMS-SID (it contains a command-line
92 SID-player).
92 93
93 94
94 Where to get libSIDPlay2? 95 Where to get and how to install libSIDPlay2?
95 ========================= 96 ============================================
96 As of now, some OS distributions already include libSIDPlay2 97 Please read the following web-page:
97 packages, but some of those may be too old or incompatible
98 with XMMS-SID. Also note, that ONLY the latest CVS version
99 (as of 28.5.2006) of libSIDPlay2 compiles correctly with
100 GCC 4.x - older versions trigger a GCC4 bug, which causes
101 tunes to play too fast!
102 98
103 The fixed versions are available as source tarballs 99 http://www.tnsp.org/?p=libsidplay2
104 (and RPMs for Fedora Core 3) and I highly recommend that
105 you use these versions. Please refer to:
106
107 http://www.tnsp.org/xmms-sid.php#download
108
109
110 However, the original home of libSIDPlay2 is at SourceForge:
111
112 http://sidplay2.sourceforge.net/
113 100
114 101
115 Building a CVS-version 102 Building a CVS-version
116 ====================== 103 ======================
117 To build a CVS-version of XMMS-SID, you need to have latest 104 To build a CVS-version of XMMS-SID, you need to have latest
126 "bootstrap.sh"-script which generates all necessary build-files. 113 "bootstrap.sh"-script which generates all necessary build-files.
127 After successfull bootstrapping, you should be able to install 114 After successfull bootstrapping, you should be able to install
128 the package normally, following steps described in next chapter. 115 the package normally, following steps described in next chapter.
129 116
130 117
131 Installing libSIDPlay2
132 ======================
133 NOTICE! The upstream libSIDPlay2 has several bugs in build
134 scripts, which botch up building on some non-mainstream
135 platforms, such as NetBSD and Solaris. I personally provide
136 fixed versions of libSIDPlay2, reSID and reSID-builder
137 packages. Therefore I highly recommend that you use the
138 fixed versions I provide on XMMS-SID's homepage (see above).
139
140
141 NOTICE #2! Under Solaris you may run into a linking problem,
142 because of a bug in GCC's libtool, please read following
143 mailing list thread for more information:
144
145 http://lists.gnu.org/archive/html/libtool/2005-08/msg00021.html
146
147
148 As the installation procedure of libSIDPlay2 is not completely
149 transparent or simple, I describe here the steps how to do it
150 (hopefully) in a succesful manner:
151
152 1) Get libSIDPlay2, reSID and reSID-builder packages.
153
154 2) Build reSID (you may need to invoke 'gmake' instead of 'make'):
155
156 tar -xzvf resid-0.16.2-ccr.tar.gz
157 cd resid-0.16.2-ccr
158 ./configure
159 make
160
161 There is no need to do "make install", just leave the
162 build directory intact, you will need the contents when
163 compiling reSID-builder below.
164
165 3) Build libSIDPlay2 similarly, but this time do install.
166 Untar the package as usual and ...
167
168 ./configure
169 make
170 make install
171
172 You have to do "make install" as root.
173
174 4) Build reSID-builder in similar manner, but with specific
175 configure parameters. As usual, untar the package and ...
176
177 ./configure --with-resid=/path/to/resid-0.16.2-ccr
178 make
179 make install
180
181 NOTE! Obviously you have to change the /path/to/ the
182 correct location where you compiled the reSID-package.
183
184 5) If all went well and without errors, you now should have
185 libSIDPlay2 installed with reSID software SID emulation
186 backend.
187
188
189 Installing XMMS-SID 118 Installing XMMS-SID
190 =================== 119 ===================
191 When you have the requirements installed and working succesfully, 120 When you have the requirements installed and working succesfully,
192 you may try compiling and installation of XMMS-SID. 121 you may try compilation and installation of XMMS-SID.
193 122
194 Invoke configure script (use parameter --help for help) 123 Invoke configure script (use 'configure --help' for help)
195 124
196 $ ./configure 125 $ ./configure
197 126
198 The configure-script will print out lots of information and in 127 The configure script will print out lots of information and in
199 the end it tells you some of the selected build options. 128 the end it tells you some of the selected build options.
200 129
201 NOTICE! On some systems it may be necessary to force 'configure' 130 NOTICE! On some systems it may be necessary to force 'configure'
202 to use gcc instead of g++ with following syntax: 131 to use gcc instead of g++ with following syntax:
203 132