INSTALL.cmake | 76 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 76 insertions(+)
New commits: commit a5c616a65a77bf597836cced6f987e5b93480ca5 Author: Adrian Johnson <[email protected]> Date: Mon Sep 11 20:55:01 2017 +0930 cmake INSTALL file diff --git a/INSTALL.cmake b/INSTALL.cmake new file mode 100644 index 00000000..7b5d6585 --- /dev/null +++ b/INSTALL.cmake @@ -0,0 +1,76 @@ +Installation Instructions +************************* + +Basic Installation +================== + +mkdir build +cd build +cmake .. +make +make install + + +CMake configuration options can be set using the -D option. eg + + cmake .. -DCMAKE_INSTALL_PREFIX=/usr/local -DCMAKE_BUILD_TYPE=release + + +Build Options +============= + +Set install prefix: + + -DCMAKE_INSTALL_PREFIX=<path> + +Set build type. This sets the standard compiler flags for the build +type. + + -DCMAKE_BUILD_TYPE=debug or -DCMAKE_BUILD_TYPE=release + +Set compiler flags: + + -DCMAKE_CXX_FLAGS=<flags> or set CXXFLAGS environment variable + +Set linker flags: + + -DCMAKE_LD_FLAGS=<flags> or set LDFLAGS environment variable + + +Optional Features +================= + + -D<FEATURE>=<ON|OFF> + +eg + + -DENABLE_SPLASH=ON -DBUILD_GTK_TESTS=OFF + +A list of all options can be display with the commmand: + + egrep '^ *(option|set.*STRING)' CMakeLists.txt + +Alternatively, the options can be edited by running "ccmake ." in the +build directory. + + +Cross Compiling +=============== + +A toolchain file is required to specify the target specific compiler +tools. Run cmake with the option: + + -DCMAKE_TOOLCHAIN_FILE=<Toolchain file> + +A sample toolchain for a 64-bit mingw build is shown below. Replace +/path/to/win/root with the install prefix for the target environment. + + SET(CMAKE_SYSTEM_NAME Windows) + SET(CMAKE_C_COMPILER x86_64-w64-mingw32-gcc) + SET(CMAKE_CXX_COMPILER x86_64-w64-mingw32-g++) + SET(CMAKE_RC_COMPILER x86_64-w64-mingw32-windres) + SET(CMAKE_FIND_ROOT_PATH /usr/x86_64-w64-mingw32 /path/to/win/root ) + set(CMAKE_FIND_ROOT_PATH_MODE_PROGRAM NEVER) + set(CMAKE_FIND_ROOT_PATH_MODE_LIBRARY ONLY) + set(CMAKE_FIND_ROOT_PATH_MODE_INCLUDE ONLY) + _______________________________________________ poppler mailing list [email protected] https://lists.freedesktop.org/mailman/listinfo/poppler
