speed-dreams/speed-dreams-code
6
0
Fork 1
Code Issues 8 Pull requests 1 Projects Releases Packages Wiki Activity Actions 2

Improved INSTALL instructions about the CMake option OPTION_UNLOAD_SSGGRAPH (added refs to the relevant tickets)

Browse source 
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
This commit is contained in:
pouillot 2011-10-27 09:36:18 +00:00
parent dde238b44a
commit e76008f8ce
1 changed files with 31 additions and 18 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

49
INSTALL.txt
View file

@ -121,31 +121,44 @@ The Speed Dreams Team.
Usefull CMake variables for Speed Dreams : Usefull CMake variables for Speed Dreams :
- OPTION_OFFICIAL_ONLY:BOOL : Build/install only official contents (def: OFF) - CMAKE_BUILD_TYPE:STRING :
- OPTION_DEBUG:BOOL : Debug symbols even in Release builds if ON (def: ON) Debug, Release, RelWithDebInfo, MinSizeRel (def: Release)
- OPTION_TRACE:BOOL : Full run-time traces if ON (def: ON)
- OPTION_TRACE_LEVEL:STRING : Run-time traces level integer threshold, - OPTION_OFFICIAL_ONLY:BOOL :
only if OPTION_DEBUG (traces with higher level are Build/install only official contents (def: OFF)
not logged ; 0=Fatal, 1=Error, 2=Warning, 3=Info,
4=Trace, 5=Debug, ...) (def: 5) - OPTION_TRACE:BOOL :
- OPTION_UNLOAD_SSGGRAPH:BOOL : The 'ssggraph' graphics engine module will never be Full run-time traces if ON (def: ON)
unloaded if OFF (def: ON) - OPTION_TRACE_LEVEL:STRING :
Usefull under some Linux configurations where this Run-time traces level integer threshold, only if OPTION_DEBUG
unloading badly crashes XOrg, or simply makes SD crash (traces with higher level are not logged ;
because PLib is shipped as a set of shared libraries. 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) - OPTION_DEBUG:BOOL :
- CMAKE_PREFIX_PATH:STRING : Path prefixes for additional 3rdParty libraries (def:empty) Debug symbols even in Release builds if ON (def: ON)
(use /usr/local if you compiled some 3rdParty libs yourself).
- CMAKE_INSTALL_PREFIX:PATH : Install path (def: /usr/local) - SD_LOCALDIR:STRING :
- CMAKE_BUILD_TYPE:STRING : Debug, Release, RelWithDebInfo, MinSizeRel (def: Release) 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 : Tips reported about some issues :
- sometimes, ENET_INCLUDE_DIR is not detected correctly, resulting in something like - 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 or so, and, consequently, in bad compilation errors because
/usr/include/enet contains a special time.h header file that conflicts with the standard /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 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: d - build: