"SfR Fresh" - the SfR Freeware/Shareware Archive

Member "gpsdrive-2.10pre6/INSTALL" of archive gpsdrive-2.10pre6.tar.gz:

As a special service "SfR Fresh" has tried to format the requested source page into HTML format using source code syntax highlighting with prefixed line numbers. Alternatively you can here view or download the uninterpreted source code file. That can be also achieved for any archive member file by clicking within an archive contents listing on the first character of the file(path) respectively on the according byte size field. 
    1 # How to build from source
    2 
    3 ## Requirements
    4 
    5 ### Common requirements
    6 
    7 In order to build the gpsdrive, you need to install several components:
    8 
    9 - A C++ compiler
   10 - [CMake](http://www.cmake.org/) >= 2.4.4.
   11 - [GTK2](http://www.gnome.org/)
   12 - [Boost](http://www.boost.org/) >= 1.33.1
   13 - [mapnik](http://www.mapnik.org/) >= 0.4
   14 - perl
   15     - perl-DB
   16     - FIXME
   17 
   18 There are also some platform specific requirements listed below.
   19 
   20 Note that these version numbers are version we know works correctly. If you
   21 build and run the gpsdrive successfully with an older version, please let us
   22 know.
   23 
   24 ### Optional requirements
   25 
   26 - [gdal](http://www.gdal.org/)
   27 
   28 ### Specific requirements for GNU/Linux
   29 
   30 The default compiler should be gcc 4.0 or newer.
   31 
   32 Other components:
   33 
   34 ### Specific requirements for MacOS X
   35 
   36 - [GTK2](http://www.gnome.org/)
   37 
   38 GTK2 can be installed using [Fink](http://www.finkproject.org) or
   39 [MacPorts](http://www.macports.org).
   40 
   41 ### Specific requirements for Windows
   42 
   43 FIXME
   44 
   45 ## Building
   46 First, you need to configure the compilation, using CMake. Go inside the
   47 `build` dir.
   48 
   49 Windows with Visual C++:
   50 
   51     cmake -DCMAKE_BUILD_TYPE=Debug -G "NMake Makefiles" ..
   52     nmake
   53 
   54 Windows with MinGW:
   55 
   56     cmake -DCMAKE_BUILD_TYPE=Debug -G "MinGW Makefiles" ..
   57     make
   58 
   59 GNU/Linux and MacOS X:
   60 
   61     cmake -DCMAKE_BUILD_TYPE=Debug ..
   62     make
   63 
   64 ### CMake standard options
   65 Here is a list of the most interesting options provided out of the box by CMake.
   66 
   67 - CMAKE_BUILD_TYPE: The type of build (can be Debug Release MinSizeRel RelWithDebInfo)
   68 - CMAKE_INSTALL_PREFIX: The prefix to use when running make install (Default to
   69   /usr/local on GNU/Linux and MacOS X)
   70 - CMAKE_C_COMPILER: The path to the C compiler
   71 - CMAKE_CXX_COMPILER: The path to the C++ compiler
   72 
   73 ### CMake options defined for gpsdrive
   74 
   75 Options are defined in the following files:
   76 
   77 - DefineOptions.cmake
   78 
   79 They can be changed with the -D option:
   80 
   81 `cmake -DCMAKE_BUILD_TYPE=Debug -DWITH_GDAL=ON ..`
   82 
   83 ### Browsing/editing CMake options
   84 
   85 In addition to passing options on the command line, you can browse and edit
   86 CMake options using `cmakesetup` (Windows) or `ccmake` (GNU/Linux and MacOS X).
   87 
   88 - Go to the build dir
   89 - On Windows: run `cmakesetup`
   90 - On GNU/Linux and MacOS X: run `ccmake ..`
   91 
   92 ## Running
   93 
   94 The gpsdrive binary can be found in the `build` directory.
   95 
   96 ## About this document
   97 
   98 This document is written using [Markdown][] syntax, making it possible to
   99 provide usable information in both plain text and HTML format. Whenever
  100 modifying this document please use [Markdown][] syntax.
  101 
  102 [markdown]: http://www.daringfireball.net/projects/markdown