README.MacOSX
author Sam Lantinga <slouken@lokigames.com>
Thu, 26 Apr 2001 16:45:43 +0000
changeset 0 74212992fb08
child 47 45b1c4303f87
permissions -rw-r--r--
Initial revision
     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"