From e76008f8ceb417269fa1c93dce4a61ffac80ecd7 Mon Sep 17 00:00:00 2001 From: pouillot Date: Thu, 27 Oct 2011 09:36:18 +0000 Subject: [PATCH] Improved INSTALL instructions about the CMake option OPTION_UNLOAD_SSGGRAPH (added refs to the relevant tickets) git-svn-id: https://svn.code.sf.net/p/speed-dreams/code/trunk@4005 30fe4595-0a0c-4342-8851-515496e4dcbd Former-commit-id: 30feb288779c29cdc84e0c66ac4ef9e2687e0dd6 Former-commit-id: 5394ca8924c4f6ed57dc1fbed1674effef543c52 --- INSTALL.txt | 49 +++++++++++++++++++++++++++++++------------------ 1 file changed, 31 insertions(+), 18 deletions(-) diff --git a/INSTALL.txt b/INSTALL.txt index 811e07bde..b4016267c 100644 --- a/INSTALL.txt +++ b/INSTALL.txt @@ -121,31 +121,44 @@ The Speed Dreams Team. Usefull CMake variables for Speed Dreams : - - OPTION_OFFICIAL_ONLY:BOOL : Build/install only official contents (def: OFF) - - OPTION_DEBUG:BOOL : Debug symbols even in Release builds if ON (def: ON) - - OPTION_TRACE:BOOL : Full run-time traces if ON (def: ON) - - OPTION_TRACE_LEVEL:STRING : Run-time traces level integer threshold, - only if OPTION_DEBUG (traces with higher level are - not logged ; 0=Fatal, 1=Error, 2=Warning, 3=Info, - 4=Trace, 5=Debug, ...) (def: 5) - - OPTION_UNLOAD_SSGGRAPH:BOOL : The 'ssggraph' graphics engine module will never be - unloaded if OFF (def: ON) - Usefull under some Linux configurations where this - unloading badly crashes XOrg, or simply makes SD crash - because PLib is shipped as a set of shared libraries. + - CMAKE_BUILD_TYPE:STRING : + Debug, Release, RelWithDebInfo, MinSizeRel (def: Release) + + - OPTION_OFFICIAL_ONLY:BOOL : + Build/install only official contents (def: OFF) + + - OPTION_TRACE:BOOL : + Full run-time traces if ON (def: ON) + - OPTION_TRACE_LEVEL:STRING : + Run-time traces level integer threshold, only if OPTION_DEBUG + (traces with higher level are not logged ; + 0=Fatal, 1=Error, 2=Warning, 3=Info, 4=Trace, 5=Debug, ...) (def: 5) + + - OPTION_UNLOAD_SSGGRAPH:BOOL : + The 'ssggraph' graphics engine module will never be unloaded if OFF (def: ON) + Usefull under some Linux configurations where this unloading badly crashes XOrg + (see http://sourceforge.net/apps/trac/speed-dreams/ticket/209), + or simply makes SD crash because PLib is shipped as a set of shared libraries + (see http://sourceforge.net/apps/trac/speed-dreams/ticket/459). - - SD_LOCALDIR:STRING : User settings dir for run-time (def: ~/.speed-dreams-2) - - CMAKE_PREFIX_PATH:STRING : Path prefixes for additional 3rdParty libraries (def:empty) - (use /usr/local if you compiled some 3rdParty libs yourself). - - CMAKE_INSTALL_PREFIX:PATH : Install path (def: /usr/local) - - CMAKE_BUILD_TYPE:STRING : Debug, Release, RelWithDebInfo, MinSizeRel (def: Release) + - OPTION_DEBUG:BOOL : + Debug symbols even in Release builds if ON (def: ON) + + - SD_LOCALDIR:STRING : + User settings dir for run-time (def: ~/.speed-dreams-2) + + - CMAKE_PREFIX_PATH:STRING : + Path prefixes for additional 3rdParty libraries (def:empty) + (use /usr/local if you compiled some 3rdParty libs yourself). + - CMAKE_INSTALL_PREFIX:PATH : + Install path (def: /usr/local) Tips reported about some issues : - sometimes, ENET_INCLUDE_DIR is not detected correctly, resulting in something like /usr/include/enet or so, and, consequently, in bad compilation errors because /usr/include/enet contains a special time.h header file that conflicts with the standard one in /usr/include. Removing the "enet" postfix from ENET_INCLUDE_DIR should fix this - (in cmake command line or interactively in ccmake). + (in cmake command line or interactively through ccmake). d - build: