Mercurial > hg > xmms-sid
annotate INSTALL @ 80:7047a6390b08
Updated and improved documentation
| author | Matti Hamalainen <ccr@tnsp.org> |
|---|---|
| date | Fri, 03 Oct 2003 03:14:00 +0000 |
| parents | c145ff12f2d0 |
| children | 9ab0c2fff794 |
| rev | line source |
|---|---|
| 1 | 1 Requirements |
| 2 ============ | |
| 3 - XMMS version 1.2.0 or later (http://www.xmms.org/) | |
| 7 | 4 |
| 5 - Gtk+ and Glib 1.2.8 or later (http://www.gtk.org/) | |
| 6 | |
| 7 - C and C++-compiler. Preferably gcc and g++, I have | |
| 8 no idea whether this compiles with any other | |
| 9 compilers ... sorry. | |
| 10 | |
| 23 | 11 - You need either one or both of the following: |
| 12 * libsidplay1 | |
| 13 * libsidplay2 | |
| 7 | 14 |
|
34
0e1189b94a7f
Updated installation instructions
Matti Hamalainen <ccr@tnsp.org>
parents:
31
diff
changeset
|
15 Only v1 or v2 is required and you can only compile in support |
|
0e1189b94a7f
Updated installation instructions
Matti Hamalainen <ccr@tnsp.org>
parents:
31
diff
changeset
|
16 for either one, but not both! See below for more information |
|
0e1189b94a7f
Updated installation instructions
Matti Hamalainen <ccr@tnsp.org>
parents:
31
diff
changeset
|
17 about them. |
| 1 | 18 |
| 19 | |
| 20 Where to get XMMS? | |
| 21 ================== | |
| 22 Latest version of XMMS should be available from | |
| 23 | |
| 24 http://www.xmms.org/ | |
| 25 | |
| 26 Please refer to XMMS documentation for information | |
| 27 on it's usage and installation (etc). | |
| 28 | |
| 29 | |
|
80
7047a6390b08
Updated and improved documentation
Matti Hamalainen <ccr@tnsp.org>
parents:
41
diff
changeset
|
30 Where to get those emulator libraries? |
|
7047a6390b08
Updated and improved documentation
Matti Hamalainen <ccr@tnsp.org>
parents:
41
diff
changeset
|
31 ====================================== |
|
7047a6390b08
Updated and improved documentation
Matti Hamalainen <ccr@tnsp.org>
parents:
41
diff
changeset
|
32 |
|
7047a6390b08
Updated and improved documentation
Matti Hamalainen <ccr@tnsp.org>
parents:
41
diff
changeset
|
33 * libSIDPlay1 is available at SIDPlay's homepage: |
| 1 | 34 |
|
80
7047a6390b08
Updated and improved documentation
Matti Hamalainen <ccr@tnsp.org>
parents:
41
diff
changeset
|
35 http://www.geocities.com/SiliconValley/Lakes/5147/sidplay/ |
| 1 | 36 |
|
80
7047a6390b08
Updated and improved documentation
Matti Hamalainen <ccr@tnsp.org>
parents:
41
diff
changeset
|
37 You only need libsidplay, the sidplay-base is not necessary |
|
7047a6390b08
Updated and improved documentation
Matti Hamalainen <ccr@tnsp.org>
parents:
41
diff
changeset
|
38 if you are sure that you don't need the commandline player. |
| 1 | 39 |
| 23 | 40 |
|
80
7047a6390b08
Updated and improved documentation
Matti Hamalainen <ccr@tnsp.org>
parents:
41
diff
changeset
|
41 * libSIDPlay2 is available at SourceForge: |
|
7047a6390b08
Updated and improved documentation
Matti Hamalainen <ccr@tnsp.org>
parents:
41
diff
changeset
|
42 |
|
7047a6390b08
Updated and improved documentation
Matti Hamalainen <ccr@tnsp.org>
parents:
41
diff
changeset
|
43 http://sidplay2.sourceforge.net/ |
| 7 | 44 |
|
80
7047a6390b08
Updated and improved documentation
Matti Hamalainen <ccr@tnsp.org>
parents:
41
diff
changeset
|
45 You need the "sidplay-libs-2.1.0" package! Earlier versions |
|
7047a6390b08
Updated and improved documentation
Matti Hamalainen <ccr@tnsp.org>
parents:
41
diff
changeset
|
46 WILL NOT WORK! Later versions MAY work, but it is not really |
|
7047a6390b08
Updated and improved documentation
Matti Hamalainen <ccr@tnsp.org>
parents:
41
diff
changeset
|
47 guaranteed. |
| 7 | 48 |
|
80
7047a6390b08
Updated and improved documentation
Matti Hamalainen <ccr@tnsp.org>
parents:
41
diff
changeset
|
49 |
|
7047a6390b08
Updated and improved documentation
Matti Hamalainen <ccr@tnsp.org>
parents:
41
diff
changeset
|
50 * libNanoSID is available from LolOLOlo's pages: |
|
7047a6390b08
Updated and improved documentation
Matti Hamalainen <ccr@tnsp.org>
parents:
41
diff
changeset
|
51 |
|
7047a6390b08
Updated and improved documentation
Matti Hamalainen <ccr@tnsp.org>
parents:
41
diff
changeset
|
52 http://www.sid6581.org/NanoSID/ |
| 1 | 53 |
| 54 | |
| 36 | 55 Building a CVS-version |
| 56 ====================== | |
| 57 To build a CVS-version of XMMS-SID, you need to have latest | |
| 41 | 58 (STABLE) versions of following tools installed, including: |
|
34
0e1189b94a7f
Updated installation instructions
Matti Hamalainen <ccr@tnsp.org>
parents:
31
diff
changeset
|
59 |
| 41 | 60 - GNU autoconf 2.56 or later |
| 61 - GNU automake 1.7 or later | |
| 62 - GNU libtool 1.4.3 or later | |
| 63 - Glade for Gtk+ 1.2 programs (I use Glade 0.6.4) | |
|
34
0e1189b94a7f
Updated installation instructions
Matti Hamalainen <ccr@tnsp.org>
parents:
31
diff
changeset
|
64 |
|
0e1189b94a7f
Updated installation instructions
Matti Hamalainen <ccr@tnsp.org>
parents:
31
diff
changeset
|
65 If you have all required tools installed, just run the |
|
0e1189b94a7f
Updated installation instructions
Matti Hamalainen <ccr@tnsp.org>
parents:
31
diff
changeset
|
66 "bootstrap.sh"-script which generates all necessary |
|
0e1189b94a7f
Updated installation instructions
Matti Hamalainen <ccr@tnsp.org>
parents:
31
diff
changeset
|
67 build-files. After successfull bootstrapping, you can |
|
0e1189b94a7f
Updated installation instructions
Matti Hamalainen <ccr@tnsp.org>
parents:
31
diff
changeset
|
68 continue to install the package normally. |
|
0e1189b94a7f
Updated installation instructions
Matti Hamalainen <ccr@tnsp.org>
parents:
31
diff
changeset
|
69 |
|
0e1189b94a7f
Updated installation instructions
Matti Hamalainen <ccr@tnsp.org>
parents:
31
diff
changeset
|
70 |
| 7 | 71 Installing XMMS-SID |
| 1 | 72 =================== |
| 7 | 73 When you have the requirements installed and working |
| 74 succesfully, you can try compiling XMMS-SID. | |
| 75 | |
| 76 Invoke configure-script (use parameter --help for help) | |
| 77 | |
| 78 $ ./configure | |
| 1 | 79 |
|
34
0e1189b94a7f
Updated installation instructions
Matti Hamalainen <ccr@tnsp.org>
parents:
31
diff
changeset
|
80 You may need to select which version of libSIDPlay you want to |
|
0e1189b94a7f
Updated installation instructions
Matti Hamalainen <ccr@tnsp.org>
parents:
31
diff
changeset
|
81 use by specifying either --with-sidplay1 or --with-sidplay2 |
|
0e1189b94a7f
Updated installation instructions
Matti Hamalainen <ccr@tnsp.org>
parents:
31
diff
changeset
|
82 options. If none are specified, configure will use the first |
|
0e1189b94a7f
Updated installation instructions
Matti Hamalainen <ccr@tnsp.org>
parents:
31
diff
changeset
|
83 one found. |
| 7 | 84 |
|
34
0e1189b94a7f
Updated installation instructions
Matti Hamalainen <ccr@tnsp.org>
parents:
31
diff
changeset
|
85 The configure-script will print out lots of information and in |
|
0e1189b94a7f
Updated installation instructions
Matti Hamalainen <ccr@tnsp.org>
parents:
31
diff
changeset
|
86 the end it tells you some of the selected build options. |
|
0e1189b94a7f
Updated installation instructions
Matti Hamalainen <ccr@tnsp.org>
parents:
31
diff
changeset
|
87 |
|
0e1189b94a7f
Updated installation instructions
Matti Hamalainen <ccr@tnsp.org>
parents:
31
diff
changeset
|
88 If configure passed without errors, try compilation. (Depending |
|
0e1189b94a7f
Updated installation instructions
Matti Hamalainen <ccr@tnsp.org>
parents:
31
diff
changeset
|
89 on your system, you may need to invoke 'gmake' instead of 'make'.) |
| 1 | 90 |
| 7 | 91 $ make |
| 92 | |
|
34
0e1189b94a7f
Updated installation instructions
Matti Hamalainen <ccr@tnsp.org>
parents:
31
diff
changeset
|
93 If that went OK too, then you may try installation (as root, if |
|
0e1189b94a7f
Updated installation instructions
Matti Hamalainen <ccr@tnsp.org>
parents:
31
diff
changeset
|
94 you are installing globally for the system). Again, you may need |
|
0e1189b94a7f
Updated installation instructions
Matti Hamalainen <ccr@tnsp.org>
parents:
31
diff
changeset
|
95 to invoke 'gmake' instead of 'make'. |
| 7 | 96 |
| 97 # make install | |
| 1 | 98 |
|
34
0e1189b94a7f
Updated installation instructions
Matti Hamalainen <ccr@tnsp.org>
parents:
31
diff
changeset
|
99 If everything went as supposed, you may now try (re)starting XMMS |
|
0e1189b94a7f
Updated installation instructions
Matti Hamalainen <ccr@tnsp.org>
parents:
31
diff
changeset
|
100 and go play with your shiny new XMMS-SID-plugin! :-) |
| 1 | 101 |