aboutsummaryrefslogtreecommitdiff
path: root/docs/markdown/Reference-manual.md
diff options
context:
space:
mode:
authorXavier Claessens <xavier.claessens@collabora.com>2021-01-29 15:18:12 -0500
committerJussi Pakkanen <jpakkane@gmail.com>2021-01-30 21:28:21 +0000
commit6c6b5d77d696c160a8f65719058dba2faf783b3e (patch)
tree74e172d60ee634e1a7dd344b75c883841749aad2 /docs/markdown/Reference-manual.md
parentc491d48b9d081125f242227ff9e543abbbb838d8 (diff)
downloadmeson-6c6b5d77d696c160a8f65719058dba2faf783b3e.zip
meson-6c6b5d77d696c160a8f65719058dba2faf783b3e.tar.gz
meson-6c6b5d77d696c160a8f65719058dba2faf783b3e.tar.bz2
add_install_script: add skip_if_destdir kwarg
It is common, at least in GNOME projects, to have scripts that must be run only in the final destination, to update system icon cache, etc. Skipping them from Meson ensures we can properly log that they have not been run instead of relying on such scripts to to it (they don't always).
Diffstat (limited to 'docs/markdown/Reference-manual.md')
-rw-r--r--docs/markdown/Reference-manual.md4
1 files changed, 4 insertions, 0 deletions
diff --git a/docs/markdown/Reference-manual.md b/docs/markdown/Reference-manual.md
index 72199df..fa6321a 100644
--- a/docs/markdown/Reference-manual.md
+++ b/docs/markdown/Reference-manual.md
@@ -1851,6 +1851,10 @@ the following methods.
`MESON_BUILD_ROOT`, `MESON_INSTALL_PREFIX`,
`MESON_INSTALL_DESTDIR_PREFIX`, and `MESONINTROSPECT` set.
All positional arguments are passed as parameters.
+ *since 0.57.0* `skip_if_destdir` boolean keyword argument (defaults to `false`)
+ can be specified. If `true` the script will not be run if DESTDIR is set during
+ installation. This is useful in the case the script updates system wide
+ cache that is only needed when copying files into final destination.
*(since 0.54.0)* If `meson install` is called with the `--quiet` option, the
environment variable `MESON_INSTALL_QUIET` will be set.