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
slouken@0
     1
==============================================================================
slouken@0
     2
Using the Simple DirectMedia Layer with Mac OS X
slouken@0
     3
==============================================================================
slouken@0
     4
slouken@0
     5
These instructions are for people using Apple's Mac OS X (pronounced
slouken@0
     6
"ten").
slouken@0
     7
slouken@0
     8
From the developer's point of view, OS X is a sort of hybrid Mac and
slouken@0
     9
Unix system, and you have the option of using either traditional
slouken@0
    10
command line tools or Apple's IDE ProjectBuilder (PB).
slouken@0
    11
slouken@0
    12
To build using the command line, use the standard configure and make
slouken@0
    13
process:
slouken@0
    14
slouken@0
    15
	./configure
slouken@0
    16
	make
slouken@0
    17
	make install
slouken@0
    18
slouken@0
    19
(You may need to create the subdirs of /usr/local manually.)
slouken@0
    20
slouken@0
    21
For some reason, libtool doesn't run ranlib properly, so do this
slouken@0
    22
manually:
slouken@0
    23
slouken@0
    24
	ranlib /usr/local/lib/libSDL.a
slouken@0
    25
slouken@0
    26
To use the library once it's built, you need to use the "Carbon
slouken@0
    27
framework", which is the port of the old Mac Toolbox to OS X.
slouken@0
    28
To do this, use the -F and -framework arguments for compiling
slouken@0
    29
and linking, respectively:
slouken@0
    30
slouken@0
    31
	cc -c myprog.c -I/usr/local/include/SDL -F/System/Library/Frameworks/Carbon.framework
slouken@0
    32
	cc myprog.o -L/usr/local/lib -lSDL -framework Carbon
slouken@0
    33
slouken@0
    34
sdl-config knows about the linking path and -framework, so it's
slouken@0
    35
recommended to use it to fill in your Makefile variables.
slouken@0
    36
slouken@0
    37
[Add instructions for how to build using PB]
slouken@0
    38
slouken@0
    39
As of this writing (Sep 2000), OS X is in public beta.  This means
slouken@0
    40
that while most of the APIs are frozen, things are still subject to
slouken@0
    41
change, and many of the known problems will be resolved before the
slouken@0
    42
final release comes out.
slouken@0
    43
slouken@0
    44
Known bugs are listed in the file "BUGS"