aboutsummaryrefslogtreecommitdiff
path: root/doc/Building/meson.asciidoc
diff options
context:
space:
mode:
authorAqua-sama <aqua@iserlohn-fortress.net>2019-02-11 20:25:02 +0200
committerAqua-sama <aqua@iserlohn-fortress.net>2019-02-11 20:25:02 +0200
commit5fe4b752fec9b56da213c38127cab4e70efddc6d (patch)
tree1e30eb7629b9ced0604bd6bb4980667ffe46cf89 /doc/Building/meson.asciidoc
parentmove add_global_arguments before build targets (diff)
downloadsmolbote-5fe4b752fec9b56da213c38127cab4e70efddc6d.tar.xz
Add configure script
Configure script is not needed when building, it is provided as a convenience tool. Requires python3.
Diffstat (limited to 'doc/Building/meson.asciidoc')
-rw-r--r--doc/Building/meson.asciidoc39
1 files changed, 39 insertions, 0 deletions
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
+----
+