[cairo-commit] 2 commits - INSTALL.meson

[GitLab Mirror]

 INSTALL.meson |   56 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 56 insertions(+)

New commits:
commit 6872490e77fb2d0cc7d7bb7b43f1da8464da6344
Merge: 908b243ab 47c4dc4fc
Author: Adrian Johnson <ajohnson at redneon.com>
Date:   Sun Jul 25 11:33:43 2021 +0000

    Merge branch 'meson-install' into 'master'
    
    Add meson install instructions
    
    See merge request cairo/cairo!206

commit 47c4dc4fcffdc7faa3acaed823629bcc40a49be3
Author: Adrian Johnson <ajohnson at redneon.com>
Date:   Sun Jul 25 11:33:42 2021 +0000

    Add meson install instructions

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.