Mercurial > hg > xmms-sid
annotate INSTALL @ 198:c7b5120c53c8
Cleanup
| author | Matti Hamalainen <ccr@tnsp.org> |
|---|---|
| date | Wed, 18 Aug 2004 09:01:05 +0000 |
| parents | be1cf864f28e |
| children | 6117c326cc3e |
| rev | line source |
|---|---|
|
123
9ab0c2fff794
Updated installation instructions
Matti Hamalainen <ccr@tnsp.org>
parents:
80
diff
changeset
|
1 This document describes overall requirements and procedure |
|
9ab0c2fff794
Updated installation instructions
Matti Hamalainen <ccr@tnsp.org>
parents:
80
diff
changeset
|
2 for installation of XMMS-SID package, please read it carefully! |
| 171 | 3 For more tips, please also read README and FAQ. |
|
123
9ab0c2fff794
Updated installation instructions
Matti Hamalainen <ccr@tnsp.org>
parents:
80
diff
changeset
|
4 |
| 1 | 5 Requirements |
| 6 ============ | |
| 7 - XMMS version 1.2.0 or later (http://www.xmms.org/) | |
| 7 | 8 |
| 145 | 9 - Gtk+ and Glib 1.2.5 or later (http://www.gtk.org/) |
| 7 | 10 |
| 171 | 11 - C and C++-compiler. Preferably GCC along with rest of the |
| 12 GNU toolchain. I have no idea whether this compiles with | |
| 13 any other compiler ... sorry. | |
|
123
9ab0c2fff794
Updated installation instructions
Matti Hamalainen <ccr@tnsp.org>
parents:
80
diff
changeset
|
14 |
|
9ab0c2fff794
Updated installation instructions
Matti Hamalainen <ccr@tnsp.org>
parents:
80
diff
changeset
|
15 - You need AT LEAST one emulation library: |
| 7 | 16 |
|
123
9ab0c2fff794
Updated installation instructions
Matti Hamalainen <ccr@tnsp.org>
parents:
80
diff
changeset
|
17 * libSIDPlay1 |
|
9ab0c2fff794
Updated installation instructions
Matti Hamalainen <ccr@tnsp.org>
parents:
80
diff
changeset
|
18 * libSIDPlay2 |
|
9ab0c2fff794
Updated installation instructions
Matti Hamalainen <ccr@tnsp.org>
parents:
80
diff
changeset
|
19 * NanoSID |
| 7 | 20 |
| 171 | 21 Only one is required, but all are supported. You may also need |
| 22 some supplementary libraries, that are required by the emulator | |
| 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 | |
| 1 | 29 |
| 30 | |
| 31 Where to get XMMS? | |
| 32 ================== | |
|
123
9ab0c2fff794
Updated installation instructions
Matti Hamalainen <ccr@tnsp.org>
parents:
80
diff
changeset
|
33 Latest version of XMMS should be available from: |
| 1 | 34 |
|
123
9ab0c2fff794
Updated installation instructions
Matti Hamalainen <ccr@tnsp.org>
parents:
80
diff
changeset
|
35 http://www.xmms.org/ |
| 1 | 36 |
| 171 | 37 Please refer to XMMS documentation for information on its usage |
| 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. | |
| 1 | 41 |
| 42 | |
|
123
9ab0c2fff794
Updated installation instructions
Matti Hamalainen <ccr@tnsp.org>
parents:
80
diff
changeset
|
43 Where to get libSIDPlay1? |
|
9ab0c2fff794
Updated installation instructions
Matti Hamalainen <ccr@tnsp.org>
parents:
80
diff
changeset
|
44 ========================= |
|
9ab0c2fff794
Updated installation instructions
Matti Hamalainen <ccr@tnsp.org>
parents:
80
diff
changeset
|
45 libSIDPlay1 is available at SIDPlay's homepage: |
| 1 | 46 |
| 145 | 47 http://www.geocities.com/SiliconValley/Lakes/5147/sidplay/linux.html |
| 1 | 48 |
|
123
9ab0c2fff794
Updated installation instructions
Matti Hamalainen <ccr@tnsp.org>
parents:
80
diff
changeset
|
49 You only need libsidplay, the sidplay-base is not necessary |
|
9ab0c2fff794
Updated installation instructions
Matti Hamalainen <ccr@tnsp.org>
parents:
80
diff
changeset
|
50 if you are sure that you don't need the commandline player. |
| 1 | 51 |
| 23 | 52 |
|
123
9ab0c2fff794
Updated installation instructions
Matti Hamalainen <ccr@tnsp.org>
parents:
80
diff
changeset
|
53 Where to get libSIDPlay2? |
|
9ab0c2fff794
Updated installation instructions
Matti Hamalainen <ccr@tnsp.org>
parents:
80
diff
changeset
|
54 ========================= |
|
9ab0c2fff794
Updated installation instructions
Matti Hamalainen <ccr@tnsp.org>
parents:
80
diff
changeset
|
55 libSIDPlay2 is available at SourceForge: |
| 7 | 56 |
|
123
9ab0c2fff794
Updated installation instructions
Matti Hamalainen <ccr@tnsp.org>
parents:
80
diff
changeset
|
57 http://sidplay2.sourceforge.net/ |
|
9ab0c2fff794
Updated installation instructions
Matti Hamalainen <ccr@tnsp.org>
parents:
80
diff
changeset
|
58 |
| 171 | 59 You need the "sidplay-libs-2.1.0" package! Earlier versions WILL NOT |
| 60 WORK! Later versions MAY work, but I can't really guarantee that. | |
| 7 | 61 |
|
80
7047a6390b08
Updated and improved documentation
Matti Hamalainen <ccr@tnsp.org>
parents:
41
diff
changeset
|
62 |
|
123
9ab0c2fff794
Updated installation instructions
Matti Hamalainen <ccr@tnsp.org>
parents:
80
diff
changeset
|
63 Where to get NanoSID? |
|
9ab0c2fff794
Updated installation instructions
Matti Hamalainen <ccr@tnsp.org>
parents:
80
diff
changeset
|
64 ===================== |
|
9ab0c2fff794
Updated installation instructions
Matti Hamalainen <ccr@tnsp.org>
parents:
80
diff
changeset
|
65 libNanoSID is available from LolOLOlo's pages: |
|
80
7047a6390b08
Updated and improved documentation
Matti Hamalainen <ccr@tnsp.org>
parents:
41
diff
changeset
|
66 |
|
123
9ab0c2fff794
Updated installation instructions
Matti Hamalainen <ccr@tnsp.org>
parents:
80
diff
changeset
|
67 http://www.sid6581.org/NanoSID/ |
|
9ab0c2fff794
Updated installation instructions
Matti Hamalainen <ccr@tnsp.org>
parents:
80
diff
changeset
|
68 |
|
9ab0c2fff794
Updated installation instructions
Matti Hamalainen <ccr@tnsp.org>
parents:
80
diff
changeset
|
69 The configure looks the "libNanoSID.a" and "libNanoSID.h" |
|
9ab0c2fff794
Updated installation instructions
Matti Hamalainen <ccr@tnsp.org>
parents:
80
diff
changeset
|
70 from the standard locations, but you can also specify them |
|
9ab0c2fff794
Updated installation instructions
Matti Hamalainen <ccr@tnsp.org>
parents:
80
diff
changeset
|
71 yourself if you don't wish to "install" them. |
| 1 | 72 |
| 73 | |
| 36 | 74 Building a CVS-version |
| 75 ====================== | |
| 76 To build a CVS-version of XMMS-SID, you need to have latest | |
| 41 | 77 (STABLE) versions of following tools installed, including: |
|
34
0e1189b94a7f
Updated installation instructions
Matti Hamalainen <ccr@tnsp.org>
parents:
31
diff
changeset
|
78 |
| 171 | 79 - GNU autoconf 2.56 or newer |
| 80 - GNU automake 1.7 (older and newer versions MAY be incompatible!) | |
| 81 - GNU libtool 1.5 or newer | |
| 41 | 82 - 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
|
83 |
|
0e1189b94a7f
Updated installation instructions
Matti Hamalainen <ccr@tnsp.org>
parents:
31
diff
changeset
|
84 If you have all required tools installed, just run the |
| 171 | 85 "bootstrap.sh"-script which generates all necessary build-files. |
| 86 After successfull bootstrapping, you should be able to install | |
| 87 the package normally, following steps described in next chapter. | |
|
34
0e1189b94a7f
Updated installation instructions
Matti Hamalainen <ccr@tnsp.org>
parents:
31
diff
changeset
|
88 |
|
0e1189b94a7f
Updated installation instructions
Matti Hamalainen <ccr@tnsp.org>
parents:
31
diff
changeset
|
89 |
| 7 | 90 Installing XMMS-SID |
| 1 | 91 =================== |
| 171 | 92 When you have the requirements installed and working succesfully, |
| 93 you may try compiling and installation of XMMS-SID. | |
| 7 | 94 |
| 171 | 95 Invoke configure script (use parameter --help for help) |
| 7 | 96 |
| 97 $ ./configure | |
| 1 | 98 |
|
34
0e1189b94a7f
Updated installation instructions
Matti Hamalainen <ccr@tnsp.org>
parents:
31
diff
changeset
|
99 The configure-script will print out lots of information and in |
|
0e1189b94a7f
Updated installation instructions
Matti Hamalainen <ccr@tnsp.org>
parents:
31
diff
changeset
|
100 the end it tells you some of the selected build options. |
|
0e1189b94a7f
Updated installation instructions
Matti Hamalainen <ccr@tnsp.org>
parents:
31
diff
changeset
|
101 |
|
0e1189b94a7f
Updated installation instructions
Matti Hamalainen <ccr@tnsp.org>
parents:
31
diff
changeset
|
102 If configure passed without errors, try compilation. (Depending |
|
0e1189b94a7f
Updated installation instructions
Matti Hamalainen <ccr@tnsp.org>
parents:
31
diff
changeset
|
103 on your system, you may need to invoke 'gmake' instead of 'make'.) |
| 1 | 104 |
| 7 | 105 $ make |
| 106 | |
| 198 | 107 If that went OK too, then you may try installation. Again, you |
| 108 may need to invoke 'gmake' instead of 'make'. Install globally | |
| 109 to whole system (as root): | |
| 7 | 110 |
| 111 # make install | |
| 1 | 112 |
| 198 | 113 or install for current user only: |
|
181
be1cf864f28e
Added install-user and uninstall-user targets which install to current
Matti Hamalainen <ccr@tnsp.org>
parents:
171
diff
changeset
|
114 |
|
be1cf864f28e
Added install-user and uninstall-user targets which install to current
Matti Hamalainen <ccr@tnsp.org>
parents:
171
diff
changeset
|
115 $ make install-user |
|
be1cf864f28e
Added install-user and uninstall-user targets which install to current
Matti Hamalainen <ccr@tnsp.org>
parents:
171
diff
changeset
|
116 |
|
be1cf864f28e
Added install-user and uninstall-user targets which install to current
Matti Hamalainen <ccr@tnsp.org>
parents:
171
diff
changeset
|
117 If everything went as supposed, try restarting XMMS and go play |
| 159 | 118 with your shiny new XMMS-SID-plugin! :-) |