docs/README-cmake.md
author Sam Lantinga <slouken@libsdl.org>
Tue, 29 Jul 2014 08:04:15 -0700
changeset 9025 d09d4b578e77
parent 9023 doc/README-cmake.md@276802355854
child 9066 c2af3ff967cc
permissions -rw-r--r--
Moved documentation to docs, recreated a simple README.txt, fixed build
gabomdq@9023
     1
CMake
gabomdq@9023
     2
================================================================================
gabomdq@9023
     3
(www.cmake.org)
gabomdq@9023
     4
gabomdq@9023
     5
SDL's build system was traditionally based on autotools. Over time, this
gabomdq@9023
     6
approach has suffered from several issues across the different supported 
gabomdq@9023
     7
platforms.
gabomdq@9023
     8
To solve these problems, a new build system based on CMake is under development.
gabomdq@9023
     9
It works in parallel to the legacy system, so users can experiment with it
gabomdq@9023
    10
without complication.
gabomdq@9023
    11
While still experimental, the build system should be usable on the following
gabomdq@9023
    12
platforms:
gabomdq@9023
    13
    
gabomdq@9023
    14
    * FreeBSD
gabomdq@9023
    15
    * Linux
gabomdq@9023
    16
    * VS.NET 2010
gabomdq@9023
    17
    * MinGW and Msys
gabomdq@9023
    18
    * OS X with support for XCode
gabomdq@9023
    19
    
gabomdq@9023
    20
================================================================================
gabomdq@9023
    21
Usage
gabomdq@9023
    22
================================================================================
gabomdq@9023
    23
gabomdq@9023
    24
Assuming the source for SDL is located at ~/sdl
gabomdq@9023
    25
gabomdq@9023
    26
cd ~
gabomdq@9023
    27
mkdir build
gabomdq@9023
    28
cd build
gabomdq@9023
    29
cmake ../sdl
gabomdq@9023
    30
gabomdq@9023
    31
This will build the static and dynamic versions of SDL in the ~/build directory.