annotate INSTALL @ 249:e122de403a2d

Patch to not puke on Timidity++-specific config file directives.
author Ryan C. Gordon <icculus@icculus.org>
date Thu, 07 Feb 2002 07:48:24 +0000
parents effbf695ba58
children 6e1ee1f5be1b
rev   line source
248
effbf695ba58 Updated.
Ryan C. Gordon <icculus@icculus.org>
parents: 243
diff changeset
1 Building is pretty easy. Please read README, too, as it duplicates and
effbf695ba58 Updated.
Ryan C. Gordon <icculus@icculus.org>
parents: 243
diff changeset
2 expands upon much of this information.
0
1078b3528e6f Initial revision
Ryan C. Gordon <icculus@icculus.org>
parents:
diff changeset
3
1078b3528e6f Initial revision
Ryan C. Gordon <icculus@icculus.org>
parents:
diff changeset
4
1078b3528e6f Initial revision
Ryan C. Gordon <icculus@icculus.org>
parents:
diff changeset
5 ALL PLATFORMS:
1078b3528e6f Initial revision
Ryan C. Gordon <icculus@icculus.org>
parents:
diff changeset
6
184
47cc2de2ae36 Changed reference to "LICENSE" file to "COPYING".
Ryan C. Gordon <icculus@icculus.org>
parents: 140
diff changeset
7 Please understand your rights and mine: read the text file COPYING in the root
0
1078b3528e6f Initial revision
Ryan C. Gordon <icculus@icculus.org>
parents:
diff changeset
8 of the source tree. If you can't abide by it, delete this source tree now.
1078b3528e6f Initial revision
Ryan C. Gordon <icculus@icculus.org>
parents:
diff changeset
9
1078b3528e6f Initial revision
Ryan C. Gordon <icculus@icculus.org>
parents:
diff changeset
10 The best documentation for the SDL_sound API is SDL_sound.h. It is VERY
1078b3528e6f Initial revision
Ryan C. Gordon <icculus@icculus.org>
parents:
diff changeset
11 heavily commented, and makes an excellent, in-depth reference to all the
1078b3528e6f Initial revision
Ryan C. Gordon <icculus@icculus.org>
parents:
diff changeset
12 functions.
1078b3528e6f Initial revision
Ryan C. Gordon <icculus@icculus.org>
parents:
diff changeset
13
1078b3528e6f Initial revision
Ryan C. Gordon <icculus@icculus.org>
parents:
diff changeset
14
1078b3528e6f Initial revision
Ryan C. Gordon <icculus@icculus.org>
parents:
diff changeset
15 UNIX:
1078b3528e6f Initial revision
Ryan C. Gordon <icculus@icculus.org>
parents:
diff changeset
16
140
c28566f219e2 Updated.
Ryan C. Gordon <icculus@icculus.org>
parents: 0
diff changeset
17 (If you pulled the source from CVS), run ./bootstrap
0
1078b3528e6f Initial revision
Ryan C. Gordon <icculus@icculus.org>
parents:
diff changeset
18
140
c28566f219e2 Updated.
Ryan C. Gordon <icculus@icculus.org>
parents: 0
diff changeset
19 run ./configure --help, and see if there's any options you need. Rerun
c28566f219e2 Updated.
Ryan C. Gordon <icculus@icculus.org>
parents: 0
diff changeset
20 configure with those options. If this is confusing to you, just run
c28566f219e2 Updated.
Ryan C. Gordon <icculus@icculus.org>
parents: 0
diff changeset
21 ./configure with no options: the defaults are generally decent, and
c28566f219e2 Updated.
Ryan C. Gordon <icculus@icculus.org>
parents: 0
diff changeset
22 configure is usually smart enough to figure out what's best..
c28566f219e2 Updated.
Ryan C. Gordon <icculus@icculus.org>
parents: 0
diff changeset
23
c28566f219e2 Updated.
Ryan C. Gordon <icculus@icculus.org>
parents: 0
diff changeset
24 If configuration succeeded, run "make".
0
1078b3528e6f Initial revision
Ryan C. Gordon <icculus@icculus.org>
parents:
diff changeset
25
140
c28566f219e2 Updated.
Ryan C. Gordon <icculus@icculus.org>
parents: 0
diff changeset
26 Run "make install" as root to install the library for use on your system.
c28566f219e2 Updated.
Ryan C. Gordon <icculus@icculus.org>
parents: 0
diff changeset
27
243
4a8d627a2326 Updated.
Ryan C. Gordon <icculus@icculus.org>
parents: 184
diff changeset
28 This should work for most Unix-style systems, including Linux, *BSD, BeOS, and
140
c28566f219e2 Updated.
Ryan C. Gordon <icculus@icculus.org>
parents: 0
diff changeset
29 MacOS X. Reports of success and failure are welcome.
c28566f219e2 Updated.
Ryan C. Gordon <icculus@icculus.org>
parents: 0
diff changeset
30
0
1078b3528e6f Initial revision
Ryan C. Gordon <icculus@icculus.org>
parents:
diff changeset
31
248
effbf695ba58 Updated.
Ryan C. Gordon <icculus@icculus.org>
parents: 243
diff changeset
32 MacOS 9:
effbf695ba58 Updated.
Ryan C. Gordon <icculus@icculus.org>
parents: 243
diff changeset
33 CWProject.sit contains project files for CodeWarrior 5.0 and above. Unpack
effbf695ba58 Updated.
Ryan C. Gordon <icculus@icculus.org>
parents: 243
diff changeset
34 this into the root of the SDL_sound folder.
effbf695ba58 Updated.
Ryan C. Gordon <icculus@icculus.org>
parents: 243
diff changeset
35
effbf695ba58 Updated.
Ryan C. Gordon <icculus@icculus.org>
parents: 243
diff changeset
36
effbf695ba58 Updated.
Ryan C. Gordon <icculus@icculus.org>
parents: 243
diff changeset
37 MacOS X command line tools:
effbf695ba58 Updated.
Ryan C. Gordon <icculus@icculus.org>
parents: 243
diff changeset
38 You can use the "UNIX" instructions above if you like the command line tools.
effbf695ba58 Updated.
Ryan C. Gordon <icculus@icculus.org>
parents: 243
diff changeset
39
effbf695ba58 Updated.
Ryan C. Gordon <icculus@icculus.org>
parents: 243
diff changeset
40
effbf695ba58 Updated.
Ryan C. Gordon <icculus@icculus.org>
parents: 243
diff changeset
41 MacOS X PowerBuilder:
effbf695ba58 Updated.
Ryan C. Gordon <icculus@icculus.org>
parents: 243
diff changeset
42 If you prefer to use PowerBuilder, download this file:
effbf695ba58 Updated.
Ryan C. Gordon <icculus@icculus.org>
parents: 243
diff changeset
43 http://icculus.org/SDL_sound/downloads/PBProjects.tar.gz
effbf695ba58 Updated.
Ryan C. Gordon <icculus@icculus.org>
parents: 243
diff changeset
44 ...and unpack it in the root of the SDL_sound folder. This archive contains
effbf695ba58 Updated.
Ryan C. Gordon <icculus@icculus.org>
parents: 243
diff changeset
45 several external libraries you would have to download/install manually if you
effbf695ba58 Updated.
Ryan C. Gordon <icculus@icculus.org>
parents: 243
diff changeset
46 used the command line tools (these libraries are for extra decoders, and are
effbf695ba58 Updated.
Ryan C. Gordon <icculus@icculus.org>
parents: 243
diff changeset
47 NOT required for SDL_sound to function...however, without them, the number of
effbf695ba58 Updated.
Ryan C. Gordon <icculus@icculus.org>
parents: 243
diff changeset
48 sound formats you can decode is reduced.)
effbf695ba58 Updated.
Ryan C. Gordon <icculus@icculus.org>
parents: 243
diff changeset
49
effbf695ba58 Updated.
Ryan C. Gordon <icculus@icculus.org>
parents: 243
diff changeset
50
140
c28566f219e2 Updated.
Ryan C. Gordon <icculus@icculus.org>
parents: 0
diff changeset
51 WIN32:
c28566f219e2 Updated.
Ryan C. Gordon <icculus@icculus.org>
parents: 0
diff changeset
52 Download http://icculus.org/SDL_sound/downloads/SDL_sound_win32.zip ...
c28566f219e2 Updated.
Ryan C. Gordon <icculus@icculus.org>
parents: 0
diff changeset
53 Unzip that file in the root of the source directory. That will give you
c28566f219e2 Updated.
Ryan C. Gordon <icculus@icculus.org>
parents: 0
diff changeset
54 some needed external libraries, and Visual C++ project files. Use the
c28566f219e2 Updated.
Ryan C. Gordon <icculus@icculus.org>
parents: 0
diff changeset
55 project files to compile.
0
1078b3528e6f Initial revision
Ryan C. Gordon <icculus@icculus.org>
parents:
diff changeset
56
1078b3528e6f Initial revision
Ryan C. Gordon <icculus@icculus.org>
parents:
diff changeset
57
1078b3528e6f Initial revision
Ryan C. Gordon <icculus@icculus.org>
parents:
diff changeset
58 OTHER PLATFORMS:
1078b3528e6f Initial revision
Ryan C. Gordon <icculus@icculus.org>
parents:
diff changeset
59
140
c28566f219e2 Updated.
Ryan C. Gordon <icculus@icculus.org>
parents: 0
diff changeset
60 Send me patches, and instructions, and I'll list them here. Consider
c28566f219e2 Updated.
Ryan C. Gordon <icculus@icculus.org>
parents: 0
diff changeset
61 joining the SDL_sound mailing list. Details are at:
c28566f219e2 Updated.
Ryan C. Gordon <icculus@icculus.org>
parents: 0
diff changeset
62 http://icculus.org/SDL_sound/
0
1078b3528e6f Initial revision
Ryan C. Gordon <icculus@icculus.org>
parents:
diff changeset
63
1078b3528e6f Initial revision
Ryan C. Gordon <icculus@icculus.org>
parents:
diff changeset
64 --ryan. (icculus@clutteredmind.org)
1078b3528e6f Initial revision
Ryan C. Gordon <icculus@icculus.org>
parents:
diff changeset
65
1078b3528e6f Initial revision
Ryan C. Gordon <icculus@icculus.org>
parents:
diff changeset
66