summaryrefslogtreecommitdiff
path: root/README.CMake_build
diff options
context:
space:
mode:
authorMatthias Melcher <fltk@matthiasm.com>2010-12-20 20:00:44 +0000
committerMatthias Melcher <fltk@matthiasm.com>2010-12-20 20:00:44 +0000
commit7046e8ebcb01c91500066300bdeaaa41ca1ac0cb (patch)
tree11a1ee83044cab4680367cfa5903b63de2f6a028 /README.CMake_build
parent8bf8cdd52438a5cac97b525a8c83d6aadb2e0ee5 (diff)
Merged the CMake documenation and adapted the format to the one used in the other README fiels (mainly adding a TOC).
git-svn-id: file:///fltk/svn/fltk/branches/branch-1.3@8082 ea41ed52-d2ee-0310-a9c1-e6b18d33e121
Diffstat (limited to 'README.CMake_build')
-rw-r--r--README.CMake_build137
1 files changed, 0 insertions, 137 deletions
diff --git a/README.CMake_build b/README.CMake_build
deleted file mode 100644
index d68fc60c6..000000000
--- a/README.CMake_build
+++ /dev/null
@@ -1,137 +0,0 @@
-Using CMake to build FLTK.
-
-PREREQUISITES
-
-The prerequisites for building FLTK with CMake are staightforward:
-CMake 2.6 or later and a recent FLTK 1.3 snapshot. Installation of
-CMake is covered on its web site.
-
-This howto will cover building FLTK with the default options using cmake
-under Linux with both the default Unix Makefiles and a MinGW cross compiling
-toolchain. Other platforms are just as easy to use.
-
-OPTIONS
-
-All options have sensible defaults so you won't usually need to touch these.
-There are only two CMake options that you may want to specify.
-
-CMAKE_BUILD_TYPE
- This specifies what kind of build this is i.e. Release, Debug...
-Platform specific compile/link flags/options are automatically selected
-by CMake depending on this value.
-
-CMAKE_INSTALL_PREFIX
- Where everything will go on install. Defaults are /usr/local for unix
-and C:\Program Files\FLTK for Windows.
-
-These are the FLTK specific options. Platform specific options are ignored
-on other platforms.
-
-OPTION_OPTIM
- Extra optimization flags.
-OPTION_ARCHFLAGS
- Extra architecture flags.
-
- The OPTION_PREFIX_* flags are for fine-tuning where everything goes
-on the install.
-OPTION_PREFIX_BIN
-OPTION_PREFIX_LIB
-OPTION_PREFIX_INCLUDE
-OPTION_PREFIX_DATA
-OPTION_PREFIX_DOC
-OPTION_PREFIX_CONFIG
-OPTION_PREFIX_MAN
-
-OPTION_APPLE_X11 - default OFF
- In case you want to use X11 on OSX. Not currently supported.
-OPTION_USE_POLL - default OFF
- Don't use this one either.
-
-OPTION_BUILD_SHARED_LIBS - default OFF
- Normally FLTK is built as static libraries which makes more portable
-binaries. If you want to use shared libraries, this will build them too.
-OPTION_BUILD_EXAMPLES - default ON
- Builds the many fine example programs.
-
-OPTION_CAIRO - default OFF
- Enables libcairo support
-OPTION_CAIROEXT - default OFF
- Enables extended libcairo support
-
-OPTION_USE_GL - default ON
- Enables OpenGL support
-
-OPTION_USE_THREADS - default ON
- Enables multithreaded support
-
-OPTION_LARGE_FILE - default ON
- Enables large file (>2G) support
-
- FLTK has built in jpeg zlib and png libraries. These let you use
-system libraries instead, unless CMake can't find them.
-OPTION_USE_SYSTEM_LIBJPEG - default ON
-OPTION_USE_SYSTEM_ZLIB - default ON
-OPTION_USE_SYSTEM_LIBPNG - default ON
-
- X11 extended libraries.
-OPTION_USE_XINERAMA - default ON
-OPTION_USE_XFT - default ON
-OPTION_USE_XDBE - default ON
-
-BUILDING UNDER LINUX WITH UNIX MAKEFILES
-
-After untaring the FLTK source, go to the root of the FLTK tree and type
-the following.
-
-mkdir build
-cd build
-cmake ..
-make
-sudo make install
-
-This will build and install a default configuration FLTK.
-
-CROSSCOMPILING
-
-Once you have a crosscompiler going, to use CMAke to build FLTK you need
-two more things. You need a toolchain file which tells CMake where your
-build tools are. The CMake website is a good source of information on
-this file. Here's mine for MinGW under Linux.
-----
-
-# the name of the target operating system
-set(CMAKE_SYSTEM_NAME Windows)
-
-# which tools to use
-set(CMAKE_C_COMPILER /usr/bin/i486-mingw32-gcc)
-set(CMAKE_CXX_COMPILER /usr/bin/i486-mingw32-g++)
-
-# here is where the target environment located
-set(CMAKE_FIND_ROOT_PATH /usr/i486-mingw32)
-
-# adjust the default behaviour of the FIND_XXX() commands:
-# search programs in the host environment
-set(CMAKE_FIND_ROOT_PATH_MODE_PROGRAM NEVER)
-# search headers and libraries in the target environment,
-set(CMAKE_FIND_ROOT_PATH_MODE_LIBRARY ONLY)
-set(CMAKE_FIND_ROOT_PATH_MODE_INCLUDE ONLY)
-
-set(CMAKE_INSTALL_PREFIX ${CMAKE_FIND_ROOT_PATH}/usr CACHE FILEPATH
- "install path prefix")
-
-----
-
-Not too tough. The other thing you need is a native installation of FLTK
-on your build platform. This is to supply the fluid executable which will
-compile the *.fl into C++ source and header files.
-
-So, again from the FLTK tree root.
-
-mkdir mingw
-cd mingw
-cmake -DCMAKE_TOOLCHAIN_FILE=~/projects/toolchain/Toolchain-mingw32.cmake ..
-make
-sudo make install
-
-This will create a default configuration FLTK suitable for mingw/msys and
-install it in the /usr/i486-mingw32/usr tree.