From 5fe4b752fec9b56da213c38127cab4e70efddc6d Mon Sep 17 00:00:00 2001
From: Aqua-sama <aqua@iserlohn-fortress.net>
Date: Mon, 11 Feb 2019 20:25:02 +0200
Subject: Add configure script

Configure script is not needed when building, it is provided as a
convenience tool. Requires python3.
---
 doc/Building/meson.asciidoc | 39 +++++++++++++++++++++++++++++++++++++++
 1 file changed, 39 insertions(+)
 create mode 100644 doc/Building/meson.asciidoc

(limited to 'doc/Building/meson.asciidoc')

diff --git a/doc/Building/meson.asciidoc b/doc/Building/meson.asciidoc
new file mode 100644
index 0000000..255e0ad
--- /dev/null
+++ b/doc/Building/meson.asciidoc
@@ -0,0 +1,39 @@
+==== Setting compiler
+Compiler can only be set when initially configuring the build, and cannot be
+changed with --reconfigure:
+
+[source, sh]
+----
+export CXX="ccache clang++"
+meson build-path
+----
+
+==== Setting linker
+[source, sh]
+----
+build% meson configure -Dcpp_link_args='-fuse_ld=gold'
+----
+
+==== Listing build options
+[source, sh]
+----
+build% meson configure
+----
+
+==== Changing build options
+[source, sh]
+----
+build% meson configure -D<option-name>=<enabled|disabled>
+# for example:
+build% meson configure -DPlasma=enabled
+----
+
+==== Prevent meson from downloading wraps
+During configure, meson can download missing dependencies on its own using
+wraps. To disable this, pass '--wrap-mode=nodownload' during the configure
+phase:
+[source, sh]
+----
+repo% meson --wrap-mode=nodownload build-path
+----
+
-- 
cgit v1.2.1

