X-Git-Url: https://git.lyx.org/gitweb/?a=blobdiff_plain;f=INSTALL.cmake;h=980eb8556ac3c7222d4e02e77a89f0773439dbff;hb=c7bdd2908856cdbb4ff89ac0d573391c980d8bb2;hp=d6e2acfdb9810386cb3a9bd2a040646bd18febb7;hpb=73070977da0e28aa1b9be71d00628a5d8926d124;p=lyx.git diff --git a/INSTALL.cmake b/INSTALL.cmake index d6e2acfdb9..980eb8556a 100644 --- a/INSTALL.cmake +++ b/INSTALL.cmake @@ -16,13 +16,25 @@ Building LyX with CMake Linux/Unix: export PATH=/bin:$PATH Windows : set PATH=\bin;%PATH% - + When you wanna run LyX without installing from a out-of-source + build directory you have to set the environment variable LYX_DIR_21x + and it must point to the lib dir in the source tree. + Linux/Unix: export LYX_DIR_21x=/lib + Windows : set LYX_DIR_21x=\lib + Windows specific On Windows install the supplementary modules: * Visual Studio 2008: ftp://ftp.lyx.org/pub/lyx/contrib/lyx-windows-deps-msvc2008.zip - * Visual Studio 2010: ftp://ftp.devel.lyx.org/pub/contrib/windows/bin/ - + * Visual Studio 2010: ftp://ftp.devel.lyx.org/pub/contrib/windows/bin + or use the option LYX_DEPENDENCIES_DOWNLOAD, then you have to add + these paths to your PATH variable: + \msvc2010-deps\deps20\bin + \msvc2010-deps\deps20\python + \msvc2010-deps\deps20\imagemagick + \msvc2010-deps\deps20\ghostscript + \msvc2010-deps\deps20\gettext-tools + If cmake couldn't find these modules set GNUWIN32_DIR, eg. -DGNUWIN32_DIR=c:\gnuwin32. By default cmake searches in your program folder. Or use the cmake GUI to set the GNUWIN32_DIR path. @@ -62,6 +74,10 @@ Building out-of-source select this folder when using CMake's GUI, cmake-gui, or go into this folder when you call cmake from the shell. + Before performing an out-of-source build, ensure that all CMake generated + in-source build information is removed from the source directory, + e.g., CMakeFiles directory, CMakeCache.txt. + Using cmake @@ -74,24 +90,24 @@ Using cmake Here some examples, assuming the build folder is in the same folder as the source tree: * Makefiles on Linux - cmake ../trunk/development/cmake + cmake ../trunk * Project files for QtCreator: - Open the trunk/development/cmake/CMakeLists.txt file and select the build folder + Open the trunk/CMakeLists.txt file and select the build folder or create the files in the command line using the -G"CodeBlocks *" option, eg - cmake ../trunk/development/cmake -G"CodeBlocks - Unix Makefiles" + cmake ../trunk -G"CodeBlocks - Unix Makefiles" * Project files for Xcode - cmake ../trunk/development/cmake -GXcode + cmake ../trunk -GXcode * Project files for Visual Studio 10 - cmake ..\trunk\development\cmake -G"Visual Studio 10" + cmake ..\trunk -G"Visual Studio 10" * NMake files for Visual Studio - cmake ..\trunk\development\cmake -G"NMake Makefiles" + cmake ..\trunk -G"NMake Makefiles" * Makefiles for MinGW - cmake ..\trunk\development\cmake -G"MinGW Makefiles" + cmake ..\trunk -G"MinGW Makefiles" Daily work: @@ -116,17 +132,17 @@ Build options Options could be passed by the -D prefix when running cmake. Available options will be listed on each cmake run. - Here the options with their default value: + -Dhelp=1 lists all available options: # Available on all systems/compilers -- LYX_CPACK = OFF : Use the CPack management (Implies LYX_INSTALL option) -- LYX_INSTALL = OFF : Build install projects/rules (implies a bunch of other options) - -- LYX_NLS = OFF : Use nls + -- LYX_NLS = ON : Use nls -- LYX_ASPELL = OFF : Require aspell -- LYX_ENCHANT = OFF : Require Enchant -- LYX_HUNSPELL = OFF : Require Hunspell -- LYX_DEVEL_VERSION = OFF : Build developer version - -- LYX_RELEASE = ON : Build release version, build debug when disabled + -- LYX_RELEASE = OFF : Build release version, build debug when disabled -- LYX_PACKAGE_SUFFIX = ON : Use version suffix for packaging -- LYX_PCH = OFF : Use precompiled headers -- LYX_MERGE_FILES = OFF : Merge source files into one compilation unit @@ -148,7 +164,8 @@ Build options -- LYX_CONSOLE = ON : Show console on Windows -- LYX_VLD = OFF : Use VLD with MSVC -- LYX_WALL = OFF : Enable all warnings - -- LYX_LYX_CONFIGURE_CHECKS = OFF : Also run configure checks for MSVC + -- LYX_CONFIGURE_CHECKS = OFF : Also run configure checks for MSVC + -- LYX_DEPENDENCIES_DOWNLOAD= OFF : Download precompiled 3rd party libraries for MSVC 10 @@ -261,5 +278,19 @@ Xcode/Mac Packaging ---------- - - Source .tar.gz, .tar.bz2, .zip: - make package_source + - Source .tar.gz, .tar.bz2, .zip: + make package_source + + - Binary .tar.gz and install .sh: + make package + + - Binary .deb: + create : cpack -G DEB --config CPackConfig.cmake + list : dpkg-deb -c lyx-*.deb + install: dpkg -i lyx-*.deb + + - Binary .rpm: + create : cpack -G RPM --config CPackConfig.cmake + list : rpm -qlp lyx-*.rpm + install: rpm -U lyx-*.rpm +