aboutsummaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
authorJussi Pakkanen <jpakkane@gmail.com>2019-06-30 17:13:19 +0300
committerDylan Baker <dylan@pnwbakers.com>2019-07-01 09:53:30 -0700
commit33aee8d113c09d51ef183e692164bc5374e80f73 (patch)
tree537ac3270f03510782cc72f0b01ea615b20ce5e2 /docs
parent866d105036b93704982f97dcd0afd51d081bf878 (diff)
downloadmeson-33aee8d113c09d51ef183e692164bc5374e80f73.zip
meson-33aee8d113c09d51ef183e692164bc5374e80f73.tar.gz
meson-33aee8d113c09d51ef183e692164bc5374e80f73.tar.bz2
Describe array values in install_dir. [skip ci]
Diffstat (limited to 'docs')
-rw-r--r--docs/markdown/Installing.md21
1 files changed, 21 insertions, 0 deletions
diff --git a/docs/markdown/Installing.md b/docs/markdown/Installing.md
index 66d090d..5abfdd4 100644
--- a/docs/markdown/Installing.md
+++ b/docs/markdown/Installing.md
@@ -115,3 +115,24 @@ command in the build tree:
```console
$ meson install --no-rebuild --only-changed
```
+
+## Finer control over install locations
+
+Sometimes it is necessary to only install a subsection of output files
+or install them in different directories. This can be done by
+specifying `install_dir` as an array rather than a single string. The
+array must have as many items as there are outputs and each entry
+specifies how the corresponding output file should be installed. For
+example:
+
+```meson
+custom_target(...
+ output: ['file1', 'file2', 'file3'],
+ install_dir: ['path1', false, 'path3'],
+ ...
+)
+```
+
+In this case `file1` would be installed to `/prefix/path1/file1`,
+`file2` would not be installed at all and `file3` would be installed
+to `/prefix/path3/file3'.