aboutsummaryrefslogtreecommitdiff
path: root/docs/markdown/snippets
diff options
context:
space:
mode:
authorJussi Pakkanen <jpakkane@gmail.com>2019-12-21 21:22:45 +0200
committerJussi Pakkanen <jpakkane@gmail.com>2020-02-12 22:31:08 +0200
commit47759550e5f6a5e617ff686f2b5f275ade97c4b2 (patch)
treecd7ead67c7f1a346e6e2699d8cfa6cd0a31ddbed /docs/markdown/snippets
parent6b5c1a4fc34f8f782947bde3e9a14446c89a2934 (diff)
downloadmeson-47759550e5f6a5e617ff686f2b5f275ade97c4b2.zip
meson-47759550e5f6a5e617ff686f2b5f275ade97c4b2.tar.gz
meson-47759550e5f6a5e617ff686f2b5f275ade97c4b2.tar.bz2
Add unity block size option.
Diffstat (limited to 'docs/markdown/snippets')
-rw-r--r--docs/markdown/snippets/unitysize.md12
1 files changed, 12 insertions, 0 deletions
diff --git a/docs/markdown/snippets/unitysize.md b/docs/markdown/snippets/unitysize.md
new file mode 100644
index 0000000..4919ce0
--- /dev/null
+++ b/docs/markdown/snippets/unitysize.md
@@ -0,0 +1,12 @@
+## Unity file block size is configurable
+
+Traditionally the unity files that Meson autogenerates contain all
+source files that belong to a single target. This is the most
+efficient setting for full builds but makes incremental builds slow.
+This release adds a new option `unity_size` which specifies how many
+source files should be put in each unity file.
+
+The default value for block size is 4. This means that if you have a
+target that has eight source files, Meson will generate two unity
+files each of which includes four source files. The old behaviour can
+be replicated by setting `unity_size` to a large value, such as 10000.