diff options
author | Jacques Beuarain <jacques.beaurain@gmail.com> | 2006-12-06 11:52:43 +0300 |
---|---|---|
committer | Jacques Beuarain <jacques.beaurain@gmail.com> | 2006-12-06 11:52:43 +0300 |
commit | cad803951a7f4e8e7c7c84c29dcc5f9d2368cdc8 (patch) | |
tree | fa698fc6d83d73a5be32ebec86a0d76e764b0fe3 /doc | |
parent | cf1cbbd97936ace35840af18b0f22e3d20caabb3 (diff) |
CMake: Provide better control over Python versions and library locations for both Mac and Unix and add to documentation
Diffstat (limited to 'doc')
-rw-r--r-- | doc/blender-cmake.txt | 52 |
1 files changed, 39 insertions, 13 deletions
diff --git a/doc/blender-cmake.txt b/doc/blender-cmake.txt index 084b712cb8c..05037a3ab2a 100644 --- a/doc/blender-cmake.txt +++ b/doc/blender-cmake.txt @@ -3,22 +3,34 @@ $Id$ Blender CMake build system ============================ - Introduction - ------------ + Contents + --------------- + + 1. Introduction + 2. Obtaining CMake + 3. Obtaining Dependencies + 4. Deciding on a Build Environment + 5. Configuring the build for the first time + 6. Configuring the build after CVS updates + 7. Specify alternate Python library versions and locations - This document describes general usage of the new CMake scripts. The - inner workings are described in blender-cmake-dev.txt. - Obtaining CMake + 1. Introduction --------------- + This document describes general usage of the new CMake scripts. The + inner workings will be described in blender-cmake-dev.txt (TODO). + + 2. Obtaining CMake + ------------------ + CMake for can either be downloaded using your favorite package manager or is also available from the CMake website at http://www.cmake.org The website also contains some documentation on CMake usage but I found the man page alone pretty helpful. - Obtaining Dependencies - ---------------------- + 3. Obtaining Dependencies + ------------------------- Check from the page http://www.blender.org/cms/Getting_Dependencies.135.0.html that you @@ -26,8 +38,8 @@ $Id$ windows many of these dependencies already come in the lib/windows module from CVS. - Deciding on a Build Environment - ------------------------------- + 4. Deciding on a Build Environment + ---------------------------------- To build Blender with the CMake scripts you first need to decide which build environment you feel comfortable with. This decision will also be @@ -45,8 +57,8 @@ $Id$ progress indicator. - Configuring the build for the first time - ---------------------------------------- + 5. Configuring the build for the first time + ------------------------------------------- CMake allows one to generate the build project files and binary objects outside the source tree which can be pretty handy in working and experimenting @@ -102,8 +114,8 @@ $Id$ It is also possible to use the commandline of 'cmake' to override certain of these settings. - Configuring the build after CVS updates - --------------------------------------- + 6. Configuring the build after CVS updates + ------------------------------------------ The $BLENDERBUILD directory maintains a file called CMakeCache.txt which remembers the initial run's settings for subsequent generation runs. After @@ -114,6 +126,20 @@ $Id$ % cmake -G Xcode $BLENDERSOURCE + 7. Specify alternate Python library versions and locations + ---------------------------------------------------------- + + The commandline can be used to override detected/default settings, e.g: + + On Unix: + cmake -D PYTHON_LIB=/usr/local/lib/python2.3/config/libpython2.3.so -D PYTHON_INC=/usr/local/include/python2.3 -D PYTHON_BINARY=/usr/local/bin/python2.3 -G "Unix Makefiles" ../blender + On Macs: + cmake -D PYTHON_INC=/System/Library/Frameworks/Python.framework/Versions/2.5/include/python2.5 -D PYTHON_LIBPATH=/System/Library/Frameworks/Python.framework/Versions/2.5/lib/python2.5/config -D PYTHON_BINARY=/System/Library/Frameworks/Python.framework/Versions/2.5/bin/python2.5 -G Xcode ../blender + + Mote that this should only be needed once per build directory generation because it will keep the overrides in CMakeCache.txt for subsequent runs. + + + To be continued... TODO's |