d/control: Recommend gdb
[gammaray-debian.git] / Install.txt
blob8c039fc32c156b545dee1be877b76884801fa788
1 GammaRay uses the CMake buildsystem.
2 You must have CMake version 2.8 or higher.
4 Please see the comments at the top of CMakeLists.txt for
5 the available configuration options you can pass to cmake.
7 The installation directory defaults to /usr/local on UNIX
8 c:/Program Files on Windows and /Applications on MacOS.
9 You can change this location by passing the option
10 -DCMAKE_INSTALL_PREFIX=/install/path to cmake.
12 To build a debug version pass -DCMAKE_BUILD_TYPE=Debug to cmake.
14 To build GammaRay you will need:
15  - CMake 2.8
16  - Qt 4.7 or higher
18 Building on Unix with gcc or clang:
19 % mkdir build
20 % cd build
21 % cmake ..
22 % make
23 % make install
25 Building on Windows with Microsoft Visual Studio:
26 % mkdir build
27 % cd build
28 % cmake -G "NMake Makefiles" ..
29 % nmake
30 % nmake install
33 Building on Windows with mingw:
34 % mkdir build
35 % cd build
36 % cmake -G "MinGW Makefiles" ..
37 % mingw32-make
38 % mingw32-make install
40 == Warning! ==
41 If your Qt is linked with the "-Bsymbolic-function" option preloading will be
42 broken.  When this is enabled, references to global functions will be bound to
43 the shared object internally; therefore, the definition of the function will be
44 fixed and cannot be overwritten by preloading.
46 So, be sure that your distro-provided packages or your self-compiled packages
47 are not linked with this flag (check with `echo $LDFLAGS` before compiling).
48 For more info see: "man ld; search for "-Bsymbolic-function".
50 Known affected distros:
52     Ubuntu 10.10, 11.04
54 If you are affected by this, try the gdb injector instead by using the "-i gdb"
55 command line argument.