Add meson install instructions

1 files changed, 56 insertions, 0 deletions

diff --git a/INSTALL.meson b/INSTALL.meson
new file mode 100644
index 000000000..5603a9ae7
--- /dev/null
+++ b/INSTALL.meson
@@ -0,0 +1,56 @@
+Installation Instructions
+=========================
+
+Requirements
+------------
+As well as the requirements listed in README, the meson build also requires:
+  meson (http://mesonbuild.com)
+  ninja (http://ninja-build.org)
+
+Basic Installation
+------------------
+  meson setup $builddir
+  ninja -C $builddir
+  ninja -C $builddir install
+
+where $builddir is the name directory where the build artifacts will be written to.
+
+Some of the common options that can be used with "meson setup" include:
+
+Set the install prefix.
+  --prefix=<path>
+
+Set the build type. Some common build types include "debug" and "release"
+  --buildtype=<buildtype>
+
+Compiler and linker flags can be set with the CFLAGS and LDFLAGS
+environment variables.
+
+Configuring cairo backends
+--------------------------
+After running "meson build", "meson configure" can be used to display
+or modify the build configuration.
+
+eg
+
+ Display configuration:
+    meson configure $builddir
+
+ Enable pdf and disable ps:
+    meson configure $builddir -Dpdf=enabled -Dps=disabled
+
+The "-D" options can also be used with "meson setup"
+
+Tests
+-----
+Refer to test/README. The main difference with running a test from a
+meson build is that the cairo-test-suite executable needs to be run in
+$builddir/test to find the image conversion executables but also needs
+to be told where the reference images are.
+
+eg
+  cd $builddir/test
+  srcdir="../../test" ./cairo-test-suite
+
+Where srcdir is the path to the "test" directory in the cairo source. The
+above example assumes $builddir is a directory in the cairo source tree.