comparison INSTALL @ 171:78e06aecad7f

Updated documentation.
author Matti Hamalainen <ccr@tnsp.org>
date Fri, 13 Aug 2004 06:39:04 +0000
parents b80986b4f510
children be1cf864f28e
comparison
equal deleted inserted replaced
170:89844080b44b 171:78e06aecad7f
1 This document describes overall requirements and procedure 1 This document describes overall requirements and procedure
2 for installation of XMMS-SID package, please read it carefully! 2 for installation of XMMS-SID package, please read it carefully!
3 3 For more tips, please also read README and FAQ.
4 4
5 Requirements 5 Requirements
6 ============ 6 ============
7 - XMMS version 1.2.0 or later (http://www.xmms.org/) 7 - XMMS version 1.2.0 or later (http://www.xmms.org/)
8 8
9 - Gtk+ and Glib 1.2.5 or later (http://www.gtk.org/) 9 - Gtk+ and Glib 1.2.5 or later (http://www.gtk.org/)
10 10
11 - C and C++-compiler. Preferably gcc and g++, I have no idea 11 - C and C++-compiler. Preferably GCC along with rest of the
12 whether this compiles with any other compilers ... sorry. 12 GNU toolchain. I have no idea whether this compiles with
13 any other compiler ... sorry.
13 14
14 - You need AT LEAST one emulation library: 15 - You need AT LEAST one emulation library:
15 16
16 * libSIDPlay1 17 * libSIDPlay1
17 * libSIDPlay2 18 * libSIDPlay2
18 * NanoSID 19 * NanoSID
19 20
20 Only one is required, but all are supported. You may also 21 Only one is required, but all are supported. You may also need
21 need some supplementary libraries, that are required by 22 some supplementary libraries, that are required by the emulator
22 the emulator library. See below for more information. 23 library. See below for more information.
24
25
26 NOTICE! Refer to file README for recommendations about which
27 emulator libraries you should install!
28
23 29
24 30
25 Where to get XMMS? 31 Where to get XMMS?
26 ================== 32 ==================
27 Latest version of XMMS should be available from: 33 Latest version of XMMS should be available from:
28 34
29 http://www.xmms.org/ 35 http://www.xmms.org/
30 36
31 Please refer to XMMS documentation for information 37 Please refer to XMMS documentation for information on its usage
32 on it's usage and installation (etc). 38 and installation, etc. You probably have XMMS already installed,
39 but if you installed from a pre-built package, make sure that
40 you have corresponding xmms-devel -package also.
33 41
34 42
35 Where to get libSIDPlay1? 43 Where to get libSIDPlay1?
36 ========================= 44 =========================
37 libSIDPlay1 is available at SIDPlay's homepage: 45 libSIDPlay1 is available at SIDPlay's homepage:
46 ========================= 54 =========================
47 libSIDPlay2 is available at SourceForge: 55 libSIDPlay2 is available at SourceForge:
48 56
49 http://sidplay2.sourceforge.net/ 57 http://sidplay2.sourceforge.net/
50 58
51 You need the "sidplay-libs-2.1.0" package! Earlier versions 59 You need the "sidplay-libs-2.1.0" package! Earlier versions WILL NOT
52 WILL NOT WORK! Later versions MAY work, but I can't really 60 WORK! Later versions MAY work, but I can't really guarantee that.
53 guarantee that.
54 61
55 62
56 Where to get NanoSID? 63 Where to get NanoSID?
57 ===================== 64 =====================
58 libNanoSID is available from LolOLOlo's pages: 65 libNanoSID is available from LolOLOlo's pages:
67 Building a CVS-version 74 Building a CVS-version
68 ====================== 75 ======================
69 To build a CVS-version of XMMS-SID, you need to have latest 76 To build a CVS-version of XMMS-SID, you need to have latest
70 (STABLE) versions of following tools installed, including: 77 (STABLE) versions of following tools installed, including:
71 78
72 - GNU autoconf 2.56 or later 79 - GNU autoconf 2.56 or newer
73 - GNU automake 1.7 or later 80 - GNU automake 1.7 (older and newer versions MAY be incompatible!)
74 - GNU libtool 1.5 or later 81 - GNU libtool 1.5 or newer
75 - Glade for Gtk+ 1.2 programs (I use Glade 0.6.4) 82 - Glade for Gtk+ 1.2 programs (I use Glade 0.6.4)
76 83
77 If you have all required tools installed, just run the 84 If you have all required tools installed, just run the
78 "bootstrap.sh"-script which generates all necessary 85 "bootstrap.sh"-script which generates all necessary build-files.
79 build-files. After successfull bootstrapping, you 86 After successfull bootstrapping, you should be able to install
80 should be able to install the package normally. 87 the package normally, following steps described in next chapter.
81 88
82 89
83 Installing XMMS-SID 90 Installing XMMS-SID
84 =================== 91 ===================
85 When you have the requirements installed and working 92 When you have the requirements installed and working succesfully,
86 succesfully, you can try compiling XMMS-SID. 93 you may try compiling and installation of XMMS-SID.
87 94
88 Invoke configure-script (use parameter --help for help) 95 Invoke configure script (use parameter --help for help)
89 96
90 $ ./configure 97 $ ./configure
91 98
92 The configure-script will print out lots of information and in 99 The configure-script will print out lots of information and in
93 the end it tells you some of the selected build options. 100 the end it tells you some of the selected build options.