1 ==============================================================================

     2 Using the Simple DirectMedia Layer with Mac OS X

     3 ==============================================================================

     4 

     5 These instructions are for people using Apple's Mac OS X (pronounced

     6 "ten").

     7 

     8 From the developer's point of view, OS X is a sort of hybrid Mac and

     9 Unix system, and you have the option of using either traditional

    10 command line tools or Apple's IDE ProjectBuilder (PB).

    11 

    12 To build using the command line, use the standard configure and make

    13 process:

    14 

    15 	./configure

    16 	make

    17 	make install

    18 

    19 (You may need to create the subdirs of /usr/local manually.)

    20 

    21 For some reason, libtool doesn't run ranlib properly, so do this

    22 manually:

    23 

    24 	ranlib /usr/local/lib/libSDL.a

    25 

    26 To use the library once it's built, you need to use the "Carbon

    27 framework", which is the port of the old Mac Toolbox to OS X.

    28 To do this, use the -F and -framework arguments for compiling

    29 and linking, respectively:

    30 

    31 	cc -c myprog.c -I/usr/local/include/SDL -F/System/Library/Frameworks/Carbon.framework

    32 	cc myprog.o -L/usr/local/lib -lSDL -framework Carbon

    33 

    34 sdl-config knows about the linking path and -framework, so it's

    35 recommended to use it to fill in your Makefile variables.

    36 

    37 [Add instructions for how to build using PB]

    38 

    39 As of this writing (Sep 2000), OS X is in public beta.  This means

    40 that while most of the APIs are frozen, things are still subject to

    41 change, and many of the known problems will be resolved before the

    42 final release comes out.

    43 

    44 Known bugs are listed in the file "BUGS"