From 59b20e35463d57cd26c7c8986c2d2f498e1363f5 Mon Sep 17 00:00:00 2001
From: Matthias Vogelgesang <matthias.vogelgesang@kit.edu>
Date: Thu, 5 Jul 2018 11:13:43 +0200
Subject: docs: add meson instructions

---
 docs/install.rst | 38 ++++++++++++++++++++++++++++++++------
 1 file changed, 32 insertions(+), 6 deletions(-)

(limited to 'docs')

diff --git a/docs/install.rst b/docs/install.rst
index f83f4f1..ae6b44b 100644
--- a/docs/install.rst
+++ b/docs/install.rst
@@ -2,25 +2,51 @@
 Installation
 ============
 
+
 Prior to building the filter suite you have to install the base library ufo-core
 as well as all task-specific dependencies (e.g. *libtiff* for :gobj:class:`read`
-and :gobj:class:`write`). Once installed you can check out the source with::
+and :gobj:class:`write`). Once ufo-core is installed you can check out the
+source with::
+
+  $ git clone https://github.com/ufo-kit/ufo-filters
+
 
-    $ git clone https://github.com/ufo-kit/ufo-filters
+Building with CMake
+-------------------
 
 Configure the build with::
 
-    $ cd <source-path>
-    $ cmake .
+  $ cd <source-path>
+  $ cmake .
 
 Installation paths can be customized by passing ``configure`` equivalents like
 so::
 
-    $ cmake . -DCMAKE_INSTALL_PREFIX=/usr -DCMAKE_INSTALL_LIBDIR=/usr/lib64
+  $ cmake . -DCMAKE_INSTALL_PREFIX=/usr -DCMAKE_INSTALL_LIBDIR=/usr/lib64
 
 Now build and install the filters with::
 
-    $ make && make install
+  $ make && make install
 
 Depending on the installation location, the second step requires administration
 rights.
+
+
+Building with meson
+-------------------
+
+Configure the build with ``meson`` by changing into the root source directory
+and type ::
+
+  $ meson build
+
+You can change the location of GNU installation directories during this step or
+later with the ``meson configure`` tool ::
+
+  $ meson build --prefix=/usr
+  $ cd build && meson configure -Dprefix=/usr/local
+
+Build, test and install everything with ::
+
+  $ cd build
+  $ ninja && ninja test && ninja install
-- 
cgit v1.2.1