README.MacOSX
changeset 0 74212992fb08
child 47 45b1c4303f87
equal deleted inserted replaced
-1:000000000000 0:74212992fb08
       
     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"