summaryrefslogtreecommitdiff
path: root/docs/markdown/snippets/local_program.md
diff options
context:
space:
mode:
Diffstat (limited to 'docs/markdown/snippets/local_program.md')
-rw-r--r--docs/markdown/snippets/local_program.md13
1 files changed, 13 insertions, 0 deletions
diff --git a/docs/markdown/snippets/local_program.md b/docs/markdown/snippets/local_program.md
new file mode 100644
index 000000000..e671efb2c
--- /dev/null
+++ b/docs/markdown/snippets/local_program.md
@@ -0,0 +1,13 @@
+## New [[local_program]] function
+
+Similar to [[find_program]], but only work with a program that exists in
+source tree, or a built target. Meson will not look for the program in the
+system or in a subproject.
+
+In addition, `depends` keyword argument can be specified in case the program
+depends on built targets, for example a Python script could require a compiled
+C module. If any such dependency is present, the program can only be used in
+build-time commands (e.g. [[custom_target]]).
+
+The program can be passed to [[meson.override_find_program]] and used in
+subprojects.