Add meson install instructions

This commit is contained in:
Adrian Johnson 2021-07-25 11:33:42 +00:00
parent 908b243ab8
commit 47c4dc4fcf

56
INSTALL.meson Normal file
View file

@ -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.