README.MacOSX
changeset 0 74212992fb08
child 47 45b1c4303f87
     1.1 --- /dev/null	Thu Jan 01 00:00:00 1970 +0000
     1.2 +++ b/README.MacOSX	Thu Apr 26 16:45:43 2001 +0000
     1.3 @@ -0,0 +1,44 @@
     1.4 +==============================================================================
     1.5 +Using the Simple DirectMedia Layer with Mac OS X
     1.6 +==============================================================================
     1.7 +
     1.8 +These instructions are for people using Apple's Mac OS X (pronounced
     1.9 +"ten").
    1.10 +
    1.11 +From the developer's point of view, OS X is a sort of hybrid Mac and
    1.12 +Unix system, and you have the option of using either traditional
    1.13 +command line tools or Apple's IDE ProjectBuilder (PB).
    1.14 +
    1.15 +To build using the command line, use the standard configure and make
    1.16 +process:
    1.17 +
    1.18 +	./configure
    1.19 +	make
    1.20 +	make install
    1.21 +
    1.22 +(You may need to create the subdirs of /usr/local manually.)
    1.23 +
    1.24 +For some reason, libtool doesn't run ranlib properly, so do this
    1.25 +manually:
    1.26 +
    1.27 +	ranlib /usr/local/lib/libSDL.a
    1.28 +
    1.29 +To use the library once it's built, you need to use the "Carbon
    1.30 +framework", which is the port of the old Mac Toolbox to OS X.
    1.31 +To do this, use the -F and -framework arguments for compiling
    1.32 +and linking, respectively:
    1.33 +
    1.34 +	cc -c myprog.c -I/usr/local/include/SDL -F/System/Library/Frameworks/Carbon.framework
    1.35 +	cc myprog.o -L/usr/local/lib -lSDL -framework Carbon
    1.36 +
    1.37 +sdl-config knows about the linking path and -framework, so it's
    1.38 +recommended to use it to fill in your Makefile variables.
    1.39 +
    1.40 +[Add instructions for how to build using PB]
    1.41 +
    1.42 +As of this writing (Sep 2000), OS X is in public beta.  This means
    1.43 +that while most of the APIs are frozen, things are still subject to
    1.44 +change, and many of the known problems will be resolved before the
    1.45 +final release comes out.
    1.46 +
    1.47 +Known bugs are listed in the file "BUGS"