From 81f35f15492a35bcb294f7a516459141b1bd73ab Mon Sep 17 00:00:00 2001 From: Dylan Baker Date: Wed, 29 Apr 2020 13:14:10 -0700 Subject: docs: Update documentation for add_*_script --- .../snippets/add_foo_script_type_additions.md | 24 ++++++++++++++++++++++ 1 file changed, 24 insertions(+) create mode 100644 docs/markdown/snippets/add_foo_script_type_additions.md (limited to 'docs/markdown/snippets') diff --git a/docs/markdown/snippets/add_foo_script_type_additions.md b/docs/markdown/snippets/add_foo_script_type_additions.md new file mode 100644 index 0000000..88a88b2 --- /dev/null +++ b/docs/markdown/snippets/add_foo_script_type_additions.md @@ -0,0 +1,24 @@ +## meson.add_*_script methods accept new types + +All three (`add_install_script`, `add_dist_script`, and +`add_postconf_script`) now accept ExternalPrograms (as returned by +`find_program`), Files, and the output of `configure_file`. The dist and +postconf methods cannot accept other types because of when they are run. +While dist could, in theory, take other dependencies, it would require more +extensive changes, particularly to the backend. + +```meson +meson.add_install_script(find_program('foo'), files('bar')) +meson.add_dist_script(find_program('foo'), files('bar')) +meson.add_postconf_script(find_program('foo'), files('bar')) +``` + +The install script variant is also able to accept custom_targets, +custom_target indexes, and build targets (executables, libraries), and can +use built executables a the script to run + +```meson +installer = executable('installer', ...) +meson.add_install_script(installer, ...) +meson.add_install_script('foo.py', installer) +``` -- cgit v1.1