development/cmake/README.cmake

   1 Building LyX with CMake
   2
   3 For all builds:
   4 - CMake 2.4 or CVS version from www.cmake.org
   5 - install Qt 4 and make sure qmake 4 is found
   6   (add the folder with qmake to the environment variable PATH)
   7 - by default it builds the Qt4 frontend
   8 - with GNUWIN32_DIR you could point to your gnuwin32 packages
   9   (eg. -DGNUWIN32_DIR=c:\gnuwin32) by default it searches in your
  10   program  folder
  11
  12 Building Visual C++ 2005 project files:
  13 - install Visual C++ 2005
  14 - install Platform SDK 2005, "Core" and "Web Workshop"
  15 - add include and library paths of the SDK to the IDE search paths,
  16   menu: Tools->Options->VC++ directories->Library files + Include files
  17 - install zlib (www.zlib.net) into %ProgramFiles%/GnuWin32/include+lib
  18   or %ProgramFiles%/zlib/include+lib
  19 - create a build directory, e.g. .../trunk/../build
  20 - call in the build directory 'cmake ..\trunk\development\cmake'
  21 - start lyx.sln
  22 - Warnings:
  23         The default warning level of the msvc cmake builds is now /W4.
  24         The cmake option
  25                 -DDISABLEWALL=1
  26         switches to /W3,
  27                 -DWALL=1
  28         re enables /W4.
  29         To disable a specific warning add it to MSVC_W_DISABLE of
  30         cmake/CMakeLists.txt. To make the warning an error add it
  31         to MSVC_W_ERROR of the same file.
  32
  33 TIPS: - rename Microsoft Visual Studio 8\VC\vcpackages\feacp.dll
  34         to disable Intellisense
  35       - the Release build links much faster
  36       - for the 'Debug' and 'Release' build all precompiled headers are enabled
  37         to compile without pch (to check if all necessary headers are included)
  38           * use 'MinSizeRel' which only precompiles the STL and Boost headers
  39           * use 'RelWithDebInfo' which does not use any precompiled headers
  40
  41
  42 Building with GCC/Linux:
  43 - create a build directory, e.g. .../trunk/../build
  44 - call in the build directory 'cmake ..\trunk\development\cmake'
  45
  46 Building with GCC/Windows (Win2k only works with MSYS, XP?):
  47 - install zlib (www.zlib.net) into %ProgramFiles%/GnuWin32/include+lib
  48 - create a build directory, e.g. .../trunk/../build
  49 - call: export QMAKESPEC=win32-g++ (MSYS) or set QMAKESPEC=win32-g++ (CMD)
  50 - call in the build directory 'cmake ..\trunk\development\cmake'
  51
  52
  53 To generate other build files call 'cmake'
  54 which shows a list of possibilities.
  55
  56
  57 The build process tries to find aspell on Windows
  58 in %ProgramFiles%/GnuWin32/ and in /usr/ or in /usr/local
  59 under Linux. If it is not found the support is disabled.