summaryrefslogtreecommitdiff
path: root/INSTALL
diff options
context:
space:
mode:
authorAdrian Johnson <ajohnson@redneon.com>2023-01-08 22:28:29 +1030
committerAdrian Johnson <ajohnson@redneon.com>2023-01-08 22:28:29 +1030
commitc756836dbe079d9dc7e664774de291c6809c20e5 (patch)
treeef4e50e48e42f0de2ca378d8585caa79d3f33548 /INSTALL
parentefe303d9db6e24d5786c15252327811338bc9b0a (diff)
downloadcairo-c756836dbe079d9dc7e664774de291c6809c20e5.tar.gz
Rename INSTALL.meson and README.meson
Diffstat (limited to 'INSTALL')
-rw-r--r--INSTALL47
1 files changed, 47 insertions, 0 deletions
diff --git a/INSTALL b/INSTALL
new file mode 100644
index 000000000..252dcf737
--- /dev/null
+++ b/INSTALL
@@ -0,0 +1,47 @@
+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 of the 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.meson