changeset 559:80f7cafcda0a

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 19c43bc20d1e
children c90cebde0907
files INSTALL
diffstat 1 files changed, 14 insertions(+), 85 deletions(-) [+]
line wrap: on
line diff
--- a/INSTALL	Thu Mar 08 23:01:00 2007 +0000
+++ b/INSTALL	Thu Mar 08 23:06:01 2007 +0000
@@ -77,39 +77,26 @@
 
 Where to get libSIDPlay1?
 =========================
-Your OS distribution or some supplementary package repository
-may contain libSIDPlay1 packages. Usually those should work
+Typically your OS distribution or some supplementary package
+repository may contain libSIDPlay1 packages. Usually those work
 well, but remember to also install the corresponding -dev/-devel
-package.
+package so that XMMS-SID can be compiled.
 
-If you can't find packages for your OS, source tarballs for
-libSIDPlay1 are available at SIDPlay's homepage:
+If you can't find pre-made packages for your OS, source tarballs
+for libSIDPlay1 are available at SIDPlay's homepage:
 
 http://www.geocities.com/SiliconValley/Lakes/5147/sidplay/linux.html
 
 You only need libsidplay, the sidplay-base is not necessary
-if you think that you do not need the commandline player.
+for building or using XMMS-SID (it contains a command-line
+SID-player).
 
 
-Where to get libSIDPlay2?
-=========================
-As of now, some OS distributions already include libSIDPlay2
-packages, but some of those may be too old or incompatible
-with XMMS-SID. Also note, that ONLY the latest CVS version
-(as of 28.5.2006) of libSIDPlay2 compiles correctly with
-GCC 4.x - older versions trigger a GCC4 bug, which causes
-tunes to play too fast!
+Where to get and how to install libSIDPlay2?
+============================================
+Please read the following web-page:
 
-The fixed versions are available as source tarballs
-(and RPMs for Fedora Core 3) and I highly recommend that
-you use these versions. Please refer to:
-
-http://www.tnsp.org/xmms-sid.php#download
-
-
-However, the original home of libSIDPlay2 is at SourceForge:
-
-http://sidplay2.sourceforge.net/
+http://www.tnsp.org/?p=libsidplay2
 
 
 Building a CVS-version
@@ -128,74 +115,16 @@
 the package normally, following steps described in next chapter.
 
 
-Installing libSIDPlay2
-======================
-NOTICE! The upstream libSIDPlay2 has several bugs in build
-scripts, which botch up building on some non-mainstream
-platforms, such as NetBSD and Solaris. I personally provide
-fixed versions of libSIDPlay2, reSID and reSID-builder
-packages. Therefore I highly recommend that you use the
-fixed versions I provide on XMMS-SID's homepage (see above).
-
-
-NOTICE #2! Under Solaris you may run into a linking problem,
-because of a bug in GCC's libtool, please read following
-mailing list thread for more information:
-
-http://lists.gnu.org/archive/html/libtool/2005-08/msg00021.html
-
-
-As the installation procedure of libSIDPlay2 is not completely
-transparent or simple, I describe here the steps how to do it
-(hopefully) in a succesful manner:
-
-1) Get libSIDPlay2, reSID and reSID-builder packages.
-
-2) Build reSID (you may need to invoke 'gmake' instead of 'make'):
-
-   tar -xzvf resid-0.16.2-ccr.tar.gz
-   cd resid-0.16.2-ccr
-   ./configure
-   make
-
-   There is no need to do "make install", just leave the
-   build directory intact, you will need the contents when
-   compiling reSID-builder below.
-
-3) Build libSIDPlay2 similarly, but this time do install.
-   Untar the package as usual and ...
-
-   ./configure
-   make
-   make install
-
-   You have to do "make install" as root.
-
-4) Build reSID-builder in similar manner, but with specific
-   configure parameters. As usual, untar the package and ...
-
-   ./configure --with-resid=/path/to/resid-0.16.2-ccr
-   make
-   make install
-
-   NOTE! Obviously you have to change the /path/to/ the
-   correct location where you compiled the reSID-package.
-
-5) If all went well and without errors, you now should have
-   libSIDPlay2 installed with reSID software SID emulation
-   backend.
-
-   
 Installing XMMS-SID
 ===================
 When you have the requirements installed and working succesfully,
-you may try compiling and installation of XMMS-SID.
+you may try compilation and installation of XMMS-SID.
 
-Invoke configure script (use parameter --help for help)
+Invoke configure script (use 'configure --help' for help)
 
 $ ./configure
 
-The configure-script will print out lots of information and in
+The configure script will print out lots of information and in
 the end it tells you some of the selected build options.
 
 NOTICE! On some systems it may be necessary to force 'configure'