installer updates

[lyx.git] / development / cmake / README.cmake

diff --git a/development/cmake/README.cmake b/development/cmake/README.cmake
index a6f7168052f71e33d20d920d7db1b727990dfeb5..284758b0be6b000f5acc44217e73b8876af07434 100644 (file)
--- a/development/cmake/README.cmake
+++ b/development/cmake/README.cmake
@@ -19,10 +19,24 @@ Building Visual C++ 2005 project files:
 - create a build directory, e.g. .../trunk/../build
 - call in the build directory 'cmake ..\trunk\development\cmake'
 - start lyx.sln
+- Warnings:
+       The default warning level of the msvc cmake builds is now /W4.
+       The cmake option 
+               -DDISABLEWALL=1 
+       switches to /W3, 
+               -DWALL=1 
+       re enables /W4.
+       To disable a specific warning add it to MSVC_W_DISABLE of
+       cmake/CMakeLists.txt. To make the warning an error add it
+       to MSVC_W_ERROR of the same file.
 
 TIPS: - rename Microsoft Visual Studio 8\VC\vcpackages\feacp.dll 
         to disable Intellisense
       - the Release build links much faster
+      - for the 'Debug' and 'Release' build all precompiled headers are enabled
+        to compile without pch (to check if all necessary headers are included)
+          * use 'MinSizeRel' which only precompiles the STL and Boost headers
+          * use 'RelWithDebInfo' which does not use any precompiled headers
 
 
 Building with GCC/Linux:
@@ -35,6 +49,29 @@ Building with GCC/Windows (Win2k only works with MSYS, XP?):
 - call: export QMAKESPEC=win32-g++ (MSYS) or set QMAKESPEC=win32-g++ (CMD)
 - call in the build directory 'cmake ..\trunk\development\cmake'
 
+Building with Xcode/Mac:
+- create a build directory, e.g. .../trunk/../build
+- call in the build directory 'cmake .../trunk/development/cmake -G Xcode'
+- open .../trunk/../build/lyx-qt4.xcodeproj
+
+TIPS: - Xcode prefers UTF8 when opening source files, though LyX usually uses
+        Latin1. To fix that select all source files in Xcode and click "Get Info"
+        in the context menu. Change the encoding to Latin1.
+      - You can run and debug LyX from Xcode. For LyX to find its resources, there
+        are two possibilities:
+       a) Put a resource directory, e.g. a link to the lib directory of the 
+          source tree, at .../trunk/../build/bin/Resources
+       b) Select the lyx-qt4 executable in Xcode, click on "Get Info" in the 
+          context menu and add "-sysdir a_valid_LyX_resource_directory" 
+          pointing e.g. to a valid Contents/Resources of a LyX.app directory.
+      - LyX on Mac doesn't look for fonts in the resource directory if the
+        executable is not in an .app bundle. Instead you have to create a
+        symbolic link to the fonts directory in the place where the executable
+        is: ln -s .../trunk/lib/fonts .../trunk/../build/bin/Debug/
+        If you don't do that math character will not show up correctly.
+      - CMake properly finds the Qt4 library bundles from Trolltech's binary
+        Qt4 package for Mac. So no need to compile Qt on your own.
+
 
 To generate other build files call 'cmake'
 which shows a list of possibilities.