Basic Installation
==================

    For more information specific to this package, please read the README
file. This source code distribution is automatically configured using
CMake and you should be able to compile it and install it without manual
interventions such as editing Makefiles and configuration files. These
are generic instructions for people who are not familiar with installing
software using CMake.

The simplest way to compile this package is to enter the source code main
directroy and do the following:

  1. Create a build directory. Building from within the source tree directly
     causes problems and is disallowed.

       $ mkdir build
       $ cd build

  2. From within the build directory run CMake by typing:

       $ cmake ..

     If you wish to change install locations, or set optional configuration
     options, you can run it interactively by typing:

       $ cmake -i ..

     The CMake program will then ask a series of questions that allow you to
     change the configuration options.

  3. Once configured, make the library from within the build directory by typing:

       $ make

  4. The software is installed by typing:

       $ make install

     Depending on where it is installed, you will typically have to do this as the
     root user. If you have sudo permissions, you can do this by typing:

       $ sudo make install

     Refer to the sudo documentation for more information.

