cli: use $LIB to handle multilib automagically on glibc

[apitrace] / INSTALL.markdown

diff --git a/INSTALL.markdown b/INSTALL.markdown
index e310df1bf05cd29a20a9cb84f2ef15f878268e53..5a74557d07c7f8de91ecdfec3ae684ac8112a8e2 100644 (file)
--- a/INSTALL.markdown
+++ b/INSTALL.markdown
@@ -35,13 +35,22 @@ tracing.
 Linux / Mac OS X
 ----------------
 
 Linux / Mac OS X
 ----------------
 

+Additional optional dependencies for Linux:
+
+* libprocps (procps development libraries)
+
+* libdwarf
+

 Build as:
 
 Build as:
 

-    cmake -H. -Bbuild
+    cmake -H. -Bbuild -DCMAKE_BUILD_TYPE=RelWithDebInfo

     make -C build
 
     make -C build
 

-You can also build the 32bit GL wrapper on 64bit distro with a multilib gcc by
-doing:
+Other possible values for `CMAKE_BUILD_TYPE` `Debug`, `Release`,
+`RelWithDebInfo`, and `MinSizeRel`.
+
+You can also build the 32-bits GL wrapper on a 64-bits distribution, provided
+you have a multilib gcc and 32-bits X11 libraries, by doing:

 
     cmake \
         -DCMAKE_C_FLAGS=-m32 \
 
     cmake \
         -DCMAKE_C_FLAGS=-m32 \


@@ -52,6 +61,10 @@ doing:
         -H. -Bbuild32
     make -C build32 glxtrace
 
         -H. -Bbuild32
     make -C build32 glxtrace
 

+The `/usr/lib32` refers to the path where the 32-bits shared objects are may
+differ depending on the actual Linux distribution.
+
+

 Android
 -------
 
 Android
 -------
 


@@ -65,6 +78,19 @@ Build as:
     cmake -DCMAKE_TOOLCHAIN_FILE=cmake/toolchain/android.toolchain.cmake -DANDROID_API_LEVEL=9 -H. -Bbuild
     make -C build
 
     cmake -DCMAKE_TOOLCHAIN_FILE=cmake/toolchain/android.toolchain.cmake -DANDROID_API_LEVEL=9 -H. -Bbuild
     make -C build
 

+You can also choose a particular ABI by passing `ANDROID_ABI` variable to
+cmake, e.g., `-DANDROID_ABI=x86`.
+
+FirefoxOS
+---------
+
+Put Apitrace source tree into `B2GROOT/external/apitrace/` and the `Android.mk`
+file (`B2GROOT/external/apitrace/Android.mk`) will do the needful to compile
+and install apitrace appropriately into the system image as part of FirefoxOS
+build process. It expects a linaro-type of Android NDK to be present in
+`../../prebuilt/ndk/android-ndk-r7` (ie `B2GROOT/prebuilt/ndk/android-ndk-r7`).
+
+

 Windows
 -------
 
 Windows
 -------
 


@@ -98,6 +124,10 @@ It will try to detect most required/optional dependencies automatically.  When
 not found automatically, you can manually specify the location of the
 dependencies from the CMake GUI.
 
 not found automatically, you can manually specify the location of the
 dependencies from the CMake GUI.
 

+Qt on Windows doesn't ship with 64-bit binaries, you may want to add
+`-DENABLE_GUI=FALSE` to the above cmake command line for Windows 64-bits
+builds.
+

 After you've successfully configured, you can start the build by opening the
 generated `build\apitrace.sln` solution file, or invoking CMake as:
 
 After you've successfully configured, you can start the build by opening the
 generated `build\apitrace.sln` solution file, or invoking CMake as: